
本文详解如何修改 woocommerce 邮件模板中的 wc_get_email_order_items() 函数调用,将默认的缩略图(thumbnail)替换为产品主图(full)、单页大图(woocommerce_single)等更高质量图像尺寸。
在 WooCommerce 默认邮件模板(如订单确认邮件)中,商品列表通常通过 wc_get_email_order_items() 函数渲染。该函数内置支持图片显示,但其 image_size 参数默认值为 'thumbnail',因此仅展示低分辨率缩略图,无法满足品牌化邮件对视觉呈现的要求。
要显示更高清、更具表现力的产品主图(即后台设置的“特色图像”/Featured Image),只需将 image_size 参数由数组(如 array(75, 75))或 'thumbnail' 显式改为 'full':
$sent_to_admin,
'show_image' => true,
'image_size' => 'full', // ✅ 关键修改:使用 'full' 获取原始上传尺寸主图
'plain_text' => $plain_text,
'sent_to_admin' => $sent_to_admin,
) );
?>image_size 支持以下常用值:
- 'full':原始上传图像尺寸(推荐用于邮件主图,兼顾清晰度与适配性)
- 'woocommerce_single':WooCommerce 单品页标准尺寸(默认 600×600,可于「WooCommerce → 设置 → 产品 → 显示」中调整)
- 'woocommerce_thumbnail':列表页缩略图(默认 300×300)
- 'woocommerce_gallery_thumbnail':相册缩略图(默认 100×100)
- 自定义尺寸数组,如 array(400, 400)(需确保该尺寸已通过 add_image_size() 注册)
⚠️ 注意事项:
- 使用 'full' 时,请确保后台上传的产品主图本身分辨率足够(建议 ≥800px 宽),避免邮件中拉伸模糊;
- 部分主题或插件可能覆写了图片尺寸注册逻辑,若 'full' 未生效,可临时添加 add_image_size( 'email_full', 600, 600, true ); 并改用 'email_full';
- 邮件客户端对
标签样式兼容性有限,建议配合内联 CSS 控制最大宽度(如 style="max-width:90%"),防止在移动端溢出;
- 修改前请务必复制并覆盖对应邮件模板文件至子主题路径:/wp-content/themes/your-child-theme/woocommerce/emails/email-order-items.php,避免更新后丢失自定义。
通过这一简洁调整,即可显著提升 WooCommerce 订单邮件的专业度与用户体验——让每一张产品图都真正“代表品牌”。










