
默认情况下,woocommerce 邮件中的商品图片使用 `thumbnail` 尺寸;本文详解如何通过修改 `image_size` 参数,强制在订单邮件中显示商品的「特色图像」或原始上传的「完整尺寸图像」。
在 WooCommerce 的邮件模板(如 emails/customer-processing-order.php 或自定义邮件模板)中,调用 wc_get_email_order_items() 是渲染订单商品列表的标准方式。该函数支持多项配置参数,其中 image_size 决定了商品图片的尺寸输出。
默认代码通常如下(显示的是小缩略图):
$sent_to_admin,
'show_image' => true,
'image_size' => array( 75, 75 ), // 自定义像素尺寸 → 仍属缩略图范畴
'plain_text' => $plain_text,
'sent_to_admin' => $sent_to_admin,
) ); ?>要显示商品的完整尺寸原图(即上传时的原始分辨率),只需将 'image_size' 参数设为 'full':
$sent_to_admin,
'show_image' => true,
'image_size' => 'full', // ✅ 关键修改:使用 'full' 显示原始图像
'plain_text' => $plain_text,
'sent_to_admin' => $sent_to_admin,
) ); ?>image_size 支持以下常用值:
- 'thumbnail'(默认):WordPress 默认缩略图(通常 150×150)
- 'woocommerce_thumbnail':WooCommerce 专用缩略图(常为 300×300)
- 'woocommerce_single':单商品页主图尺寸(默认 600×600)
- 'woocommerce_gallery_thumbnail':相册缩略图(默认 100×100)
- 'full':✅ 原始上传图像(无裁剪、无压缩,保留全部分辨率)
- array( width, height ):如 array(800, 600),按比例缩放(非裁剪)
⚠️ 注意事项:
- 使用 'full' 时,请确保服务器允许加载大图——若商品图普遍超过 2MB,可能影响邮件加载速度与兼容性(尤其 Outlook 等客户端会自动屏蔽大图或降质处理);
- 部分主题或插件可能注册了自定义图片尺寸(如 'product_hero'),可通过 get_intermediate_image_sizes() 验证可用尺寸;
- 若需统一控制所有邮件中的图片尺寸,建议在子主题的 functions.php 中使用 woocommerce_email_order_items_table 过滤器进行全局覆盖,而非逐个修改模板。
综上,将 image_size 从数组或 'thumbnail' 替换为 'full',即可让 WooCommerce 邮件中展示商品真正的完整尺寸特色图像——简洁、有效,且完全兼容核心机制。










