⚡Installation & Setup

Get AccessIQ up and running on your WordPress site in under 2 minutes. No API keys, no external accounts, no configuration required for core features.

Requirements

Install Steps

Method 1 — WordPress Plugin Directory (Recommended)

Method 2 — Manual Upload

First Run

After activation, AccessIQ will automatically:

• Create 4 database tables: wp_accessiq_sessions, wp_accessiq_clicks, wp_accessiq_issues, wp_accessiq_dashboard
• Inject the lightweight tracking script on all frontend pages
• Add the Accessibility Widget to your frontend
• Redirect you to the About & Features page

🔬WCAG Scanner

The WCAG Scanner checks any page on your site against WCAG 2.1 accessibility standards and gives you a 0–100 compliance score with a full breakdown of violations.

Running a Scan

Reading Results

Compliance Score

The animated score ring shows a number from 0 to 100. Higher is better.

Severity Labels

Violations by Category

The horizontal bar chart groups all violations into 5 categories:

• Images — Missing or inadequate alt text on images
• Contrast — Text/background color contrast ratio failures
• Headings — Missing H1, skipped heading levels, empty headings
• ARIA — Incorrect or missing ARIA roles, labels, and attributes
• Forms — Form inputs missing labels or required attributes

Scan Reports

Go to AccessIQ → Scan Reports to see your full scan history. Each report shows:

• Page URL scanned
• Date and time
• Compliance score with color-coded ring
• Total issue count
• WCAG level used

Click View Report on any row to see the full detailed breakdown. Use the Print Report button to generate a browser-printable compliance report.

♿Accessibility Widget

The Accessibility Widget is a floating toolbar that appears on your frontend for site visitors. It provides tools to help users with visual, cognitive, or motor disabilities browse your site more comfortably.

Widget Features

Configuration

Go to AccessIQ → Settings → Accessibility → Widget to configure the widget.

🔥Heatmap Engine

The Heatmap Engine records every click made by visitors on your site and visualizes them as an overlay on your live pages — directly inside WP Admin. 100% self-hosted, no external service.

How Tracking Works

When AccessIQ is activated, a lightweight JavaScript tracker (under 3KB) is injected into every public-facing page. It runs asynchronously — meaning it loads after your page has fully rendered and has zero impact on page speed or Core Web Vitals.

For each click, the tracker records:

• X and Y coordinates of the click
• CSS selector of the clicked element
• Current page URL
• Device type (Desktop / Mobile / Tablet)
• Timestamp

Reading the Heatmap

Go to AccessIQ → Heatmap. You'll see a live preview of your site inside a macOS-style browser frame with click data overlaid.

Filters

Summary Cards

Above the heatmap you'll see 4 summary cards:

• Total Clicks — all click events in the selected period
• Most Clicked — the top element's CSS selector
• Pages Tracked — number of distinct pages with click data
• Peak Hour — hour of the day with most activity

Top Clicked Elements

Below the heatmap, the Top Clicked Elements table ranks every interacted element. Each row shows:

• Rank — 🥇 Gold / 🥈 Silver / 🥉 Bronze for top 3
• Element Selector — CSS selector in a monospace pill
• Clicks — total click count
• % of Total — color-coded: red (>20%), amber (10–20%), green (<10%)
• Progress Bar — visual representation of click share

📈Behavior Analytics

Behavior Analytics tracks visitor sessions, time on page, bounce rate, and device distribution — all stored in your own database. No Google Analytics, no cookies, no third-party scripts.

Sessions & Metrics

Go to AccessIQ → Behavior. At the top you'll see 4 key metrics:

Daily Sessions Chart

The line chart shows daily session count over the selected period. Hover over any point to see the exact count. Use the date range buttons (7 days / 30 days / 90 days) to change the period.

Device Breakdown

The animated donut chart shows your audience split by device type:

• Desktop — PCs and laptops
• Mobile — smartphones
• Tablet — tablets and iPads

Device type is detected from the visitor's browser User-Agent string. No cookies are used.

Top Pages Performance

The Top Pages table at the bottom of the analytics page shows performance per URL:

⚙️Settings

Go to AccessIQ → Settings to configure all plugin options. Settings are organized into tabs.

Accessibility — Widget Tab

Accessibility — Scanner Tab

InsightForge — Analytics Tab

💻Developer Reference

