
默认情况下,woocommerce 邮件中的商品图片使用的是 `thumbnail` 尺寸;本文教你通过修改 `image_size` 参数为 `'full'` 或其他注册尺寸(如 `'woocommerce_single'`),在订单邮件中正确显示商品主图或高清详情图。
在 WooCommerce 的邮件模板(如 customer-processing-order.php 或自定义邮件模板)中,商品列表通常通过 wc_get_email_order_items() 函数渲染。该函数支持灵活的图片尺寸控制,但默认仅显示小缩略图(thumbnail)。若需展示更清晰、更具视觉表现力的商品主图(即「特色图像」或「全尺寸图」),关键在于正确配置 image_size 参数。
✅ 正确做法是将 'image_size' 设为 'full'(对应 WordPress 全尺寸原图)或预注册的 WooCommerce 专用尺寸,例如:
$sent_to_admin,
'show_image' => true,
'image_size' => 'full', // ✅ 替换为 'full'、'woocommerce_single' 或 'large'
'plain_text' => $plain_text,
'sent_to_admin' => $sent_to_admin,
) );
?>? 支持的 image_size 值包括:
- 'full':原始上传图像(推荐用于高保真展示,需确保后台已生成对应尺寸);
- 'woocommerce_single':WooCommerce 默认单商品页尺寸(通常为 600×600,响应式友好);
- 'woocommerce_thumbnail':标准缩略图(默认值,300×300);
- 'large':WordPress 内置大图尺寸;
- 自定义数组:如 array(400, 400)(宽×高,按比例裁剪)。
⚠️ 注意事项:
- 使用 'full' 时,请确保商品图片原始分辨率足够高,且服务器未因性能原因禁用全尺寸图生成;
- 若邮件中图片不显示,请检查主题或插件是否覆盖了 wp_get_attachment_image_src() 行为,或确认图片附件 ID 有效(部分第三方图库插件可能影响 get_post_thumbnail_id());
- 在 plain_text 模式下,图片将被自动忽略(符合预期),无需额外判断;
- 如需进一步定制图片 HTML(如添加 alt 文本、懒加载或响应式 srcset),建议通过 woocommerce_email_order_items_table 钩子重构输出逻辑,而非依赖默认函数。
总结:只需将 image_size 从默认的 'thumbnail' 替换为 'full' 或更适合业务场景的尺寸,即可让 WooCommerce 订单邮件呈现专业、高质的商品主图,显著提升客户体验与品牌质感。










