=== Blacklist Manager - WooCommerce Anti-Fraud, Blacklist & Checkout Verification ===
Contributors: yoohw, baonguyen0310
Tags: woocommerce anti fraud, blacklist, checkout, fraud prevention, form spam
Requires at least: 6.3
Tested up to: 7.0
WC tested up to: 10.9
Requires PHP: 7.4
Stable tag: 2.2.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Block risky WooCommerce orders, spam signups, and form submissions with blacklist rules plus checkout email and phone verification.

== Description ==

**Blacklist Manager** is a WooCommerce blacklist, anti-fraud, and spam prevention plugin for stores that need to block fake orders, suspicious customers, spam registrations, and unwanted form submissions.

Use blacklist rules for **phone numbers**, **email addresses**, **IP addresses**, and **email domains** at WooCommerce checkout, registration, comments, product reviews, REST API orders, and supported WordPress forms. Built-in checkout email verification and phone verification can also challenge risky customers before an order is accepted.

The plugin works with WooCommerce Classic Checkout, WooCommerce Checkout Blocks, Contact Form 7, Gravity Forms, and WPForms.

[Premium version](https://yoohw.com/product/blacklist-manager-premium/) | [Global Blacklist](https://yoohw.com/global-blacklist-plan/) | [Documentation](https://yoohw.com/docs/category/woocommerce-blacklist-manager/) | [Support](https://yoohw.com/support/) | [Demo](https://sandbox.yoohw.com/demo/yobm_demo.html)

== Key Features ==

* **WooCommerce checkout protection**: Block or review orders using phone, email, IP address, and email domain rules.
* **Suspect and blocked lists**: Review risky identities before moving confirmed abuse to the blocklist.
* **Fast blacklist management**: Add entries from the dashboard or directly from the WooCommerce order screen.
* **Registration protection**: Stop signups that match blocked emails, IP addresses, or email domains.
* **Comment and review blocking**: Prevent comments and product reviews from blacklisted emails.
* **Form spam protection**: Check Contact Form 7, Gravity Forms, and WPForms submissions against blacklist data.
* **Checkout email verification**: Require a verification code before allowing checkout to continue.
* **Checkout phone verification**: Require an SMS verification code for phone-based checkout validation.
* **WooCommerce REST API protection**: Block blacklisted identities from creating orders through external apps or integrations.
* **Custom notices and alerts**: Customize customer-facing block messages and admin email alerts.
* **Dashboard stats**: Review blacklist entries and detection attempts from the admin area.

== Checkout Compatibility ==

Blacklist Manager supports WooCommerce Classic Checkout, [WooCommerce Checkout Blocks](https://woocommerce.com/checkout-blocks/), and many third-party checkout plugins that use standard WooCommerce checkout and order creation flows.

== Global Blacklist Decisions ==

Blacklist Manager can connect your store to **Global Blacklist Decisions**, a fraud-prevention service that checks order identities such as email, phone, IP address, address, and email domain against broader risk data.

[Learn more about Global Blacklist Decisions](https://yoohw.com/global-blacklist-plan/)

== Premium Features ==

Blacklist Manager Premium adds deeper fraud review and automation for stores that need more than manual blacklist rules:

* Risk scoring for blacklist, identity, IP, address, payment, device, and order pattern signals.
* Automation rules to auto-suspect, auto-block, or auto-review orders.
* Payment intelligence for Stripe, PayPal, Mollie, Braintree, WooPayments, AVS, card country, and payer mismatch signals.
* Device identity checks to link repeat abuse across emails, phones, IPs, addresses, and accounts.
* Advanced blocking for customer name, address, device, disposable email, disposable phone, country, VPN, and proxy signals.
* Activity logs, import/export, cleanup tools, permissions, multi-store sync, CAPTCHA, SMS, IP intelligence, geocoding, and email validation integrations.

[Explore Premium](https://yoohw.com/product/blacklist-manager-premium/)

== Supported Plugins and Integrations ==

= Supported plugins =

* [WooCommerce](https://wordpress.org/plugins/woocommerce/)
* [Contact Form 7](https://wordpress.org/plugins/contact-form-7/)
* [Gravity Forms](https://www.gravityforms.com/)
* [WPForms](https://wordpress.org/plugins/wpforms-lite/)

= Premium integrations =

* WooCommerce Stripe Gateway, Payment Plugins for Stripe WooCommerce, WooCommerce PayPal Payments, Payment Plugins for PayPal WooCommerce, Braintree for WooCommerce, Mollie Payments for WooCommerce, and WooPayments.
* Cloudflare, reCAPTCHA v3/v2, hCaptcha, IP-api, BigDataCloud, ZeroBounce, NumCheckr, Google Maps, Yo Credits, Twilio, and Textmagic.

== Use Cases ==

* Block fake WooCommerce orders before payment review.
* Prevent repeat abuse from known phone numbers, email addresses, IP addresses, and domains.
* Reduce spam registrations, comments, product reviews, and form submissions.
* Require email or phone verification during checkout.
* Review suspicious customers before moving them to the blocklist.
* Use Global Blacklist Decisions as an additional fraud signal.

== Installation ==

1. Install the plugin from **Plugins > Add New**, or upload the plugin folder to `wp-content/plugins`.
2. Activate **Blacklist Manager** from the WordPress Plugins screen.
3. Go to **Blacklist Manager > Settings** and enable the checks that match your workflow.
4. Add phone numbers, email addresses, IP addresses, or domains to the Suspects or Blocklist lists.
5. Configure checkout email or phone verification if you want customers to verify their details before checkout continues.

== Frequently Asked Questions ==

= Do I need to configure settings after installation? =

Yes. Go to **Blacklist Manager > Settings** and enable checks for checkout, registration, comments, reviews, forms, or REST API orders.

= What is the Suspects list for? =

The Suspects list gives you a review step before fully blocking a customer. Use it when an identity looks risky but should not be rejected immediately.

= Can Blacklist Manager stop checkout through PayPal, Stripe, or another payment gateway? =

Yes. Blacklist Manager checks customer details during the WooCommerce checkout and order creation flow before the payment gateway becomes the final decision point. Test custom checkout flows on staging.

= Can this plugin stop contact form spam? =

Yes. Blacklist Manager supports Contact Form 7, Gravity Forms, and WPForms submissions.

= Does Blacklist Manager slow down my site? =

Blacklist checks run only when needed, such as checkout, registration, comment submission, form submission, or API order creation. The checks are designed to stay lightweight.

= Are Premium features required? =

No. The free plugin includes blacklist management, checkout protection, form protection, verification, notices, and dashboard stats. Premium adds risk scoring, automation, payment intelligence, device identity, activity logs, multi-store sync, and advanced integrations.

= Does Global Blacklist Decisions share data? =

Global Blacklist Decisions is a connected fraud-prevention service. Data exchange depends on the Global Blacklist connection and checks you enable. Review the Global Blacklist settings, plan details, and privacy terms before using it in production.

== Changelog ==

= 2.2.8 (Jul 12, 2026) =
* Improve: Prevented the device identity seed cookie from being set server-side on product pages to preserve product page cache behavior.
* Improve: Deferred checkout device identity payload generation until the final Classic checkout submit or Store API checkout POST to reduce repeated checkout refresh work.
* Improve: Debounced checkout email and phone verification scripts so field validation is not repeatedly triggered by normal checkout refreshes.
* Improve: Added short checkout-attempt caching for strict Global Blacklist checks using cart, WooCommerce session, customer contact, IP, and browser context to avoid recalculating risk on validation retries.
* Improve: Added stable integration hooks (`wc_blacklist_manager_order_suspected`, `wc_blacklist_manager_order_blocked`, `wc_blacklist_manager_order_blacklist_removed`, and `wc_blacklist_manager_order_suspect_detected`) with structured payloads for customer intelligence and external audit integrations.

For older release notes, see `changelog.txt`.
