WordPress 從 2.9 版開始支援文章特色影像功能,使用 WordPress 的特色影像功能,會使用網站更加規範,提高頁面載入速度,如何讓主題支援特色影像功能很簡單。
第一步,新增主題對特色影像功能的支援
將下面程式碼主題 functions.php 檔案中:
// 新增特色影像功能
add_theme_support('post-thumbnails');
set_post_thumbnail_size(130, 100, true); // 圖片寬度與高度
其中圖片的長寬可以自行修改。
第二步,新增特色影像呼叫程式碼
將下面的程式碼新增到主題模板的適當位置,比如分類歸檔模板 archive.php 主循中:
<?php
if (has_post_thumbnail()) {
     // 顯示特色影像
     the_post_thumbnail();
} else {
     // 設定特色影像
     $attachments = get_posts(array(
          'post_type' => 'attachment',
          'post_mime_type'=>'image',
          'posts_per_page' => 0,
          'post_parent' => $post->ID,
          'order'=>'ASC'
     ));
     if ($attachments) {
          foreach ($attachments as $attachment) {
               set_post_thumbnail($post->ID, $attachment->ID);
               break;
          }
          // 顯示特色影像
          the_post_thumbnail();
     }
} ?>
程式碼說明,如果未手動設定特色影像,那麼會自動呼叫第一個圖片附件的 「縮圖」 作為特色影像,並顯示它。
注:程式碼中所使用的 WP 函式:
has_post_thumbnail()
set_post_thumbnail()
the_post_thumbnail()
可以到官方 Codex 檢視詳細使用說明,並根據需要加以修改。
呼叫顯示特色影像還可以使用另一種方法:
如果你認為將特色影像呼叫程式碼加到主題模板主迴圈中看上去會很亂,可以將下面的程式碼新增到主題 functions.php 檔案中:
// 特色影像
add_filter('the_content', 'set_featured_image_from_attachment');
function set_featured_image_from_attachment($content) {
     global $post;
     if (has_post_thumbnail()) {
          // 顯示特色影像
          $content = the_post_thumbnail() . $content;
     } else {
          // 獲取和設定特色影像
          $attachments = get_children(array(
               'post_parent' => $post->ID,
               'post_status' => 'inherit',
               'post_type' => 'attachment',
               'post_mime_type' => 'image',
               'order' => 'ASC',
               'orderby' => 'menu_order'
          ));
          if ($attachments) {
               foreach ($attachments as $attachment) {
                    set_post_thumbnail($post->ID, $attachment->ID);
                    break;
               }
               // 顯示特色影像
               $content = the_post_thumbnail() . $content;
          }
     }
     return $content;
}
這段程式碼基本原理與上面的相同 , 除了使用 get_children 過濾 the_content(),而不是 get_posts() 。