Описание функции get_page_hierarchy()
Функция get_page_hierarchy() возвращает иерархическую структуру страниц WordPress в виде массива. Она позволяет получить список страниц с учетом их родительских связей, что полезно для построения навигации или отображения страниц в иерархическом формате.
Функция часто используется в темах и плагинах для формирования меню или списков страниц с учетом их уровня вложенности.
Параметры
$pages
Тип: array
Обязательный: Да
По умолчанию: array()
Описание: Массив объектов WP_Post, представляющих страницы
Возможные значения:
Возвращаемое значение
Тип: array
Описание: Массив страниц в иерархическом порядке
Возможные значения:
• Массив объектов WP_Post, отсортированных по уровню вложенности
• Пустой массив, если нет страниц
Примеры использования
Базовый пример получения иерархии страниц
$pages = get_pages();
$hierarchy = get_page_hierarchy($pages);
foreach ($hierarchy as $page) {
echo $page->post_title.'<br>';
}
Вывод заголовков страниц
Получение страниц с сортировкой по меню
$args = array(
'sort_column' => 'menu_order',
'sort_order' => 'ASC'
);
$pages = get_pages($args);
$hierarchy = get_page_hierarchy($pages);
Страницы отсортированы по порядку
Безопасность
Валидация входных данных: Функция предполагает правильный формат входного массива
Санитизация: Не требуется, так как функция работает с объектами WP_Post
Рекомендации: Проверяйте, что массив страниц не пустой перед вызовом функции
— Связанные функции
Получает массив страниц с возможностью фильтрации
Выводит список страниц в иерархическом формате
— Примечания
– Ограничения
Возвращает только страницы, не учитывает другие типы постов
– Частые проблемы
- Пустой результат при отсутствии страниц
- Неверный порядок, если массив не отсортирован
