SHOW_ADMIN_BAR() │ WP 3.1.0

Функция show_admin_bar() позволяет отключить "Панель инструментов" (Admin Bar) на фронтенде вашего сайта WordPress. Однако, важно помнить, что её нельзя отключить в админ-панели.

Как использовать

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

Изображение

Можно вызывать функцию сразу при загрузке плагина. Нет необходимости вызывать её из функции, связанной с событием init.

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

add_filter( 'show_admin_bar', '__return_false'); // отключить
add_filter( 'show_admin_bar', '__return_true');  // включить

Примечание: "Admin Bar" была переименована в "Toolbar" с версии WordPress 3.3.

Возвращаемое значение

Функция возвращает null, то есть ничего не возвращает (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 — см. примеры выше.

Примечания

• Глобальная переменная. true|false. $show_admin_bar.

История изменений

• Версия 3.1.0 — введена.

Код функции

Функция show_admin_bar находится в файле:

wp-includes/admin-bar.php

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

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

• Toolbar (Admin Bar)

  • is_admin_bar_showing()
  • WP_Admin_Bar()

Не классифицированные функции

• _doing_it_wrong()
• cache_javascript_headers()
• do_robots()
• download_url()
• get_privacy_policy_url()
• maybe_convert_table_to_utf8mb4()
• nocache_headers()
• wp_check_browser_version()
• wp_die()
• wp_editor()
• wp_get_raw_referer()
• wp_get_referer()
• wp_install_defaults()
• wp_magic_quotes()
• wp_mail()
• wp_oembed_get()
• wp_redirect()
• wp_safe_redirect()
• wp_star_rating()
• wp_timezone_choice()
• wp_validate_redirect()

Теперь вы обладаете простой и понятной информацией о функции show_admin_bar() и её использовании в WordPress!