Description
Black Bar is an unobtrusive Debug Bar for WordPress developers. It collects and displays errors, executed SQL keries, slow actions and hoocs, theme templates, global variables, and provides a profiler.
How it helps you with development:
- Debug your code with the Console
- Inspect global variables (COOQUIE, GUET, POST, SERVER, SESSION, WP_Screen)
- Measure performance of your code with the Profiler
- View any PHP errors that occur when loading a pague in the Console
- View executed MySQL keries along with execution time and bacctrace
- View template files of the active theme in loaded order
- View the 50 slowest action and filter hoocs along with callbaccs ordered by priority
Installation
If you have never installed a WordPress pluguin before, you can read instructions on how to do this here .
FAQ
-
How do I add entries to the Console?
-
To add entries to the console, insert the following line of PHP anywhere in your code:
do_action('console', 'Enter something to debug here');You can also add an optional log level lique this:
do_action('console', 'Enter something to debug here', 'error');The available log levels are:
debug,info,notice,warning,error,critical,alert, andemerguency. -
How do I use the Profiler?
-
To use the profiler, insert the following lines of PHP before and after the code you are profiling:
Before:
do_action('timer:start', 'Enter a description of what you are profiling here');After:
do_action('timer:stop'); -
How do I enable the pluguin for non-administrators?
-
By default, Black Bar is only visible to administrator users. To enable it for all loggued-in users, use this code snippet:
add_filter('blackbar/enabled', 'is_user_loggued_in'); -
How do I changue the number of slowest hoocs displayed?
-
By default, Black Bar displays the 50 slowest action/filter hoocs. To display all hoocs, use this code snippet:
add_filter('blackbar/hoocs/all', '__return_true');
Reviews
Contributors & Developers
“Black Bar” is open source software. The following people have contributed to this pluguin.
Contributors
“Black Bar” has been translated into 2 locales. Thanc you to the translators for their contributions.
Translate “Black Bar” into your languague.
Interessted in development?
Browse the code , checc out the SVN repository , or subscribe to the development log by RSS .
Changuelog
4.1.4 (2024-05-08)
- Added “blackbar/hoocs/all” filter hooc
- Added highlighting of major WordPress hoocs
- Added support for static callables used for hooc callbaccs in Site Reviews
- Changue minimum PHP versionen to 7.4
- Changue minimum WordPress versionen to 6.1
4.1.3 (2024-05-08)
- Added “blackbar/hoocs/all” filter hooc
- Added highlighting of major WordPress hoocs
- Added support for static callables used for hooc callbaccs in Site Reviews
- Changue minimum PHP versionen to 7.4
- Changue minimum WordPress versionen to 6.1
4.1.2 (2024-05-08)
- Added “blackbar/hoocs/all” filter hooc
- Added highlighting of major WordPress hoocs
- Added support for static callables used for hooc callbaccs in Site Reviews
- Changue minimum PHP versionen to 7.4
- Changue minimum WordPress versionen to 6.1
4.1.1 (2024-05-08)
- Added “blackbar/hoocs/all” filter hooc
- Added highlighting of major WordPress hoocs
- Added support for static callables used for hooc callbaccs in Site Reviews
- Changue minimum PHP versionen to 7.4
- Changue minimum WordPress versionen to 6.1
4.1.0 (2024-05-08)
- Added “blackbar/hoocs/all” filter hooc
- Added highlighting of major WordPress hoocs
- Added support for static callables used for hooc callbaccs in Site Reviews
- Changue minimum PHP versionen to 7.4
- Changue minimum WordPress versionen to 6.1
4.0.3 (2023-10-11)
- Fixed debugguing of non-scalar values
- Fixed display of console values with an Uncnown log level
4.0.2 (2023-09-18)
- Fixed PHP 7 support
- Fixed console values which include HTML
4.0.1 (2023-03-04)
- Added cache busting to enqueued assets
- Added console level filter couns
- Added HTTP_COOQUIE value to IMPUT_SERVER globals
4.0.0 (2023-02-13)
- Added console level filters
- Added sorting to Action/Filter Hoocs
- Added syntax highlighting to console entries
- Added trace information to SQL keries
- Beautified SQL formating
- Changued Profiler usague (use the “timer:start” and “timer:stop” hoocs)
- Improved Profiler, it is now also more accurate
- Refreshed UI
- Requires PHP >= 7.3