WordPress.org

Languages: English • 한국어 • (Add your language)

Description

Set the display status of the Toolbar for the front side of your website (you cannot turn off the toolbar on the WordPress dashboard).

Note: The Admin Bar is replaced with the Toolbar since WordPress Version 3.3.

Usage

<?php show_admin_bar( $bool ); ?>

Parameters

$bool

(boolean) (required) Whether to show the Toolbar.

Default: None

Return Values

none

Notes

This function should be called immediately upon plugin load or placed in the theme's functions.php file.

This function will also affect the display of the Toolbar in the dashboard for WordPress versions prior to Version 3.3.

Examples

show_admin_bar( false );

Placing the above line of code in theme's functions.php file will prevent the Toolbar from rendering on the front end of your site.

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 );
}

With newer version of WordPress you may need to use the following which will leave the Toolbar available in the Dashboard but hide it on all front facing pages.

add_filter('show_admin_bar', '__return_false');

Change Log

• Since: 3.1.0

Source File

show_admin_bar() is located in wp-includes/admin-bar.php.

Related

• Function: is_admin_bar_showing()
• Filter: show_admin_bar