show_admin_bar( bool $show )

User Contributed Notes

1. Skip to note 7 content

   Codex 8 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   The proper method for hiding the Toolbar on the front-end (cannot be disabled on the back-end).

   add_filter( 'show_admin_bar', '__return_false' );
2. Skip to note 8 content

   Codex 8 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   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.

   show_admin_bar( false );
3. Skip to note 9 content

   Codex 8 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   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 );
   }
4. Skip to note 10 content

   Philipp Stracker 3 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   This function can be called immediately from the functions.php or the main plugin file to disable the admin-bar for all users.

   If you want to conditionally hide the admin-bar based on the current page or user role, then you can do it in/before the following actions:

   Front-End

   // To disable admin-bar on front-end, the last
   // possibility is action "wp" at any Prio.
   add_action( 'wp', 'prefix_maybe_hide_admin_bar' );

   wp-admin

   // To disable admin-bar inside wp-admin. the last
   // possibility is action "admin_init" at Prio 9
   add_action( 'admin_init', 'prefix_maybe_hide_admin_bar', 9 );

   Full sample

   add_action( 'wp', 'wpdocs_maybe_hide_admin_bar' );
   add_action( 'admin_init', 'wpdocs_maybe_hide_admin_bar', 9 );
   
   function wpdocs_maybe_hide_admin_bar() {
       if ( ! current_user_can( 'manage_options' ) ) {
           show_admin_bar( false );
       }
   }

   Note:

   The init action is fired before wp and admin_init. It’s possible to use show_admin_bar() inside the init action, but other plugins might overwrite your decision at a later point.

   I do NOT recommend using the filter add_filter( 'show_admin_bar', '__return_false' ); in shared plugins! It will create conflicts with other plugins. Only use the filter in your private (child) theme or internal plugins, and stick with the show_admin_bar() function in public or shared plugins.
5. Skip to note 11 content

   amirhp-com 2 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Hide adminbar for custom post type, e.g. ‘course‘

   add_action( "wp", function wp(){
     if (is_singular("course"))
       add_filter( "show_admin_bar", "__return_false" );
   });
6. Skip to note 12 content

   Matt Taylor 2 months ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   With this example we can hide the admin bar for all users, but for users with “edit posts” permissions, they can opt-in to showing the bar via the “Show Toolbar when viewing site” option on their profile.

   You can flip the logic so those users can opt-out of showing the bar as well.

   // Display the admin bar for editors and above
   add_filter( 'show_admin_bar', function ( $bool ) {
   	if ( empty( $bool ) ) {
   		return false;
   	}
   
   	if ( current_user_can( 'edit_posts' ) ) {
   		// Note: get_user_option() will return a string (ie. 'false'/'true'/'') and not a bool or null
   	        $show_bar_setting = get_user_option( 'show_admin_bar_front' );
   
           	// Default for these users is to hide the bar but allow them to turn it on
   	        return ( 'true' === $show_bar_setting ? true : false );
   	}
   
   	return false;
   } );