show_admin_bar( bool $show )
Sets the display status of the admin bar.
Description
This can be called immediately upon plugin load. It does not need to be called from a function hooked to the ‘init’ action.
Parameters
- $show
-
(bool) (Required) Whether to allow the admin bar to show.
Source
File: wp-includes/admin-bar.php
function show_admin_bar( $show ) {
global $show_admin_bar;
$show_admin_bar = (bool) $show;
}
Changelog
| Version | Description |
|---|---|
| 3.1.0 | Introduced. |
Basic Example
Placing the below line of code in theme’s function.php file will prevent the Toolbar from rendering on the front end of your site.
Selected display
You can also determine for which users the admin bar is shown. For example the following lines will only display the admin bar for users with administrative privileges.
if ( ! current_user_can( 'manage_options' ) ) { show_admin_bar( false ); }The proper method for hiding the Toolbar on the front-end (cannot be disabled on the back-end).