Описание функции the_post_thumbnail_url()
Функция the_post_thumbnail_url() возвращает URL миниатюры записи. Она используется для получения изображения миниатюры, связанного с конкретной записью, что позволяет вставлять его в шаблоны тем и плагинов.
Функция позволяет указать размер изображения и возвращает URL в зависимости от заданного параметра
Параметры
$size
Тип: string
Обязательный: Нет
По умолчанию: post-thumbnail
Описание: Размер изображения миниатюры, который необходимо вернуть
Возможные значения:
0: thumbnail
1: medium
2: large
3: full
4: custom-size
Возвращаемое значение
Тип: string|null
Описание: URL миниатюры записи или null, если миниатюра не задана
Возможные значения:
• URL изображения миниатюры при успешном выполнении
• null если миниатюра не найдена
Примеры использования
Базовый пример получения URL миниатюры текущей записи
$thumbnail_url = get_the_post_thumbnail_url();
// Вывод URL миниатюры
echo $thumbnail_url;
Выводит URL миниатюры, если она задана
Получение URL миниатюры определенного размера
$thumbnail_url = get_the_post_thumbnail_url(null, 'medium');
// Вывод URL миниатюры среднего размера
echo $thumbnail_url;
Размер ‘medium’ позволяет получить изображение среднего размера
Проверка на наличие миниатюры перед выводом
$thumbnail_url = get_the_post_thumbnail_url();
if ($thumbnail_url === null) {
echo 'Миниатюра не найдена';
} else {
echo $thumbnail_url;
}
Выводит сообщение, если миниатюра не задана
Безопасность
Валидация входных данных: Параметр size валидируется внутри функции
Санитизация: Функция автоматически очищает параметры
Рекомендации: При выводе URL используйте esc_url() для безопасности
— Связанные функции
Получает HTML-код миниатюры записи
Проверяет, есть ли у записи миниатюра
— Примечания
– Ограничения
Функция работает только для постов с установленными миниатюрами
– Частые проблемы
- Возвращает null, если миниатюра не задана
- Некорректный размер может привести к неожиданным результатам
