如何在 WooCommerce 邮件模板中显示商品的完整尺寸图片(而非缩略图)

12次阅读

如何在 WooCommerce 邮件模板中显示商品的完整尺寸图片(而非缩略图)

默认情况下,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 邮件中展示商品真正的完整尺寸特色图像——简洁、有效,且完全兼容核心机制。

text=ZqhQzanResources