=== Retaint ===
Contributors: retaintdev
Tags: woocommerce, retention, marketing, abandoned cart, customer events
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Retention marketing for WooCommerce. Capture customer events and push them to Retaint to power win-back, abandoned-cart, and lifecycle campaigns.

== Description ==

Retaint connects your WooCommerce store to the Retaint retention marketing platform. Once you paste your Org ID and activate the plugin, every meaningful customer touchpoint is captured automatically:

* Product views, category views, search queries
* Add-to-cart, checkout started
* Order placed (with full order details for retention flows)
* User registration and login (linked to anonymous browsing sessions)

No code changes needed — the plugin handles event tracking on every storefront page automatically.

= How it works =

The plugin loads a small JavaScript snippet on every frontend page (loaded from tracker.retaint.com), which assigns each visitor an anonymous ID. As the visitor browses, views products, searches, and starts checkout, events are reported to Retaint. When a customer registers, logs in, or completes an order, the plugin links their anonymous browsing session to their email and phone so Retaint can target them with retention campaigns.

= Requirements =

* WordPress 6.0 or later
* WooCommerce 7.0 or later
* PHP 7.4 or later
* A Retaint account (https://retaint.com)

== Installation ==

1. Upload the `retaint` folder to `/wp-content/plugins/`, or install through the Plugins screen.
2. Activate the plugin through the 'Plugins' menu.
3. Go to Settings → Retaint.
4. Paste your Retaint Org ID and click "Save Org ID".
5. Click "Test Connection" to verify the integration is working.

== Frequently Asked Questions ==

= Where do I find my Retaint Org ID? =

Log in to your Retaint dashboard at https://app.retaint.com and find the Org ID under your workspace settings.

= Will this slow down my store? =

No. Server-side events use fire-and-forget HTTP requests (1-second timeout, non-blocking), so even if Retaint's API is slow, your checkout and cart flows remain instant. The JavaScript snippet is loaded asynchronously and does not block page rendering.

= Does this plugin store any personal data in WordPress? =

The plugin stores only your Retaint Org ID and a timestamp of the last verified connection. Customer event data is sent directly to Retaint's API and is not stored locally.

= Is this plugin compatible with WooCommerce High-Performance Order Storage (HPOS)? =

Yes. Retaint declares HPOS compatibility and uses only HPOS-safe WooCommerce APIs.

= How do I enable debug logging? =

Add `define( 'RETAINT_DEBUG', true );` to your `wp-config.php`. Every dispatched event will be logged to your PHP error log.

== External Services ==

This plugin connects to the Retaint service (https://retaint.com) to send customer event data so retention marketing campaigns can be triggered.

**What it sends:**

* On every frontend page: loads `https://tracker.retaint.com/retaint.wl.js` (the Retaint tracker script) which assigns the visitor an anonymous ID.
* On commerce events (add-to-cart, checkout, order placed): sends an HTTP POST to `https://tracker.retaint.com/rest/v1/learn/event` with the event name, value, and anonymous visitor ID.
* On user registration, login, and order completion: sends an HTTP POST to `https://tracker.retaint.com/rest/v1/learn/identify` with the user's email, phone, and full name to link the anonymous browsing session to a known customer.
**When it sends:** Only after a site administrator enters a Retaint Org ID under Settings → Retaint. If no Org ID is configured, no data leaves your site.

**Retaint terms and privacy:**

* Terms of Service: https://retaint.com/terms-condition/
* Privacy Policy: https://retaint.com/privacy-policy/

== Changelog ==

= 1.0.0 =
* Initial release.
* Captures: product views, category views, search, add-to-cart, checkout started, order placed, user identify.
* WooCommerce HPOS compatible.
* Admin settings page with connection status and test-connection button.

== Upgrade Notice ==

= 1.0.0 =
First public release of Retaint for WordPress + WooCommerce.
