WooCommerce新订单邮件产品图片无法打印问题求助

以下是针对该问题的排查和解决步骤：

• 检查图片访问权限
  Epson Connect的打印服务无法抓取需要登录验证或带防盗链的图片。确保你的WooCommerce产品图片链接是公开可访问的：关闭网站的图片防盗链功能，若使用CDN，确认CDN规则允许外部服务器（Epson的打印服务器）抓取图片。

• 调整图片格式与尺寸
  Epson Connect对WebP等小众格式支持有限，且过大的图片可能超出打印解析范围。将产品图片统一转为JPG/PNG格式；通过YAY Mail设置邮件内图片的最大宽度（建议600px以内），避免尺寸超限。

• 强制使用绝对路径引用图片
  若邮件内图片用了相对路径，Epson服务器无法解析。可添加以下代码强制生成绝对路径的图片链接：

  add_filter( 'woocommerce_email_order_items_args', 'force_absolute_image_paths_in_emails' );
  function force_absolute_image_paths_in_emails( $args ) {
      $args['show_image'] = true;
      $args['image_size'] = array( 100, 100 ); // 按需调整图片尺寸
      return $args;
  }
  
  add_filter( 'wp_get_attachment_image_src', 'convert_relative_to_absolute_image_url', 10, 4 );
  function convert_relative_to_absolute_image_url( $image, $attachment_id, $size, $icon ) {
      if ( is_email() && !empty($image[0]) ) {
          $image[0] = esc_url_raw( wp_make_link_relative( $image[0] ) ? home_url( wp_make_link_relative( $image[0] ) ) : $image[0] );
      }
      return $image;
  }
  

  将代码添加到主题的functions.php文件，或使用代码片段插件导入，无需修改核心文件。

• 配置Epson Connect的邮件加载规则
  登录Epson Connect后台，进入邮件打印设置页面，开启「允许加载外部图片」选项；若有域名白名单设置，将你的网站域名添加到白名单列表，确保Epson服务器能正常抓取图片资源。

• 简化邮件模板的HTML结构
  Epson的邮件解析引擎对复杂HTML/CSS支持较差。用YAY Mail编辑模板时，确保图片使用原生<img>标签插入，用inline样式指定宽高，避免使用CSS背景图、JS脚本或嵌套过深的HTML结构；测试纯HTML格式的模板，排除样式兼容问题。

内容的提问来源于stack exchange，提问作者Amaury Neury