WP_GET_NAV_MENUS() возвращает объекты всех навигационных меню

## WP_GET_NAV_MENUS() │ WP 3.0.0

Функция wp_get_nav_menus() возвращает объекты всех навигационных меню.

### Что такое wp_get_nav_menus()?

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

### Использование

Функция имеет следующий синтаксис:

```php
wp_get_nav_menus( $args );

Параметры

• $args (array): Массив аргументов, передаваемых в функцию get_terms(). По умолчанию — пустой массив.

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

$menus = wp_get_nav_menus( $args );
print_r( $menus );

Результат

Функция вернет массив объектов меню. Вот пример вывода:

Array
(
    [0] => stdClass Object
        (
            [term_id] => 3
            [name] => меню 1
            [slug] => menu-1
            [term_group] => 0
            [term_taxonomy_id] => 3
            [taxonomy] => nav_menu
            [description] => 
            [parent] => 0
            [count] => 1
        )

    [1] => stdClass Object
        (
            [term_id] => 4
            [name] => Меню 2
            [slug] => menu-2
            [term_group] => 0
            [term_taxonomy_id] => 4
            [taxonomy] => nav_menu
            [description] => 
            [parent] => 0
            [count] => 2
        )
)

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

Функци�� возвращает массив объектов меню (WP_Term[]).

Изменения

• С версии 3.0.0: Функция была добавлена.
• С версии 4.1.0: Значение по умолчанию для аргумента orderby было изменено с none на name.

Код функции

Вот реализация функции wp_get_nav_menus():

function wp_get_nav_menus( $args = array() ) {
$defaults = array(
'taxonomy' => 'nav_menu',
'hide_empty' => false,
'orderby' => 'name',
);
$args = wp_parse_args( $args, $defaults );

/**
 * Фильтрует объекты навигационных меню перед их возвращением.
 *
 * @since 3.0.0
 *
 * @see get_terms()
 *
 * @param WP_Term[] $menus Массив объектов меню.
 * @param array     $args  Массив аргументов, использованных для получения объектов меню.
 */
return apply_filters( 'wp_get_nav_menus', get_terms( $args ), $args );

}

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

• get_nav_menu_locations()
• has_nav_menu()
• is_nav_menu()
• register_nav_menu()
• wp_get_nav_menu_items()
• wp_nav_menu()

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

Теперь вы знаете, как использовать wp_get_nav_menus() в ваших проектах на WordPress. Эта функция поможет вам эффективно управлять навигационными меню на вашем сайте!