=== Universal Accessibility Audit ===
Contributors: pbpyrojust
Donate link: https://wordpress.justwhat.net/accessibility-audit/
Tags: accessibility, wcag, ada, a11y, audit
Requires at least: 6.4
Tested up to: 6.8
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Check your site against WCAG 2.2 from wp-admin. Scans run in your browser with axe-core; every issue is listed with the page, the element and how to fix it.

== Description ==

Universal Accessibility Audit tests your pages against the Web Content Accessibility Guidelines (WCAG 2.2, 2.1 or 2.0, levels A and AA) and keeps the results in wp-admin.

**How it works.** Pick the pages to check under Accessibility → Scan. Each page opens out of sight in your browser tab and is tested with [axe-core](https://github.com/dequelabs/axe-core), the open-source engine most accessibility auditors use. Nothing is sent to any outside service, and no server-side browser is needed, so it works on any host.

**What you get**

* An accessibility score and the issues by rule and severity (critical, serious, moderate, minor), with the WCAG success criteria each one fails.
* Every failing element: page, CSS selector, HTML and what exactly failed, with a guide on how to fix it.
* The pages with the most problems, so you know where to start.
* An image alt-text review: missing alt text, file-name alt text, "image of...", overly long or generic text. Fix media-library images right on that screen.
* "Check accessibility" under every published post and page in the admin lists.
* CSV export of the latest scan's issues.
* Up to 25 pages per scan, as many scans as you like. The latest 3 scans keep full detail.

**Automated testing finds a large share of accessibility problems, not all of them.** Keyboard use, screen-reader wording, captions and how content reads still need a person. Treat a clean scan as a strong start, not a certificate.

= Pro =

[Universal Accessibility Audit Pro](https://wordpress.justwhat.net/accessibility-audit/) is a separate add-on for sites that need accessibility checked continuously: scheduled scans of every page, headless and external front ends, full history and trends, fix tickets, email alerts, an executive report and an accessibility statement generator. Nothing in this plugin is locked or time-limited.

= The command-line scanner =

The same checks run from the command line, in CI or on any site, with the free and open-source [`@pbpyrojust/universal-accessibility-audit`](https://www.npmjs.com/package/@pbpyrojust/universal-accessibility-audit) package.

== Installation ==

1. Install and activate the plugin.
2. Go to Accessibility → Scan, choose pages and select Start scan. Keep the tab open until it finishes (a few seconds per page).
3. Review the results under Accessibility → Dashboard, Issues and Images.

Settings (Accessibility → Settings): the WCAG version and level, whether to include axe-core best practices, and which content types appear in the scan list.

== Frequently Asked Questions ==

= Does this make my site compliant? =

No tool can by itself. The plugin finds the problems automated testing can detect and tells you how to fix them; a full audit also includes manual checks. Many of the issues it finds (contrast, missing labels and alt text, heading structure, link names) are the ones most often cited in complaints.

= Does it slow down my site? =

No. Nothing runs for visitors. Scans run only when an administrator starts one, in their own browser.

= Some pages couldn't be scanned. Why? =

A page that refuses to be shown in a frame (a strict Content-Security-Policy or X-Frame-Options header from a security plugin or your host), or that takes longer than 45 seconds to load, is reported as not scanned. Allow your own site to frame itself (`frame-ancestors 'self'` / `SAMEORIGIN`).

= Is any data sent anywhere? =

No. The scan runs in your browser against your own pages, and the results are saved in your WordPress database.

= Can it fix issues automatically? =

It fixes image alt text for media-library images from the Images screen. Other issues are in your theme, plugins or content; the plugin shows exactly where and links to a guide for each. Overlay widgets that claim to "fix" accessibility automatically don't, and can make it worse.

== Screenshots ==

1. Dashboard: score, issues by rule and the pages with the most problems.
2. Scan: choose pages and watch the scan run.
3. Issues: every failing element with its page, selector and how to fix it.
4. Images: review and fix alt text.

== Changelog ==

= 1.0.0 =
* First release: in-browser WCAG 2.2/2.1/2.0 A + AA scans with axe-core, dashboard and score, issues, image alt-text review with in-place fixes, "Check accessibility" row actions, CSV export.

== Third-party libraries ==

This plugin bundles axe-core (assets/axe.min.js), copyright Deque Systems, Inc., under the Mozilla Public License 2.0 (https://www.mozilla.org/en-US/MPL/2.0/), which is compatible with the GPL. Source: https://github.com/dequelabs/axe-core
