WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

show_admin_bar() WP 3.1.0

Позволяет отключить "Панель инструментов" (Админ Бар). Технически функция включает/отключает "Панель" для лицевой части (фронтэнда). В админ-панели "Панель" отключить невозможно.

Функцию можно вызывать на раннем этапе, даже до подключения плагинов или темы или следует размещать в файл темы functions.php. Нет необходимости вызывать функцию во время события init.

toolbar
как выглядит Панель инструментов (Админ бар)

Заметка: с версии WordPress 3.3 название "Админ бар" (admin bar) было изменено на "Панель инструментов" (toolbar)

Рекомендую прочитать статью: 10 хаков для тулбара (админ бара) WordPress

Также есть фильтр для отключения или включения админ бара, который обладает большим приоритетом нежели эта функция:

add_filter('show_admin_bar', '__return_false'); // отключить
add_filter('show_admin_bar', '__return_true'); // включить
Заметки
  1. Функция влияет на отображения Админ Бара в админ-панели, до версии 3.3.

  2. Для версий ниже 3.3. может понадобится отключить Админ бар во фронтенде, но не отключать его в админ-панели, для этого используйте такой код:
    add_filter('show_admin_bar', '__return_false');

Хуков нет.

Возвращает

Ничего не возвращает.

Использование

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() WP 5.5.1

wp-includes/admin-bar.php
<?php
function show_admin_bar( $show ) {
	global $show_admin_bar;
	$show_admin_bar = (bool) $show;
}

Cвязанные функции

Из метки: toolbar (admin bar)

Еще из раздела: Без рубрики

7 комментов