=== Curbcut Accessibility Checker ===
Contributors: curbcut
Tags: accessibility, wcag, ada, audit, a11y
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Scan your site for accessibility problems against WCAG 2.1, see every failure with the page and element, and get the fix written for you.

== Description ==

Most accessibility plugins do one of two things: they overlay a widget on your site that
claims to fix it, or they hand you a list of rule numbers and leave. The first kind is why
businesses get sued. The second leaves you with homework and no instructions.

Curbcut finds the problems and tells you, in plain language, what each one is and where it
is.

Run a scan from **Tools → Accessibility**. It fetches your published pages the way a
visitor would — so what gets checked is what people actually receive, theme and plugins
included — and reports the failures that show up most often in accessibility complaints.

= What it checks =

* Images with no alt text, or alt text that is the file name, or the word "image"
* Alt text so long it should have been page content
* Links with nothing a screen reader can announce
* Link text like "click here" that describes no destination
* Form fields labelled only by a placeholder, which vanishes as soon as someone types
* Form fields with no label at all
* Pages that declare no language
* Frames with no title
* Missing h1, and heading levels that skip

Each finding names the rule, the WCAG success criterion it breaks, the page, and a snippet
of the markup, so you can go straight to it.

= Applying a fix pack =

If you bought a Curbcut fix pack, the alt text it wrote for you can be applied here instead
of copied by hand. Upload the pack's `fixes.json` and the plugin lays every suggestion next
to the alt text you have now, image by image, and writes only the ones you tick.

It writes into the media library, not into your theme or your posts. That means one image
carries its alt text everywhere it is used, it survives a theme change, and a scanner
reading your page afterwards sees a real fix rather than a script pretending to one.

Nothing is applied without a person ticking that row — there is deliberately no "apply
everything" button. Alt text is a judgement about what an image means in the place it is
used, and you are the one who can make it. Every batch records what was there before, so
**Undo that** puts it back, and it will not overwrite alt text you have edited since.

The file is read on your own server. The plugin still makes no outbound request.

= Where it shows up =

* An **Accessibility** column in the Posts and Pages lists: what the last scan found on each one, or that it was not reached.
* A dashboard tile with the last scan in one line and the one useful next step.
* When you review a fix pack, every image is shown as a picture with the alt text it has now beside what Curbcut suggests, and you can change any suggestion in place before you tick it.

= Your data stays yours =

Everything runs on your own server. No page content, no URLs, no email address and no
analytics are sent anywhere. The plugin makes no outbound request except to fetch your own
pages. There is no account, no API key and no tracking, and it adds nothing to the front
end of your site — no badge, no widget, no "powered by" link.

= What it cannot do, and nor can anything else =

It reads your pages as HTML. It cannot see colour contrast, keyboard focus order, whether
the site reflows on a phone, or what a screen reader actually says out loud. Those need a
real browser.

**No automated tool can tell you a site is accessible.** Roughly a third of WCAG can be
tested automatically at all; the rest needs a person. Any product that offers you a
certificate from a scan is selling something that does not exist, and courts have not been
impressed by it.

A free scan that renders every page in a real browser, and the fixes written out for you,
are at [curbcuthq.com](https://curbcuthq.com). You do not need it to use this plugin, and
this plugin does not ask you for anything.

== Installation ==

1. Install and activate the plugin.
2. Go to **Tools → Accessibility**.
3. Press **Scan my site**.

No configuration and no account.

== Frequently Asked Questions ==

= Does this make my site compliant? =

No, and be wary of anything that says it does. It finds a specific set of failures and
tells you where they are. Fixing them makes your site better for real people; it is not a
legal opinion and nobody can give you one from a scan.

= Does it change my site? =

The scan only reads. The one thing that writes is applying a fix pack, and it writes only
the rows you tick, only into the alt text field of the media library, and every batch can
be undone. Nothing is ever added to your pages and nothing is shown to visitors — no badge,
no widget, no script.

= Is this an accessibility overlay? =

No, and it is the opposite of one. An overlay loads JavaScript that patches the page in the
visitor's browser: your source never changes, the fix vanishes if the script fails, and the
page still fails a manual audit. Overlays are the subject of most of the accessibility
lawsuits filed against remediation vendors. This edits your content so the fix is in the
page itself, and then it gets out of the way.

= Does it send my content anywhere? =

No. The scan runs on your server against your own pages.

= How many pages does it check? =

The front page and your ten most recently updated published pages and posts, which is
enough to be representative without hammering your own site. Problems in a theme show up
on every page anyway.

= Will it slow my site down? =

No. It only runs when you press the button in the admin, and it makes no change to the
front end.

== Screenshots ==

1. The results screen: failures grouped by rule, with the page and markup for each.
2. Running a scan from Tools → Accessibility.
3. Reviewing a fix pack: the alt text you have now beside what Curbcut suggests, one tick per image.

== Changelog ==

= 1.2.0 =
* An Accessibility column in the Posts and Pages lists, and a dashboard tile.
* Reviewing a pack shows each image as a picture, with an editable suggestion. What is written is what you see in the box, for the images you tick.

= 1.1.0 =
* Apply a Curbcut fix pack: review the suggested alt text image by image and write the ones you approve into the media library.
* Undo any applied batch. Alt text you edited afterwards is never overwritten.
* No new outbound requests; the pack file is read on your own server.

= 1.0.0 =
* First release.
