MarketSync Referral Network — CUSTOMER v0.1.2
============================================
DEVELOPMENT BUILD. Test on a non-production WooCommerce shop first.

Install as a separate WordPress plugin on each participating WooCommerce
store. WooCommerce and publicly reachable HTTPS are required to register.

1. Install/activate this CUSTOMER ZIP.
2. Under Referral Network > Settings / Diagnostics set central server to
   https://marketsyncpro.com and click Register / reconnect.
   The server verifies ownership using the public local REST challenge.
3. Choose partner recommendation hosting: shop Page 1, Page 2, or Both.
4. Under Advertising Credits review the server's mode. Only the SERVER
   controls Stripe Test/Live; there are NO Stripe keys in the client.
5. Run Check connection and retry uploads to synchronize the initial batch;
   larger catalogs upload over successive heartbeats/manual checks.
6. Browse partner recommendations: two eligible product cards on supported
   classic and WooCommerce Product Collection block shop/category archives.
   If fewer than two eligible products are available, the block is omitted.
   Use [marketsync_recommendations] in custom layouts. JavaScript positions
   the cards in a product row when a supported grid has products.
7. Dashboard > Cross-Listings shows latest VERIFIED impressions with links
   to partner shop pages. Since ads rotate, cards may not appear on every
   subsequent page visit.

Queue/recovery:
* Paid WooCommerce orders with a referral token are persisted in a local
  SQL queue and retried approximately every five minutes using WP-Cron.
* Server outage or site migration does not disable normal WooCommerce.
* Six-hour heartbeats refresh account status, notices, catalog and listings.
* Outages do not erase local registration or queue entries; replayed events
  use original paid timestamp so long server outages don't falsely expire
  valid sale-time referral tokens.
* Scheduled tasks may be late on low-traffic sites; configure real cron.
* Merchant sales through normal checkout are NEVER processed through the
  Referral Network Stripe flow (Stripe only sells advertising credits).

LIMITATIONS: v0.1.2 is a development prototype. Live billing is not ready
without order-verification and accounting policy review. Catalog syncing
is batch-based and does not yet prune deleted products on the server.
Non-critical admin announcements can be dismissed per WordPress administrator;
critical announcements cannot be dismissed.
Software directory features do not yet
provide full Woo-Rewards one-click install/update capabilities.
WooCommerce Blocks & unusual AJAX themes need compatibility testing.
Do not enable this build for real customer payments or public merchant sales.
