=== AccessLens - Web Accessibility Audit ===
Contributors: manitosdevs
Tags: accessibility, wcag, eaa, audit, ada
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 0.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free WordPress client for the AccessLens service. Scan for WCAG 2.2 barriers and download an Accessibility Statement report.

== Description ==

AccessLens is a free, fully functional WordPress client for the AccessLens accessibility service. You enter
the URLs you want to audit, the external service renders each page in a real browser and runs an accessibility
analysis (axe-core), and the plugin shows the results in your admin dashboard. It is aimed at site owners and
agencies who need to work towards the requirements of the European Accessibility Act (EAA).

The plugin itself is not feature-limited: it sends your requests to the external service and displays whatever
the service returns. Advanced, server-side analysis tiers (full-site crawl and an AI-assisted PDF report) are
provided by a paid subscription to the AccessLens service, not by locked code inside this plugin.

**What this plugin does:**

* Runs accessibility scans on any public URL (single page, sitemap or full crawl mode).
* Shows WCAG 2.2 violations per page, classified by severity (critical, serious, moderate, minor).
* Includes a short, informational questionnaire about whether your organisation falls under the EAA.
* Requests an Accessibility Statement report from the service and lets you download it as PDF.

**What this plugin does NOT do:**

* It does not guarantee or certify conformance with the EAA, WCAG or any other regulation.
* It does not detect 100% of issues: automated scanning covers roughly 25-40% of the criteria. Manual review
  by an expert remains essential.
* It does not provide legal advice.

The scope questionnaire is purely informational. Always consult a qualified accessibility or legal advisor
for your specific situation.

**Requirements:**

* Access to an EAA Engine instance over HTTP (a default public engine is provided; you can point to your own).
* PHP 8.0 or higher.
* WordPress 6.0 or higher.

== Installation ==

1. Upload the `accesslens` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin from the "Plugins" menu in WordPress.
3. Go to **AccessLens > Settings** and configure your audit engine URL (a default is provided).
4. Open **AccessLens > Dashboard** to run your first audit.

== Frequently Asked Questions ==

= Does the scan certify that my website complies with the EAA? =

No. Automated scanning detects a subset of technical violations (about 25-40%). A conformance declaration
requires a full manual audit carried out by people with disabilities or certified experts.

= What is the EAA Directive? =

The European Accessibility Act (EAA, Directive 2019/882) requires certain digital products and services to be
accessible. Member States have been applying it since 28 June 2025.

= Does it work with any website? =

The plugin can audit any public URL reachable from the server where the engine is hosted.

= What is the difference between Free and Pro? =

These are tiers of the external AccessLens service, not locked code in the plugin. The free service tier
covers single-page and sitemap scans (up to 10 pages) and a basic report. The Pro service subscription adds
full-site crawl (up to 25 pages) and an AI-assisted PDF report with alternative-text and improvement
suggestions. The plugin works fully on the free tier and shows whatever the service returns.

== External services ==

This plugin relies on an external service (the "AccessLens engine") to perform the accessibility analysis,
because scanning requires rendering the page in a headless browser, which cannot run inside WordPress.

**Service: AccessLens engine**

* What it is: an audit engine that renders the given URL and runs an accessibility analysis (axe-core) to
  detect WCAG violations.
* When it is used: only when an administrator starts a scan or generates a report from the dashboard.
* Data sent: the URL(s) you choose to audit and, when generating a report, the site metadata you enter in the
  form (site name, contact email/URL, entity type).
* Default endpoint: https://eaa-audit-engine-26367529082.europe-southwest1.run.app (configurable in Settings;
  you may point to your own engine instance).
* Terms of service: https://accesslens-27h.pages.dev/terminos
* Privacy policy: https://accesslens-27h.pages.dev/privacidad

**AI processing (Pro service tier)**

On the Pro service tier, the engine may send fragments of the page HTML and image URLs to the AI provider
Anthropic (https://www.anthropic.com/legal/privacy) to generate alternative text and improvement suggestions.
This only happens with an active Pro subscription and when you request a report.

== Screenshots ==

1. Dashboard: informational EAA scope questionnaire and the audit form (URL and scan mode).
2. Results: per-page WCAG 2.2 violations classified by severity (critical, serious, moderate, minor) and the Accessibility Statement report download.

== Changelog ==

= 0.1.0 =
* First public release.
* Single, sitemap and full crawl scan modes.
* Informational EAA scope questionnaire.
* AJAX polling every 3 seconds with a results table.
* Accessibility Statement report (PDF) via the AccessLens service.
