=== reala11y — Accessibility Checker & WCAG Scanner ===
Contributors: wkh0000
Tags: accessibility, accessibility checker, wcag, alt text, ada
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accessibility checker for WordPress: scan for WCAG 2.2 issues, auto-fix them in the code, and add AI alt text. A real fix, not an overlay widget.

== Description ==

reala11y is a WordPress accessibility checker and scanner that helps your site move toward WCAG 2.2 AA conformance by scanning for common issues and applying safe, code-level fixes — skip links, focus outlines, language attributes, form labels, target-size, link purpose, and more. Unlike accessibility overlay widgets, reala11y modifies the underlying HTML so screen readers and keyboard users encounter the corrected page.

= What reala11y does =

* Scans posts and pages against a WCAG 2.2 rule library.
* Applies safe, automated fixes at render time (per-rule on/off, one-click rollback).
* Generates a customizable accessibility statement.
* Suggests image alt text with your own AI key (OpenAI, Anthropic, or Google Gemini) — you review every suggestion before it is applied.

= What reala11y does NOT do =

* It does not guarantee WCAG, ADA, EAA, or Section 508 compliance. Automated tools detect approximately 30–40% of WCAG failures by criteria. Full conformance requires human review.
* It is not an overlay widget. The Federal Trade Commission's April 21, 2025 order against accessiBe affirmed that overlay claims of automatic WCAG conformance are not supportable.

= External services =

reala11y is self-contained and contacts third-party services only as described below, and only when the relevant feature is used.

* WordPress.org — used for plugin update checks, as for any plugin hosted here. No personal data is sent beyond the standard update request.

* AI providers — OpenAI, Anthropic, and Google Gemini (optional, bring-your-own-key). The AI authoring features (for example, alt-text suggestions) stay off until you enter your own API key for a provider and run a feature. When you run a feature, reala11y uses your key to send that provider the input you selected — for example, the URL of an image or a block of your post's text — together with a short instruction prompt. The response is shown to you for review and is never applied automatically. reala11y does not proxy or resell AI usage; the provider bills you directly. Remove a provider's key to disable it.
    * OpenAI — Terms: https://openai.com/policies/terms-of-use/ — Privacy: https://openai.com/policies/privacy-policy/
    * Anthropic — Terms: https://www.anthropic.com/legal/commercial-terms — Privacy: https://www.anthropic.com/legal/privacy
    * Google Gemini — Terms: https://ai.google.dev/gemini-api/terms — Privacy: https://policies.google.com/privacy

This free build does not bundle Freemius or any licensing or analytics service. See our privacy policy at https://reala11y.com/legal/privacy.

= Source code =

reala11y is open source (GPLv2 or later). The admin interface is written in React and TypeScript and bundled with Vite. The human-readable source for the compiled files in build/admin/ ships with the plugin under admin/src/. To rebuild it, run "npm install" and then "npm run build" in the plugin's admin/ directory.

= Why reala11y =

* Code-level remediation, not an overlay widget.
* WCAG 2.2 (including 2.5.8 Target Size and the focus criteria).
* Bring-your-own AI key — no surprise quotas, no resold tokens.
* Honest claims. We never tell you you're "fully compliant."

= Links =

* Website and documentation: https://reala11y.com
* How reala11y compares to overlay widgets: https://reala11y.com/vs/accessibe and https://reala11y.com/vs/userway
* Our own accessibility statement: https://reala11y.com/accessibility-statement

== Installation ==

1. Upload the plugin to /wp-content/plugins/reala11y/ or install via the Plugins screen.
2. Activate "reala11y" from the Plugins screen.
3. Go to "reala11y" in the WordPress admin to configure.

== Frequently Asked Questions ==

= Does this make my site WCAG compliant? =

No tool can. reala11y identifies common WCAG issues and remediates a defined subset at the code level. Full conformance requires manual review and user testing.

= Do I need an API key for AI features? =

Yes — bring your own OpenAI, Anthropic, or Google Gemini key. The AI authoring features then work in this free version at no extra charge from us; your provider bills you directly for what you use. reala11y never resells or proxies AI usage.

