WordPress.org

Ready to get started?Download WordPress

Codex

Function Reference/show admin bar

Contents

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

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

Source File

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

Related

is_admin_bar_showing()

See also index of Function Reference and index of Template Tags.