wp_get_attachment_image_src()
Получает массив данных указанной картинки: URL, ширина, высота картинки-вложения.
Заметка: первый (нулевой) элемент массива используйте для атрибута src
.
Используйте wp_get_attachment_image_url(), когда нужно получить готовый URL.
Хуки из функции
Возвращает
Массив|false
. Массив содержащий следующие данные:
[0] => url [1] => width [2] => height [3] => is_intermediate
Использование
$src = wp_get_attachment_image_src( $attachment_id, $size, $icon );
- $attachment_id(число) (обязательный)
- ID вложения-картинки, данные которой нужно получить.
- $size(строка/массив)
Размер картинки, данные о которой нужно получить. В этом параметре можно указывать предусмотренные в WordPress размеры (
thumbnail
,medium
,large
илиfull
).Так же можно указать размер в массиве в виде двух элементов (ширина, высота):
array(32,32)
. В этом случае будет подобран наиболее подходящий размер из имеющихся, затем картинка будет сжата/растянута до указанных размеров. С версии 2.5. этот параметр не влияет на размер медиа иконок (иконок для файлов), они всегда показываются в оригинальном размере.По умолчанию: 'thumbnail'
- $icon(логический)
- Ставим в true (1), чтобы показывать медиа-иконки для вложений не картинок (.zip, .rar и т.д.)
По умолчанию: false
Примеры
#1 Использование по умолчанию
Выведем html код картинки вложения с ID=8:
<?php $attachment_id = 8; // ID вложения $image_attributes = wp_get_attachment_image_src( $attachment_id ); // вернулся массив array ?> <img src="<?php echo $image_attributes[0] ?>" width="<?php echo $image_attributes[1] ?>" height="<?php echo $image_attributes[2] ?>">
#2 Изменение директории иконок
В WordPress для показа картинок для вложенных файлов (не картинок) используются специальные иконки. За такой показ отвечает параметр $icon
в этой функции. Так, для вложений картинок выводится миниатюра, а для остальных файлов выводится соответствующая его типу икона. Например, для .mp3 файла будет показана картинка audio.jpg из папки: wp-includes/images/crystal/
).
Этот пример показывает, как можно изменить раздел откуда будут браться такие медиа-иконки. Изменим директорию по умолчанию на папку темы: wp-content/themes/yourtheme/images
(разумеется в эту папку нужно разместить картинки для разных типов файлов).
add_filter('icon_dir', 'my_theme_icon_dyrectory'); function my_theme_icon_dyrectory($icon_dir) { return TEMPLATEPATH . '/images'; } add_filter('icon_dir_uri', 'my_theme_icon_uri'); function my_theme_icon_uri($icon_dir) { return get_bloginfo('stylesheet_directory').'/images'; }
Размещать этот код надо в файл темы functions.php
Список изменений
С версии 2.5.0 | Введена. |