=== Recovero - Cart Recovery for WooCommerce ===
Contributors: codewoogeek, propluginslab, heyvicky
Tags: woocommerce, abandoned cart, cart recovery, email marketing, ecommerce
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Recover lost WooCommerce sales with real time cart capture and automated recovery emails that start working the moment you activate.

== Description ==

Recovero - Cart Recovery for WooCommerce recovers lost sales automatically. It works the moment it is activated: a three step email series and five ready to use templates are installed for you, so there is nothing to configure before your first cart is saved.

**What you get**

* Real time cart capture for guests and logged in shoppers, including live email capture as the shopper types at checkout.
* Unlimited recovery campaigns and email steps, each with its own delay, template, and subject line, targeted by cart value. Adding a step to a live campaign also reaches carts already recovering.
* Five mobile friendly starter templates and unlimited templates of your own, built in a visual editor with blocks, a live preview, and an HTML mode.
* Merge tags and test sends, so you can check exactly what a shopper receives.
* Reliable background sending on WooCommerce Action Scheduler, with retries, bounded batches, and a stalled queue warning.
* Live dashboard and full reports: recovery rate, recovered revenue, per campaign performance, best performing products, and 7, 30 or 90 day ranges.
* Abandoned cart list with status filters, search, sortable columns, bulk actions, CSV export, shopper location, and a detailed single cart view with an activity timeline.
* Stock aware cart restore, so a shopper is never sent back to a broken checkout.
* Privacy tools: consent capture, unsubscribe links, data retention, anonymization, and integration with the WordPress personal data export and erase tools. IP addresses are stored only as a salted hash, never in plain text.
* Emails in the shopper's own language with WPML and Polylang.
* Settings import and export, so a tuned configuration moves between stores.
* Built in documentation with a full developer hook reference.
* Compatible with WooCommerce High Performance Order Storage and the block based cart and checkout.

**Built for performance**

The plugin does no work on requests that do not need it. It never forces a session or a cookie on an anonymous visitor, so full page caching keeps working. All sending runs through Action Scheduler in claimed batches rather than on page loads.

**Premium version**

A commercial edition, Recovero - Cart Recovery for WooCommerce Pro, is available from [ProPluginsLab](https://propluginslab.com/shop/plugins/pro-plugins/recovero-cart-recovery-for-woocommerce/). It adds single use recovery coupons, with a coupon block in the email builder and two extra discount templates, an exit intent popup with device and operating system targeting, email throttling with hourly caps and a daily send window, and outgoing webhooks for Zapier, Make and CRMs, and session replay, which records what happened on the storefront before a cart was abandoned with every input masked and payment areas excluded. The two editions share the same data, so moving between them keeps every cart, campaign, template, and setting.

**Developer hooks**

Actions include ppl_acrw_loaded, ppl_acrw_cart_captured, ppl_acrw_cart_abandoned, ppl_acrw_sequence_scheduled, and ppl_acrw_cart_recovered. Filters include ppl_acrw_default_settings, ppl_acrw_starter_templates, ppl_acrw_merge_tags, ppl_acrw_should_send, ppl_acrw_queue_batch_size, ppl_acrw_recovery_url, and ppl_acrw_rendered_email. The full reference is on the built in Documentation screen.

**External services**

This plugin does not connect to any external service. All cart data, email content, and statistics stay in your own WordPress database, and recovery email is sent through your site's own mail configuration.

== Installation ==

1. Upload the plugin folder to /wp-content/plugins/ or install it through the Plugins screen.
2. Activate the plugin. Tables, starter templates, and the default campaign are created automatically.
3. Visit Cart Recovery to review the dashboard. That is it, recovery is already running.

== Frequently Asked Questions ==

= Does it work right after activation? =

Yes. A default campaign and email templates are installed on activation, so carts are recovered without any setup.

= Does it support guest checkouts? =

Yes. Guest emails are captured in real time from the checkout email field, before the order is placed.

= Will it slow my store down? =

No. Nothing runs on requests that do not need it, no session or cookie is forced on an anonymous visitor, and all sending happens in the background through Action Scheduler.

= How are recovery emails sent? =

Through wp_mail, so they use whatever mail configuration your site already has, including any SMTP plugin.

= Is anything in this plugin limited or locked? =

No. Everything included here is fully functional with no caps, trials or licence checks. The Pro edition is a separate plugin that adds further features; it does not unlock anything in this one.

= What happens to my data if I move to the Pro edition? =

Nothing is lost. Both editions read and write the same tables and settings, so every cart, campaign, template, and setting carries straight over. Uninstalling one edition also leaves the data alone while the other is still installed.

= Can both editions run at once? =

Pro takes over automatically and this edition stands down, so recovery emails are never sent twice.

= Is it compatible with High Performance Order Storage? =

Yes, and with the block based cart and checkout.

== Screenshots ==

1. The dashboard shows live carts, recovery revenue and email delivery at a glance, updating in real time as shoppers browse, abandon and return.
2. Every captured cart in one list, with status filters, search, sortable columns and the shopper country and IP address in the Location column.
3. The cart detail screen shows the items left behind, the shopper contact details, the scheduled emails and a full activity timeline.
4. Recovery campaigns, each with its own schedule, priority and cart value conditions.
5. Build a multi step sequence by choosing when each email sends, which template it uses and what the subject line says.
6. The email template library, with ready made templates that work the moment you activate the plugin.
7. The visual email builder, with a live preview beside the blocks you are editing.
8. Reports covering recovery rate, revenue recovered, email performance and the products most often left behind.
9. Settings, covering the recovery engine, the sender identity and your email branding.

== Changelog ==

= 1.0.2 - 21 August 2026 =
* Improvement: The minimum PHP version is now 7.4, so the plugin installs on more hosts. Every file has been checked for compatibility across 7.4 and later.
* Improvement: Tested with WordPress 7.1 and WooCommerce 11.0.1.
* Fix: The Documentation screen no longer lists a Webhooks section, which is not part of this edition.
* Fix: Cart CSV export now sets its escaping explicitly, so a field containing a backslash exports the same way on every supported PHP version.
* Fix: The currency symbol shown in the admin now decodes the same way on PHP 8.1 and later, where the default changed.

= 1.0.1 - 17 August 2026 =
* New: Optional IP address storage for captured carts. It is off by default and can be switched on under Settings, Privacy.
* New: The shopper country is recorded automatically and shown in a Location column on the Abandoned Carts screen, and on each individual cart.
* Improvement: Adding a step to a campaign that is already running now schedules that step for carts still working through the sequence, timed from when each cart was abandoned.
* Fix: Email open tracking no longer counts an image prefetch by a mail provider as an open.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.2 =
Lowers the PHP requirement to 7.4 and adds WordPress 7.1 and WooCommerce 11.0.1 compatibility. No action needed after updating.

= 1.0.1 =
Adds optional IP address storage and a shopper location column. No action needed after updating.

= 1.0.0 =
Initial release.
