=== CleanVerify for WooCommerce ===
Contributors: fahimmurshed
Donate link: https://fahimm.com
Tags: woocommerce, cleanup, verification, security, anti-spam
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

All-in-one customer verification, anti-fraud protection, quarantine trash recovery, and inactive account cleanup for WooCommerce.

== Description ==

**CleanVerify for WooCommerce** is a high-performance optimization and account security suite designed for WooCommerce store owners. It keeps your customer database lean, fast, and free of fake signups, spam registrations, and abandoned zero-order accounts.

Over time, online stores accumulate thousands of dormant customer accounts generated by spam bots, disposable email signups, abandoned carts, or test registrations. These accounts bloat your database, slow down order queries, skew marketing analytics, and increase hosting overhead. CleanVerify provides an intuitive, high-aesthetic wp-admin dashboard that gives you total control over account maintenance and verification.

---

### 🚀 Free Features (Included in Core)

* **Zero-Order Customer Detection:** Accurately filters customer-role accounts that have never completed a purchase, cross-checking both User ID and guest billing emails.
* **Configurable Age Buffer:** Filter candidates by account age (e.g. older than 30, 60, or 90 days) with 1-click quick presets so recent shoppers are never touched.
* **Instant CSV Export:** Export filtered or selected customer data to CSV with UTF-8 BOM encoding for seamless compatibility with Microsoft Excel and Google Sheets.
* **Multi-Account Bulk Actions:** Select individual accounts or bulk-select all candidates for swift, controlled management.
* **Role Safety Shield:** Hardcoded protection ensuring Administrators, Editors, Authors, and Shop Managers are never flagged or accidentally modified.
* **Modern Responsive Dashboard:** Clean, intuitive card-based user interface with instant tab switching and smooth interactions.
* **Instant Client-Side Tab Navigation:** Seamlessly switch between dashboard views with zero page reloads and browser history support.
* **Enterprise Security Standards:** Built strictly with WordPress security best practices, strict nonce validation, `delete_users` capability checks, and confirmation barriers.
* **100% Zero Remote CDN Dependencies:** Completely self-contained local assets, SVGs, and styles with zero external CDN calls.

---

### ⚡ PRO Features (CleanVerify Pro)

Upgrade to **CleanVerify Pro** to unlock enterprise-grade spam protection, automated background maintenance, account recovery, and privacy compliance:

* **Cloudflare Turnstile Anti-Spam:** Block malicious bots and fake account spam at WooCommerce registration, checkout, and login with privacy-first Cloudflare Turnstile CAPTCHA.
* **Disposable & Temporary Email Shield:** Automatically detect and block throwaway email services (10minutemail, Mailinator, GuerrillaMail, and 500+ disposable domains) during registration.
* **One-Time Passcode (OTP) Email Verification:** Require customers to verify their email address via a secure 6-digit verification code before account activation or first checkout.
* **Automated Background Cron Pruning:** Set it and forget it. Schedule automatic daily, weekly, or monthly background cleanup tasks without manual intervention.
* **Quarantine Trash Bin (30-Day Soft-Delete & Restore):** Safely move pruned customers to a 30-day quarantine bin before permanent removal, with instant 1-click account and meta restoration.
* **GDPR & CCPA Account Anonymization:** Pseudonymize and mask personal data (names, emails, addresses, phones) while preserving historical order analytics and financial reporting integrity.
* **Comprehensive Audit Trail & Activity Logs:** Track all verification events, deletions, restorations, and blocked bot attempts in a dedicated admin audit log.

---

== Installation ==

1. Upload the `cleanverify-for-woocommerce` folder to `/wp-content/plugins/`, or install directly via the WordPress Plugins menu.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **CleanVerify** in your WordPress admin sidebar (positioned right after **WooCommerce**).
4. Review your inactive customer metrics, set your age filter, export CSV backups, or clean inactive accounts.

== Frequently Asked Questions ==

= Does CleanVerify delete customer accounts automatically in the Free version? =

No. In the free version, accounts are only deleted when you manually review candidates, select checkboxes, and explicitly confirm deletion. Automated background pruning is available in CleanVerify Pro.

= Does CleanVerify protect past guest checkout customers? =

Yes! CleanVerify checks both the customer's WordPress User ID and any WooCommerce orders associated with their billing email address. If a customer previously placed an order as a guest using the same email, they are protected and will never be flagged.

= Can I export a customer backup before performing a cleanup? =

Yes. CleanVerify includes an export tool allowing you to export all filtered candidates or specifically selected accounts to a CSV file before running any cleanup.

= Can I recover a deleted account? =

In the Free version, deletion is permanent. If you need safety nets, **CleanVerify Pro** includes a **Quarantine Trash Bin** that holds removed accounts for 30 days and allows 1-click complete restoration of user accounts and metadata.

= Are my administrator and shop manager accounts safe? =

Yes. CleanVerify has a multi-layer role protection mechanism. Privileged roles such as Administrator, Editor, and Shop Manager are excluded from candidate queries and blocked from deletion even if submitted.

= Does this plugin load external scripts or CDNs? =

No. CleanVerify strictly adheres to privacy and security standards. All icons, SVGs, styles, and scripts are bundled 100% locally with zero external network requests.

== Screenshots ==

1. CleanVerify Customer Cleanup Dashboard with real-time metrics and presets.
2. CleanVerify Pro Anti-Spam & Automated Background Maintenance.
3. Quarantine Trash Bin with 1-Click Customer Account Restoration.
4. High-performance clean dashboard interface.

== Changelog ==

= 1.0.0 =
* Initial release of CleanVerify for WooCommerce.
* Safe inactive customer detection cross-referenced with order history and billing emails.
* Instant CSV Export with Excel UTF-8 BOM support.
* Modern reactive dashboard with instant tab switching.
* Full compatibility with WooCommerce HPOS (High-Performance Order Storage).