Описание функции get_page_children()
Функция get_page_children() возвращает массив дочерних страниц (постов) для заданной родительской страницы. Она полезна для получения всех дочерних страниц в иерархической структуре, что часто требуется в темах и плагинах для построения меню или навигации.
Функция используется в случаях, когда необходимо отобразить или обрабатывать дочерние страницы конкретной родительской страницы.
Параметры
$parent_id
Тип: int
Обязательный: Да
Описание: ID родительской страницы, для которой нужно получить дочерние страницы
Возможные значения:
Возвращаемое значение
Тип: array
Описание: Массив объектов WP_Post, представляющих дочерние страницы
Возможные значения:
• Массив объектов WP_Post при наличии дочерних страниц
• Пустой массив, если дочерние страницы не найдены
Примеры использования
Базовый пример получения дочерних страниц для страницы с ID 1
$children = get_page_children(1);
foreach($children as $child) {
echo $child->post_title . ', ';
}
Отобразит названия всех дочерних страниц
Проверка наличия дочерних страниц перед выводом
$children = get_page_children(5);
if (empty($children)) {
echo 'Нет дочерних страниц';
} else {
foreach($children as $child) {
echo $child->post_title . ', ';
}
}
Сообщение о отсутствии дочерних страниц при их отсутствии
Безопасность
Валидация входных данных: Параметр parent_id проходит валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для названий страниц
— Связанные функции
Получает список страниц с возможностью фильтрации
Получает одну запись по ID
— Примечания
– Ограничения
Возвращает только опубликованные страницы
– Частые проблемы
- Пустой результат при отсутствии дочерних страниц
- Ошибки при передаче неверного ID родительской страницы
