Описание функции wp_get_nav_menu_name()
Функция wp_get_nav_menu_name() возвращает название навигационного меню по его идентификатору. Она используется для получения удобочитаемого названия меню, которое может быть использовано в интерфейсе или в шаблонах темы.
Эта функция полезна для разработчиков тем и плагинов, которые работают с пользовательскими меню и хотят отображать их названия в различных местах.
Параметры
$menu
Тип: int|string|WP_Term
Обязательный: Да
По умолчанию: Нет
Описание: Идентификатор меню, его название или объект WP_Term
Возможные значения:
int: ID меню
string: Название меню
WP_Term: Объект WP_Term меню
Возвращаемое значение
Тип: string|null
Описание: Название навигационного меню или null, если меню не найдено
Возможные значения:
• Строка с названием меню, если меню найдено
• null, если меню не найдено
Примеры использования
Базовый пример получения названия меню по его ID
$menu_name = wp_get_nav_menu_name(42);
// Вывод названия меню
echo $menu_name;
Выводит название меню с ID 42
Получение названия меню по его имени
$menu_name = wp_get_nav_menu_name('main-menu');
// Вывод названия меню
echo $menu_name;
Выводит название меню с именем ‘main-menu’
Пример обработки случая, когда меню не найдено
$menu_name = wp_get_nav_menu_name(999);
if (is_null($menu_name)) {
echo 'Меню не найдено';
} else {
echo $menu_name;
}
Выводит сообщение, если меню с ID 999 не существует
Безопасность
Валидация входных данных: Входные параметры проверяются на наличие корректного формата
Санитизация: Функция очищает входные данные
Рекомендации: Используйте esc_html() для вывода названия меню
— Связанные функции
Получает элементы навигационного меню
Отображает навигационное меню на фронтенде
— Примечания
– Ограничения
Функция работает только с существующими меню, иначе вернет null
– Частые проблемы
- Неверный ID или название меню может привести к получению null
- Ошибки при работе с пользовательскими меню без их предварительного создания
