Описание функции wp_get_attachment_thumb_url()
Функция wp_get_attachment_thumb_url() возвращает URL миниатюры (thumbnail) для заданного вложения. Используется для получения изображения миниатюры, связанного с записью или вложением, что позволяет отображать его в шаблонах и на страницах.
Функция применяется в темах и плагинах для работы с изображениями и вложениями
Параметры
$attachment_id
Тип: int
Обязательный: Да
Описание: ID вложения, для которого необходимо получить URL миниатюры
Возможные значения:
Возвращаемое значение
Тип: string|null
Описание: Возвращает URL миниатюры или null, если миниатюра не найдена
Возможные значения:
• URL миниатюры в виде строки при успешном выполнении
• null если миниатюра не найдена
Примеры использования
$thumbnail_url = wp_get_attachment_thumb_url(123);
// Вывод результата
echo $thumbnail_url; // Примерный вывод: 'http://example.com/wp-content/uploads/2023/01/image-thumb.jpg'
Проверка наличия миниатюры перед выводом
$thumbnail_url = wp_get_attachment_thumb_url(456);
if ($thumbnail_url) {
echo $thumbnail_url;
} else {
echo 'Миниатюра не найдена';
}
Безопасность
Валидация входных данных: Функция ожидает целое число в качестве ID
Санитизация: WordPress обрабатывает входные данные и предотвращает SQL-инъекции
Рекомендации: Используйте intval() для явного преобразования ID перед передачей в функцию
— Связанные функции
Возвращает массив с URL изображения, шириной и высотой
Получает ID миниатюры записи
— Примечания
– Ограничения
Миниатюра должна быть создана для вложения, иначе функция вернет null
– Частые проблемы
- Неправильный ID вложения приведет к null
- Миниатюра может отсутствовать при отсутствии соответствующего изображения
