WordPress.org

Function Reference/show admin bar

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

Change Log

Since: 3.1.0

Source File

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

WordPress.org

Codex

Function Reference/show admin bar

Contents