=== HULO Review Requests ===
Contributors: huloglobal
Tags: reviews, trustpilot, review request, customer reviews, google reviews
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

Review invitation e-mails that link to your free Trustpilot page, Google or Reviews.io. For HULO Payments customers, lists and WooCommerce orders.

== Description ==

HULO Review Requests asks your customers for a review by e-mail, in a way that works with the **free** Trustpilot plan. You do not need Trustpilot's paid automatic invitation service.

The review button links to Trustpilot's public "evaluate" page for your domain (`https://www.trustpilot.com/evaluate/yourstore.com`). Anyone can leave a review there, so the reviews you get are ordinary organic reviews. You can point the button at Google reviews, Reviews.io or any link you like instead.

Works on any WordPress site. With the HULO Payments plugin, every customer who pays is listed for an invitation. With WooCommerce it also invites from orders and can ask for product reviews.

**What this plugin does**

* **Invite customers from a list.** Paste names and e-mail addresses, or upload a CSV, and send up to 20 invitations at a time.
* **Customers who paid.** After a successful HULO Payments payment, the customer appears on the Customers tab, ready to invite (up to 20 at a time).
* **WooCommerce orders (when WooCommerce is active).** Use "Send review invitation" on any order, or the bulk action on the orders list (up to 20 orders per action). Ask for a store review, product reviews or both; each product links to the reviews section of its own page.
* **Rules on every invitation.** Opt-outs, exclusions, a per-customer cooldown and an hourly limit are applied, and each customer is invited only once for each payment, order or list.
* **Review page set-up.** Choose Trustpilot, Google (Place ID), Reviews.io or a custom link. The plugin builds the review link for you.
* **Invitation e-mail.** Edit the subject and HTML body with `{{firstName}}`, `{{orderCode}}`, `{{businessName}}`, `{{reviewButton}}` and other variables. See a live preview and send yourself a test.
* **One-click unsubscribe.** Every e-mail has a signed unsubscribe link and RFC 8058 `List-Unsubscribe` headers. The link opens a confirmation page, so mail scanners that prefetch links cannot unsubscribe anyone by accident.
* **Link click tracking.** The review button goes through a signed redirect on your own site, which records the first click and forwards the customer to the review page.
* **Overview and activity log.** Invitations sent, review links clicked and click-through rate, skips, failures and opt-outs, plus a full log you can filter.

E-mail goes through your site's normal WordPress e-mail (`wp_mail`), so any SMTP plugin you already use applies. With WooCommerce, the plugin supports High-Performance Order Storage and the Cart and Checkout blocks.

= Review Requests Pro =

The free plugin sends invitations when you ask. The separate **Pro** add-on adds:

* Automatic sending: each customer is invited on their own, the set number of days after they pay (or their WooCommerce order is completed), with your rules, the cooldown, exclusions and opt-outs applied
* Scheduling for pasted lists (no limit of 20)
* Resend, overriding exclusions, the cooldown or a previous invitation (opt-outs are always honoured)
* Your live Trustpilot or Google star rating and review count in the e-mail
* Exclusions for staff, wholesale accounts and whole e-mail domains
* A weekly report e-mail

Pro comes with a 14-day evaluation and needs no card to start. See [huloglobal.com/wordpress-plugins/review-requests](https://huloglobal.com/wordpress-plugins/review-requests/).

== Installation ==

1. Install this plugin from Plugins → Add New, or upload the zip, and activate it.
2. Go to **HULO → Review Requests → Settings**. Enter your business name, choose the review platform and enter your Trustpilot domain (or Google Place ID), then save.
3. On the **E-mail** tab, adjust the invitation, check the preview and send yourself a test.
4. On the **Customers** tab, paste a list of customers or invite the customers who paid. With WooCommerce, you can also open a completed order and press **Send review invitation**, or use **Send review invitation** in the orders list's Bulk actions.

== Frequently Asked Questions ==

= Do I need WooCommerce? =

No. The plugin works on any WordPress site, with a pasted or CSV list of customers and with customers who paid through the HULO Payments plugin. WooCommerce adds orders and product reviews.

= Do I need a paid Trustpilot plan? =

No. The review button links to Trustpilot's public review page for your domain, which is part of the free plan. Reviews left there are organic Service Reviews.

= Can I use Google reviews instead? =

Yes. Choose "Google reviews" and enter your Google Place ID. Reviews.io and custom links work the same way.

= Does it send e-mails on its own? =

No. The free plugin sends an invitation only when you ask: from the Customers tab, from an order, or with the orders bulk action (up to 20 per send). Automatic sending after each payment or order is in the Pro add-on.

= Who is skipped? =

Customers who unsubscribed, excluded addresses or domains, customers invited within the cooldown (120 days by default), refunded or cancelled payments and orders, and anyone already invited for the same payment or order. No more than the hourly limit (200 by default) goes out in any hour.

= How does unsubscribing work? =

Each e-mail carries a signed link to a confirmation page on your site, plus the one-click `List-Unsubscribe` headers that mail clients use. Customers who unsubscribe are never invited again. The unsubscribe endpoint is rate-limited.

= What happens to my data if I uninstall? =

Nothing is deleted unless you tick "Delete all Review Requests data" under Settings → Rules and advanced settings before uninstalling.

== Screenshots ==

1. Overview: invitations sent, review links clicked, skips, failures and opt-outs.
2. Customers: paste a list or invite customers who paid.
3. Settings: review platform and rules.
4. E-mail editor with a live preview.
5. With WooCommerce: the review box on the order screen.

== Changelog ==

= 0.1.0 =
* First release: invitations to a pasted or CSV list and to HULO Payments customers (up to 20 per send); with WooCommerce, from any order or the orders bulk action, with WooCommerce product reviews as a destination. Review page set-up (Trustpilot, Google, Reviews.io, custom link), invitation editor with live preview and test send, cooldown and hourly limit, signed one-click unsubscribe, review-link click tracking, overview, activity log and dashboard widget.

== External services ==

This plugin does not contact any external service by itself.

The invitation e-mails contain links to the review platform you choose, for example Trustpilot (`https://www.trustpilot.com/evaluate/<your domain>`), Google (`https://search.google.com/local/writereview?placeid=<your Place ID>`) or Reviews.io. Nothing is sent to those services by the plugin; your customer's browser opens the page only when they click the button. The click first goes through a redirect on your own site, which records that the link was clicked. Trustpilot terms and privacy: [legal.trustpilot.com](https://legal.trustpilot.com/). Google: [terms](https://policies.google.com/terms), [privacy](https://policies.google.com/privacy). Reviews.io: see [reviews.io](https://www.reviews.io/) (terms and privacy policy linked in its footer).
