WordPress特色圖片代碼詳解，設置與調(diào)用方法

來自：素雅營銷研究院

方知筆記

2025年06月06日 16:13

特色圖片（Featured Image）是WordPress中一個重要的功能，它允許為每篇文章或頁面設置一張代表性圖片。本文將詳細介紹如何在WordPress中使用代碼來設置和調(diào)用特色圖片。

一、特色圖片的基本概念

特色圖片（在早期版本中稱為”縮略圖”）是WordPress主題用來展示文章摘要時的主要視覺元素。它通常出現(xiàn)在文章列表、存檔頁面和社交媒體分享中。

二、在主題中啟用特色圖片功能

在開始使用特色圖片前，需要確保你的主題支持這一功能。在你的主題的functions.php文件中添加以下代碼：

// 啟用文章和頁面的特色圖片功能
add_theme_support('post-thumbnails');

如果需要為自定義文章類型啟用特色圖片，可以這樣寫：

// 為特定文章類型啟用特色圖片
add_theme_support('post-thumbnails', array('post', 'page', 'custom_post_type'));

三、在模板中調(diào)用特色圖片

1. 基本調(diào)用方法

在主題模板文件中，可以使用以下代碼顯示特色圖片：

if (has_post_thumbnail()) {
the_post_thumbnail();
}

2. 指定圖片尺寸

WordPress允許你注冊自定義圖片尺寸，并在調(diào)用時指定：

// 在functions.php中注冊新尺寸
add_image_size('custom-size', 800, 400, true);

// 在模板中調(diào)用特定尺寸
the_post_thumbnail('custom-size');

3. 帶參數(shù)的調(diào)用方式

你可以為特色圖片添加更多參數(shù)：

the_post_thumbnail('medium', array(
'class' => 'featured-image',
'alt' => get_the_title(),
'title' => get_the_title()
));

四、獲取特色圖片URL

有時你可能需要直接獲取特色圖片的URL而不是直接輸出：

if (has_post_thumbnail()) {
$featured_image_url = get_the_post_thumbnail_url(get_the_ID(), 'full');
echo '<img src="'.$featured_image_url.'" alt="'.get_the_title().'">';
}

五、設置默認特色圖片

當文章沒有設置特色圖片時，可以顯示默認圖片：

$default_image = get_template_directory_uri().'/images/default.jpg';
$featured_image = has_post_thumbnail() ? get_the_post_thumbnail_url() : $default_image;
echo '<img src="'.$featured_image.'" alt="'.get_the_title().'">';

六、特色圖片的高級用法

1. 獲取特色圖片ID

$thumbnail_id = get_post_thumbnail_id($post->ID);

2. 使用特色圖片ID獲取圖片信息

$image_attributes = wp_get_attachment_image_src($thumbnail_id, 'large');
if ($image_attributes) {
echo '<img src="'.$image_attributes[0].'" width="'.$image_attributes[1].'" height="'.$image_attributes[2].'">';
}