=== HULO Visitor Analytics Pro ===
Contributors: huloglobal
Tags: analytics, goals, conversions, abandoned cart, live visitors
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Pro add-on for HULO Visitor Analytics: conversion goals for pages, forms and payments, live visitors, CSV export and weekly reports.

== Description ==

Requires the free **HULO Visitor Analytics** plugin. Works on any WordPress site. With WooCommerce it also detects abandoned carts and sends reminders. Pro adds to the HULO → Visitor Analytics page:

* **Conversion goals** of three kinds:
  * **Page reached**: a URL pattern (`*` within a segment, `**` across segments), for example a thank-you page.
  * **Form submitted**: any form on the site, matched by its id, name or action path, optionally only on certain pages.
  * **Payment succeeded**: a payment taken with the HULO Payments plugin, optionally matched by reference or description. A goal value of 0 counts the amount paid. Offered when HULO Payments is installed.
* **Live visitors** in the last five minutes, refreshed every 10 seconds.
* **CSV export** of events (90 days).
* **Weekly report** by e-mail every Monday, and a setup checklist.

**With WooCommerce**

* **Abandoned carts.** The basket is read server-side from WooCommerce whenever it changes, in the classic cart and checkout and in the Cart and Checkout blocks. A cart idle for the window you choose (30 minutes by default) is marked abandoned. An order on any device marks it converted and counts the recovery.
* **Reminder e-mails.** Up to two reminders (1 hour and 24 hours by default). They go through a WooCommerce e-mail you can edit under WooCommerce → Settings → Emails. Every reminder has an unsubscribe link and RFC 8058 one-click unsubscribe headers. Opt-outs are honoured permanently.
* **Basket restore links.** Signed, expiring links that rebuild the basket in the shopper's current session without doubling items already there, then open the cart page. Attribution: link sent → opened → basket restored → ordered through the link.
* **Slack alerts** for abandoned carts above a value you set, and CSV export of abandoned carts.
* Personal-data export and erase for saved baskets.

Includes a 14-day evaluation with every feature on and no card. If the licence lapses, the Pro features pause. Goals, carts and settings are kept, and links already e-mailed to shoppers and unsubscribe links keep working.

== Installation ==

1. Install and activate the free HULO Visitor Analytics plugin.
2. Upload this zip under Plugins → Add New → Upload, and activate it.
3. Open HULO → Visitor Analytics. The evaluation starts automatically; subscribe from the banner at any time.

== Frequently Asked Questions ==

= Do I need WooCommerce? =

No. Goals, the live view, CSV export and the weekly report work on any WordPress site. Abandoned carts need WooCommerce.

= How are payment goals attributed to visits? =

When HULO Payments reports a successful payment, the completion is tied to the visitor's current session (recognised by the cookieless identity of the browser that completed the payment). If no session is found, the completion is still counted for the goal.

= Which checkouts are supported for abandoned carts? =

The classic shortcode cart and checkout and the Cart and Checkout blocks.

== External services ==

* **HULO licence server (elite.charity)**: once a day the add-on registers the evaluation, checks the licence revocation list and sends an anonymous heartbeat (plugin version, a hashed site id, and 30-day counts such as visitors and carts recovered, no personal data). When you subscribe from the banner, the checkout opens on elite.charity. Terms: https://huloglobal.com/legal/terms/
* **Updates (huloglobal.com)**: checks https://huloglobal.com/wordpress-plugins/ for new versions of this add-on.
* **Slack** (only if you enter a webhook URL, WooCommerce only): posts the basket value, items and the shopper's e-mail address when a cart is abandoned. https://slack.com/terms-of-service

== Changelog ==

= 0.1.0 =
* First release: conversion goals for pages, forms and HULO Payments payments, live view, CSV export and weekly report; with WooCommerce, abandoned-cart detection, reminder e-mails, restore links and attribution, and Slack alerts.
