=== Woo Speed Audit ===
Contributors: wpbundle
Tags: woo, speed, performance, pagespeed, headless, checkout
Requires at least: 5.8
Tested up to: 6.4
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Audit your WooCommerce shop & checkout speed. Identify bottlenecks in plain English and see if your store is ready for headless commerce.

== Description ==

**Is your WooCommerce checkout costing you sales?**

Studies show that every 1 second delay in page load reduces conversions by up to 7%. But most speed tools give you developer jargon, not actionable answers.

Woo Speed Audit is different. It:

* **Audits your Shop, Cart, and Checkout pages** using Google PageSpeed Insights (mobile)
* **Explains bottlenecks in plain English** — no technical knowledge required
* **Scans your installed plugins** for headless commerce compatibility
* **Shows you exactly what to fix** with ranked opportunities

= Features =

* One-click PageSpeed audit for all WooCommerce pages
* Mobile performance scores with letter grades (A–F)
* Core Web Vitals breakdown: LCP, FID, CLS, FCP, TBT, TTI
* Top 5 actionable speed opportunities per page
* Plugin compatibility scanner: headless-ready, partial, or incompatible
* Headless readiness score (0–100%)
* Results cached for 1 hour (configurable)
* Optional Google PageSpeed API key for higher quotas

= Why Speed Matters for WooCommerce =

WooCommerce stores running on classic PHP themes typically score 30–60 on Google PageSpeed. The root cause isn't your hosting — it's the architecture. PHP-rendered pages, heavy JavaScript, and multiple round-trips all add up.

This plugin helps you understand exactly what's slowing you down, and whether your store is ready to move to a faster headless architecture.

= About WPBundle =

[WPBundle](https://wpbundle.com/) gives WooCommerce stores a blazing-fast headless storefront without rebuilding your backend. Same WordPress admin. Same plugins. Scores that actually hit 90+.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/woo-speed-audit` directory, or install directly through the WordPress plugins screen.
2. Activate the plugin.
3. Go to **WooCommerce → Speed Audit** in your admin menu.
4. Click **Run Audit Now**.

Optionally, add a [Google PageSpeed API key](https://developers.google.com/speed/docs/insights/v5/get-started#key) in Settings to avoid rate limits.

== Frequently Asked Questions ==

= Do I need a Google API key? =

No — the plugin works without one, but the shared quota is limited. If you get rate-limit errors, add a free API key in Settings.

= How long does an audit take? =

Usually 30–60 seconds. PageSpeed Insights fetches and renders your pages from Google's servers, so the time depends on your server response and page complexity.

= Why are results cached? =

PageSpeed Insights has API rate limits. Results are cached for 1 hour to avoid hitting them. You can clear the cache manually in the plugin.

= What is a "headless" WooCommerce store? =

A headless store separates your WooCommerce backend from your customer-facing frontend. The frontend is built in React/Next.js and served via CDN — which is why it loads instantly. Your WordPress admin, products, orders, and plugins stay exactly as they are.

= My score is low — what should I do? =

The plugin shows you the top opportunities per page, ranked by potential time savings. Common fixes include reducing render-blocking JavaScript, optimising images, and removing unused plugins. For a comprehensive fix, consider a headless setup with WPBundle.

== Screenshots ==

1. One-click audit dashboard showing speed scores for Shop, Cart, and Checkout pages.
2. Detailed metrics breakdown with Core Web Vitals.
3. Top opportunities ranked by potential speed savings.
4. Plugin scanner showing headless compatibility.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
