Default featured image

常見問題集

選取的預設精選圖片並未顯示，外掛無法正確執行的原因為何？

這個外掛在大多數的情況下，安裝啟用後便立即可用。如果外掛無法執行，請嘗試以下操作。

• 切換佈景主題。有些佈景主題會有非常規的執行方式。
• 檢查網站是否使用 WordPress 核心程式功能取得圖片 (請參考下一條)。
• 檢查一般精選圖片是否正常。
• 檢查是否透過 CSS 隱藏精選圖片？Default featured image 可使用 default-featured-img 類別達成這個目的。

如果仍然發生問題，請與我聯絡，讓我了解問題的發生原因。

哪些是網站管理員可以用來顯示精選圖片的函式？

這個外掛並未使用新的函式，全部使用 WordPress 核心程式內建的函式。

• the_post_thumbnail / get_the_post_thumbnail 會顯示圖片。
• the_post_thumbnail_url / get_the_post_thumbnail_url 會取得網址。
• 如果設定了 Default featured image，has_post_thumbnail 便會永遠傳回 true。
• get_post_thumbnail_id 會傳回在文章或 Default featured image 中設定的 ID。

是否能為自訂內容類型設定不同圖片？

可以。下列程式碼片段能讓每個自訂內容類型設定不同的預設精選圖片。

add_filter( 'dfi_thumbnail_id', 'dfi_posttype_book', 10, 2 );
function dfi_posttype_book( $dfi_id, $post_id ) {
    $post = get_post( $post_id );
    if ( 'book' === $post->post_type ) {
        return 31; // the image id for the book post type.
    }

    return $dfi_id; // the original featured image id.
}

是否能為每個分類設定不同圖片？

可以。下列程式碼片段能讓每個分類設定不同的預設精選圖片。

add_filter( 'dfi_thumbnail_id', 'dfi_category', 10, 2 );
function dfi_category( $dfi_id, $post_id ) {
    // Set a different image for posts that have the 'cats' category set.
    // This will trigger first, if multiple categories have been set.
    if ( has_category( 'cats', $post_id ) ) {
        return 7; // cats img id.
    }
    // Set a different image for posts that have the 'cats' category set.
    if ( has_category( 'dogs', $post_id ) ) {
        return 8; // dogs img id.
    }

    return $dfi_id; // the original featured image id.
}

是否能變更預設精選圖片的 HTML 程式碼？

啟用這個外掛後，它會新增額外的 default-featured-img 類別，這個類別可用於進行樣式化。

如果需要變更更多項目，可以使用 dfi_thumbnail_html 篩選器變更全部 HTML 程式碼。

add_filter( 'dfi_thumbnail_html', 'dfi_add_class', 10, 5 );
function dfi_add_class( $html, $post_id, $default_thumbnail_id, $size, $attr ) {
    // Add a class to the existing class list.
    $attr['class'] .= ' my-class';

    return wp_get_attachment_image( $default_thumbnail_id, $size, false, $attr );
}

是否能讓某個頁面不使用預設的精選圖片？

下列程式碼片段能讓 ID 為 23 的文章/頁面不使用預設的精選圖片。

add_filter( 'dfi_thumbnail_id', 'dfi_skip_page', 10, 2 );
function dfi_skip_page( $dfi_id, $post_id ) {
    if ( $post_id == 23 ) {
        return 0; // invalid id.
    }

    return $dfi_id; // the original featured image id.
}