Описание функции get_page_by_title()
Функция get_page_by_title() используется для получения объекта страницы WordPress по ее заголовку. Это может быть полезно, когда необходимо получить информацию о странице без знания ее ID. Функция также поддерживает параметры для определения, в каком формате следует искать страницу, например, по типу публикации и статусу.
Функция возвращает объект WP_Post, если страница найдена, или null, если страницы не существует.
Параметры
$title
Тип: string
Обязательный: Да
Описание: Заголовок страницы для поиска.
Возможные значения:
$output
Тип: string
Обязательный: Нет
По умолчанию: object
Описание: Формат возвращаемого значения.
Возможные значения:
0: object
1: id
$post_type
Тип: string
Обязательный: Нет
По умолчанию: page
Описание: Тип поста для поиска.
Возможные значения:
0: post
1: page
2: any
$post_status
Тип: string
Обязательный: Нет
По умолчанию: publish
Описание: Статус поста для поиска.
Возможные значения:
0: publish
1: draft
2: pending
Возвращаемое значение
Тип: WP_Post|null
Описание: Объект WP_Post, представляющий найденную страницу, или null, если страница не найдена.
Возможные значения:
• Объект WP_Post при успешном выполнении
• null если страница не найдена
Примеры использования
Базовый пример получения страницы по заголовку
$page = get_page_by_title('Моя страница');
if ($page) {
echo $page->ID;
}
Выводит ID страницы, если она найдена
Получение страницы типа ‘post’ по заголовку
$page = get_page_by_title('Контакты', 'object', 'post');
if ($page) {
echo $page->post_content;
}
Выводит содержимое поста, если он найден
Проверка на наличие страницы и вывод сообщения об ошибке
$page = get_page_by_title('Не существующая страница');
if (!$page) {
echo 'Страница не найдена';
}
Выводит сообщение, если страница не найдена
Безопасность
Валидация входных данных: Функция не требует дополнительной валидации параметров, но передаваемые значения должны быть корректными.
Санитизация: Параметры автоматически очищаются WordPress.
Рекомендации: При выводе данных используйте esc_html() для текстовых значений, чтобы избежать XSS.
— Связанные функции
Получает страницу по ID.
Получает пост по его ID.
— Хуки
Фильтрует результаты перед возвращением.
— Примечания
– Ограничения
Функция ищет только публичные страницы по умолчанию.
– Частые проблемы
- Не найденная страница при неправильном заголовке.
- Конфликты заголовков, если несколько страниц имеют одинаковые заголовки.
