Описание функции register_nav_menus()
Функция register_nav_menus() используется для регистрации одного или нескольких навигационных меню в теме WordPress. Она позволяет разработчикам определять места для меню, которые затем могут быть использованы в шаблонах темы. Функция обычно вызывается в файле functions.php темы.
После регистрации меню, пользователи могут добавлять элементы в них через панель администрирования WordPress.
Параметры
$menus
Тип: array
Обязательный: Да
По умолчанию: array()
Описание: Ассоциативный массив, где ключ — это название места меню, а значение — его описание
Возможные значения:
название_меню: Описание меню
Возвращаемое значение
Тип: null
Описание: Функция не возвращает значение
Возможные значения:
• null
Примеры использования
Базовый пример регистрации одного навигационного меню
register_nav_menus(array(
'primary' => 'Основное меню'
));
Это меню будет доступно в админке для настройки
Регистрация нескольких навигационных меню в одной функции
register_nav_menus(array(
'primary' => 'Основное меню',
'footer' => 'Меню в подвале'
));
Оба меню будут доступны для настройки в админке
Безопасность
Валидация входных данных: Параметры проверяются на корректность перед регистрацией
Санитизация: Ключи и значения массива очищаются WordPress
Рекомендации: Избегайте использования специальных символов в названиях меню
— Связанные функции
Выводит зарегистрированные навигационные меню на сайте
Получает зарегистрированные местоположения меню
— Примечания
– Ограничения
Функция не поддерживает динамическое добавление меню после инициализации темы
– Частые проблемы
- Меню не отображается, если не зарегистрировано
- Ошибки в названиях мест меню могут привести к их недоступности
