1. 程式人生 > >wordpress獲取文章特色圖像路徑函數wp_get_attachment_image_src()

wordpress獲取文章特色圖像路徑函數wp_get_attachment_image_src()

med clu mage icon php 如果 說明 功能 視頻

特色圖像是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

wordpress獲取文章特色圖像路徑函數wp_get_attachment_image_src()