wordpress獲取文章特色影象路徑函式wp_get_attachment_image_src()
阿新 • • 發佈:2018-12-16
特色影象是wordpress主要的文章縮圖功能,幾乎全部wordpress模板都使用或支援特色影象。今天介紹的wp_get_attachment_image_src()函式就是獲取文章特色影象路徑的wordpress函式,通過該函式可以返回一個包含圖片路徑、寬度和高度的有序陣列。
函式結構:
<?php wp_get_attachment_image_src( $attachment_id, $size, $icon ); ?>
返回值:
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地址:
<?php $getThumbnail = wp_get_attachment_image_src( get_post_thumbnail_id(get_the_ID()),full); echo $getThumbnail[0]; ?>
2、官方示例:
<?php $attachment_id = 8; // 附件ID $image_attributes = wp_get_attachment_image_src( $attachment_id ); // 返回一個數組 if( $image_attributes ) { ?> <img src="<?php echo $image_attributes[0]; ?>" width="<?php echo $image_attributes[1]; ?>" height="<?php echo $image_attributes[2]; ?>"> <?php } ?
函式位置:
wp_get_attachment_image_src()
位於wp-includes/media.php