aaemnnosttv / dev-debug
Development debugging functions for WordPress
Installs: 1 481
Dependents: 0
Suggesters: 0
Security: 0
Stars: 9
Watchers: 4
Forks: 0
Open Issues: 0
Type:wordpress-muplugin
Requires
- composer/installers: ^1.0
This package is auto-updated.
Last update: 2024-12-19 03:59:19 UTC
README
A WordPress plugin for developing plugins.
Dev Debug provides some handy functions for analyzing your code and giving some helpful feedback.
In order to be available for use in early plugin execution, Dev Debug needs to be included first. It's for this reason that Dev Debug was designed as a MU plugin, but it may also be installed as a normal plugin.
Disclaimer: This plugin is a handy tool. It is not intended as a replacement for a real debugging solution like Xdebug. If you don't know what xdebug can do, drop what you're doing and check that out immediately. You can thank me later 😄
Basic Usage
Non-persistent Data Capture
Dev Debug's primary feature is essentially a super var_dump. Want to dump the contents of a variable/expression?
Simply use ddprint( $somevariable );
and you will see a nice dump at the bottom of the page.
Example:
// some test in your plugin or theme's functions.php add_action( 'wp_head', function() { ddprint( get_queried_object() ); } );
Want to label your dump? ddprint( $data, $label )
(label defaults to the datatype of $data
). Useful when capturing many items at a time, eg: within the loop.
Each dump shows up as an individual panel at the bottom of the loaded page, regardless of where you are in WP.
The default dump representation is var_export
but you can toggle between var_dump
and print_r
(I find they each have their uses).
Each dump also has a full comprehensive sexy lookin backtrace with which you can reveal with a toggle button at the top right corner of the panel.
Captured output is suppressed during ajax requests and media uploads to prevent the output from interferring with the expected returned data.
Persistent Capture
Dev Debug also provides two functions for capturing data in circumstances where ddprint()
would not work, such during as an ajax request.
sdt()
sdt( $data, $label = 'optional' );
This function saves the captured data as a transient. It's captured output will appear with other captures as long as the data is still set.
The sdt()
capture has a short lifespan of only 2 minutes by default.
ddlog()
ddlog( $data, $label = 'optional' );
This function writes the data to a log file.
By default, the file is located in the wp-content/.htdev-debug.log
. The destination directory can be changed with the ddbug/logging/path
filter if desired.
Most standard Apache and Nginx configurations include rules to block external access to files that begin with
.ht
such as.htaccess
and.htpasswd
. The.htdev-debug
file could possibly contain very sensitive information so it is not recommended to be used on production environments, however this filename aims to protect unauthorized access for those that choose to live on the wild side.
Hook Inspection
Ever want to know what the heck is going on during a particular action or filter?
ddhook('the_content')
The ddhook
function will produce a non-persistent capture of all of the callbacks attached to the given hook.
It can also be configured to listen for a given number of arguments that are passed, and provide an additional capture of the arguments passed to the callback.
Menu Item
Dev Debug also adds an admin menu item for clearing the persistent debug capture if set, and a very accessible list of constants.
Constants with truthy values are green, falsy are gray, and undefined are faded/italic for quick reference. The constant's values can also be seen on hover.
Debug Bar
Dev Debug integrates with the Debug Bar plugin out of the box, by adding a panels to its overlay for showing captured dumps, as well as quick in-app access to viewing the Dev Debug log.
Installation
Dev Debug can be installed in a few different ways.
Via Composer
Use
composer require aaemnnosttv/dev-debug
to add the latest release of the package to your project and install it as an MU plugin.
Via Git
Clone the project into either:
{path-to-wp-content}/mu-plugins
{path-to-wp-content}/plugins
git clone git@github.com:aaemnnosttv/dev-debug.git
Manual Installation
- Download the desired release.
- Extract directory into one of the two directories listed above.
- Optionally rename the directory to
dev-debug
if it is not already.
Note on installing as a MU plugin
WordPress only loads plugins within the root directory of the mu-plugins
directory. It does not recurse into sub-directories as it does with plugins
.
This means that you will need to load the main plugin file yourself.
Create a simple MU loader for Dev Debug:
Create a file called load-dev-debug.php
within the root of the mu-plugins
directory.
Add this code:
if ( file_exists( __DIR__ . '/dev-debug/dev-debug.php' ) ) require_once ( __DIR__ . '/dev-debug/dev-debug.php' );
The loader file can be named anything, but WordPress will load it in alphabetical order. So if you want Dev Debug functions to be available within another MU plugin, you'll just need to ensure that it loads first.