Функция has_nav_menu() в WordPress

Функция has_nav_menu() в WordPress проверяет, назначено ли меню для заданной области меню (меню-локации). Эта функция возвращает true, если для указанной области меню назначено меню, и false в противном случае. Она полезна для условного отображения контента в зависимости от того, задано ли меню для определенной области.

bool has_nav_menu( string $location )

Параметры

• $location (string): Область меню, которую вы хотите проверить. Это значение должно совпадать с именем локации меню, как она была зарегистрирована в вашей теме.

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

• (bool): Возвращает true, если для указанной области меню назначено меню, и false, если меню не назначено.

Пример 1: Проверка наличия меню для основной области меню

Этот пример показывает, как проверить, назначено ли меню для основной области меню, и выполнить действия в зависимости от этого.

if ( has_nav_menu( 'primary' ) ) {
    // Основное меню назначено
    echo '<p>Основное меню активно.</p>';
} else {
    // Основное меню не назначено
    echo '<p>Основное меню не назначено.</p>';
}

В этом примере primary — это локация меню, которую вы зарегистрировали в своей теме. Вы можете использовать этот код для проверки, назначено ли меню для основной области меню и отображать соответствующее сообщение.

Пример 2: Условное отображение меню в шаблоне

В этом примере демонстрируется, как отобразить меню только если для указанной области меню назначено меню.

if ( has_nav_menu( 'header-menu' ) ) {
    wp_nav_menu( array(
        'theme_location' => 'header-menu',
        'container'      => 'nav',
        'container_class'=> 'header-nav',
        'menu_class'     => 'header-menu',
    ) );
}

Здесь header-menu — это локация меню, зарегистрированная для области меню в заголовке. Если меню назначено для этой области, функция wp_nav_menu() выводит меню с заданными параметрами.

Пример 3: Проверка наличия меню в нескольких областях

Этот пример показывает, как проверить, назначено ли меню в нескольких областях меню.

if ( has_nav_menu( 'primary' ) || has_nav_menu( 'footer' ) ) {
    // Проверка, назначено ли меню для основной или футерной области
    echo '<p>Есть активные меню в основной или футерной области.</p>';
} else {
    echo '<p>Нет активных меню в основной и футерной областях.</p>';
}

В этом примере проверяется, назначено ли меню для одной из двух областей: основной или футерной.

Пример 4: Отображение альтернативного контента в зависимости от наличия меню

В этом примере показано, как можно отобразить альтернативный контент, если для заданной области меню не назначено меню.

if ( has_nav_menu( 'footer-menu' ) ) {
    wp_nav_menu( array(
        'theme_location' => 'footer-menu',
        'container'      => 'nav',
        'container_class'=> 'footer-nav',
        'menu_class'     => 'footer-menu',
    ) );
} else {
    echo '<p>Меню для футера не задано.</p>';
}

Этот код проверяет наличие меню для области footer-menu, и если меню назначено, то оно выводится, иначе отображается сообщение о том, что меню для футера не задано.

Регистрация областей меню

Чтобы функция has_nav_menu() могла работать, вам нужно зарегистрировать области меню в вашей теме. Пример регистрации нескольких областей меню:

function register_my_menus() {
    register_nav_menus(
        array(
            'primary'   => __( 'Primary Menu' ),
            'footer'    => __( 'Footer Menu' ),
            'header-menu' => __( 'Header Menu' ),
            'sidebar-menu' => __( 'Sidebar' ),
        )
    );
}
add_action( 'init', 'register_my_menus' );

Заключение

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

Используя has_nav_menu(), вы можете сделать ваш сайт более гибким и адаптивным, улучшая пользовательский опыт.