Как использовать функцию is_nav_menu() в WordPress: руководство

# IS_NAV_MENU() │ WP 3.0.0

Функция **is_nav_menu()** проверяет, является ли указанный ID меню навигационным.

Она возвращает true, если это так, и false в противном случае.

## Использует

Функция использует wp_get_nav_menu_object() для получения объекта меню.

---

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

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

- **true** или **false** — существует ли меню.

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

Чтобы проверить, существует ли меню, используйте следующую конструкцию:

```php
is_nav_menu( $menu );

Параметры

• $menu (int|string|WP_Term) (обязательный) — ID меню, его слаг, имя или объект меню, который нужно проверить.

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

1 Проверка кастомного меню на существование

$menu = 'menyu-s-rubrikami';       // слаг меню 
// $menu = 41;                     // или ID меню
// $menu = 'Menu with categories'; // или имя меню

if( is_nav_menu( $menu ) ){
    echo 'Это меню существует';
}

Вы можете заменить переменную $menu на любые допустимые значения — слаг меню, его ID или имя.

Описание функции

Ниже приведён код функции is_nav_menu():

function is_nav_menu( $menu ) {
if ( ! $menu ) {
return false;
}

$menu_obj = wp_get_nav_menu_object( $menu );

if (
    $menu_obj &&
    ! is_wp_error( $menu_obj ) &&
    ! empty( $menu_obj->taxonomy ) &&
    'nav_menu' === $menu_obj->taxonomy
) {
    return true;
}

return false;

}

Объяснение кода

1. Проверка на пустое значение: Если $menu пустое, функция сразу возвращает false.
2. Получение объекта меню: С помощью wp_get_nav_menu_object() мы получаем объект меню по переданному параметру.
3. Проверка условий: Если объект меню существует, не содержит ошибок и его таксономия — это nav_menu, функция возвращает true. В противном случае — false.

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

Вот некоторые функции, с которыми может быть полезно ознакомиться:

• get_nav_menu_locations(): Получает местоположения меню.
• has_nav_menu(): Проверяет наличие меню на определённом местоположении.
• register_nav_menu(): Регистрирует одно меню.
• wp_get_nav_menu_items(): Получает элементы меню для определённого меню.
• wp_nav_menu(): Отображает меню.

Теперь у вас есть базовое понимание о функции is_nav_menu(), её использовании и связанности с другими функциями в WordPress. Эта функция полезна для проверки существования меню, что особенно актуально при создании тем и кастомизации вашего са��та на WordPress.