Описание функции the_post_thumbnail()
Функция the_post_thumbnail() используется для отображения миниатюры записи в WordPress. Она позволяет выводить изображение миниатюры с заданными параметрами, такими как размер и дополнительные атрибуты. Эта функция часто применяется в темах для отображения изображений, связанных с записями, и поддерживает различные форматы изображений и их стили.
Также функция поддерживает возвращение HTML-кода для миниатюры, что позволяет легко интегрировать ее в шаблоны.
Параметры
$size
Тип: string|array
Обязательный: Нет
По умолчанию: ‘post-thumbnail’
Описание: Размер миниатюры, который будет использован для отображения
Возможные значения:
string: thumbnail, medium, large, full, custom_size
array: ширина, высота
$attr
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив дополнительных атрибутов для тега
Возможные значения:
class: CSS класс
alt: Альтернативный текст
title: Заголовок изображения
Возвращаемое значение
Тип: string|null
Описание: HTML-код изображения или null, если миниатюра не существует
Возможные значения:
• HTML-код тега при наличии миниатюры
• null если миниатюра не задана
Примеры использования
Простой вызов для отображения миниатюры записи
the_post_thumbnail();
// Выводит миниатюру записи, если она установлена
Если миниатюра не установлена, ничего не будет выведено
Указание размера и атрибутов для миниатюры
the_post_thumbnail('medium', array('class' => 'custom-class', 'alt' => 'Описание изображения'));
// Выводит миниатюру среднего размера с кастомным классом
Миниатюра будет иметь класс ‘custom-class’ и альтернативный текст
Безопасность
Валидация входных данных: Параметры size и attr проходят валидацию.
Санитизация: Входные параметры автоматически очищаются WordPress.
Рекомендации: При выводе изображений используйте функции sanitization для атрибутов, особенно для alt и title.
— Связанные функции
Получает HTML-код миниатюры без вывода.
Проверяет, установлена ли миниатюра для записи.
— Хуки
Фильтрует HTML-код миниатюры перед выводом.
— Примечания
– Ограничения
Миниатюра должна быть установлена в редакторе записи.
– Частые проблемы
- null возвращается, если миниатюра не установлена.
- Неправильные размеры могут вызвать искажение изображения.
