Описание функции register_nav_menu()
Функция register_nav_menu() используется для регистрации одного места навигационного меню в теме WordPress. Это позволяет пользователям добавлять и управлять меню через интерфейс администратора. Меню можно выводить в различных местах темы, таких как верхнее меню, боковые панели и подвал.
Функция должна вызываться во время инициализации темы, например, в функции theme_setup.
Параметры
$location
Тип: string
Обязательный: Да
Описание: Уникальный идентификатор для меню
$description
Тип: string
Обязательный: Нет
Описание: Краткое описание меню, показываемое в админке
Возвращаемое значение
Тип: void
Описание: Функция не возвращает значения
Возможные значения:
• Нет возвращаемых значений
Примеры использования
Регистрация основного меню для темы
function my_theme_setup() {
register_nav_menu('header-menu', 'Основное меню');
}
add_action('after_setup_theme', 'my_theme_setup');
Меню будет доступно в админке для редактирования
Регистрация двух мест для навигации
function my_theme_setup() {
register_nav_menu('header-menu', 'Основное меню');
register_nav_menu('footer-menu', 'Меню в подвале');
}
add_action('after_setup_theme', 'my_theme_setup');
Теперь доступны оба меню в админке
Безопасность
Валидация входных данных: Функция не выполняет явную валидацию входных данных
Санитизация: Идентификатор меню должен быть уникальным и не содержать пробелов
Рекомендации: Используйте уникальные идентификаторы для каждого меню
— Связанные функции
Выводит зарегистрированное меню в указанном месте
Регистрация нескольких меню за один вызов
— Примечания
– Ограничения
Необходимо вызывать функцию до вывода меню
– Частые проблемы
- Меню не отображается, если оно не зарегистрировано
- Ошибка при использовании дублирующихся идентификаторов
