=== Confirmed Meta Purchase for WooCommerce ===
Requires at least: 6.5
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Manual confirmation gates Meta Purchase through CAPI. Includes PixelYourSite Meta Purchase suppression, checkout consent capture, order notes, HPOS-compatible order CRUD, and bounded retries.

== Installation ==
Upload the ZIP in WordPress Plugins. Configure WooCommerce > Confirmed Meta Purchase.
Read SETUP-BN.md before enabling. Disable existing Meta Purchase sources and clear caches.
Use the same Meta Dataset ID as PixelYourSite. Configure consent and test with new orders.

== Important ==
Server Purchase only: no administrator-browser or customer-browser Purchase is emitted.
Other PixelYourSite events remain enabled. Existing orders are not imported.
Applies to all checkout payment methods. Automatic Processing/Completed is not confirmation.
Use Order actions > Confirm & Send Meta Purchase to preserve the fulfillment status.
Custom Confirmed (Meta) status is optional; third-party fulfillment integrations must support it.
Database must support MySQL/MariaDB GET_LOCK; Action Scheduler or WP-Cron must run.
Token may alternatively be supplied by CMP_META_ACCESS_TOKEN in wp-config.php.
Email/phone hashes, order IP/user-agent, attribution cookies, amount and currency go to Meta.
The plugin contacts graph.facebook.com only when a confirmed order is processed.
Settings and order tracking markers are retained on deletion to avoid accidental replays.

== Changelog ==
= 1.0.2 =
Added developer credit and Facebook profile link in the plugin header and settings page.
= 1.0.1 =
Normalize REST routes to prevent case-based suppression bypasses.
Coalesce pending jobs while allowing a running worker to schedule its retry.
Report confirmation lock failures and avoid endless jobs on unsupported locks.
Verified with real local WordPress 7.1.3, WooCommerce 11.2.1, MySQL 8.4.3, and both order storage modes. Meta responses remain mocked.
= 1.0.0 =
Initial release. PHP syntax and behavioral harness verified; live store/Meta testing required.
