Description
This plugin sets the following debug constants in wp-config.php
on plugin activation and removes them on plugin deactivation. Any errors will result in a PHP Exception being thrown. Debug constants per Debugging in WordPress.
Default settings:
define( 'WP_DEBUG_LOG', true );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );
@ini_set( 'display_errors', 1 ); is set when the plugin is active. `WP_DEBUG` is set to true when the plugin is first run, thereafter it can be turned off in the Settings.
The Settings page allows the user to set the following.
define( 'WP_DEBUG', true ); // Default on initial plugin installation.
define( 'WP_DEBUG_DISPLAY', false ); // Default when not declared is true.
define( 'WP_DISABLE_FATAL_ERROR_HANDLER', true ); // WordPress 5.2 WSOD Override.
When the plugin is deactivated best efforts are made to re-add pre-existing constants to their former state. When the plugin is activated the default settings and any saved settings are restored.
This plugin uses the wp-cli/wp-config-transformer command for writing constants to wp-config.php
.
Debug Quick Look from Andrew Norcross is included with this plugin to assist in reading the debug.log file. If you already have this plugin installed you should delete it when WP Debugging is not active.
Query Monitor and Debug Bar plugins are optional dependencies to aid in debugging and troubleshooting. The notice for installation will recur 45 days after being dismissed.
If you have a non-standard location for your wp-config.php
file you can use the filter wp_debugging_config_path
to return the file path for your installation.
Development
PRs are welcome against the develop branch on GitHub.
Contributors & Developers
“WP Debugging” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “WP Debugging” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.4.1 / 2019-02-10
- refactor set/restore pre-activation constants
2.4.0 / 2019-02-06
- save pre-activation constants for re-installation on deactivation ( say that 5x fast )
2.3.0 / 2019-02-04
- look for
wp-config.php
in directory aboveABSPATH
- add filter
wp_debugging_config_path
to set non-standard path towp-config.php
2.2.0 / 2019-02-02 🏈
- initial release on dot org
2.1.1 / 2019-02-01
- only show WSOD bypass when appropriate
- update dependencies
2.1.0 / 2019-01-26
- update Debug Quick Look, minor CSS changes
- Improve messaging
- add setting for WP_DISABLE_FATAL_ERROR_HANDLER constant (WSOD)
- add default setting of WP_DEBUG to true, can be changed
2.0.0 / 2019-01-18
- total re-write
- add settings page
- use
wp-cli/wp-config-transformer
to changewp-config.php
- include
norcross/debug-quick-look
as dependency via composer but use my fork - update POT via
composer.json
and wp-cli - add image assets