WordPress debugging tools is designed to help developers and site administrators easily enable debugging, view error logs, manage log files, and more within their WordPress environment. It provides a convenient interface for modifying wp-config.php constants related to debugging, viewing error logs directly from the browser, and performing other debugging-related tasks without the need for manual file modifications.
- Easy Debugging Toggle: Quickly enable or disable WordPress debugging settings with a single click.
- Log Viewer: View
debug.logcontents directly in the browser, with options to highlight errors, filter log entries, and bypass file size limitations. - Log Management: Download, rotate, or delete the
debug.logfile directly from the tool. - Error Revealer: Automatically download and install the error revealer script for advanced debugging.
- Backup and Restore: Automatically creates a backup of
wp-config.phpbefore making changes, allowing for easy restoration if needed. - WP-CLI wp-config-transformer Integration: Utilizes the wp-config-transformer library for safely modifying
wp-config.phpconstants, ensuring compatibility and preventing syntax errors.
- Download the "wdt.php" file from the GitHub repository.
- Place it in your WordPress site's root directory.
- Access the tools by navigating to
http://yourwordpresssite.com/wdt.phpin your web browser.
- Open the debugging tools in your browser.
- Click on the "Enable Debugging" button to modify the
wp-config.phpfile and enable WordPress debugging features.
- Access the log viewer by clicking on the "Debug Log Viewer" button.
- Use the provided buttons to highlight errors, filter log entries, download the log file, rotate log files, or delete the log file.
- Enable the error revealer by checking the "Install Error Revealer" checkbox when enabling debugging. This downloads and activates a script that helps reveal hidden errors.
- Disable debugging by clicking on the "Disable Debugging" button. This restores the original
wp-config.phpfile from backup.
- Lists the version of WordPress core, active theme and all the plugins without using any of the native WordPress functions. This is still experimental so might not work on some installations.
You can modify the following constants in the wdt.php file to customize the behavior of the debugging tools:
MU_PATH: Path to the Must-Use plugins directory.ER_URL: URL to the error revealer script.BACKUP_CONFIG_FILENAME: Filename for thewp-config.phpbackup.LOGVIEW_FILEZIE_LIMIT_MB: Maximum file size for viewing the log file in the browser.
This tool relies on the wp-config-transformer library provided by WP-CLI for modifying the wp-config.php file. For more information, visit the wp-config-transformer GitHub page.
- WordPress 4.0 or higher.
- PHP 5.6 or higher.
Contributions are welcome! Please feel free to submit pull requests or create issues for bugs and feature requests.
WordPress debugging tools is open-source software licensed under the GNU General Public License.



