Содержание
Функция wp_get_attachment_image_src() – возвращает массив данных о медиафайле (картинке, миниатюре, изображению) wordpress:
- Ссылка на медиафайл wordpress
- Размер: ширина изображения
- Размер: высота изображения.
В первом элементе массива хранится прямая ссылка на медиафайл, в том числе ссылка на миниатюру wordpress.
Основная задача этой функции — получение прямых ссылок на медиафайлы WP в переменную PHP для использования в любом месте макета.
Преимуществом такого подхода к получению медиа является отсутствие мусорного хтмл кода, ведь вы всегда можете настроить вывод под себя.
Параметры функции wp_get_attachment_image_src
wp_get_attachment_image_src( $attachment_id, $size, $icon )
Параметр | Тип данных | Описание |
$attachment_id | число | идентификатор (Ид) изображения |
$size | строка / массив |
размер картинки, который нам нужен. Можно указывать зарезервированные строки:
или же указать данные в виде числового массива, например array(200,200)
Функция wp_get_attachment_image_src возвращает
В результате своей работы, функция wp_get_attachment_image_src возвращает массив из 3 эллементов:
Получает URL картинки-вложения по переданному ID картинки. Также, можно указать размер картинки, URL на которую нужно получить.
Возвращает
Строку/false. URL картинки или false если картинки нет.
Использование
Размер картинки, URL на которую нужно получить.
В этом параметре можно указывать базовые WordPress размеры: thumbnail , medium , large или full .
Также, можно указать размер в массиве, в виде двух элементов (ширина, высота): array(32, 32) . В этом случае будет подобран наиболее подходящий размер из имеющихся, затем картинка будет сжата/растянута до указанных размеров. С версии 2.5. этот параметр не влияет на размер медиа-иконок (иконок для файлов), они всегда показываются в оригинальном размере.
По умолчанию: ‘thumbnail’
$icon(логический) Ставим в true, чтобы выводить URL на медиа-иконки для вложений, если это не картинка, а например .zip архив.
По умолчанию: false
Возвращает массив данных об указанной картинке: URL, ширина, высота картинки-вложения.
Заметка: первый (нулевой) элемент массива используйте для атрибута src .
C версии 4.4 появилась функция wp_get_attachment_image_url() — сразу возвращает URL, работает на основе этой функции.
Хуки из функции
Возвращает
Массив содержащий следующие данные:
Использование
Размер картинки, данные о которой нужно получить. Отличаться будет ссылка. В этом параметре можно указывать предусмотренные в WordPress размеры ( thumbnail , medium , large или full ).
Так же можно указать размер в массиве в виде двух элементов (ширина, высота): array(32,32) . В этом случае будет подобран наиболее подходящий размер из имеющихся, затем картинка будет сжата/растянута до указанных размеров. С версии 2.5. этот параметр не влияет на размер медиа иконок (иконок для файлов), они всегда показываются в оригинальном размере.
По умолчанию: ‘thumbnail’
$icon(логический) Ставим в true (1), чтобы показывать медиа-иконки для вложений не картинок (.zip, .rar и т.д.)
По умолчанию: false
Примеры
#1. Использование по умолчанию
Выведем html код картинки вложения с >
#2. Изменение директории иконок
В WordPress для показа картинок для вложенных файлов (не картинок) используются специальные иконки. За такой показ отвечает параметр $icon в этой функции. Так, для вложений картинок выводится миниатюра, а для остальных файлов выводится соответствующая его типу икона. Например, для .mp3 файла будет показана картинка audio.jpg из папки: wp-includes/images/crystal/ ).
Этот пример показывает, как можно изменить раздел откуда будут браться такие медиа-иконки. Изменим директорию по умолчанию на папку темы: wp-content/themes/yourtheme/images (разумеется в эту папку нужно разместить картинки для разных типов файлов).