Описание функции wp_page_menu()
Функция wp_page_menu() отображает меню страниц на сайте WordPress. Позволяет выводить список страниц в виде HTML-меню. Это полезно для создания навигации между страницами в вашем контенте.
Меню может быть настроено с помощью параметров, таких как ‘sort_column’, ‘depth’ и других, обеспечивая гибкость в отображении структуры страниц
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для настройки отображения меню
Возможные значения:
sort_column: имя колонки для сортировки (например, ‘menu_order’, ‘post_title’)
sort_order: ASC, DESC
depth: глубина отображения вложенных страниц (0 — все уровни, 1 — только корневые)
show_home: 1,
exclude: ID страниц для исключения из меню
Возвращаемое значение
Тип: string
Описание: HTML-код меню страниц
Возможные значения:
• HTML-код
- с элементами
• Пустая строка, если меню не найдено
Примеры использования
Простой вызов для отображения меню страниц
wp_page_menu();
Выводит меню всех страниц по умолчанию
Отображение меню с сортировкой по порядку меню и без вложенных страниц
$args = array(
'sort_column' => 'menu_order',
'depth' => 1
);
wp_page_menu($args);
depth=1 исключает вложенные страницы
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе используйте esc_html() для безопасности
— Связанные функции
Отображает меню, созданное в админке WordPress
Получает массив страниц с различными параметрами
— Хуки
Фильтрует аргументы перед созданием меню страниц
Фильтрует вывод меню страниц
— Примечания
– Ограничения
Не поддерживает пользовательские типы записей
– Частые проблемы
- Пустое меню, если нет страниц
- Неверный порядок, если меню не отсортировано
