show_admin_bar()
Позволяет отключить "Панель инструментов" (Админ Бар). Технически функция включает/отключает "Панель" для лицевой части (фронтэнда). В админ-панели "Панель" отключить невозможно.
Функцию можно вызывать на раннем этапе, даже до подключения плагинов или темы или следует размещать в файл темы functions.php. Нет необходимости вызывать функцию во время события init.
Также есть фильтр show_admin_bar для отключения или включения админ бара. Он обладает большим приоритетом чем эта функция:
add_filter( 'show_admin_bar', '__return_false' ); // отключить add_filter( 'show_admin_bar', '__return_true' ); // включить
Рекомендую прочитать статью: 10 хаков для тулбара (админ бара) WordPress
Заметка: с версии WordPress 3.3 название "Админ бар" (admin bar) было изменено на "Панель инструментов" (toolbar)
Хуков нет.
Возвращает
null. Ничего не возвращает.
Использование
show_admin_bar( $show );
- $show(true/false) (обязательный)
- Показывать или не показывать «Панель инструментов».
Примеры
#1 Мягкое отключение Панель инструментов
Предположим, нам нужно отключить "Панель инструментов" в лицевой части сайта. Но при этом, нужно дать возможность плагинам, включить панель через фильтр show_admin_bar.
Для этого вставьте следующую строку в файл темы functions.php:
show_admin_bar( false );
#2 Мягкое Отключение Панели для всех кроме админа
Для этого используем функцию current_user_can():
add_action( 'init', function(){
if ( ! current_user_can( 'manage_options' ) ) {
show_admin_bar( false );
}
} ); #3 Жесткое отключение - приоритетнее чем функция show_admin_bar()
Для этого нужно использовать хук show_admin_bar - примеры смотрите по ссылке.
Заметки
- Global. true|false. $show_admin_bar
Список изменений
| С версии 3.1.0 | Введена. |
Код show_admin_bar() show admin bar WP 6.3.1
function show_admin_bar( $show ) {
global $show_admin_bar;
$show_admin_bar = (bool) $show;
}