WP debugger & Rescue Tool

A powerful, single-file PHP emergency kit (wp-debugger.php) designed for developers and sysadmins to recover WordPress installations suffering from critical errors or to perform rapid maintenance tasks.

⚠️ IMPORTANT: Security Warning

This script provides deep access to the WordPress database and file system.

• Immediately change the password in the TOOL_PASSWORD constant at the top of the script.
• Delete this script from the server as soon as your troubleshooting is complete.
• Use at your own risk. Always perform a backup before using bulk actions.

✨ Key Features

• One-Click Subdirectory to Root Move: Move a complete website from a subfolder to the root directory. The script automatically handles file relocation and updates the siteurl and home options in the database.
• DB Recovery: Update wp-config.php credentials and fix connection strings.
• Access Management: Instantly create a new admin user or reset existing passwords.
• Plugin & Theme Manager: Toggle problematic plugins or themes without dashboard access.
• Core Reinstall: Replace corrupted WordPress core files with a single click.
• System Tools: Clear LSCache/Object Cache, restore default .htaccess, and fix file permissions (755 for dirs, 600 for wp-config).
• Security Scan: Detect unauthorized PHP files in the uploads folder (potential malware).
• Search & Replace: Migrate database URLs with 'Dry Run' support.

🚀 Installation & Usage

1. Download the file as wp-debugger.php.
2. Upload it to the directory of your WordPress installation.
3. Navigate to yourdomain.com/wp-debugger.php in your browser.
4. Log in using the password you defined in the script.

🛠 Configuration

Open the script and modify the following lines:

define('TOOL_PASSWORD', 'your-secure-password'); // Change this immediately!
define('DEFAULT_USER', 'support');           // Default admin username to be created