Функция is_admin_bar_showing() в WordPress: Документация и пример использования

Функция is_admin_bar_showing() в WordPress проверяет, отображается ли в данный момент панель администратора (Admin Bar) для текущего пользователя. Это может быть полезно при создании тем или плагинов, когда необходимо учитывать отображение панели администратора.

bool is_admin_bar_showing ( void )

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

Функция возвращает true, если панель администратора отображается, и false, если нет.

Пример 1: Условное отображение стилей

Предположим, вы хотите применить некоторые стили только в том случае, если панель администратора отображается. Вы можете использовать функцию is_admin_bar_showing() следующим образом:

function my_custom_styles() {
    if ( is_admin_bar_showing() ) {
        echo '<style>
            body {
                margin-top: 32px;
            }
            @media screen and ( max-width: 782px ) {
                body {
                    margin-top: 46px;
                }
            }
        </style>';
    }
}
add_action( 'wp_head', 'my_custom_styles' );

В этом примере, если панель администратора отображается, к элементу body добавляется отступ сверху (это важно когда ваш первый экран имеет абсолютное позиционирование). Это полезно, чтобы содержимое страницы не перекрывалось панелью администратора.

Пример 2: Условное добавление скрипта

Другой пример — добавление JavaScript только для тех пользователей, у которых отображается панель администратора:

function my_custom_scripts() {
    if ( is_admin_bar_showing() ) {
        wp_enqueue_script( 'my-admin-bar-script', get_template_directory_uri() . '/js/admin-bar.js', array('jquery'), null, true );
    }
}
add_action( 'wp_enqueue_scripts', 'my_custom_scripts' );

В этом примере скрипт admin-bar.js подключается только тогда, когда отображается панель администратора. Это позволяет избежать лишней загрузки ресурсов для пользователей, у которых панель не отображается.

Отключение панели администратора

Фильтр show_admin_bar

Для отключения панели администратора можно использовать фильтр show_admin_bar. Это правильный способ отключения панели для всех пользователей на сайте.

Для этого достаточно передать значение false в данный фильтр. Добавьте следующий код в файл functions.php вашей темы:

add_filter('show_admin_bar', '__return_false');

Альтернативный способ — создать собственную функцию, которая возвращает false:

function disable_admin_bar() {
    return false;
}
add_filter('show_admin_bar', 'disable_admin_bar');

Для того чтобы скрыть панель администратора для всех пользователей, кроме администраторов, можно использовать следующую функцию:

function hide_admin_bar_except_for_admin() {
    if ( !current_user_can('administrator') ) { 
        return false;
    } else {
        return true;
    }
}
add_filter('show_admin_bar', 'hide_admin_bar_except_for_admin');

Эта функция проверяет права текущего пользователя и отключает панель администратора, если пользователь не является администратором.

Заключение

Функция is_admin_bar_showing() в WordPress — это простой способ проверить, отображается ли панель администратора для текущего пользователя. Используя эту функцию, можно гибко адаптировать темы и плагины, улучшая пользовательский опыт и оптимизируя загрузку ресурсов. Фильтр show_admin_bar позволяет легко контролировать отображение панели администратора, что может быть полезно для улучшения интерфейса вашего сайта.