=== WhappCart ===
Contributors: ayeshanfernando
Tags: woocommerce, abandoned cart, cart recovery, whatsapp, dashboard
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.19.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Recover abandoned WooCommerce carts. Track name, phone and cart, see what you lose, and message customers on WhatsApp with one click.

== Description ==

WhappCart catches the WooCommerce carts that customers leave behind. It shows you how much you are losing, emails you about it, and gives you ways to win the customer back.

**Free**

* Cart tracking: name, phone, email, cart contents, location and traffic source.
* Dashboard with recovery rate, recovered revenue, trends, top sources and most abandoned products. Show or hide each widget.
* Carts list with filters, sorting and a cart detail page with history and recovery link.
* A free "Message on WhatsApp" button on each cart. It opens WhatsApp with a ready message. You send it yourself.
* Basic add-to-cart popup that asks for a name and phone number.
* Import unfinished orders from before you installed the plugin.
* Reports with CSV export.
* Email alerts to you when a cart is abandoned or recovered.
* Consent and privacy tools, including WordPress personal data export and erase.

**Pro**

* Automatic WhatsApp reminders through the official WhatsApp Business Cloud API, with templates and delivery status.
* Three-step reminder sequence with follow-ups and unique coupons.
* Email recovery with unsubscribe handling.
* Order messages: confirm the delivery address and send the tracking link.
* Add-to-cart popup branding: your colours, your picture and your own text.
* More webhook URLs and step reports.

Pro has a 7-day free trial.

**Requirements**

WooCommerce with the classic checkout. Automatic WhatsApp sending needs your own WhatsApp Business account in Meta. Meta charges you for template messages.

== External services ==

This plugin connects to one outside service, and only after you agree on the Freemius screen or when you start a trial or buy Pro.

* **Freemius** (https://freemius.com): handles opt-in, licensing, trials, checkout and updates for the optional Pro version. It receives your site address, plugin version and WordPress and PHP versions after you opt in. If you buy Pro it also receives your account and payment details. Terms: https://freemius.com/terms/ Privacy: https://freemius.com/privacy/

The free "Message on WhatsApp" button only opens a wa.me link in the customer's or your own browser. Nothing is sent to WhatsApp or Meta by the plugin. All cart and customer data stays on your own site.

== Installation ==

1. Go to Plugins > Add New > Upload Plugin, choose the zip file, install and activate.
2. Open WooCommerce > WhappCart.
3. In Settings, set your cut-off time and default country code.
4. Optional: turn on the add-to-cart popup and add a webhook URL.

== Frequently Asked Questions ==

= Does it work with the block-based checkout? =

It is built for the classic WooCommerce checkout.

= Does the free version send WhatsApp messages by itself? =

No. The free version gives you a button that opens WhatsApp with a ready message. Automatic sending is in Pro.

= Do I need a special WhatsApp account? =

For automatic sending, yes. You need a WhatsApp Business account in your own Meta business account.

= Can it find carts abandoned before I installed it? =

It can import unfinished orders (pending, failed or cancelled) from before. WooCommerce never saved the carts themselves, so those cannot be recovered.

= Is it legal to message customers? =

You need their permission. Use the consent note in the popup or the consent checkbox at checkout, and follow the rules in your country.

= What happens to my data if I uninstall it? =

Your carts and settings stay in your database until you delete the plugin; deleting it removes them.

== Changelog ==

= 2.19.8 =
* CSV export no longer writes through fwrite.
* Tested up to WordPress 7.1.

= 2.19.7 =
* Plugin name shortened to WhappCart so the directory address matches the text domain.
* Settings rows no longer print an unescaped variable.

= 2.19.6 =
* Updated the plugin description.

= 2.19.5 =
* Popup, email and order-page texts can now be translated. Romanian (ro_RO) is included. Admin screens are still English.
* The popup has a hidden bot trap and limits saves to 10 per hour per visitor address.
* Delivery-status updates now accept the key only in the request header, not in the URL.

= 2.19.4 =
* The free version no longer shows a disabled Pro button on the cart screen. Added the licence file.

= 2.19.3 =
* Plugin data (carts table and settings) is now removed when the plugin is deleted.
* The popup picture preview updates when a picture address is pasted.
* Fixed the brand picture button in the popup settings.

= 2.19.1 =
* Free version no longer includes Pro settings or code.

= 2.19.0 =
* Pro features now live in separate files, so the free version does not contain paid code.

= 2.18.6 =
* Freemius menu now sits under the WhappCart submenu in WooCommerce.

= 2.18.5 =
* Freemius SDK set up for the new product.

= 2.18.4 =
* Admin page address is now admin.php?page=whappcart.

= 2.18.1 =
* Header shows Start free trial and Upgrade on the free plan, and Account on Pro.

= 2.18.0 =
* Popup: no consent checkbox. Saving counts as consent, with a short note under the button.
* Popup (Pro): brand colours and a brand picture.

= 2.17.0 =
* New design for the add-to-cart popup.

= 2.16.2 =
* Fixed horizontal overflow of admin pages on phones.

== Upgrade Notice ==

= 2.19.5 =
Texts are now translatable. Delivery-status callbacks must send the key in the X-Whappcart-Key header.

= 2.19.4 =
Settings are kept. The admin page address changed to admin.php?page=whappcart.
