=== Aluleth Reviews ===
Contributors: aluleth
Tags: reviews, product reviews, customer reviews, review request, testimonials
Requires at least: 7.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Reviews from your real customers: a review request after each order or appointment, stars, text and photos, moderation, replies and blocks.

== Description ==

Aluleth Reviews asks your customers for a review after a real order or appointment, and shows their reviews on your site. The email has clickable stars; the customer lands on a short review page, with no account and no password, and writes about each product or service they bought. You read every review before it goes live, answer it in public if you like, and show the reviews anywhere with blocks.

Everything runs on your site: no outside service, no fee per review, and no review is ever written, changed or hidden for its rating.

**Review requests**

* After an order paid with WooCommerce, FluentCart or Aluleth Commerce (7 days after payment by default), and after a completed appointment with Aluleth Appointments (3 hours after by default).
* Every customer is asked, whatever they thought: there is no filtering of unhappy customers.
* One request per email address in 30 days by default, an opt-out link in every email, and the marketing suppression list of the Aluleth suite is respected.
* Refunded, cancelled or deleted orders and cancelled or missed appointments are not asked; the order is checked again just before the email goes. Subscription renewals are not asked again.
* Send a request again, now, or not at all from the Requests list, with the rate of requests that became reviews.

**The review page**

* The stars of the email are already chosen. Then a title, a text and up to 3 photos for each product or service, and a consent box for publishing.
* The name shown is the first name and the initial of the last name by default.
* Photos are checked, turned the right way up, resized and saved again, so camera data (such as the place where the photo was taken) is dropped.
* Photos are shown nowhere until you publish the review (the files get random names).
* A hidden field keeps robots out.

**Reviews of your business**

* A "Leave a review" block for reviews of the business itself. These reviews always wait for you, as they do not come from a known order, and the block has a limit per connection against robots.
* Their authors are added to your contacts only once you publish the review.

**Moderation and answers**

* To read, published, spam and trash, with filters and bulk actions.
* Publish everything by hand, or publish the reviews of verified customers at once. Moderation is about the content (spam, abuse, personal details), never about the rating.
* A public answer under any review, and an email to the customer the first time you answer.
* An email to your team for each new review.
* A "verified" mark on reviews that come from an order or an appointment.

**Product reviews stay in your store**

* Published product reviews are also written into the store's own reviews (WooCommerce, FluentCart or Aluleth Commerce), with their rating, the verified mark and your answer. Product pages, star averages and the store's own structured data keep working as before.
* A review held back, marked as spam or deleted is removed from the store too.

**Show your reviews**

* Blocks: "Reviews" (filter by stars, sort, pages, with a summary), "Rating summary" (average and bars), "Star badge" and "Leave a review". Shortcodes for the same: `[aluleth_reviews]`, `[aluleth_reviews_summary]`, `[aluleth_reviews_badge]`, `[aluleth_review_form]`.
* A short text that says how reviews are collected and checked, under the reviews (written for you, or your own).
* Follows your theme's fonts and colours, with one accent colour of your choice.

**Works with the Aluleth suite**

* The reviewer is added to the shared Aluleth contacts (empty fields only), with "Left a review" in the timeline and as a tag (you can turn it off). They are not subscribed to any newsletter.
* Aluleth CRM automations can start when someone leaves a review or when it is published.

**Privacy**

* Uses the WordPress tools to export the reviews and review requests of a person and to erase them (with their photos and the copies in the store), and suggests a text for your privacy policy.
* The opt-out list keeps only a fingerprint (hash) of the email address. An erased person is added to it, so they are not asked again.
* Nothing is sent to an outside service.

== Installation ==

1. Install and activate the plugin.
2. Go to Aluleth › Reviews › Settings. Check when requests are sent and how reviews are published.
3. Create a page for your reviews (with the "Reviews" block) and choose it as the "Reviews page": the review links of the emails open there.
4. Add the "Rating summary", "Star badge" or "Leave a review" blocks where you want them.

== Frequently Asked Questions ==

= Which shops does it work with? =

WooCommerce, FluentCart and Aluleth Commerce for orders, and Aluleth Appointments for appointments. Without a shop, the "Leave a review" block still collects reviews of your business.

= Are the reviews checked? =

A review that comes from a request is linked to a real order or appointment and gets the "verified" mark. Reviews from the "Leave a review" block are not verified and always wait for you. You read them before they go live; you choose to publish verified ones at once if you prefer.

= Can I hide bad reviews? =

The plugin does not filter reviews by rating, and the requests go to every customer. You can hold back or delete a review that breaks your rules (spam, abuse, personal details), as with any comment. The rules on reviews of your country apply to you; this plugin is not legal advice.

= Do I keep my store's reviews? =

Yes. Existing store reviews stay where they are. Published product reviews are added to them.

= Which languages? =

English, French; the review page, the blocks and the emails also in Spanish, German and Portuguese.

= What happens when I delete the plugin? =

Your reviews stay, unless you tick "Aluleth Reviews" under Aluleth › Settings › Delete on uninstall. Copies in the store's own reviews stay in the store.

== Changelog ==

= 0.1.2 =
* Shared Aluleth screens (Aluleth core 0.18.9): Aluleth › Connections and the form options of Aluleth › Settings › Security show only when an active Aluleth plugin uses them. With Aluleth Reviews, Security keeps the blocklist and the Akismet check that the review form uses, with no text about forms or entries.

= 0.1.1 =
* French: the shared Aluleth screens (Dashboard, Contacts, Import, Connections, Access, Security…) are now translated.
* Inside the complete Aluleth Reviews Pro, the plugin's functions are only declared by the copy that runs.

= 0.1.0 =
* First version: review requests after orders (WooCommerce, FluentCart, Aluleth Commerce) and appointments (Aluleth Appointments), review page with stars, text and photos, business reviews, moderation and public answers, emails, copies in the store's own reviews, blocks and shortcodes, contacts and CRM events, privacy tools, French, Spanish, German and Portuguese.
