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.log
contents 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.log
file 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.php
before 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.php
constants, 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.php
in your web browser.
- Open the debugging tools in your browser.
- Click on the "Enable Debugging" button to modify the
wp-config.php
file 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.php
file 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.php
backup.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.