Как использовать функцию IS_ADMIN_BAR_SHOWING()?│WP 3.1.0

# Функция IS_ADMIN_BAR_SHOWING() │ WP 3.1.0

Эта функция помогает определить, должна ли отображаться админ-панель в WordPress.

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

## Использование функции

```php
is_admin_bar_showing();

Пример использования

Проверка наличия админ-панели и выполнение действий

if (is_admin_bar_showing()) {
    // Код, если панель отображается
} else {
    // Код, если панель не отображается
}

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

Функция возвращает:

• true — если админ-панель должна отображаться;
• false — если она не должна отображаться.

Замечания

• Глобальная переменная: $show_admin_bar (boolean).
• Глобальная переменная: $pagenow (строка). Содержит имя текущей страницы.

Изменения

• Версия 3.1.0: Введена функция.

Реализация функции

В файле wp-includes/admin-bar.php функция выглядит следующим образом:

function is_admin_bar_showing() {
    global $show_admin_bar, $pagenow;

    // Для этих типов запросов админ-панель не отображается.
    if (defined('XMLRPC_REQUEST') || defined('DOING_AJAX') || defined('IFRAME_REQUEST') || wp_is_json_request()) {
        return false;
    }

    if (is_embed()) {
        return false;
    }

    // Если мы в админке, админ-панель отображается.
    if (is_admin()) {
        return true;
    }

    if (!isset($show_admin_bar)) {
        if (!is_user_logged_in() || 'wp-login.php' === $pagenow) {
            $show_admin_bar = false;
        } else {
            $show_admin_bar = _get_admin_bar_pref(); // Получение предпочтений пользователя
        }
    }

    /**
     * Фильтрация отображения админ-панели.
     *
     * Чтобы скрыть админ-панель, возвращайте false.
     * Для вошедших пользователей используется их предпочтение отображения.
     *
     * @since 3.1.0
     *
     * @param bool $show_admin_bar должна ли отображаться админ-панель. По умолчанию false.
     */
    $show_admin_bar = apply_filters('show_admin_bar', $show_admin_bar);

    return $show_admin_bar;
}

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

• show_admin_bar()
• WP_Admin_Bar()

Условные теги

Вот некоторые условные теги, которые могут быть полезны:

• is_admin()
• is_user_logged_in()
• is_embed()

Вывод

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

Теперь у вас есть статья о функции IS_ADMIN_BAR_SHOWING(), которая понятна даже для новичков и соответствует всем техническим стандартам WordPress.