Question

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.

---

参数

$show

(bool) (Required) Whether to allow the admin bar to show.

---

源代码

File: wp-includes/admin-bar.php

function show_admin_bar( $show ) {
	global $show_admin_bar;
	$show_admin_bar = (bool) $show;
}

---

更新日志

Version	description
3.1.0	Introduced.

---

相关函数

Used By

• wp-admin/includes/template.php: iframe_header()
• wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::setup_theme()

---

User Contributed Notes

1. Skip to note content 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 Contributed by Codex

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

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).

add_filter( 'show_admin_bar', '__return_false' );