Repository navigation
Your First Scan
Varun Dubey edited this page Feb 7, 2026
·
1 revision
After adding a site, run a full scan:
wp_full_scan("my-site")
# or with password auth:
wp_full_scan("my-site", password="ssh-password")This runs all scans in sequence:
- Core file integrity (
wp core verify-checksums) - Plugin integrity (
wp plugin verify-checksums) - MU-plugins scan (backdoor detection)
- Uploads directory scan (PHP files that shouldn't exist)
- Deep malware pattern scan (obfuscated code, known signatures)
- Database injection scan (malicious content in posts/options)
- Recently modified files (infection timeline)
- Hidden admin detection (suspicious administrator accounts)
- Application password scan (REST API entry vectors)
- Web shell detection (file manager backdoors)
For detailed output including every command:
wp_full_scan_verbose("my-site")The scan produces a structured report. Here's what to look for:
## Full Malware Scan Report
Status: CLEAN
Issues found: 0
No action needed. The site is healthy.
## Full Malware Scan Report
Status: INFECTED
Issues found: 7
### Core Verification
- wp-includes/class-wp-backdoor.php (should not exist)
### MU-Plugins
- SUSPICIOUS: wp-update-manager.php (user-hiding filter)
### Admin Users
- admlnlx (created 2 days ago, typosquatted email)
Each finding includes:
- What was found (file, user, option, etc.)
- Why it's suspicious (pattern match, checksum mismatch, etc.)
- Recommended action (quarantine, delete, review, etc.)
wp_complete_cleanup("my-site")This runs 16 steps automatically: backup, revoke app passwords, remove hidden plugins, remove malware themes, delete DB markers, reinstall core, reinstall plugins/themes, remove rogue admins, reset passwords, regenerate salts, clean uploads, harden wp-config, install security MU-plugin, fix permissions, update everything.
For more control, follow the Cleanup Workflow in the README.
- Set up Daily Automated Scans to catch infections early
- Read Understanding Scan Results for detailed finding explanations
- Check the FAQ for common questions
Getting Started
Running as a Service
Threat Intelligence
Reference
Project
- GitHub Repo
- WP Vanguard (threat research)
- Wbcom Designs
- License: GPL-2.0-or-later