=== Accessibility Checker & WCAG Scanner — Cirv Guard ===
Contributors: cirvgreen
Tags: accessibility, wcag, accessibility checker, ada, compliance, section 508, a11y, color contrast, alt text, screen reader, keyboard navigation, eaa
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automated WCAG 2.1 accessibility checker for WordPress. Scan for ADA, EAA & Section 508 violations — alt text, color contrast, heading order, form labels, link text.

== Description ==

**Stop ADA lawsuits before they start. Cirv Guard scans your WordPress site for WCAG 2.1 accessibility violations and tells you exactly what to fix.**

Accessibility isn't optional — the EU Accessibility Act is now in force, ADA lawsuits are up 300%, and 96.3% of websites have detectable WCAG failures. Cirv Guard finds yours.

= Why Accessibility Matters =

* **Legal protection** - ADA/EAA compliance reduces lawsuit risk
* **Larger audience** - 1.3 billion people worldwide live with disabilities
* **Better SEO** - Accessible sites rank higher (Google rewards usability)
* **Higher conversions** - Usable sites convert better for everyone
* **Brand reputation** - Demonstrate your commitment to inclusion

= Features =

**Alt Text Checker (WCAG 1.1.1)**
Scans every image on your page for missing or empty alt attributes. Respects decorative images marked with role="presentation".

**Heading Hierarchy Checker (WCAG 1.3.1)**
Detects skipped heading levels (h1 to h3), missing H1 tags, and multiple H1s on a single page.

**Color Contrast Checker (WCAG 1.4.3)**
Analyzes text/background color pairs against the WCAG 2.1 minimum contrast ratio of 4.5:1. Uses the W3C relative luminance formula.

**Form Label Checker (WCAG 1.3.1)**
Verifies that every form input has an associated label — via `for` attribute, wrapping `<label>`, `aria-label`, or `aria-labelledby`.

**Link Text Checker (WCAG 2.4.4)**
Flags generic link text like "click here" and "read more". Detects empty links and links with no accessible name.

= How It Works =

1. **Install & Activate** - One-click from the WordPress plugin directory
2. **Go to Cirv Guard** - New top-level menu item with shield icon
3. **Run a Scan** - Scan any page or post on your site
4. **Review Results** - Color-coded pass/fail results with accessibility score
5. **Fix & Rescan** - Make changes and verify compliance

No coding required. No external APIs. Everything runs on your server.

= Perfect For =

* **Agencies** - Audit client sites and deliver compliance reports
* **E-commerce** - Meet EAA requirements for online stores
* **Government & Education** - Section 508 and WCAG compliance
* **Content publishers** - Ensure blog posts meet accessibility standards
* **Anyone** who wants to avoid a $75,000+ ADA demand letter

= Technical Highlights =

* Lightweight single-file architecture (no bloat)
* Server-side scanning via PHP DOMDocument (no external APIs)
* Transient caching for fast repeat scans
* Multisite compatible with cache isolation
* GDPR compliant (no data collection)
* Translation ready
* Works alongside any theme or page builder

== Installation ==

= Automatic Installation =

1. Log in to your WordPress dashboard
2. Navigate to **Plugins > Add New**
3. Search for "Cirv Guard"
4. Click **Install Now**
5. Click **Activate**
6. Go to **Cirv Guard** in your admin menu

= Manual Installation =

1. Download the plugin ZIP file
2. Navigate to **Plugins > Add New > Upload Plugin**
3. Choose the ZIP file and click **Install Now**
4. Click **Activate**
5. Go to **Cirv Guard** in your admin menu

= After Activation =

1. Navigate to **Cirv Guard** in your admin sidebar
2. Enable the checks you want (all 5 are on by default)
3. Go to the **Run Scan** tab
4. Enter a page URL and click Scan Page
5. Review results and start fixing issues

== Frequently Asked Questions ==

= What is WCAG? =

WCAG (Web Content Accessibility Guidelines) is the international standard for web accessibility, published by the W3C. WCAG 2.1 Level AA is the most commonly referenced compliance level for legal requirements like the ADA and EU Accessibility Act.

= Will this make my site fully WCAG compliant? =

Automated tools can detect approximately 30-40% of WCAG violations. Cirv Guard catches the most common and impactful issues. A complete accessibility audit also requires manual testing with screen readers and keyboard navigation.

= Does this slow down my site? =

No. Cirv Guard only runs scans when you trigger them from the admin dashboard. It does not add any code to your frontend or affect page load time for visitors.

= Does this work with page builders? =

Yes. Cirv Guard scans the rendered HTML output of your pages, so it works with Elementor, Divi, Beaver Builder, WPBakery, Gutenberg, and any other builder.

= What is the EU Accessibility Act? =

The European Accessibility Act (EAA) requires websites and apps serving EU customers to meet accessibility standards. Enforcement began in June 2025. Non-compliance can result in fines and legal action.

= Can I use this with other accessibility plugins? =

Yes. Cirv Guard focuses on automated scanning and reporting. It works alongside other tools like WP Accessibility, One Click Accessibility, and UserWay.

= How accurate is the color contrast checker? =

Cirv Guard uses the W3C relative luminance formula specified in WCAG 2.1 Success Criterion 1.4.3. It checks inline CSS color/background-color pairs. For complete contrast testing, also test with browser dev tools.

== Screenshots ==

1. General Settings - Enable/disable individual accessibility checks
2. Scan Results - Color-coded pass/fail report with accessibility score
3. Run Scan - One-click scanning for any page on your site
4. Issue Details - Specific elements flagged with WCAG references
5. Debug Log - Professional debugging tools for developers

== Changelog ==

= 1.0.0 - February 2026 =
* Initial Release
* 5 WCAG 2.1 checks: alt text, heading hierarchy, color contrast, form labels, link text
* Accessibility score dashboard (0-100)
* Transient caching for performance
* Multisite support with cache isolation
* Debug logging system
* 6-tab admin interface

== Upgrade Notice ==

= 1.1.0 =
Initial release of Cirv Guard. Automated WCAG accessibility scanning for WordPress with 5 checks covering the most common accessibility issues.

== Additional Info ==

**Privacy & GDPR Compliance:**
Cirv Guard does not collect, store, or transmit any personal data. All accessibility scanning is performed locally on your server using PHP DOMDocument. No external API calls. No tracking. No cookies.

**Related Plugins:**
* **Cirv Box** - Schema.org structured data for better Google rankings

**Support & Documentation:**
* Built-in help in plugin settings
* Support forum: WordPress.org support forum
* Email: support@cirvgreen.com

== Third-Party Service Usage ==

This plugin does not use any third-party services. All scanning is performed locally on your WordPress server using PHP's built-in DOMDocument library.