特色图像是wordpress主要的文章缩略图功能,几乎全部wordpress模板都使用或支持特色图像。今天介绍的wp_get_attachment_image_src()函数就是获取文章特色图像路径的wordpress函数,通过该函数可以返回一个包含图片路径、宽度和高度的有序数组。
函数结构:
1 |
<?php wp_get_attachment_image_src( $attachment_id, $size, $icon ); ?> |
返回值:
1 2 3 4 5 6 7 |
Array ( [0] => url //图片地址 [1] => width //图片宽度 [2] => height //图片高度 [3] => boolean //true表示返回了缩放后的图片,false表示返回了原始图片 ) |
参数说明:
$attachment_id
– 数值,必需,想要获取信息的附件ID,默认值:None
$size
– 字符串,获取指定尺寸的图像,默认值:None,可选thumbnail, medium, large or full(对应后台——设置——多媒体的图像大小 ,full表示原始尺寸),或通过array(300,240)
自定义图片大小。需要注意的是WordPress 2.5 以前的版本是没有 $size 参数的,只显示原始尺寸。
$icon
– 布尔,可选,是否使用媒体图标来表示当前附件,比如:如果要获取的附件不是一张图片,而是,比如说视频,让$icon为真可以返回代表视频(mime type:video)的图标,否则只能返回空值。这些代表不同mime type的图片在wp-includes/images/crystal目录下
示例:
1、获取文章缩略图url地址:
1 2 3 4 |
<?php $getThumbnail = wp_get_attachment_image_src( get_post_thumbnail_id(get_the_ID()),full); echo $getThumbnail[0]; ?> |
2、官方示例:
1 2 3 4 5 6 7 |
<?php $attachment_id = 8; // 附件ID $image_attributes = wp_get_attachment_image_src( $attachment_id ); // 返回一个数组 if( $image_attributes ) { ?> <img src="<?php%20echo%20$image_attributes[0];%20?>" width="<?php echo $image_attributes[1]; ?>" height="<?php echo $image_attributes[2]; ?>"> <?php } ?> |
函数位置:
wp_get_attachment_image_src()
位于wp-includes/media.php