WHMCS SPAM CLEANUP

Description

# Spam Client Cleanup for WHMCS

Safely identify and remove **spam clients**, **orphaned users**, and **invalid user-client links** from your WHMCS system.
Designed for **WHMCS 8.13+**, this addon improves database hygiene, reduces clutter, and protects your system from spam signups.

—

## ✨ Features
– 🔍 **Preview Mode** – Review empty clients, orphaned users, and invalid links before deleting.
– 🗑️ **Safe Cleanup** – Bulk removal or per-row manual deletion.
– 📂 **CSV Export** – Download lists of flagged clients, users, or links.
– 🛡️ **Spam Domain Filters** – Automatically flag clients from common spam domains.
– ✅ **Allowlist Protection** – Ensure VIP/test domains are never deleted.
– ⚡ **Optimize Tables** – Optionally run `OPTIMIZE TABLE` after cleanup.
– 🕑 **Daily Report Mode** – Generate preview-only reports in WHMCS Activity Log during cron.
– 🔐 **Licensing System** – Fully integrated with WHMCS Licensing Addon for secure distribution.

—

## 📦 Installation
1. Upload the module files to your WHMCS installation:
2. In your WHMCS admin area:
– Go to **System Settings → Addon Modules**
– Find **Spam Client Cleanup**
– Click **Activate**

—

## ⚙️ Configuration
After activation, configure the module under **Addons → Spam Client Cleanup → Settings**:

– **Optimize Tables** – Run `OPTIMIZE TABLE` on key WHMCS tables after cleanup.
– **Spam Domains** – Enter a list of domains considered spam (one per line).
– **Allowlist Domains** – Enter domains that must never be deleted (e.g., `mycompany.com`).
– **Auto Delete Spam Domains** – Auto-delete clients/users from spam domains (instead of just flagging).
– **Daily Report (No Delete)** – Log preview-only results in WHMCS Activity Log during cron.
– **License Key** – Enter the key provided after purchase (via WHMCS Licensing Addon).

—

## 🚀 Usage
1. Navigate to **Addons → Spam Client Cleanup**.
2. Select **Preview Mode** to see flagged records.
3. Use **per-row delete buttons** for manual removals, or click **Run Cleanup** for bulk actions.
4. Export flagged lists as CSV for external review.

—

## 🛡️ Licensing
– This module requires a **valid license key** issued via the WHMCS Licensing Addon.
– Enter the key in the addon settings page.
– ✅ Free test keys may be available for beta testers.

—

## 🧪 Compatibility
– WHMCS **8.13+**
– PHP **7.4 / 8.1 / 8.2**
– MySQL **5.7+ / MariaDB 10.3+**

—

## 📝 Changelog
### v2.2
– Added per-row delete buttons
– Added CSV export for preview lists
– Added allowlist protection for safe domains
– Integrated WHMCS Licensing Addon
– Improved UI/UX for admin interface

—

## 📧 Support
For support, licensing, or feature requests, please contact:
**[STARTOPUB / SUPPORT]**
– Email: [support@startopub.fr]
– Website: [https://startopub.fr]

—

## ⚠️ Disclaimer
Use this module at your own risk. Always create a **full database backup** before running cleanup actions.