=== Cartright for WooCommerce ===
Contributors: famosmedia
Tags: woocommerce, abandoned cart, cart recovery, abandoned cart recovery, cart abandonment
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 0.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Session-verified abandoned-cart recovery for WooCommerce. Counts genuine human carts, reports revenue reconciled to real orders, sends via your SMTP.

== Description ==

Cartright is an abandoned-cart recovery plugin for WooCommerce focused on data you can
trust. It records a cart as a real, recoverable abandon only when there is evidence of a
genuine human shopping session, and it reports recovered revenue reconciled against your
actual completed orders — so the numbers on your dashboard match the money in your store.

= How it works =

* **Session-verified tracking.** A lightweight confidence score combines signals of a real
  shopping session — JavaScript execution proof (a session-bound, cryptographically signed
  token), a prior page view, human interaction, and realistic timing. Carts that show no
  evidence of a real browser session (typically bots or direct API calls) are placed in a
  separate, clearly labelled bucket instead of being counted as recoverable.
* **Revenue reconciled to real orders.** "Recovered revenue" counts only real, paid orders
  that carry a valid recovery token, with a full audit trail — no estimates, no double
  counting.
* **Your data, your mailbox.** Everything is stored in your own WordPress database. Recovery
  emails are sent through your own mailer / SMTP (works with any SMTP or deliverability
  plugin) — there is no external service and no per-email fee.
* **Transparent dashboard.** See how many carts were counted, held, or filtered — and the
  reason each filtered cart was excluded.

= Why Cartright is different =

Most WooCommerce abandoned cart recovery tools are monthly SaaS services: they route your
shoppers' data through their servers, cap how many recovery emails you can send, and inflate
"recovered revenue" with estimates. Cartright is the opposite — it is fully self-hosted, sends
abandoned cart emails through your own SMTP with no per-email fee and no sending limit, counts
only real session-verified abandons, and reports recovered revenue reconciled to actual paid
orders. You recover abandoned carts on your own WordPress install, and Pro is a one-time
(Lifetime) license instead of a recurring subscription.

= Free vs Pro =

The free plugin sends a single, well-timed recovery reminder and includes the tracking
dashboard and email template editor. The optional **Cartright Pro** add-on unlocks the full
multi-step recovery sequence and is a one-time (Lifetime) license — no monthly fees.

== Installation ==

1. Install and activate WooCommerce.
2. Install and activate Cartright (upload the plugin, or install it from the Plugins screen).
3. Go to **WooCommerce → Cartright** to view tracking and edit your recovery email.
4. Make sure your store can send email reliably — an SMTP plugin such as FluentSMTP or
   WP Mail SMTP is recommended.

== Frequently Asked Questions ==

= Does it send email through a third-party service? =
No. Emails are sent through your own WordPress mailer / SMTP. Your customer data stays on
your server.

= Why are some carts marked "suspicious"? =
Those add-to-cart events showed no evidence of a real browser session — for example no
JavaScript executed, no page view, and no interaction. Cartright keeps them out of your
headline numbers and does not email them. The dashboard shows the reason for each.

= Will it slow down my store? =
No. Tracking uses a first-party cookie and a couple of small background requests on page
render.

= Do I need the Pro add-on? =
No. The free plugin sends one recovery reminder. Pro is optional and adds the full
multi-step sequence.

== Screenshots ==

1. Cartright dashboard — recovered revenue reconciled against real paid orders, plus cart-signal quality (verified, held, and filtered).
2. Transparency view — each filtered cart with the reason it was excluded from your numbers (for example datacenter ASN, known bot user-agent, impossible-fast dwell, high velocity).
3. Recovery email editor — configurable subject and body per step, with {recovery_link} and {site_name} placeholders. The free core sends one reminder; Pro unlocks the full multi-step sequence.

== Changelog ==

= 0.1.1 =
* Readme: clearer positioning and improved search metadata (tags, description). No functional changes to the plugin.
* Packaging: exclude the test runner from the distributed build.

= 0.1.0 =
* Initial release: session-verified cart tracking, transparent dashboard, single recovery
  reminder, editable email template, revenue reconciliation.
