Developer tools for debugging and testing things as you develop and troubleshoot your WordPress site.
- View debug.log and error logs directly from admin in your timezone, conveniently combining repeats for readability, and with quick links to search Google for suggested solutions.
- View additional .txt logs with custom URLs.
- Quickly clear your debug and error logs with a click of a button.
- View and download backups of wp-config.php file and .htaccess file from the admin area.
- Add/remove snippets on the wp-config.php file without editing the file directly.
- Add/remove snippets on the .htaccess file without editing the file directly.
- Choose which errors to report to the debug.log (if your host allows it).
- View and download functions.php file.
- Toggle wp_mail() failure logging.
- View and edit user meta, including custom meta, for a given user directly from the admin panel.
- Add/remove roles for a specific user.
- View and edit post meta, including custom meta for a given post directly from the admin panel.
- Clear all taxonomy terms from a given post.
- View all php.ini values.
- View detailed information about your PHP’s configuration.
- View cookies.
- View scheduled cron jobs.
- View all site options and registered settings.
- Clear all or expired transients easily.
- View available WP global variables with ease.
- View additional details about active plugins, and see warnings about outdated plugins at a glance.
- Regex playground with cheat sheet.
- Enable/disable WP heartbeat from settings.
- Extend cURL timeout errors easily.
- Shortcode Finder displays all available shortcodes and lets you search posts and pages where they are used.
- Additional user and post information on admin bar.
- View online users to avoid working on the site at the same time as other admins and users.
- Centering tool added to the admin bar that helps you line up elements on a page.
- See all shortcodes used on any page from the front-end in the admin bar.
- If Gravity Forms is installed, see form ids in the admin bar.
- Replaces “Howdy” on admin bar with your user ID.
- Adds date/time that the page was loaded to admin bar for comparing two windows.
- Quick links for debugging users, posts, pages, and Gravity Forms forms and entries.
- Option to remove items from admin bar.
- Allow posts and pages to be searched by ID in the admin area.
- Access to a handful of additional functions and hooks that you can use for debugging.
- A great list of links to helpful resources.
- Discord notifications of fatal errors, user page loads, and user logins.
- Install the plugin from your website’s plugin directory, or upload the plugin to your plugins folder.
- Activate it.
- Go to Developer Debug Tools in your admin menu.
- Enter your account email address as a “Developer Email Address” to view the rest of the tools.
Should I backup my wp-config.php and .htaccess files before using the tools to add/remove snippets?
Yes! It is always best to back these files up when making updates to them.
Can I use this plugin on a live website?
Yes, but you should always make a backup of your site before using functionality that makes changes to your core files or database.
My site broke when updating my wp-config.php or .htaccess. How do I revert back to my original?
The originals are stored in your root folder and renamed with the date and time from which they were replaced. For example, the wp-config.php file will have been renamed to wp-config-2022-08-22-15-25-46.php and replaced with a new file. Simply log into your FTP or File Manager (from your host), rename the current file to something else such as wp-config-BROKEN.php (just in case you need it), and then rename the version you want to revert back to as wp-config.php. If everything looks good, then you can either delete this file or send a copy of it to me so I can figure out what went wrong. You can do so in the Discord server mentioned below.
Why can’t I edit a username for a user?
Some hosts will not allow you to update a user’s username directly from WP. In order to do so, you’ll have to update it in your database directly.
Where is the centering tool?
Viewable only on the front-end, there is a link on the admin bar that shows +Off. Click on it and it will add a transparent bar with lines on it at the top of the page underneath the admin bar. If you click on the centering bar it will expand all the way down the page. Click on it again and it will minimize back to the top. You can click on the +On link from the admin bar to make it go away.
You have to enable them on the Developer Debug Tools settings first. Once they are enabled, an “ID” column will be added to the user and/or post admin list pages. Next to the user or post’s ID you will see a lightning bolt icon. Clicking on the lightning bolt will redirect you to the User Meta or Post Meta tab on our plugin where you can view and edit all of the meta easily.
Where can I get further support?
Join my WordPress Support Discord server
Contributors & Developers
“Developer Debug Tools” is open source software. The following people have contributed to this plugin.Contributors
Interested in development?
- Fix: Front-end admin menu links visible to people without permissions
- Fix: Front-end admin menu links not able to click if list is too long, made scrollable
- Fix: Separators added to front-end admin menu link if another class is added
- Update: Added option to add admin menu links to admin bar on front end
- Tweak: Changed Remove Admin Bar Items section to Admin Bar
- Fix: Admin bar post id showing inaccurate info for non-posts/pages
- Fix: Page load Discord notifications getting inaccurate page when loading non-post/pages
- Fix: Easy reader combining arrays and displaying them inside another array
- Update: Added new function ddtt_backtrace() that logs wp_debug_backtrace_summary() to debug.log
- Update: Added snippets in wp-config and htaccess tabs to increase max input vars
- Fix: Inaccurate error log reporting fatal error to Discord
- Update: Added field to post meta tab for hiding post meta keys with a prefix
- Update: Added field to user meta tab for hiding user meta keys with a prefix
- Update: Add hook for filtering quick link post types in case some post types are not registered
- Fix: Quick links not showing up on posts, pages, and custom post types
- Tweak: Prevent adding non-txt files to additional logs field
- Tweak: Clean up some code
- Fix: Removed unneccesary instantiation of Discord class
- Tweak: Removed all unneccesary static declarations and usage
- Fix: is_plugin_active() not found when Gravity Forms is deactivated
- Tweak: Added Child Theme Configurator to recommended plugins
- Tweak: Added NS Cloner – Site Copier to recommended plugins
- Fix: array_intersect() error on class-online-users.php
- Update: Added option in settings for sending fatal errors to a Discord channel
- Fix: Custom logs trying to load when saving settings with no custom log defined
- Tweak: Added a video tutorial for migrating WP in Resources
- Fix: Developer email field pattern not recognizing dashes or periods in domain
- Tweak: Added sections in Logs tab for each log that is being checked
- Update: Added field in settings for adding custom logs and viewing them on the Logs tab
- Tweak: Added String locator to recommended plugins
- Update: Added quick error_reporting code converter to bottom of Error Reporting tab
- Tweak: Added a notice to Error Reporting tab if error reporting is being overwritten by another plugin or custom code
- Fix: User error tracking in debug.log causing issues when not executed by a user directly
- Fix: File size and last modified dates not working on must-use plugins
- Update: Added Error Reporting tab
- Tweak: Added title, ID, and post type to Discord page load notifications if on front-end or editing back-end
- Tweak: Added Redirection to recommended plugins
- Tweak: Added version logging to deactivation feedback to make it easier to chase down errors
- Tweak: Reformat hook examples on Hooks tab, removed
- Fix: Dark CSS was affecting h2 tags in notices on DDT pages
- Tweak: Updated the TESTING_PLAYGROUND.php file to allow deletion of all content, added example code
- Tweak: Changed name of Hooks tab to Available Hooks
- Tweak: Changed name of Functions tab to Available functions
- Tweak: Changed name of FX tab to Functions.php
- Tweak: Updated some CSS styles and highlighted syntax on Functions tab
- Tweak: Removed planned features from About tab
- Fix: Links inside notices were too light with the background
- Fix: If someone is not a dev and saves the settings, it was clearing all settings
- Tweak: Updated Discord server link on Resources tab
- Update: Added unserialized array values underneath serialized values in User Meta and Post Meta tabs, making it easier to read
- Fix: Attempting to send Discord notifications when there are no priority roles selected causing fatal error
- Update Added option in settings to disable error counts to improve page load time when there are lots of errors
- Fix: Debug log not pulling up if location is changed
- Fix: Some sites do not have a blog name, so default to domain in Discord notifications
- Tweak: ddtt_print_r() / dpr() now accepts array for user id
- Fix: Improved performance on show online users feature
- Update: Added option for Discord Notifications of online priority users
- Tweak: Added an option to stop showing feedback form on deactivate; will automatically disable for certain choices
- Tweak: Changed order of deactivate feedback form options
- Update: Automatically prioritize online users with same email domain as website
- Update: Added setting to choose priority roles for “show online users”
- Update: Removed “show online users” active users dashboard widget as it’s redundant
- Update: Added total users count to “show online users” admin bar dropdown
- Fix: Automatic conversion of false to array being deprecated
- Fix: New install dev email address field populating user id instead of email
- Tweak: Wordwrapped plugin file path on plugin pages if super long
- Fix: Error on Post Meta tab if the website does not have any posts
- Fix: Timezone error if someone tries to save their timezone as blank, revert back to default
- Fix: Easy Reader debug log viewer causing issues if writing an array to the logs
- Tweak: Move author URL and support server to defines
- Update: Added deactivation survey
- Fix: Timezone conversion on false date or timestamp returning error
- Tweak: Changed default developer email to the user that activated the plugin instead of the admin email
- Fix: A few minor text corrections
- Tweak: Update planned features list on About tab
- Tweak: Stylized warning symbols
- Fix: PHP Warning for undefined variable $err
- Fix: Issue removing some snippets on wp-config
- Tweak: Added semicolon to end of existing snippets
- Fix: Removed modified date and compatibility check for Hello Dolly plugin
- Tweak: Removed temp files if updating wp-config/htaccess are cancelled
- Tweak: Added warnings for outdated plugin/WP/PHP versions in header
- Fix: DateTime::__construct(): Passing null to parameter #1 ($datetime) of type string is deprecated
- Update: Added more options for showing online users in admin bar
- Update: Added option to also log user id, user display name and url with query string when an error is triggered
- Tweak: Update Discord support link
- Update: Added search field for Site Options to include options not registered
- Tweak: Added full changelog to readme.txt
- Tweak: Updated changelog to use commonly used prefixes (Fix, Tweak, and Update)
- Tweak: Changed
gmdate()in activation hook (props @sybrew)
- Tweak: Changed multiple calls to
site_url()to variable in root file (props @sybrew)
- Tweak: Moved
includesfolder (props @sybrew)
- Fix: Patched security issues with downloads (props @sybrew)
- Fix: Unserialize notice on usermeta tab
- Fix: Error with GFAPI not being found on feed page
- Tweak: Sorted plugins alphabetically by name
- Update: Added quick debug links to Gravity Form entry page
- Tweak: Moved quick debug link results for Gravity Forms to it’s own page instead of sharing the Testing tab
- Update: Added quick debug link for Gravity Forms feeds
- Update: Added more recommended plugins
- Tweak: Redacted sensitive information from view to hide when getting support and showing demos
- Fix: Shortcode finder attribute field not filtering out value properly
- Update: Added functions.php viewer
- Update: Added a simple functions.php viewer
- Update: Added backups sections to wp-config/htaccess tabs with ability to clear old backups
- Tweak: Disabled preview button on wp-config/htaccess tabs if nothing is checked or unchecked
- Fix: Deprecated function in online users class
- Fix: Admin side menu showing tabs for non-devs
- Tweak: Made cURL seconds field show/hide with JS instead of needing to save the changes first
- Update: Added settings link, website link, and Discord support link to plugins list page
- Update: Added message for user that activated the plugin with instructions on how to begin
- Tweak: Only make paths to plugin/theme editor pages if editors are not disabled
- Update: Added notice to top of Cron Jobs page if
WP Cronis disabled
- Update: Added two more snippets to wp-config:
- Update: Added feedback form in About tab
- Update: Added Admin Help Docs plugin to recommended plugins and on About tab
- Fix: Minor bugs related to multisite
- Update: Added a couple more recommended plugins
- Update: Added buttons to cookies tab for clearing cookies and browser local storage
- Fix: Debug quick link on post edit screens not showing up
- Update: Added link to primary site on debug log if not on primary site
- Fix: Subsite links on network settings page all pointing to primary site
- Fix: Debug log easy viewer highlighting issue
- Tweak: Changed classic debug log viewer to show raw last 100 lines with user’s timezone
- Tweak: Shortened submenu slugs to not include full url
- Tweak: Removed
clear_debug_logquery string so we can refresh log without clearing it again
- Fix: Browser tab customization on subsites that are not primary
- Fix: Active tab highlighting on side menu
- Tweak: Updated plugin slug in url to not include path to options page
- Fix: Bug on network plugins tab
- Update: Added inactive plugins to plugins tab
- Update: Added “Sites” column to plugins tab on multisite network to see which sites plugins are installed on
- Update: Added multisite suffixes to title and browser tabs to clearly identify which site you are on
- Update: Added support for multisite
- Tweak: Reverted to display name in Online Users if no first and last name is provided
- Tweak: Ensured
is_plugin_active()is defined for admin on multisite
- Update: Added setting for condensing admin bar items
- Tweak: Updated
ddtt_debug_log_help_colhooks with more options
- Update: Added view recent links to debug log in Easy Reader
- Update: Added links to color key on debug log in Easy Reader to filter results
- Update: Added a search field to debug log in Easy Reader
- Fix: Removed plugin from menu if not admin
- Fix: Error on debug log easy reader
- Fix: Error in online user column
- Update: Added max filesize for debug log to prevent site crashing with filter to change amount
- Tweak: Changed plugins last modified date to developer’s timezone
- Update: Added filter for changing debug log help links
- Update: Added filter for changing debug log highlight colors
- Update: Added Easy Reader view and viewer options to debug log
- Tweak: Changed logs tab slug to “logs” instead of “debug”
- Update: Added full regex array and preg_match_all with pattern to Regex tab for easy copying
- Update: Added tab titles to browser tabs, and push user/post ids on user/post meta tabs
- Tweak: Changed PHP testing playground local path to theme root folder, old path still works as backup
- Fix: PHP Warning for undefined variable
- Update: Added setting for swapping out discord link if already a member
- Update: Added confirmation for updating wp-config.php and .htaccess files
- Tweak: Combined repeated shortcodes found on admin bar, replaced with count
- Update: Added sources to available shortcodes on shortcode finder
- Tweak: Changed shortcode finder input field to select field
- Update: Added filter for omitting shortcodes from shortcode finder, good for minimizing page builders
- Update: Added capability for posts and pages to be searched by ID in the admin area
- Tweak: Changed order of admin bar items
- Update: Added online users feature
- Update: Added quick debug links to Gravity Forms action links
- Tweak: Changed admin bar user info to existing wp-account so Debug Bar will work
- Tweak: Minimized space at top of each page
- Fix: Log path notice
- Update: Added shortcode finder
- Tweak: Allowed disabling of admin bar items
- Fix: Beta htaccess editing was still in test mode
- Update: Added Resource dropdown to admin bar
- Update: Added additional resources
- Update: Added jQuery versions to header
- Update: Added Cron Jobs tab
- Update: Added Cookies tab
- Update: Added PHP Info tab
- Tweak: Added WP.org links to About tab
- Fix: Test # incrementing when not used
- Fix: Not finding Gravity Form forms on admin bar if added via Cornerstone element
- Fix: Not allowing updating user or post meta keys that are not all lowercase
- Update: Made preparations for release to WP.org repository
- Created plugin on May 13, 2022