=== PhoenixForge Auditor ===
Contributors: ryanpurvisphoenixforge
Tags: site audit, security scan, seo audit, performance, report
Requires at least: 6.2
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Comprehensive WordPress site audit with 12 scanners, weighted scoring, severity findings, and PDF export.

== Description ==

PhoenixForge Auditor runs a thorough health check across your entire WordPress site. Twelve specialised scanners examine security, performance, SEO, accessibility, and configuration — then produce a weighted score with actionable findings ranked by severity.

**The problem:** You know your WordPress site has issues, but you don't know where to start. Running separate security, SEO, and performance tools gives fragmented results with no unified priority list.

**The solution:** PhoenixForge Auditor scans everything in one pass. You get a single score, a prioritised list of findings by severity, and a PDF report you can hand to clients or stakeholders.

= Free Features =

* 12 built-in scanners covering security, performance, SEO, and more
* Weighted overall site health score
* Findings ranked by severity (critical, warning, info)
* Actionable fix recommendations for each finding
* Audit history with score tracking over time
* One-click PDF report export

= Pro Features =

* Scheduled automatic audits
* Custom scanner weights and thresholds
* White-labelled PDF reports with your branding
* Comparison reports showing improvement over time
* Email alerts when score drops below threshold
* Priority support

= Part of the PhoenixForge Suite =

PhoenixForge Auditor pairs perfectly with PhoenixForge Copilot for AI-powered diagnosis of findings, PhoenixForge Security Monitor for continuous security monitoring, and PhoenixForge Performance Monitor for ongoing performance tracking.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/wp-auditor/`
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Navigate to PhoenixForge Auditor in the admin menu
4. Click "Run Audit" to perform your first site scan
5. Review findings and follow the recommended fixes

== Frequently Asked Questions ==

= How long does an audit take? =
A typical audit completes in 30-60 seconds depending on site size. Large sites with many plugins may take up to 2 minutes.

= Will the audit affect my site's performance? =
No. Audits run in the background with throttled resource usage. Your visitors will not notice any slowdown.

= Can I export the results? =
Yes, every audit can be exported as a PDF report. Pro adds white-labelled reports with your own branding.

= Is there a Pro version? =
Yes, Pro adds scheduled audits, custom thresholds, branded reports, and comparison tracking. Visit phoenixforge.io for details.

= What do the severity levels mean? =
Critical findings are security or performance issues that need immediate attention. Warnings are best-practice violations. Info items are suggestions for improvement.

== Screenshots ==

1. Audit results dashboard with weighted site health score and scanner summary
2. Detailed findings list with severity ratings (critical, warning, info) and fix recommendations
3. PDF report preview showing branded audit results ready for client delivery
4. Audit history chart tracking site health score improvements over time
5. Scanner configuration panel with individual scanner weights and thresholds

== Third-Party Services ==

This plugin connects to external services under certain conditions:

= PhoenixForge License Server =
When you activate a Pro license key, the plugin validates it with the PhoenixForge license server.
* Service URL: https://phoenixforge-licenses.phoenixforge.workers.dev
* Privacy Policy: https://phoenixforge.io/privacy
* Terms of Service: https://phoenixforge.io/terms
* Data sent: License key, site URL
* When: On license activation, deactivation, and daily revalidation

= PhoenixForge Update Server =
The plugin checks for new versions from the PhoenixForge update server. This is disabled in WordPress.org distributed builds.
* Service URL: https://phoenixforge-updates.phoenixforge.workers.dev
* Privacy Policy: https://phoenixforge.io/privacy
* Terms of Service: https://phoenixforge.io/terms
* Data sent: Plugin slug and current version
* When: During WordPress update checks (approximately every 12 hours)

= Outbound Webhooks (Pro Feature) =
Pro users can optionally configure webhook URLs to send event data to services like Zapier, Make, or n8n.
* Only active when explicitly configured by the site administrator
* Data sent: Event type, site URL, and event-specific data
* Destination URL is entirely user-controlled

== Changelog ==

= 2.0.0 =
* Initial public release
* 12 built-in scanners
* Weighted scoring system
* Severity-ranked findings
* PDF report export

== Upgrade Notice ==

= 2.0.0 =
Initial release.
