Skip to content

Commit 0d244b8

Browse files
authored
Merge pull request #356 from wpaccessibility/update-plugin-recommendation-guideline
Update language for plugin recommendations
2 parents 5f2e223 + 5a1f415 commit 0d244b8

1 file changed

Lines changed: 12 additions & 6 deletions

File tree

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
---
2-
title: Must not recommend or require inaccessible plugins
2+
title: Must not recommend inaccessible plugins
33
layout: default
44
parent: Theme accessibility-ready guidelines
55
nav_order: 17
6-
description: Accessibility-ready themes must not recommend or require inaccessible plugins.
6+
description: Accessibility-ready themes must not recommend inaccessible plugins.
77
contributors:
88
- Amber Hinds
99
- Joe Dolson
1010
redirect_from:
1111
- /docs/topics/theme-guidelines/no-inaccessible-plugins/
1212
---
1313

14-
# Must not recommend or require inaccessible plugins
14+
# Must not recommend inaccessible plugins
1515

1616
## Basic principle
1717

18-
Accessibility Ready themes must not recommend, promote, bundle, or require plugins that introduce known accessibility barriers as part of the theme’s setup process or ongoing use within the WordPress admin.
18+
Accessibility Ready themes must not recommend plugins that introduce known accessibility barriers as part of the theme’s setup process or ongoing use within the WordPress admin.
1919

2020
Themes play a significant role in shaping how site owners build and extend their websites. When a theme directs users toward inaccessible plugins — whether through onboarding screens, admin notices, documentation, or demo imports — it undermines the goal of providing an accessible foundation and can result in inaccessible websites even when the theme itself meets accessibility requirements.
2121

@@ -25,16 +25,22 @@ Themes should either:
2525
1. Not recommend plugins at all or,
2626
2. If recommending plugins, only recommend plugins that similarly pass `accessibility-ready` requirements.
2727

28+
### What is considered a plugin recommendation?
29+
30+
It is considered a recommendation to include language or prompts that actively suggest that a user install a plugin. Examples of this behavior could include (but is not limited to) having blocks in your starter content that contains links to install plugins or bundling packages like TGM Plugin Activation, or displaying admin notices recommending that user's install specific plugins.
31+
32+
Declaring compatibility with a plugin is not considered a recommendation of that plugin.
33+
2834
## Testing
2935

3036
**Tools:** browser
3137

32-
1. Look for admin banners or notices recommending or requiring plugins after activating the theme.
38+
1. Look for admin banners or notices recommending or requiring plugins after activating the theme.
3339
2. If prompted to install "recommended" or "required" plugins, install and activate those plugins.
3440
3. Conduct all `accessibility-ready` tests with the "recommended" or "required" plugins active.
3541
4. If accessibility problems are identified related to the plugins, this is considered a failure.
3642

3743

38-
**Note:** When evaluating accessibility, responsibility for the issue is not relevant to the review outcome. Testers are not required to determine whether an accessibility problem originates in the theme or in a plugin recommended by the theme.
44+
**Note:** When evaluating accessibility, responsibility for the issue is not relevant to the review outcome. Testers are not required to determine whether an accessibility problem originates in the theme or in a plugin recommended by the theme.
3945

4046
If an accessibility barrier is present, it should be reported. It is then up to the theme developer to determine whether the issue can be addressed within the theme, needs to be reported upstream, or requires removing the plugin recommendation altogether.

0 commit comments

Comments
 (0)