aria-accessibility-toolkit
Last commit date
assets
2 months ago
frontend
2 months ago
includes
2 months ago
aria-accessibility-toolkit.php
2 months ago
index.php
2 months ago
readme.txt
2 months ago
readme.txt
321 lines
| 1 | === Web Accessibility Toolkit - ARIA Labels & Roles for WCAG & ADA Compliance === |
| 2 | Contributors: quicksnail |
| 3 | Tags: aria, ada compliance, accessibility, accessibility checker, wcag |
| 4 | Plugin URI: https://wcagforwp.com/features |
| 5 | Author URI: https://wcagforwp.com |
| 6 | Author: WCAG for WP |
| 7 | Requires at least: 5.9 |
| 8 | Tested up to: 6.9 |
| 9 | Requires PHP: 7.0 |
| 10 | Stable tag: 1.6.4 |
| 11 | License: GPLv2 or later |
| 12 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 13 | |
| 14 | Add ARIA labels, roles, alt tags, contrast & form accessibility fixes. Accessibility checker scans your site for WCAG & ADA compliance & fixes issues. |
| 15 | |
| 16 | == Description == |
| 17 | |
| 18 | The **Web Accessibility Toolkit** helps your WordPress site meet **ADA compliance** and **WCAG compliance** standards with powerful accessibility checking and fixing tools. |
| 19 | |
| 20 | This plugin is not an 'overlay' or a 'widget' - it provides real code fixes to assist with WCAG & ADA compliance for WordPress. |
| 21 | |
| 22 | Scan your site with the built-in Accessibility Checker to identify issues such as missing **ARIA labels**, **low contrast text**, missing **alt tags**, incorrect heading structure & plenty more. |
| 23 | |
| 24 | Apply one-click fixes for many common accessibility issues to improve usability and help meet requirements for laws and standards like WCAG, ADA, EAA, Section 508, EN 301 549, and AODA. |
| 25 | |
| 26 | [Documentation](https://wcagforwp.com/docs/) | [Accessibility Checker Demo](https://wcagforwp.com/accessibility-checker-demo/) | [PRO Plugin](https://wcagforwp.com/pricing/) |
| 27 | |
| 28 | ### Accessibility Checker |
| 29 | |
| 30 | The built-in Accessibility Checker scans your WordPress site in real time to identify common accessibility issues that could affect WCAG compliance and ADA compliance. With a single click, you can run an accessibility check on any page and get clear, actionable details. |
| 31 | |
| 32 | The checker highlights issues directly on the page, including: |
| 33 | |
| 34 | - Missing or empty ARIA labels |
| 35 | - Low color contrast between text and background |
| 36 | - Missing alt text on images |
| 37 | - Skipped heading levels (e.g., jumping from H2 to H4) |
| 38 | - Broken ARIA references |
| 39 | - Interactive elements without keyboard focus |
| 40 | - Improper tab order |
| 41 | - Missing page titles |
| 42 | - Duplicate link text with different destinations |
| 43 | - Duplicate IDs in the DOM |
| 44 | - Form fields without labels or ARIA labels |
| 45 | - Use of user-scalable=no in viewport meta tags |
| 46 | - Non-focusable interactive elements |
| 47 | |
| 48 | Each issue includes details on what it means, why it matters for accessibility and how to fix it. Many problems can be resolved instantly using the plugin’s one-click fixes, while others provide guidance so you can address them in your theme or content. |
| 49 | |
| 50 | |
| 51 | ### Accessibility Fixes for WCAG & ADA Compliance |
| 52 | |
| 53 | - #### ARIA Attributes |
| 54 | Add ARIA attributes such as `aria-label`, `aria-hidden`, `aria-expanded`, `aria-live`, `aria-level`, and more to any element. |
| 55 | |
| 56 | - #### ARIA Roles |
| 57 | Assign semantic roles like `banner`, `navigation`, `main`, `complementary`, and `contentinfo` to improve screen reader navigation. |
| 58 | |
| 59 | - #### Image Alt Tags |
| 60 | Shows a list of all images that are missing alt tags, and allows you to easily update them all from the one spot. |
| 61 | |
| 62 | - #### Contrast Adjustments |
| 63 | Override text and background colors for low-contrast elements using accessible HEX values. |
| 64 | |
| 65 | - #### Skip Link Target |
| 66 | Add a keyboard/screen-reader-visible “Skip to content” link by defining a main content selector. |
| 67 | |
| 68 | - #### Language Override |
| 69 | Set or override the HTML `lang` attribute for improved screen reader compatibility. |
| 70 | |
| 71 | - #### Focus Outline Enhancements |
| 72 | Ensure visible focus styles are enforced for better keyboard navigation. |
| 73 | |
| 74 | - #### Fix Tab Order |
| 75 | Remove tabindex values greater than 0 to maintain a logical focus order. |
| 76 | |
| 77 | - #### Make Viewport Scalable |
| 78 | Remove user-scalable=no from the viewport meta tag to allow pinch-zooming. |
| 79 | |
| 80 | - #### CSS Selector-Based Targeting |
| 81 | Use any valid CSS selector to apply changes without modifying theme or template files. |
| 82 | |
| 83 | |
| 84 | ### Why Use Web Accessibility Toolkit? |
| 85 | |
| 86 | Most WordPress themes don’t include full accessibility support. Web Accessibility Toolkit lets you patch those gaps quickly, keeping your site more inclusive and compliant with ADA & WCAG guidelines. |
| 87 | |
| 88 | Whether you're a developer working on a client site or a business owner aiming for better usability, this plugin makes accessibility updates faster and easier. |
| 89 | |
| 90 | The Web Accessibility Toolkit is NOT an overlay widget, which can often do more harm than good for accessibility. This plugin fixes underlying code issues. |
| 91 | |
| 92 | ### Compatibility |
| 93 | |
| 94 | - Compatible with all WordPress themes |
| 95 | - Compatible with all WordPress plugins |
| 96 | - Works alongside popular page builders |
| 97 | - Designed with WCAG 2.1 AA standards and ADA compliance in mind |
| 98 | |
| 99 | == Frequently Asked Questions == |
| 100 | |
| 101 | = What does this plugin do? = |
| 102 | Web Accessibility Toolkit scans your site with an accessibility checker and helps you fix ADA compliance and WCAG compliance issues. It lets you add ARIA attributes, landmark roles, adjust contrast, fix alt tags, and more — no coding required. |
| 103 | |
| 104 | = Can this help my WordPress site be ADA compliant? = |
| 105 | Yes. While no plugin alone guarantees compliance, this tool helps you meet several key WCAG 2.1 success criteria like semantic structure, sufficient contrast, and accessible navigation. |
| 106 | |
| 107 | = Does it work with any theme? = |
| 108 | Yes. The plugin is designed to work with any WordPress theme, including those built with page builders like Elementor, WPBakery, or Gutenberg. |
| 109 | |
| 110 | = Will it slow down my site? = |
| 111 | No. It’s lightweight and only outputs a small block of CSS (and optionally JavaScript) based on your settings. There's no third-party code or unnecessary overhead. |
| 112 | |
| 113 | = Can I use it without JavaScript? = |
| 114 | Sort of. The plugin uses CSS & PHP where possible. JavaScript is used for the accessibility checker and dynamic updates that can't be done with CSS alone. |
| 115 | |
| 116 | = What kind of selectors can I use? = |
| 117 | Any valid CSS selector is supported — including classes (`.my-button`), IDs (`#main-header`), or element types (`nav`, `section`, etc.). |
| 118 | |
| 119 | = Can I apply multiple ARIA attributes to the same element? = |
| 120 | Yes. Simply add another row targeting the same selector with a different ARIA attribute. |
| 121 | |
| 122 | = What is the accessibility checker for? = |
| 123 | It shows a small box on your site (for admin users only) highlighting common accessibility issues like empty buttons, missing labels, broken ARIA references and low contrast. |
| 124 | |
| 125 | = What does the “Skip Link” setting do? = |
| 126 | It adds a screen-reader-visible “Skip to content” link at the top of the page for keyboard users. Just define the CSS selector of your main content area. |
| 127 | |
| 128 | = What does the Language option do? = |
| 129 | It sets the `lang` attribute on your `<html>` tag — especially useful if your theme doesn’t already do this. |
| 130 | |
| 131 | = How does the Accessibility Checker work? = |
| 132 | There is an option in the admin to enable the Accessibility Checker and once enabled, admins will see a small box on the frontend of your website with a Scan Page button. Simply click this to start the accessibility scan and a list of issues will be displayed with details on how to fix them. |
| 133 | |
| 134 | = What are the full list of features? = |
| 135 | |
| 136 | The Web Accessibility Toolkit plugin provides tools to help improve frontend accessibility, scan for issues, and add missing ARIA roles, labels, and other enhancements. |
| 137 | |
| 138 | **Free Version Features:** |
| 139 | |
| 140 | 1. Frontend Accessibility Checker panel |
| 141 | 2. Scan for missing `aria-label` and `aria-labelledby` attributes |
| 142 | 3. Detect and highlight empty buttons or ARIA attributes |
| 143 | 4. Detect broken ARIA references (e.g. `aria-describedby` targets not found) |
| 144 | 5. Detect low color contrast issues (text vs background) |
| 145 | 6. Detect skipped heading levels (e.g. jumping from h2 to h4) |
| 146 | 7. Detect missing `alt` text on images |
| 147 | 8. Detect form fields without labels or ARIA labels |
| 148 | 9. Detect duplicate link text with different destinations |
| 149 | 10. Detect use of `user-scalable=no` in viewport meta tag |
| 150 | 11. Detect missing page title |
| 151 | 12. Detect duplicate IDs in the DOM |
| 152 | 13. Detect use of `tabindex` values greater than 0 |
| 153 | 14. Detect non-focusable interactive elements |
| 154 | 15. Live preview: "Show" and "Copy Selector" buttons for each issue |
| 155 | 16. Fix suggestions for supported issues via plugin settings page |
| 156 | 17. ARIA role injection via CSS selectors |
| 157 | 18. Add landmark roles like `navigation`, `main`, `banner`, and more |
| 158 | 19. Add `aria-label` to menu items or custom HTML elements |
| 159 | 20. Set default `lang` attribute on the HTML tag |
| 160 | 21. Add skip link anchor to improve keyboard navigation |
| 161 | 22. Disable animations for motion-sensitive users |
| 162 | 23. Enable high-contrast mode support (coming soon) |
| 163 | 24. Lightweight, modular design — only loads what’s needed |
| 164 | |
| 165 | **PRO Version Features:** |
| 166 | |
| 167 | 1. Form scanning |
| 168 | 1. Automatic form fixes |
| 169 | 1. Unlimited menu targeting for ARIA attributes |
| 170 | 1. Unlimited menu targeting for ARIA roles |
| 171 | 1. Full list of selectable ARIA attributes |
| 172 | 1. Full list of selectable landmark roles |
| 173 | 1. Open External Links in New Tab |
| 174 | 1. Force Underline on Text Links |
| 175 | 1. Mark Decorative Images |
| 176 | |
| 177 | |
| 178 | Note: Not all issues can be automatically fixed. Some must be addressed in your theme or content. A full accessibility audit is recommended. |
| 179 | |
| 180 | = Is there a Pro version? = |
| 181 | Yes! A Pro version unlocks unlimited menu targeting and advanced attribute/role options. Visit [wcagforwp.com](https://wcagforwp.com) to learn more. |
| 182 | |
| 183 | == Installation == |
| 184 | |
| 185 | ### Using the WordPress Dashboard |
| 186 | 1. Navigate to “Add New” in the plugins dashboard |
| 187 | 2. Search for “Web Accessibility Toolkit” |
| 188 | 3. Click “Install Now” |
| 189 | 4. Activate the plugin on the Plugin dashboard |
| 190 | 5. Go to Settings > Web Accessibility to start configuration |
| 191 | |
| 192 | ### Uploading in WordPress Dashboard |
| 193 | 1. Click the download button on this and save “aria-accessibility-toolkit.zip” to your computer |
| 194 | 2. Navigate to “Add New” in the plugins dashboard |
| 195 | 3. Navigate to the “Upload” area |
| 196 | 4. Select “aria-accessibility-toolkit.zip” from your computer |
| 197 | 5. Click “Install Now” |
| 198 | 6. Activate the plugin in the Plugin dashboard |
| 199 | 7. Go to Settings > Web Accessibility to start configuration |
| 200 | |
| 201 | ### Using FTP |
| 202 | 1. Download the Web Accessibility Toolkit ZIP file |
| 203 | 2. Extract the Web Accessibility Toolkit ZIP file to your computer |
| 204 | 3. Upload the “aria-accessibility-toolkit” directory to the `/wp-content/plugins/` directory |
| 205 | 4. Activate the plugin in the Plugin dashboard |
| 206 | 5. Go to Settings > Web Accessibility to start configuration |
| 207 | |
| 208 | == Screenshots == |
| 209 | |
| 210 | 1. The General Settings section - configure general accessibility options |
| 211 | 2. The ARIA attributes section - configure ARIA attributes options |
| 212 | 3. The Roles section - configure landmark roles options |
| 213 | 4. The Contrast section - configure contrast accessibility options |
| 214 | 5. The frontend accessibility scanner - check your site for accessibility issues |
| 215 | 6. The Images section - update alt tags on your images |
| 216 | |
| 217 | == Changelog == |
| 218 | |
| 219 | = 1.6.4 (2026-04-09) = |
| 220 | * Fix version number that was appearing on admin pages. |
| 221 | |
| 222 | = 1.6.3 (2026-04-09) = |
| 223 | * Fix javascript issue with checking focus indicator. |
| 224 | |
| 225 | = 1.6.2 (2026-04-03) = |
| 226 | * Fix issue with images only displaying 5 even after PRO plugin installed. |
| 227 | |
| 228 | = 1.6.1 (2026-03-18) = |
| 229 | * Add the ability to automatically apply fixes. |
| 230 | |
| 231 | = 1.6 (2026-03-14) = |
| 232 | * Update links. |
| 233 | * UI updates. |
| 234 | * Add logo. |
| 235 | * Add menu into main menu and remove from the settings menu. |
| 236 | |
| 237 | = 1.5.12 (2026-02-03) = |
| 238 | * Update PRO plugin links. |
| 239 | |
| 240 | = 1.5.11 (2026-01-05) = |
| 241 | * Tested with WordPress 6.9. |
| 242 | |
| 243 | = 1.5.10 (2025-12-16) = |
| 244 | * Update sanitizing to allow underscores. |
| 245 | |
| 246 | = 1.5.9 (2025-11-17) = |
| 247 | * Update user-scalable option to also remove maximum-scale which allows full pinch zooming. |
| 248 | |
| 249 | = 1.5.8 (2025-10-10) = |
| 250 | * Add review popup notice. |
| 251 | |
| 252 | = 1.5.7 (2025-10-07) = |
| 253 | * Add new options available in PRO - Open External Links in New Tab, Force Underline on Text Links, Mark Decorative Images |
| 254 | |
| 255 | = 1.5.6 (2025-09-27) = |
| 256 | * Add new ARIA Label field in menus, rather than relying on title. Still uses title as fallback if menu is selected. |
| 257 | * Fix issue with notices being squashed |
| 258 | |
| 259 | = 1.5.5 (2025-08-26) = |
| 260 | * Fix fatal error when no menu selected in ARIA tab |
| 261 | |
| 262 | = 1.5.4 (2025-08-08) = |
| 263 | * Updates to the image alt tags tab |
| 264 | |
| 265 | = 1.5.3 (2025-08-06) = |
| 266 | * Update frontend accessibility checker with errors and warnings |
| 267 | * Add new error definitions to accessibility scanner |
| 268 | * Add filter for showing frontend checker |
| 269 | |
| 270 | = 1.5.2 (2025-08-05) = |
| 271 | * Update frontend accessibility checker with Level, links to the WCAG page and cleaner style |
| 272 | |
| 273 | = 1.5.1 (2025-08-04) = |
| 274 | * Add links to leave a review |
| 275 | |
| 276 | = 1.5.0 (2025-07-31) = |
| 277 | * Major styling update |
| 278 | |
| 279 | = 1.4.2 (2025-07-29) = |
| 280 | * Add new bulk buttons to Image Alt option |
| 281 | * Add Forms tab |
| 282 | * Refactor WCAG frontend checker |
| 283 | * Styling updates to frontend accessibility checker |
| 284 | |
| 285 | = 1.4.1 (2025-07-11) = |
| 286 | * Fix issue with nav_menu_link_attributes filter only passing 3 args |
| 287 | * Minor CSS fixes |
| 288 | * Minor bug fixes to frontend accessibility checker |
| 289 | |
| 290 | = 1.4.0 (2025-07-10) = |
| 291 | * Add "Image Alt Tags" option |
| 292 | |
| 293 | = 1.3.1 (2025-07-09) = |
| 294 | * Add "Fix Tab Order" option |
| 295 | * Add "Make Viewport Scalable" option |
| 296 | * Refactor frontend accessibility checker options & update help text |
| 297 | * Add FIX buttons to frontend accessibility checker |
| 298 | |
| 299 | = 1.3.0 (2025-07-07) = |
| 300 | * Add frontend accessibility checker |
| 301 | * Add "skip link" option |
| 302 | * Add "HTML language override" option |
| 303 | * Add "focus outline" option |
| 304 | |
| 305 | = 1.2.1 (2025-07-05) = |
| 306 | * Minor bug fixes |
| 307 | |
| 308 | = 1.2.0 (2025-07-04) = |
| 309 | * Add new General Options |
| 310 | * General bug fixes and prefixing options |
| 311 | * Correctly enqueue admin JS |
| 312 | |
| 313 | = 1.1.0 (2025-07-01) = |
| 314 | * Naming updates |
| 315 | |
| 316 | = 1.0.1 (2025-06-11) = |
| 317 | * Add all ARIA options to ARIA tab |
| 318 | |
| 319 | = 1.0.0 (2025-06-11) = |
| 320 | * Initial Release |
| 321 |