=== AccessIQ — Accessibility Scanner & Heatmap Analytics === Contributors: readscope Tags: accessibility, wcag, heatmap, analytics, accessibility checker Requires at least: 6.0 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 1.2.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Scan your site for WCAG 2.1 accessibility violations AND see exactly where visitors click — all in one powerful plugin. == Description == **AccessIQ** is the only WordPress plugin that combines a full **WCAG 2.1 accessibility scanner** with a **click heatmap engine** and **behavior analytics** — giving you everything you need to build a faster, more accessible, and higher-converting website. Whether you're a developer, agency, or site owner, AccessIQ helps you find and fix accessibility issues before they become legal problems — and understand your visitors like never before. 🔬 [Live Demo](https://accessiq.thereadscope.com/) --- = Why Choose AccessIQ for Your WordPress Site? = You might be thinking, "Can't I just use a free online checker?" While true, online checkers give you a one-time snapshot with no tracking, no analytics, and no integration with your WordPress dashboard. AccessIQ fills this gap by offering: **All-in-One Solution:** Accessibility scanning + heatmaps + behavior analytics in a single plugin — no need for 3 separate tools. **Professional Dashboard:** A beautiful dark-themed admin dashboard with animated charts, score rings, and filterable reports. **Privacy-First Analytics:** All click and session data is stored in your own database — nothing sent to external servers. **Actionable Insights:** Don't just find problems — understand them. Every violation comes with context, and every heatmap shows real user behavior. **Legal Compliance:** WCAG 2.1 compliance is increasingly required by law (ADA, EAA, Section 508). AccessIQ helps you stay ahead. **Lightweight & Fast:** No bloat, no external dependencies for core features. Tracking script is under 3KB and loads asynchronously. --- = What Makes AccessIQ Stand Out? = AccessIQ doesn't just replicate basic accessibility checking. Here's what sets it apart: **Real Heatmaps Inside WP Admin:** See exactly where users click, overlaid on your live site — without leaving your WordPress dashboard. No external service needed. **Animated Compliance Score:** A beautiful 0–100 score ring shows your accessibility health at a glance, with grade labels (Excellent / Good / Fair / Poor). **Violations by Category Chart:** Instantly see which types of issues dominate — Images, Contrast, Headings, ARIA, or Forms. **Device Breakdown Donut Chart:** Understand your audience — Desktop vs Mobile vs Tablet — with an animated Chart.js visualization. **Tab Navigation Dashboard:** Overview, Violations, Auto-Fix, and Reports — all in one organized interface. **Frontend Accessibility Widget:** A floating toolbar lets visitors adjust font size, enable high contrast, switch to dyslexia-friendly fonts, and more. --- = Who is AccessIQ Most Useful For? = AccessIQ is incredibly versatile and beneficial for a wide range of WordPress users: **Developers & Agencies:** Run WCAG audits for clients, generate compliance reports, and identify issues before launch. **Business Owners:** Protect your business from accessibility lawsuits (ADA, EAA) by maintaining WCAG 2.1 compliance. **Bloggers & Content Creators:** Understand where readers click and which content drives engagement — without sending data to Google. **E-commerce Sites:** Discover where customers drop off and which elements get the most interaction on product pages. **Educational Institutions:** Ensure your learning management content is accessible to all students including those with disabilities. **Government & Nonprofits:** Meet legal accessibility requirements (Section 508, EN 301 549) with detailed compliance reports. **UX Designers:** Use heatmap data to validate design decisions and improve user experience based on real click behavior. **SEO Professionals:** Well-structured, accessible content improves search rankings — AccessIQ helps you maintain both. --- = 🔬 WCAG Scanner Features = * **Compliance Score (0–100):** Animated score ring with grade label per page * **WCAG 2.1 Level A, AA, AAA:** Choose your compliance target per scan * **Violations by Category:** Visual bar chart — Images, Contrast, Headings, ARIA, Forms * **Severity Labels:** Critical / Serious / Moderate issue classification * **Element Selector:** See exactly which HTML element caused the violation * **Scan History:** Full history with date, score, issue count, and WCAG level * **One-click Re-scan:** Re-scan any page instantly from the reports page * **Print Reports:** Print scan reports directly from the browser * **Unlimited scans:** Run as many WCAG scans as you need from your admin * **Single Report View:** Detailed breakdown with back navigation and print option * **Perfect Score Celebration:** Special screen when a page scores 100/100 --- = 🔥 Heatmap Engine Features = * **Live Click Heatmap:** Visualize click intensity overlaid on your live site * **In-Dashboard Preview:** See heatmaps inside WP Admin — no external app needed * **macOS-style Chrome:** Professional browser frame with URL bar and LIVE PREVIEW badge * **Top Clicked Elements:** Ranked table with element selector, click count, and % of total * **Rank Indicators:** Gold / Silver / Bronze rank numbers for top 3 elements * **Date Range Filter:** 7 days, 30 days, 90 days * **Device Filter:** All Devices, Desktop, Mobile, Tablet * **Page Dropdown:** Select any tracked page from the dropdown * **Pages Being Tracked:** See how many pages have active tracking * **Peak Activity Hour:** Discover when your visitors are most active * **Most Clicked Element:** Instantly see the top interacted element * **Self-Hosted:** 100% — all data stays in your WordPress database * **Lightweight Tracker:** Under 3KB, loads asynchronously, zero performance impact --- = 📈 Behavior Analytics Features = * **Session Tracking:** Total sessions, average time on page, bounce rate * **Daily Sessions Chart:** Beautiful Chart.js line chart with gradient fill and hover tooltips * **Device Breakdown:** Animated donut chart — Desktop, Mobile, Tablet split with legend * **Top Pages Performance:** Sessions, avg time, bounce rate, top device per page * **Date Range Filter:** 7, 30, 90 day periods * **Bounce Rate Alerts:** Color-coded — red (high), amber (medium), green (low) * **Real-time Indicator:** Live status badge showing last update time * **Privacy-First:** No cookies, no third-party scripts, no Google Analytics needed --- = ♿ Accessibility Widget Features = * **Floating Toolbar:** Frontend widget for site visitors with accessibility needs * **Font Size Control:** Adjust text size from 80% to 150% * **High Contrast Mode:** Switch to high-contrast color scheme * **Dyslexia-Friendly Font:** Apply Lexend font for easier reading * **Keyboard Navigation:** Highlight keyboard focus indicators * **Screen Reader Optimize:** Optimize page for screen readers * **Widget Position:** Top Left, Top Right, Bottom Left, Bottom Right * **Brand Color:** Customize widget color to match your brand (9 color options) * **Show/Hide on Mobile:** Control widget visibility per device --- = 🎛️ Settings = Go to **AccessIQ → Settings** to configure the plugin. Settings are organized into tabs: **Accessibility → Widget:** * Enable/Disable floating toolbar * Show on mobile toggle * Widget position (Top Left, Top Right, Bottom Left, Bottom Right) * Brand color selector (9 colors) * Feature toggles: Font Size, High Contrast, Dyslexia Font, Keyboard Nav, Screen Reader Optimize **Accessibility → Scanner:** * Default WCAG level (A / AA) * Notification email for scan alerts **InsightForge → Analytics:** * Tracking enable/disable * Data retention period * Session timeout configuration = ✨ Why AccessIQ? = * **2-in-1** — Accessibility + Analytics in one plugin — save money on tools * **Privacy-first** — All data stored in your own database, GDPR friendly * **No API keys required** — Core features work out of the box * **Dark theme dashboard** — Easy on the eyes, beautiful and modern * **Lightweight** — No bloat, optimized for performance * **Developer-friendly** — Clean OOP PHP, proper hooks, sanitization everywhere * **Actively maintained** — Regular updates and responsive support --- == External Services == This plugin does not send any scan, click, or session data to external servers. All analytics data is stored exclusively in your WordPress database. The WCAG scanner runs entirely in the browser (client-side within the WordPress admin). The target page is loaded and analyzed locally, then results are saved via AJAX to your site. No scan data leaves your server. = Google Fonts = This plugin loads typefaces from **Google Fonts** (fonts.googleapis.com) in two places: 1. **Admin screens** — DM Sans and DM Mono are loaded when you visit an AccessIQ admin page. 2. **Frontend accessibility widget** — Lexend is loaded on public pages when the accessibility toolbar is enabled. When these fonts are requested the visitor's browser sends a standard HTTP request to Google servers, which may include the visitor's IP address, browser user-agent, and the referring page URL. * Service: Google Fonts, provided by Google LLC * Terms of Service: https://policies.google.com/terms * Privacy Policy: https://policies.google.com/privacy == Installation == **Method 1 — WordPress Plugin Directory (Recommended):** 1. Go to **Plugins → Add New** in your WordPress admin 2. Search for **"AccessIQ"** 3. Click **Install Now**, then **Activate** 4. Go to **AccessIQ → WCAG Scanner** to run your first scan 5. Visit any page on your site to start collecting heatmap data **Method 2 — Manual Upload:** 1. Download the plugin ZIP file 2. Go to **Plugins → Add New → Upload Plugin** 3. Upload the ZIP file and click **Install Now** 4. Activate the plugin 5. Go to **AccessIQ → Overview** in your admin dashboard **Requirements:** * WordPress 6.0 or higher * PHP 7.4 or higher * MySQL 5.7 or higher * JavaScript enabled in visitor browsers (for heatmap tracking) --- == Frequently Asked Questions == = Is AccessIQ completely free? = Yes! The features in this WordPress.org release are free — including unlimited WCAG scans, click heatmap engine, behavior analytics, and the frontend accessibility widget. = Does AccessIQ send my data to external servers? = No. All scan results, click data, and session data are stored in your own WordPress database. The scanner only fetches your own site's pages for analysis. Your data stays yours. = Which WCAG standard does the scanner support? = AccessIQ checks against WCAG 2.1 at Levels A, AA, and AAA. You can choose the compliance level when running each scan. = Will the heatmap tracker slow down my website? = No. The tracking script is under 3KB, loads asynchronously after the page is fully loaded, and has no impact on your Core Web Vitals or page load speed. = How is AccessIQ different from other accessibility plugins? = Most accessibility plugins either add a frontend overlay widget (which doesn't actually fix violations) or do a basic one-time scan. AccessIQ combines a full WCAG 2.1 scanner + click heatmaps + behavior analytics in one dashboard — with ongoing tracking, history, and visual reports. = Is AccessIQ GDPR compliant? = The plugin collects click coordinates and page URLs for heatmaps, and session duration and device type for analytics. No personally identifiable information (PII) is stored. No cookies are used for tracking. We recommend disclosing heatmap/analytics tracking in your privacy policy. = Can I use AccessIQ on client sites? = Yes. You can use AccessIQ on client sites within your normal WordPress workflow and project requirements. = Does the heatmap work on all pages and post types? = The heatmap tracker works on all public-facing pages, posts, and custom post types. It requires JavaScript to be enabled in the visitor's browser. = How do I export accessibility reports? = Use the Print Report button on a scan report to print or save as PDF from your browser. = Does AccessIQ work with page builders like Elementor or Divi? = Yes. The WCAG scanner scans the final rendered HTML of any page, regardless of which page builder or theme was used to create it. = Can I track multiple pages with heatmaps? = Yes. The heatmap tracker automatically collects click data on all pages visitors browse. You can then select any tracked page from the dropdown in the Heatmap Engine. = How do I use the shortcode for the accessibility widget? = The accessibility widget is automatically added to your site when enabled in Settings. No shortcode needed — it appears as a floating button on all pages. = Is there documentation available? = Yes. Full documentation is available on our website at https://accessiq.thereadscope.com/ = How do I get support? = Post your question in the WordPress.org support forum. We respond to all questions as quickly as we can. --- == Screenshots == 1. **Overview Dashboard** — Combined accessibility + analytics dashboard with animated score ring and tab navigation 2. **WCAG Scanner** — Scan any URL for WCAG 2.1 violations with compliance score and level selector 3. **Scan Reports** — History of all scans with scores, issue counts, and relative timestamps 4. **Single Report View** — Detailed report with score ring, violation breakdown, and severity labels 5. **Heatmap Engine** — Live click heatmap overlaid on your site with macOS-style browser chrome 6. **Top Clicked Elements** — Gold/Silver/Bronze ranked table with click count and % breakdown 7. **Behavior Analytics** — Daily sessions chart, device breakdown donut, and top pages table 8. **Device Breakdown** — Animated Chart.js donut chart showing Desktop/Mobile/Tablet split 9. **Accessibility Widget** — Frontend floating toolbar with font size, contrast, and dyslexia controls 10. **Settings Page** — Widget configuration, scanner preferences, brand color, and analytics controls 11. **About Page** — Full feature showcase and plugin overview --- == Changelog == = 1.2.0 = * Fixed NonEnqueuedStylesheet: replaced inline CSS output in report template with proper linked stylesheet via esc_url() * Added nonce verification and capability checks for report view in admin * Removed sslverify => false from wp_remote_get() calls * Added wp_unslash() to all superglobal access across scanner, settings, analytics, and tracker classes * Replaced CSS @import Google Fonts with lazy JavaScript injection to meet WP.org resource guidelines * Google Fonts version parameter set to null per WP.org requirements = 1.1.0 = * Replaced all raw `