=== Checkout Blocks Guard for WooCommerce ===
Contributors: kindplugins
Tags: woocommerce, checkout, block checkout, checkout fields, b2b
Requires at least: 6.2
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Audits your WooCommerce checkout: classic vs block, custom fields that may silently disappear under block checkout, and your B2B / VAT fields.

== Description ==

When WooCommerce moved to **block checkout**, a lot of custom checkout code stopped working — because the old PHP checkout hooks do not run inside the Cart/Checkout blocks. The result is fields that quietly vanish: a company field, a VAT / NIP number, a delivery note. You often only notice when a customer complains.

**Checkout Blocks Guard** audits your checkout and tells you, in plain language:

* Whether your **checkout and cart** pages use the modern **block** or the **classic shortcode**.
* Whether any plugin or theme is attaching custom code to **classic checkout hooks that block checkout ignores** — the number-one cause of "my checkout field disappeared".
* Whether your **company / B2B** field is enabled.
* Whether a **VAT / Tax ID (NIP)** field is present.
* Core checkout health: a terms page, at least one payment method, guest checkout.

= Free features =

* One-click checkout audit with a clear pass / warning / fail checklist.
* Detects block vs classic vs custom (page-builder) checkout.
* Flags classic checkout hooks in use under block checkout, and names the plugin/theme callbacks responsible.
* B2B / VAT field detection across common EU/PL invoicing plugins and custom fields.
* Works with WooCommerce High-Performance Order Storage (HPOS) and declares Cart/Checkout Blocks compatibility.
* Read-only: it never modifies your checkout.
* Language: source strings are English (default). Ships with ready translations for Polish, German, Spanish, French, Italian and Portuguese — the plugin automatically follows your WordPress site language.

= It does not modify your checkout =

Checkout Blocks Guard only inspects and reports. It never changes fields, hooks, or pages. Fixing is up to you (or your developer), with the specific recommendation each check provides.

= Pro features =

* Daily automatic audit, so you are warned when a WooCommerce or plugin update changes the checkout.
* Email alert — optionally only when the result changes, so no daily spam.
* CSV report export (great for agencies handing findings to a client).
* Change-aware monitoring for checkout mode, required fields, payment flow, and tracking signal presence.
* Post-update audit workflow you can rerun manually after checkout, payment, or theme changes.

Part of [KindPlugins](https://plugins.courselabz.com) — small WooCommerce plugins that catch expensive operational mistakes.

== Installation ==

1. Upload the `checkout-blocks-guard` folder to `/wp-content/plugins/`, or install the ZIP from Plugins → Add New → Upload Plugin.
2. Activate the plugin.
3. Make sure WooCommerce is active.
4. Open **WooCommerce → Checkout Blocks Guard** and run an audit.

== Frequently Asked Questions ==

= Will it fix my broken checkout field? =

No. It tells you exactly what is wrong and why, but it never modifies your checkout. That keeps it safe to run on any live store.

= What does "classic hooks used under block checkout" mean? =

Block checkout does not run old PHP hooks like `woocommerce_after_order_notes`. If a plugin adds a field through one of those hooks and you are on block checkout, that field will not appear. The audit lists exactly which hooks and callbacks are affected.

= Does it need WooCommerce? =

Yes. Without WooCommerce it shows a calm notice instead of auditing.

== Screenshots ==

1. Checkout audit checklist with pass / warning / fail results.
2. Settings: email alerts on change.
3. License: activate Pro to unlock CSV export, automatic audits, and alerts.

== Changelog ==

= 1.1.2 =
* Added the KindPlugins logo asset to the admin header.

= 1.1.0 =
* Self-hosted one-click updates from plugins.courselabz.com (no wp.org needed).
* Redesigned HTML email alerts matching the KindPlugins look.

= 1.0.0 =
* Initial release: block vs classic detection, classic-hook risk detection, B2B/VAT field checks, general checkout health, Pro license unlock for daily audit, change-based email alerts and CSV export, Polish + English.

== Upgrade Notice ==

= 1.1.0 =
Adds self-hosted updates and restyled email alerts.

= 1.0.0 =
First release.
