show_admin_bar()
Дозволяє вимкнути “Панель інструментів” (Адмін Бар). Технічно функція включає/вимикає “Панель” для лицьової частини (фронтенду). В адмін-панелі “Панель” вимкнути неможливо.
Функцію можна викликати на ранньому етапі, навіть до підключення плагінів або теми, або слід розміщувати у 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.0.2
function show_admin_bar( $show ) { global $show_admin_bar; $ show_admin_bar = (bool) $ show; }