Описание функции wp_get_nav_menus()
Функция wp_get_nav_menus() возвращает массив всех зарегистрированных меню навигации в текущем сайте WordPress. Она используется для получения информации о меню, таких как их имена и ID, что позволяет разработчику легко управлять навигацией сайта.
Функция часто используется в темах и плагинах для отображения меню или для настройки пользовательского интерфейса.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для фильтрации меню навигации
Возможные значения:
orderby: name, description, slug
order: ASC, DESC
Возвращаемое значение
Тип: array
Описание: Массив объектов WP_Term, представляющих меню навигации
Возможные значения:
• Массив объектов WP_Term при успешном выполнении
• Пустой массив если меню не найдены
• WP_Error в случае ошибки
Примеры использования
Базовый пример получения всех зарегистрированных меню
$menus = wp_get_nav_menus();
foreach($menus as $menu) {
echo $menu->name.', ';
}
Меню 1, Меню 2,
Получение меню, отсортированных по имени
$args = array(
'orderby' => 'name',
'order' => 'ASC'
);
$menus = wp_get_nav_menus($args);
Меню будет отсортировано в алфавитном порядке
Безопасность
Валидация входных данных: Все параметры проходят валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для названий меню
— Связанные функции
Выводит меню навигации в заданном месте темы
Получает местоположения меню, зарегистрированные в теме
— Хуки
Фильтрует массив меню перед возвращением
— Примечания
– Ограничения
Возвращает только публичные меню по умолчанию
– Частые проблемы
- Пустой результат при отсутствии зарегистрированных меню
- Некорректные параметры могут привести к ошибкам
