=== SiteFix — Lighthouse & Accessibility Fixes On The Fly ===
Contributors: aacers
Tags: accessibility, wcag, ada compliance, lighthouse, alt text, accessibility scanner, a11y, wcag 2.1, screen reader, contrast checker, keyboard navigation, ai accessibility
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 5.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Boost your Lighthouse accessibility score instantly. Filter-based fixes — nothing changes in your database, deactivate to fully revert.

== Description ==

**SiteFix** raises your Lighthouse accessibility score the moment you activate it. No content is rewritten, no database tables are added, no permanent changes are made. Every fix is applied at runtime through WordPress filters — switch the plugin off and your site is exactly as it was before.

= What gets fixed automatically =

* **Image alt text** — empty `alt` attributes get smart, contextual fallbacks
* **Heading order** — `<h3>` after a `<h1>` (with no `<h2>`) is normalised so screen readers can navigate
* **Skip-to-content link** — a visually-hidden link is injected at the top of every page
* **Visible focus indicator** — a high-contrast outline appears on keyboard focus
* **ARIA landmarks** — navigation menus get proper `role` and `aria-label`
* **`lang` attribute** — your site language is added to the `<html>` tag if missing
* **Table captions** — accessible captions and scope are added to data tables
* **Form labels** — inputs without labels get `aria-label` from placeholders or context
* **Link text** — vague links like "click here" get descriptive `aria-label`s

= Why filter-based? =

* **Reversible** — deactivate the plugin and every fix disappears. Nothing to undo.
* **Safe** — your post content, theme, and database are never modified.
* **Fast** — no scheduled tasks, no background scans, no bloat.

= Pro =

[SiteFix Pro](https://pluginjoy.com/product/sitefix/) adds **AI-powered fixes**:

* AI ARIA labels — context-aware labels for complex widgets
* AI Color Contrast — suggested palette tweaks that meet WCAG AA
* AI Heading Restructure — semantic heading suggestions
* AI Form Label generation — natural-language labels from field context
* AI WCAG Explainer — plain-English explanations for every accessibility issue
* Bulk processing across your entire site
* Premium AI included — click and it works, no API keys to manage

== Installation ==

1. Upload the plugin to `/wp-content/plugins/sitefix/` or install via the WordPress Plugins screen.
2. Activate.
3. Visit **SiteFix** in the admin menu to choose which fixes to enable.

== Frequently Asked Questions ==

= Will this change my content? =

No. SiteFix never writes to `post_content`. Fixes are applied to the rendered HTML via filters, so what visitors see is fixed but what's stored in your database is untouched.

= What happens if I deactivate? =

Every fix is removed instantly. Your site renders exactly as it did before activation.

= Does this work with my theme / page builder? =

Yes. SiteFix hooks into core WordPress filters that fire regardless of theme — Elementor, Divi, Gutenberg, classic editor, and most page builders are supported out of the box.

= Will it slow my site down? =

No noticeable impact. Fixes run on the rendered HTML in PHP — no extra database queries, no JavaScript on the front-end.

= How is this different from other accessibility plugins? =

Most accessibility plugins inject a JavaScript "accessibility widget" — a floating button users have to click. SiteFix fixes the underlying HTML so every visitor (and every search engine, and every assistive technology) gets the improvement automatically.

== Screenshots ==

1. Dashboard with current accessibility score and last scan summary
2. Audit page showing per-page findings with WCAG rule references
3. Settings page — toggle each fix on or off
4. Pro upgrade with AI-powered features

== Changelog ==

= 5.0.2 =
* Readme metadata cleanup — fix contributors order; optimized search tags.

= 5.0.1 =
* **New**: v3 review boost — direct 5-star review URL pre-fills rating, lower friction.
* **New**: Subtle review prompt on the post-edit screen — most users live in Gutenberg, not on plugin admin pages.
* **New**: \`sitefix_user_won\` action hook — fires the review prompt immediately after a real success event.
* **Improved**: Activation time backfill so older installs see the prompt instead of waiting another 7 days.

= 5.0.0 =
* Complete clean rewrite — pure filter-based fixes, nothing permanent in the database
* New: deactivate to fully revert (zero footprint)
* New: dashboard with accessibility score and last-scan summary
* New: audit page with per-page WCAG findings
* New: granular toggle for each fix
* Removed: badge widget (was disruptive)
* Removed: scheduled background scans (no cron load)
* Improved: image alt-text generation uses surrounding context
* Improved: heading normalisation respects existing semantic structure

= 4.4.4 =
* Maintenance release

== Upgrade Notice ==

= 5.0.0 =
Major rewrite. All fixes are now filter-based — deactivate the plugin to fully revert. Settings and previous scan data are migrated automatically.
