Описание функции wp_get_attachment_image()
Функция wp_get_attachment_image() используется для получения HTML-кода изображения вложения с соответствующими атрибутами. Это позволяет легко отображать изображения в темах и плагинах WordPress.
Функция поддерживает различные размеры изображений и атрибуты, что делает её гибкой для использования в различных контекстах.
Параметры
$attachment_id
Тип: int
Обязательный: Да
Описание: ID вложения (изображения), для которого нужно получить HTML-код
Возможные значения:
$size
Тип: string|array
Обязательный: Нет
По умолчанию: thumbnail
Описание: Размер изображения. Может быть строкой (например, ‘thumbnail’, ‘medium’, ‘large’) или массивом с шириной и высотой
Возможные значения:
string: thumbnail, medium, large, full
array: ширина, высота
$attr
Тип: string|array
Обязательный: Нет
Описание: Дополнительные атрибуты для тега . Могут быть переданы в виде строки или массива
Возвращаемое значение
Тип: string|false
Описание: HTML-код изображения или false в случае ошибки
Возможные значения:
• HTML-код тега с атрибутами
• false если вложение не найдено или не является изображением
Примеры использования
Базовый пример получения HTML-кода изображения по ID
$image = wp_get_attachment_image(123);
// Вывод: <img data-lazyloaded="1" src="data:image/gif;base64,R0lGODdhAQABAPAAAMPDwwAAACwAAAAAAQABAAACAkQBADs=" data-src='URL_изображения' alt='...' />
Замените 123 на реальный ID изображения
Получение изображения размером medium
$image = wp_get_attachment_image(123, 'medium');
// Вывод: <img data-lazyloaded="1" src="data:image/gif;base64,R0lGODdhAQABAPAAAMPDwwAAACwAAAAAAQABAAACAkQBADs=" data-src='URL_изображения' alt='...' />
Размеры могут быть ‘thumbnail’, ‘medium’, ‘large’, ‘full’
Пример добавления классов и alt-атрибута
$image = wp_get_attachment_image(123, 'large', false, array('class' => 'responsive', 'alt' => 'Описание'));
// Вывод: <img data-lazyloaded="1" src="data:image/gif;base64,R0lGODdhAQABAPAAAMPDwwAAACwAAAAAAQABAAACAkQBADs=" data-src='URL_изображения' class='responsive' alt='Описание' />
Дополнительные атрибуты могут быть переданы в виде массива
Безопасность
Валидация входных данных: Входные параметры проверяются на корректность
Санитизация: Функция автоматически очищает входные данные
Рекомендации: Используйте esc_attr() для атрибутов, чтобы избежать XSS-уязвимостей
— Связанные функции
Получает URL изображения и его размеры
Получает метаданные изображения
— Хуки
Фильтрует атрибуты изображения перед выводом
— Примечания
– Ограничения
Работает только с изображениями, возвращает false для других типов вложений
– Частые проблемы
- False, если ID вложения неверный или не изображение
- Ошибки при передаче неверных параметров для атрибутов