= How does this compare to accessibility overlay widgets? =

Overlay widgets (e.g., accessiBe, UserWay) inject a floating JavaScript layer that does not modify the underlying HTML. Screen readers continue to see the original, unfixed page. The FTC fined accessiBe $1,000,000 on April 21, 2025 for claiming automated WCAG compliance. reala11y instead applies fixes to the actual HTML that browsers, screen readers, and crawlers see.

= What WCAG version do you cover? =

WCAG 2.2 AA. WCAG 2.2 became a W3C Recommendation on October 5, 2023.

= Is reala11y an alternative to accessiBe or UserWay? =

If you are looking for an accessiBe or UserWay alternative that fixes the underlying HTML instead of layering a JavaScript widget on top, reala11y is built for that. Overlay widgets leave the original page unchanged for screen readers; reala11y edits the actual code. As context, the FTC fined accessiBe $1,000,000 on April 21, 2025 over automated WCAG compliance claims.

= Can it generate alt text for my images? =

Yes. The scanner flags images missing alt text (WCAG 1.1.1), and the bring-your-own-key AI tools can draft an alt-text suggestion using your own OpenAI, Anthropic, or Google Gemini key. Every suggestion is shown for your review and is never applied automatically.

== Screenshots ==

1. The reala11y dashboard — a plain-language overview of accessibility problems, items needing review, and passed checks (no single "compliance score").
2. The Scans screen — run an accessibility scan on any post, page, or same-site URL, and review your scan history.
3. The Issues list — each WCAG finding grouped by severity, with its success criterion and a code snippet, plus one-click dismiss.
4. The Fixes screen — apply safe, code-level fixes to your content; every change is logged and reversible with one-click undo.
5. AI authoring tools — bring your own OpenAI, Anthropic, or Google Gemini key (stored encrypted) to generate alt-text suggestions you review before applying. Free for everyone.
6. The Tools screen — a built-in colour-contrast tester checks any foreground/background pair against WCAG AA and AAA for normal and large text.
7. The accessibility statement and reports — generate a customizable statement template, VPAT starter, and compliance report to document your remediation work.

== Changelog ==

= 1.0.1 =
* Listing refresh: real admin screenshots, clearer and more discoverable readme copy, and visible project links. No functional code changes.

= 1.0.0 =
* First public release.
* Scanner: 16 WCAG 2.2 rules across posts, pages, and rendered theme output.
* Auto-fix engine: safe, reversible, code-level fixes with per-fix toggles, one-click undo, and a Safe Mode kill-switch.
* Inspect on page: an author-only annotated overlay on the live site (logged-in editors only; visitors never see it).
* Dismiss issues with a structured reason and reopen them later.
* Colour Contrast Tester in the new Tools screen.
* BYOK AI authoring suite: bring your own OpenAI, Anthropic, or Google Gemini key — you pay your provider directly, never us.
* Accessibility statement generator, VPAT starter, and compliance report.
* Encrypted API-key storage and a clean uninstall.

= 0.6.0 =
* Scanner: 12 WCAG 2.2 rules across posts, pages, and rendered theme output.
* Auto-fix engine: safe, reversible, code-level fixes with per-fix toggles and one-click undo.
* "Scan this post" button in the block-editor sidebar; scan any post or same-site URL from the Scans screen.
* BYOK AI authoring suite: bring your own OpenAI, Anthropic, or Google Gemini key — you pay your provider directly, never us.
* Accessibility statement generator, VPAT starter, and compliance report.
* Encrypted API-key storage and a clean uninstall.

= 0.0.1 =
* Initial scaffold.

== Upgrade Notice ==

= 1.0.1 =
Documentation and listing update: real admin screenshots, clearer copy, and project links. No code changes.

= 1.0.0 =
First public release: 16-rule scanner, reversible auto-fix engine with Safe Mode, author-only Inspect-on-page overlay, BYOK AI suite, and compliance documents.

= 0.6.0 =
First public release candidate: scanner, auto-fix engine, BYOK AI suite, and compliance documents.

= 0.0.1 =
First development release.
