Описание функции get_queried_object()
Функция get_queried_object() возвращает объект, который был запрошен в текущем контексте. Это может быть объект записи, категории, тега, пользовательского типа записи или таксономии, в зависимости от контекста запроса. Функция полезна для получения информации о текущем объекте, на который ссылается страница или запрос.
Функция используется в большинстве случаев, когда необходимо получить данные о текущем объекте в шаблонах и плагинах.
Параметры
$none
Тип: none
Обязательный: Нет
По умолчанию: Нет параметров.
Описание: Функция не принимает параметров.
Возможные значения:
Возвращаемое значение
Тип: object|null
Описание: Возвращает объект текущего запрашиваемого объекта или null, если объект не найден.
Возможные значения:
• Объект WP_Post, если запрашивается запись
• Объект WP_Term, если запрашивается категория или тег
• Объект WP_User, если запрашивается пользователь
• null, если запрос не соответствует ни одному объекту
Примеры использования
Базовый пример получения текущей записи
$queried_object = get_queried_object();
if ( isset($queried_object->ID) ) {
echo 'Текущая запись: ' . $queried_object->post_title;
}
Выводит заголовок текущей записи
Получение текущей категории на странице архива категорий
$queried_object = get_queried_object();
if ( isset($queried_object->term_id) ) {
echo 'Текущая категория: ' . $queried_object->name;
}
Выводит название текущей категории
Обработка случая, когда объект не найден
$queried_object = get_queried_object();
if ( !$queried_object ) {
echo 'Объект не найден';
}
Выводит сообщение, если объект отсутствует
Безопасность
Валидация входных данных: Нет входных параметров для валидации.
Санитизация: Нет необходимости в санитизации, так как функция не принимает параметры.
Рекомендации: При выводе данных используйте функции экранирования, например esc_html() для заголовков
— Связанные функции
Получает объект записи по ID.
Получает объект таксономии по ID.
Получает объект пользователя по ID или логину.
— Примечания
– Ограничения
Возвращает данные только для текущего запроса.
– Частые проблемы
- Возвращает null, если запрос не соответствует запрашиваемому объекту.
- Неправильное использование в контексте, отличном от запроса.
