=== Stackedboost Email Guard for WooCommerce ===
Contributors: stackedboost
Tags: woocommerce, email validation, disposable email, fraud prevention, checkout
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Block disposable, mistyped, and blocklisted email addresses at WooCommerce checkout — before the order is placed.

== Description ==

Bad email addresses cause failed deliveries, chargebacks, fake accounts, and support tickets. Email Guard checks the customer's email at checkout and stops the risky ones before the order goes through — all locally, with no account required.

**Free version (this plugin):**

* Blocks known disposable and temp-mail domains at checkout
* Catches common typos and suggests the correct domain ("Did you mean gmail.com?")
* Enforces your own custom domain blocklist
* Also validates email on account registration
* A dashboard showing what it actually caught — counts, corrected typos and blocked domains
* 100% local — no external service, no account, no data leaves your site

**Email Guard Pro (optional, from https://stackedboost.com/woocommerce/stackedboost-email-guard/):**

* 120,000+ disposable-domain list, updated continuously
* DNS / MX deep scan to catch non-deliverable domains
* Post-order risk scoring, order tagging, and instant alerts
* Hosted risk dashboard

Pro is a separate add-on from Stackedboost and is not required to use the free version. Everything listed above under the free version keeps working whether or not you ever buy it.

== Installation ==

1. Upload the plugin to `/wp-content/plugins/` or install it from the Plugins screen.
2. Activate it through the **Plugins** screen.
3. Make sure WooCommerce is active.
4. Go to **WooCommerce → Email Guard** to configure blocking, typo suggestions, and your custom blocklist.

That is the whole setup for the free version — there is no account to create and nothing to connect.

If you bought Email Guard Pro, paste your licence key into the **Email Guard Pro licence** box on that same screen and press **Activate licence**. One licence covers one site; you can move it to another site from your account at any time.

== Frequently Asked Questions ==

= Does this send customer data anywhere? =

No. The free version performs all checks locally on your own server using bundled lists. Nothing is sent to any external service.

= Does it require WooCommerce? =

Yes. Email Guard protects the WooCommerce checkout and account registration.

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

Yes. Email Guard validates both the classic (shortcode) checkout and the newer Cart/Checkout blocks (Store API). On the block checkout, a blocked email stops the order when "Place order" is clicked.

= Will it block real customers? =

The built-in lists are conservative and target disposable providers and near-certain typos. You stay in control via the custom blocklist and the on/off toggles.

= What does Pro add? =

A much larger disposable list, DNS/MX deep scans, post-order risk scoring, and alerts — powered by the Stackedboost API. Pro is optional and sold separately at https://stackedboost.com/woocommerce/stackedboost-email-guard/.

= Does the free version phone home or check a licence? =

No. The free version never contacts any server — there is no licence check, no telemetry, and no upsell nag beyond the settings screen. The plugin only makes an outbound request if you deliberately activate a Pro licence key, and then only to the Stackedboost API.

= What happens if my Pro licence expires? =

The site quietly returns to the free version: local blocking, typo suggestions and your custom blocklist keep working exactly as before. Nothing is disabled and no data is removed.

== Screenshots ==

1. A disposable address refused at checkout, before the order is created.
2. A likely typo caught, with the correct domain suggested.
3. The Email Guard dashboard: what was blocked, what was corrected, and your settings.

== Changelog ==

= 1.1.0 =
* New: a dashboard at WooCommerce → Email Guard showing how many risky addresses were refused, which typos were corrected, and which domains were blocked.
* Counts are kept on your own site and never sent anywhere. Domain names only — no customer address is stored.
* New: test any address from the settings screen and see exactly what checkout would do. Test checks do not affect your counts.
* New: preview the dashboard with example figures before your own activity builds up. The example is never saved.
* Redesigned the settings screen around that information.

= 1.0.1 =
* The "Buy a licence" button now opens the product page instead of the checkout directly, so you can read what Pro adds before paying.
* Added the plugin's product page to its header.
* No changes to how email checking works.

= 1.0.0 =
* Initial release: local checkout + registration email validation (disposable, typo, custom blocklist).

== Upgrade Notice ==

= 1.0.1 =
Links only — checkout validation is unchanged.

= 1.0.0 =
Initial release.
