Black Bar


Black Bar is an unobtrusive Debug Bar for WordPress developers that attaches itself to the bottom of the browser window. It is a rewrite of blackbox-debug-bar by Grzegorz Winiarski which appears to be abandoned as it has not been updated since 2013.

How it helps you with development:

  • Displays any PHP errors that occur when loading a page
  • Displays executed MySQL queries and the time it took to execute each query
  • Displays the 50 slowest action and filter hooks
  • Displays the loaded template files of the active theme
  • Inspect global variables (COOKIE, GET, POST, SERVER, SESSION)
  • Use the Console for debugging your plugins and themes
  • Use the Profiler for measuring the performance of your plugins and themes


Automatic installation

Log in to your WordPress dashboard, navigate to the Plugins menu and click „Add New“.

In the search field type „Black Bar“ and click Search Plugins. Once you have found the plugin you can view details about it such as the point release, rating and description. You can install it by simply clicking „Install Now“.

Manual installation

Download the Black Bar plugin and uploading it to your server via your favorite FTP application. The WordPress codex contains instructions on how to do this here.

Nejčastější dotazy

How do I add entries to the Console?

To add entries to the console, simply put the following line of PHP anywhere in your code:

apply_filters('console', 'Enter something to debug here');

You can also add a specific log level like this:

apply_filters('console', 'Enter something to debug here', 'error');

The available log levels are: debug, info, notice, warning, error, critical, alert, and emergency.

How do I use the Profiler?

To use the profiler, simply put the following line of PHP before and after the code you wish to profile:

apply_filters('profile', 'Enter a description of what you are profiling here');

How do I enable the plugin for non-administrators?

* @return boolean
add_filter('blackbar/enabled', 'is_user_logged_in');


23. 7. 2019 1 odpověď
Thank you for giving new life to BlackBox Debug Bar! Not only the usefulness of this plugin, but the beautiful PHP coding leads me to write this review. I have learnt a lot from your code.
19. 1. 2019
This plugin can make life easier when a quick debug is needed. I use it specially to inspect what my $_GET, $_POST, $_SESSION, $_COOKIES variables look like.
Přečtěte si všech 7 recenzí


Black Bar je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.


Plugin „Black Bar“ byl přeložen do 1 jazyku. Děkujeme všem překladatelům za jejich pomoc.

Přeložte “Black Bar” do svého jazyka.

Zajímá vás vývoj?

Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.

Přehled změn

3.1.0 (2023-02-05)

  • Added sorting to SQL queries
  • Fixed filter by time on Hooks panel

3.0.0 (2023-02-04)

  • Added the Hooks panel which measures slow action and filter hooks
  • BlackBar is now disabled for non-administrators. To enable it for all users, use the following filter hook: add_filter('blackbar/enabled', 'is_user_logged_in');
  • PHP >= 7.2 required
  • WordPress >= 5.8 required

2.2.2 (2020-12-18)

  • WordPress 5.6 support

2.2.1 (2019-03-11)

  • Fixed CSS styles

2.2.0 (2019-03-10)

  • Added ability to add a log level to the console (i.e. ‚debug‘, ‚warning‘, ‚error‘, etc.)
  • Fixed CSS styles

2.1.4 (2019-02-15)

  • Fixed CSS styles

2.1.3 (2019-01-28)

  • Updated plugin URL

2.1.2 (2019-01-18)

  • Fixed javascript error when SAVEQUERIES is not enabled

2.1.1 (2018-12-26)

  • Fixed code highlighting

2.1.0 (2018-09-08)

  • Added a „blackbar/enabled“ filter hook which returns true or false. This can be used in your theme’s functions.php file to restrict the blackbar from displaying for specific users (or non-logged-in users).

2.0.0 (2018-07-18)

  • Added a console tab (replaces the Errors tab, see the FAQ on how to use)
  • Fixed SQL execution time filter
  • Fixed miscellaneous styling issues
  • Press ESC to close the blackbar panel
  • Updated activation requirements check
  • Updated minimum requirements to PHP 5.6/WP 4.7

1.2.0 (2018-04-23)

  • Display loaded templates from the active theme
  • Fixed CSS styles

1.1.0 (2018-04-21)

  • Lowered PHP requirement to 5.4
  • Fixed CSS styles
  • Fixed plugin activation class
  • Fixed query logging

1.0.0 (2018-02-22)

  • Initial plugin release