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