=== ShopGuard for WooCommerce ===
Contributors: onertheme
Tags: woocommerce, block customer, fraud prevention, blacklist, spam
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Block customers in WooCommerce by email, phone, name, or IP address. Stop fraud, spam orders, and repeat offenders before they reach checkout.

== Description ==

**WooCommerce Customer Blocker** gives you full control over who can place orders in your store. Block problematic customers by email address, phone number, full name, or IP address — and protect your business from chargebacks, spam, and repeat offenders.

Phone number matching works with or without a country code, so blocking `+15551234567` will also block `5551234567` and vice versa.

The blocked message shown to customers can include an optional clickable support link, so blocked users know where to go for help.

= Free Features =

* Block by Email Address
* Block by Phone Number (with or without country code)
* Block by Full Name
* Block by IP Address
* Custom blocked message with optional support link
* Activity log with attempt tracking
* One-click block directly from any order
* Works with Classic Checkout and Block Checkout (Store API)
* HPOS / Custom Order Tables compatible
* Clean, modern admin dashboard

= Pro Features =

Upgrade to [WooCommerce Customer Blocker Pro](https://onertheme.com/plugins/shopguard-for-woocommerce) for advanced protection:

* Country and Geo blocking
* Wildcard domain blocking (*@spam.com)
* Auto-block rules after X failed or cancelled orders
* Disposable email address detection
* Bulk CSV import and export
* VIP customer whitelist
* Email alerts on blocked attempts
* REST API access

== Installation ==

1. Upload the `shopguard-for-woocommerce` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Make sure WooCommerce is installed and active.
4. Go to **Customer Blocker** in your admin menu to start blocking customers.

== Frequently Asked Questions ==

= Does the plugin work with the WooCommerce Block Checkout? =

Yes. The plugin hooks into both the Classic Checkout and the Block-based Checkout (Store API), so it works regardless of which checkout your theme uses.

= Is it compatible with HPOS (High-Performance Order Storage)? =

Yes. The plugin fully supports WooCommerce HPOS / Custom Order Tables and declares compatibility explicitly.

= How does phone number matching work? =

Phone numbers are compared by their digits only. Country code prefixes (like +1 or 0044) are handled automatically, so blocking a number with a country code will also block the same number without one, and vice versa.

= Can I show customers a link to contact my support team when they are blocked? =

Yes. In **Customer Blocker > Settings**, fill in the **Support Link URL** field with your contact page URL. The link will be appended automatically to the blocked message shown at checkout. You can also customise the link text.

= Will my blocklist data be deleted if I uninstall the plugin? =

No. Data is preserved on uninstall by default to prevent accidental loss. If you want the plugin to clean up all data on uninstall, enable the **Delete data on uninstall** option before removing the plugin (available in the Settings page).

= What capability is required to manage the blocklist? =

The plugin requires the `manage_woocommerce` capability, which is granted to Shop Manager and Administrator roles by default.

== Screenshots ==

1. Dashboard overview showing blocked entry counts and recent blocked attempts.
2. Blocklist manager — add and remove entries by email, phone, name, or IP.
3. Settings page — configure the blocked message, support link, and logging options.
4. Activity log — paginated list of every blocked checkout attempt.
5. One-click block from a WooCommerce order detail page.

== Changelog ==

= 1.0.2 =
* Initial release.

== Upgrade Notice ==

= 1.0.2 =
Initial release.
