=== Request Google Reviews for WooCommerce ===
Contributors: scorejack
Tags: woocommerce, google reviews, review request, whatsapp, reviews
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically ask customers for a Google review after their WooCommerce order completes. Free by email. Optionally send over WhatsApp with ScoreJack.

== Description ==

This plugin asks your customers for a review on your **Google Business Profile** — the public profile that shows up in search and on Google Maps. It does not manage WooCommerce product reviews.

Most stores never ask, and the ones that do usually ask at the wrong moment. This plugin asks automatically, a set number of days after an order is marked complete, with a direct link to your Google profile.

Everything below is free and stays free. There is no locked feature, no trial, and nothing expires.

* Sends a review request by email a configurable number of days after an order completes
* Uses your own Google review short link
* Skips customers whose order was later refunded, cancelled, or failed
* Never asks the same customer twice for the same order
* Full log of every request, including the ones deliberately skipped and why
* Shows what proportion of your orders carry a phone number
* Optionally requires a mobile number at checkout, and labels the field "Mobile number"
* Works with WooCommerce High-Performance Order Storage

= Sending over WhatsApp instead (optional) =

Email review requests work, but most customers do not open them. If you also use ScoreJack, you can paste your API key into the settings screen and the same request is sent over WhatsApp instead — with two polite follow-ups if the customer does not post, and then it stops for good.

WhatsApp replaces the email for that customer rather than sending as well, so nobody is asked twice. Orders without a phone number still go by email.

This is entirely optional. The plugin is fully functional without a ScoreJack account, and if you disconnect, stop paying, or your trial ends, the plugin automatically goes back to sending by email and tells you it has done so. Requests are never silently dropped.

= External service =

This plugin does not contact any external service unless you choose to enter a ScoreJack API key.

If you enter a key, the plugin communicates with ScoreJack (https://www.scorejack.com), a third-party service that sends review requests over WhatsApp:

* **What is sent:** the customer's name, phone number, email address, and your order number, at the point a review request becomes due. Your API key is sent with each request to identify your account.
* **When:** when an order becomes due for a review request, and periodically to check whether your subscription is still active.
* **Why:** so ScoreJack can message that customer on WhatsApp on your behalf.

ScoreJack is a paid service and requires an account. Terms of service: https://www.scorejack.com/terms — Privacy policy: https://www.scorejack.com/privacy

You are responsible for having a lawful basis to send messages to your customers, and for your own privacy disclosures.

== Installation ==

1. Install and activate the plugin.
2. Go to WooCommerce → Review Requests.
3. Paste your Google review link. In your Google Business Profile, open "Read reviews" and then "Get more reviews" to copy your short link.
4. Choose how many days to wait after an order completes.
5. Save.

Optionally, paste a ScoreJack API key on the same screen to send over WhatsApp instead of email.

== Frequently Asked Questions ==

= Does the free version stop working after a while? =

No. The email review requests are permanent and unlimited. Nothing in this plugin expires or unlocks with payment.

= What happens if my ScoreJack subscription ends? =

The plugin detects it, automatically goes back to sending requests by email, and shows a notice telling you it has switched. No customer is missed.

= Will a customer be asked twice? =

No. Each order results in one request, on one channel.

= My store does not collect phone numbers. Will WhatsApp work? =

Only for orders that do have a phone number. The settings screen shows your current phone coverage so you can judge this before connecting anything. Orders without a phone number fall back to email.

There is also a setting that requires a mobile number at checkout and labels the field "Mobile number" rather than "Phone" — customers tend to give a landline when asked for a phone and a mobile when asked for a mobile.

= Does requiring a mobile number change my checkout permanently? =

No. Switching the setting off restores exactly what your checkout had before, and so does uninstalling the plugin. If your checkout already required a phone number, turning our setting off leaves it required.

On the block checkout the field becomes required but keeps WooCommerce's own label, because block field labels are rendered in the browser and cannot be changed from the server. On the classic checkout both the label and the requirement change.

= Does this gate or filter reviews? =

No. Every customer gets the same link to your public Google review page. Review gating is against Google's policies.

= Does it work with High-Performance Order Storage? =

Yes.

== Screenshots ==

1. The settings screen, showing what has been sent and your phone coverage.
2. The activity log.

== Changelog ==

= 1.0.0 =
* Initial release.
