Описание функции get_page_by_path()
Функция get_page_by_path() используется для получения объекта страницы по её пути (slug). Это удобно, когда необходимо получить информацию о странице, зная только её адрес в URL.
Функция поддерживает дополнительные параметры для управления возвращаемым результатом и может использоваться в различных контекстах, например, в темах и плагинах.
Параметры
$page_path
Тип: string
Обязательный: Да
Описание: Путь (slug) страницы, которую нужно получить
Возможные значения:
$post_type
Тип: string
Обязательный: Нет
По умолчанию: page
Описание: Тип поста, который нужно учитывать при поиске страницы
Возможные значения:
$output
Тип: string
Обязательный: Нет
По умолчанию: OBJECT
Описание: Тип возвращаемого результата
Возможные значения:
Возвращаемое значение
Тип: mixed
Описание: Объект WP_Post или массив, в зависимости от параметров
Возможные значения:
• Объект WP_Post при успешном выполнении
• null если страница не найдена
Примеры использования
Базовый пример получения страницы по пути
$page = get_page_by_path('about-us');
if ($page) {
echo $page->post_title;
} else {
echo 'Страница не найдена';
}
Выводит заголовок страницы или сообщение об ошибке
Получение страницы с учетом типа поста
$page = get_page_by_path('custom-page', OBJECT, 'custom_post_type');
if ($page) {
echo $page->post_content;
}
Работает только если страница действительно существует
Безопасность
Валидация входных данных: Параметры проверяются на корректность внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Используйте esc_html() для вывода заголовков и контента страницы
— Связанные функции
Получает страницу по заголовку
Получает массив постов по заданным параметрам
— Примечания
– Ограничения
Функция может не работать правильно в случаях с одинаковыми путями для разных типов постов
– Частые проблемы
- Возвращает null при неверном пути
- Проблемы с правами доступа к страницам