AccessIQ is built with clean OOP PHP and provides action hooks, filter hooks, and constants for developers to extend functionality.

Constants

Action & Filter Hooks

Action Hooks

// Example: Send email when scan completes
add_action( 'accessiq_scan_complete', function( $scan_id, $score, $url ) {
    if ( $score < 70 ) {
        wp_mail(
            get_option( 'admin_email' ),
            'AccessIQ: Low score on ' . $url,
            'Compliance score: ' . $score . '/100'
        );
    }
}, 10, 3 );

Filter Hooks

// Example: Exclude /cart/ and /checkout/ from heatmap tracking
add_filter( 'accessiq_track_this_page', function( $should_track, $url ) {
    $exclude = [ '/cart/', '/checkout/', '/my-account/' ];
    foreach ( $exclude as $path ) {
        if ( strpos( $url, $path ) !== false ) {
            return false;
        }
    }
    return $should_track;
}, 10, 2 );

Database Tables

Shortcode Reference

AccessIQ does not use shortcodes for its core UI — everything is in the WP Admin dashboard. However, you can use the following in templates or widgets:

// Get current site accessibility score in a template
$score = get_option( 'accessiq_latest_score', 0 );
echo esc_html( $score ); // e.g. 87

// Check if AccessIQ is active
if ( defined( 'ACCESSIQ_VERSION' ) ) {
    // Plugin is active
}

❓FAQ & Troubleshooting

Common questions and solutions to known issues.

Frequently Asked Questions

General

Is the free version really free forever?
Yes. The WCAG Scanner (5 scans/month), heatmap engine, behavior analytics, and accessibility widget are permanently free. No trial period, no expiry.

Do I need to create an account to use AccessIQ?
No. Install the plugin and it works immediately — no account, no API key, no registration required.

Is AccessIQ GDPR compliant?
AccessIQ does not collect any personally identifiable information (PII). It stores click coordinates, page URLs, session duration, and device type — no IP addresses, no user identifiers, no cookies. We recommend disclosing analytics tracking in your privacy policy.

Scanner

Why can't I scan pages behind a login?
The WCAG Scanner fetches the public HTML of a URL. Pages requiring login return a redirect to the login form — the scanner sees the login page, not the protected page. Use browser-based tools like axe DevTools for logged-in pages.

My scan limit shows 0 remaining. When does it reset?
The free tier allows 5 scans per calendar month. The counter resets on the 1st of each month. Upgrade to Pro for unlimited scans.

The scanner says "Failed to fetch URL" — what's wrong?
This means WordPress could not download the page HTML. Common causes: the URL is on a different server, the server blocks loopback requests, or the URL is incorrect. Try: Settings → Permalinks → Save Changes to flush rewrite rules, then retry.

Heatmap

No click data is showing — what's wrong?
Check these in order: (1) Tracking is enabled in Settings → InsightForge → Analytics. (2) You have visited the site as a non-admin visitor — admin sessions are excluded by default. (3) The tracker script is loading — open browser DevTools → Network and look for tracker.js. (4) The page has received at least one real visitor click.

The heatmap iframe shows a blank page
This can happen if your site has a Content Security Policy (CSP) that blocks iframes. Add your domain to the frame-src directive, or check with your hosting provider.

Clicks from my own browser are being tracked
Go to Settings → InsightForge → Analytics → Exclude Admins and make sure it is enabled. This excludes all WordPress logged-in admin users from tracking.

Analytics

Sessions are not appearing in the analytics dashboard
Sessions are recorded by behavior.js on the frontend. Ensure the script is loading (check browser DevTools → Network). Also confirm you are viewing the site as a non-admin visitor, as admin sessions are excluded by default.

Widget

The accessibility widget is not showing on my site
Check: (1) Widget is enabled in Settings → Accessibility → Widget → Enable Widget. (2) Your theme is calling <?php wp_footer(); ?> before the closing </body> tag — the widget is injected there. (3) A caching plugin may be serving an old cached page — clear all caches.

The widget conflicts with my theme's existing accessibility toolbar
You can disable specific tools in Settings → Widget or disable the entire widget and just use the WCAG scanner standalone.

Getting Further Help

If your issue isn't covered here, you have two options:

• WordPress.org Support Forum: wordpress.org/support/plugin/accessiq — we respond within 1–2 business days.
• Pro Support: Pro users get priority email support with guaranteed 24-hour response time.