=== ADA Compliance Guardian === Contributors: adacomplianceguardiandotcom Tags: accessibility, ada, wcag, section 508, compliance Requires at least: 6.0 Tested up to: 6.8 Stable tag: 1.0.2 Requires PHP: 7.4 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html An AI-driven accessibility framework to help meet and exceed digital compliance standards. == Description == **ADA Compliance Guardian** provides a robust, AI-driven framework to streamline the complex process of achieving and maintaining web accessibility standards, including WCAG 2.1, ADA Title III, and Section 508. Our solution is engineered to mitigate legal risk, enhance user experience for all individuals, and integrate seamlessly into your existing WordPress workflow. This plugin leverages state-of-the-art AI models from Google and OpenAI to automate critical compliance tasks that are traditionally manual, time-consuming, and error-prone. ### Core Technology & Features: * **AI-Powered Image Alt Text Generation (Google Gemini)** Leverages Google's advanced Gemini multimodal AI model to analyze image content and context, generating highly descriptive and accurate alternative text. The system supports multiple generation modes: * **Individual Generation:** Create alt text for single images directly from the media library interface. * **Bulk Generation:** Automatically identify all images missing alt text and generate descriptions for them in a single, managed operation. * **SEO & ADA Enhanced Regeneration:** A specialized mode to regenerate alt text for all library images, focusing on a dual-mandate of comprehensive ADA compliance and semantic SEO enrichment. * **Automated Video Captioning & Subtitles (OpenAI Whisper)** Integrates seamlessly with OpenAI's Whisper API, a leading automatic speech recognition (ASR) system, to generate precise, time-coded captions for your video assets. * **WebVTT Generation:** Automatically produces W3C standard WebVTT (.vtt) caption files from your video's audio track. * **Automatic Display:** The plugin intelligently modifies your website's front-end video players (both shortcode and block-based) to include the necessary `` tags, ensuring captions are available to your users without manual theme editing. * **Enhanced Focus Management & Keyboard Navigation** Provides a consistent and highly-visible focus indicator for all interactive elements, a critical component for users who rely on keyboard navigation. This feature can be toggled in the plugin settings. * **AI Tabindex Manager (Experimental):** An optional, experimental feature that uses an AI model to analyze the DOM and identify non-interactive elements that have been scripted to be interactive but lack focusability. When enabled, it programmatically applies `tabindex="0"` to these elements. == External Services == This plugin utilizes third-party services to provide its AI-powered features. Your use of these features is subject to the terms and policies of these services. * **Google Gemini** * **Purpose:** Used for generating descriptive alt text for images. * **Data Sent:** Image data (the image file itself) is transmitted to the Google Cloud Vision or Gemini API for analysis. No other user or site data is included in this request. * **Terms of Service:** [https://policies.google.com/terms](https://policies.google.com/terms) * **Privacy Policy:** [https://policies.google.com/privacy](https://policies.google.com/privacy) * **OpenAI Whisper** * **Purpose:** Used for generating transcriptions and captions for video files. * **Data Sent:** The video file is transmitted to the OpenAI Whisper API for transcription. No other user or site data is included in this request. * **Terms of Use:** [https://openai.com/policies/terms-of-use](https://openai.com/policies/terms-of-use) * **Privacy Policy:** [https://openai.com/policies/privacy-policy](https://openai.com/policies/privacy-policy) * **ADA Compliance Guardian Validation Service** * **Purpose:** To validate your subscription plan and track API usage against your plan's limits. * **Data Sent:** Your Plan API Key, your WordPress admin email, and the specific service being requested (e.g., 'image_alt') are sent to our secure validation server at `adacomplianceguardian.com`. * **Terms of Service:** [https://adacomplianceguardian.com/terms-of-service](https://adacomplianceguardian.com/terms-of-service) * **Privacy Policy:** [https://adacomplianceguardian.com/privacy-policy](https://adacomplianceguardian.com/privacy-policy) == Third-Party Code == This plugin uses the following third-party library: * **Captionator.js** * **Purpose:** Provides a cross-browser compatibility layer for caption rendering. * **Source:** [https://github.com/captionator/captionator](https://github.com/captionator/captionator) * **License:** Licensed under the MIT license. == Installation == ### Automatic Installation 1. Navigate to 'Plugins' > 'Add New' within your WordPress dashboard. 2. Search for "ADA Compliance Guardian". 3. Click "Install Now" and then "Activate". ### Manual Installation 1. Download the plugin ZIP file from WordPress.org. 2. Navigate to 'Plugins' > 'Add New' and click the 'Upload Plugin' button. 3. Select the downloaded ZIP file and click "Install Now", then "Activate". ### Post-Installation Configuration Upon activation, navigate to the **'ADA Compliance Guardian' > 'Initial Setup'** menu in your dashboard. Enter your **Plan API Key**, **Image Alt Text Generator API Key**, and **Video Captions Generator API Key** in the designated fields to enable all plugin features. == Frequently Asked Questions == = What are the prerequisites for using this plugin's AI features? = The core AI functionalities require a subscription plan obtained from the official ADA Compliance Guardian website. This plan provides the necessary API keys for Google Gemini, OpenAI Whisper, and service validation. The Enhanced Focus Styling and HTML Lang Enforcement features do not require an API key. = How does this plugin handle data privacy with external AI services? = Data privacy is paramount. The plugin transmits the minimum data required for functionality as described in the "External Services" section of this readme. = Is ADA Compliance Guardian a complete solution for WCAG/ADA compliance? = ADA Compliance Guardian is a powerful tool designed to address some of the most challenging technical aspects of web accessibility. However, it is not a "one-click" solution for full compliance. Achieving full compliance requires a comprehensive strategy that includes manual audits, usability testing, and content-level considerations. = How does the AI Tabindex Manager work and should I enable it? = This is an **experimental feature** that analyzes your website's Document Object Model (DOM) to find elements that behave like buttons or links but are not natively focusable. It then applies `tabindex="0"` to make them accessible to keyboard users. We recommend testing it thoroughly in a staging environment before deploying on a live site. This feature is disabled by default. == Screenshots == 1. The primary interface for the Image Alt Text Generator. 2. The Video Caption Generator dashboard. 3. The Initial Setup page for configuring API keys. 4. A detailed view of a generated alt text suggestion. 5. The progress bar for bulk generation tasks. == Changelog == = 1.0.2 = * Security and bug fixes from initial review. * Updated documentation for third-party services. * Replaced cURL with WordPress HTTP API. * Improved sanitization and escaping of data. * Refactored function and option names to prevent conflicts. = 1.0.1 = * Security and bug fixes from initial review. * Updated documentation for third-party services. * Replaced cURL with WordPress HTTP API. * Improved sanitization and escaping of data. * Refactored function and option names to prevent conflicts. = 1.0.0 = * Initial public release. == Legal Disclaimers == ### Third-Party Services This plugin's functionality is dependent on third-party services provided by Google LLC and OpenAI, L.L.C. Your use of the AI-powered features is subject to the terms of service and privacy policies of these respective companies. ### No Guarantee of Compliance ADA Compliance Guardian is a tool intended to assist you in your efforts to make your website more accessible. Use of this plugin does not constitute a legal guarantee of compliance with any accessibility laws. Responsibility for legal compliance remains solely with the website owner. ### Trademark Notice WordPress and the WordPress logo are registered trademarks of the WordPress Foundation. Google, Gemini, OpenAI, and Whisper are trademarks of their respective owners. Use of these names does not imply endorsement or affiliation.