如何使用filter來指定jetpack的圖片參數

111 瀏覽

2026-02-04 更新

最近發現如果開啟jetpack的話，在手機瀏覽網頁會讓產品縮圖的解析度太差。

主要是jetpack的參數fit為300，導致封面如果有上中文字體的話就會太糊。

可以透過程式碼片段外掛安裝後新增以下的程式碼hook即可。

add_filter( 'jetpack_photon_pre_args', function( $args ) {
// 1. 檢查是否為手機版
// 2. 檢查是否為 WooCommerce 的產品列表頁、分類頁或標籤頁
if ( wp_is_mobile() && ( is_shop() || is_product_category() || is_product_tag() ) ) {

    // 如果原本就有 fit 參數，我們將其覆蓋為較清晰的尺寸
    // 建議設定在 600~800 之間，足以應對大多數手機的 2x/3x 螢幕
    $target_width = 600;
    $target_height = 600;

    // 強制注入新的尺寸參數
    $args['fit'] = $target_width . ',' . $target_height;

    // 確保 resize 不會干擾 fit
    unset( $args['resize'] );
}

return $args;

}, 20, 1 ); // 提高優先級確保在其他插件之後執行