Описание функции get_the_post_thumbnail()
Функция get_the_post_thumbnail() возвращает HTML-код миниатюры записи (изображения) для указанной записи. Она используется для отображения изображения записи на страницах, в записях и в других местах в темах WordPress.
Функция поддерживает различные размеры изображений и может принимать дополнительные атрибуты для настройки вывода
Параметры
$post_id
Тип: int
Обязательный: Да
Описание: ID записи, для которой требуется получить миниатюру
Возможные значения:
$size
Тип: string
Обязательный: Нет
По умолчанию: ‘post-thumbnail’
Описание: Размер изображения, который нужно получить
Возможные значения:
0: thumbnail
1: medium
2: large
3: full
4: custom_size
$attr
Тип: array/string
Обязательный: Нет
По умолчанию: »
Описание: Дополнительные атрибуты для тега
Возможные значения:
Возвращаемое значение
Тип: string
Описание: HTML-код миниатюры записи или пустая строка
Возможные значения:
• HTML-код изображения при успешном выполнении
• Пустая строка если миниатюра не установлена
Примеры использования
Получение миниатюры для записи с ID 1
$thumbnail = get_the_post_thumbnail(1);
// Вывод миниатюры записи с ID 1
echo $thumbnail;
Выводит HTML-код миниатюры или пустую строку
Получение миниатюры с указанием размера и атрибутов
$thumbnail = get_the_post_thumbnail(1, 'medium', array('class' => 'custom-class'));
// Миниатюра с размером 'medium' и дополнительным классом
class=’custom-class’ добавляется к тегу
Проверка на наличие миниатюры
$thumbnail = get_the_post_thumbnail(99999);
if (empty($thumbnail)) {
echo 'Миниатюра не найдена';
} else {
echo $thumbnail;
}
Выводит сообщение, если миниатюра не найдена
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Атрибуты автоматически очищаются WordPress
Рекомендации: Используйте esc_attr() для атрибутов, чтобы избежать XSS-уязвимостей
— Связанные функции
Проверяет, назначена ли миниатюра записи
Устанавливает миниатюру для записи
— Хуки
Фильтрует HTML-код миниатюры перед выводом
— Примечания
– Ограничения
Миниатюра должна быть предварительно назначена записи
– Частые проблемы
- Пустая строка при отсутствии миниатюры
- Ошибки при использовании неверного ID записи
