Mass Delete Users by Email
| AI Plugin Information | |
|---|---|
| Version | 3 |
| Download | Download Plugin |
# Mass Delete Users by Email
A WordPress plugin that allows administrators to permanently delete multiple user accounts at once by pasting a list of email addresses.
## Description
Mass Delete Users by Email is an administrative utility designed for WordPress site administrators who need to remove multiple user accounts efficiently. Common use cases include:
– Cleaning up spam registrations
– Removing test accounts
– Processing bulk account removal requests
– Managing user databases after migrations or imports
## Features
### Two-Step Workflow
1. **Preview**: Paste email addresses and preview which users will be deleted
2. **Execute**: Review the preview and confirm permanent deletion
### Comprehensive Deletion
When a user is deleted, the plugin permanently removes:
– User account and metadata
– Posts, pages, and custom post types
– Comments (including comment metadata)
– Media and attachments
### Safety Features
– **Preview before deletion**: See exactly which users will be deleted
– **Self-deletion prevention**: Cannot delete your own admin account
– **Batch integrity validation**: Revalidates users between preview and execution
– **CSRF protection**: WordPress nonces protect all form submissions
– **Capability checks**: Restricted to users with `manage_options` capability
### Flexible Input
– Supports comma-separated email addresses
– Supports newline-separated email addresses
– Supports mixed formats
– Handles Windows, Unix, and macOS line endings
– Automatically trims whitespace and removes duplicates
– Validates email format
### Detailed Results
After deletion, view comprehensive results showing:
– Successfully deleted users
– Skipped users (with reasons)
– Failed deletions (with error messages)
– Email addresses not found
– Invalid email addresses
## Requirements
– WordPress 6.5 or higher
– PHP 7.4 or higher
– Administrator account with `manage_options` capability
## Installation
1. Upload the plugin files to `/wp-content/plugins/aiplugin5032/`
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Navigate to **Tools → Mass Delete** to use the plugin
## Usage
1. Go to **Tools → Mass Delete** in your WordPress admin
2. Paste email addresses in the textarea (one per line or comma-separated)
3. Click **Preview Users** to see which users will be deleted
4. Review the preview carefully – check:
– Users found (with their details)
– Email addresses not found
– Invalid email addresses
5. Click **Permanently Delete X Users** to execute the deletion
6. Review the results screen showing what was deleted
## Important Warnings
⚠️ **PERMANENT DELETION**: This plugin permanently deletes user accounts and all their content. This action **CANNOT BE UNDONE**.
⚠️ **BACKUP FIRST**: Always create a complete backup of your WordPress database before using this plugin.
⚠️ **MULTISITE NOT SUPPORTED**: This plugin does not support WordPress Multisite installations.
### Services
**EmailParser**: Parses and validates email addresses from textarea input
– Handles multiple formats (comma, newline, mixed)
– Normalizes line endings
– Validates email format
– Removes duplicates
– Separates valid and invalid entries
**UserLookup**: Looks up WordPress users by email address
– Resolves emails to user IDs
– Retrieves user details (username, display name, roles)
– Revalidates users between preview and execution
**UserDeletion**: Handles permanent user deletion
– Deletes user accounts via `wp_delete_user()`
– Explicitly deletes user-authored comments
– Processes batches individually (one failure doesn’t stop the batch)
– Prevents self-deletion
– Validates batch integrity
## Security
– **Capability checks**: All operations require `manage_options` capability
– **Nonce verification**: CSRF protection on all form submissions
– **Batch integrity**: Revalidates user/email relationships before deletion
– **Self-deletion prevention**: Current admin cannot delete their own account
– **Input validation**: Email format validation and sanitization
## Error Handling
The plugin gracefully handles:
– Empty textarea input
– Invalid email addresses
– Duplicate emails
– Users not found
– Users deleted between preview and execution
– WordPress deletion API failures
– Extremely long input
– Mixed formatting and blank lines
Errors for individual users do not abort the entire batch.
## Limitations
– **No undo**: Deletion is permanent
– **No logging**: Does not create permanent records of deleted users (privacy by design)
– **Multisite**: Not supported in this version
– **Synchronous processing**: Processes users sequentially (suitable for administrative batches)
## Development
### Namespace
All PHP classes use the `aiplugin5032` namespace.
### WordPress Hooks Used
– `admin_menu`: Registers the Tools submenu page
– `admin_enqueue_scripts`: Enqueues admin CSS
– `delete_user` / `deleted_user`: Fired during deletion (via `wp_delete_user()`)
### WordPress APIs Used
– `wp_delete_user()`: Core user deletion
– `wp_delete_comment()`: Comment deletion
– `get_user_by()`: User lookup
– `current_user_can()`: Capability checks
– `wp_verify_nonce()`: CSRF protection
## Support
This is proprietary software. For support, contact the plugin author.
## License
Copyright (C) AI_PLUGIN_DEV 2026. ALL RIGHTS RESERVED. THIS IS NOT FREE SOFTWARE.
## Changelog
### Version 2.0.0
– Initial implementation of Mass Delete Users by Email
– Two-step preview and deletion workflow
– Comprehensive user and content deletion
– Security features (nonce, capability checks, self-deletion prevention)
– Detailed results reporting
– Multisite detection and refusal
