=== WAP QA Auditor for Elementor ===
Contributors: waqarashraf379
Tags: elementor, quality assurance, audit, website launch, checklist
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight manual QA auditing tool for Elementor websites. Scan your pages and templates before launch or client hand-off.

== Description ==

WAP QA Auditor for Elementor is a lightweight quality assurance (QA) tool for agencies, freelancers and developers who build websites with Elementor.

It performs a manual, on-demand audit of your Elementor-managed content and flags common pre-launch issues, so you can catch them before the client sees them.

This is **not** an SEO plugin, **not** a performance optimization plugin and **not** a monitoring tool. It runs only when you click "Run Scan" — there are no background jobs, no cron events and no external requests.

**What it checks:**

* Non-WebP images (JPG, JPEG, PNG, GIF)
* Images larger than 200 KB
* Missing or multiple H1 headings
* Custom colors instead of Elementor Global Colors
* Custom typography instead of Elementor Global Typography
* Container nesting deeper than 4 levels
* Empty or invalid links (blank href, #, javascript:void(0), empty button/link URLs)

**Scan modes:**

* Full Website Scan — scans every Elementor-managed page, template, header, footer, archive, single template and popup.
* Selected Content Scan — search and choose exactly which pages or templates to scan.

**Dashboard:**

An at-a-glance score card (0-100), total content scanned, total issues, critical issues, warning issues and the last scan date.

**Results page:**

Every issue is grouped by type into clean, expandable sections, with critical issues shown first. Search, filter by page, severity or content type, jump straight to the affected page or open it in Elementor, and export the full report to CSV in one click.

**Privacy & data:**

This plugin does not collect, transmit or track any data. It stores one scan summary using the WordPress Options API and the current scan's issue list in a transient. Each new scan replaces the previous one — no scan history is kept, and no custom database tables are created.

== Installation ==

1. Upload the `wap-qa-auditor-for-elementor` folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Make sure Elementor is installed and active.
4. Go to "WAP QA Auditor" in the admin menu and click "Run Full Scan" or "Run Selected Scan".

== Frequently Asked Questions ==

= Does this plugin require Elementor? =

Yes. Elementor must be installed and active. The plugin will show an admin notice if it is not.

= Does this plugin run automatically in the background? =

No. Scans only run when you explicitly click "Run Full Scan" or "Run Selected Scan". There are no cron jobs or background workers.

= Does this plugin send any data externally? =

No. All scanning happens locally on your server. No external API calls, telemetry or tracking are used.

= Does the plugin keep a history of past scans? =

No. Only the most recent scan summary and results are stored. Running a new scan replaces the previous one.

= What happens to plugin data when I uninstall it? =

All plugin data (the scan summary option and the scan results transient) is permanently removed when the plugin is uninstalled.

== Screenshots ==

1. Dashboard with the overall score card, statistics and scan actions.
2. Selected Scan content picker for scanning specific pages or templates.
3. Audit results grouped by issue type, with search and filters.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
