在WooCommerce的运营中，定制化邮件模板是提升用户体验和品牌专业度的关键一环。无论是添加特殊格式的文本，还是插入动态的订单信息，都需要对邮件模板进行精确的修改。本教程将介绍两种主要方法：通过PHP代码直接实现高级定制，以及利用专业的邮件定制插件来简化流程。
方法一：使用PHP进行高级文本格式化与动态内容插入
直接通过PHP代码修改WooCommerce邮件模板，可以实现高度的灵活性和精确控制。这通常涉及到对主题或插件文件的修改，并需要注意代码的安全性。
1. 实现斜体文本：wp_kses与HTML标签的正确使用
在WooCommerce邮件中，如果需要插入斜体（zuojiankuohaophpcni>或<em>）或其他HTML标签，并结合printf和wp_kses进行国际化处理，需要确保wp_kses允许这些标签。wp_kses是WordPress用于过滤HTML的安全函数，它会根据定义好的允许标签列表来清理字符串。
问题分析： 原始代码中，wp_kses的$allowed_html数组只允许了<a>标签，因此<i>标签会被移除。
解决方案： 在$allowed_html数组中明确添加<i>或<em>标签及其允许的属性。
<?php if ( $order->needs_payment() ) { ?>
<p>
<?php
$allowed_html_tags = array(
'a' => array(
'href' => array(),
),
'i' => array(), // 允许<i>标签
'em' => array(), // 或者允许<em>标签，语义上更推荐
);
printf(
wp_kses(
/* translators: %1$s Site title, %2$s Order pay link */
__( 'We’re delighted to let you know that the first print of <i>The Versatile Home</i> is now available and we are able to fulfil your pre-order. Your invoice is below and here is a link to make payment: %2$s', 'woocommerce' ),
$allowed_html_tags // 使用更新后的允许标签列表
),
esc_html( get_bloginfo( 'name', 'display' ) ),
'<a href="' . esc_url( $order->get_checkout_payment_url() ) . '">' . esc_html__( 'click here to pay by credit/debit card or PayPal', 'woocommerce' ) . '</a>'
);
?>
</p>
<?php } ?>通过上述修改，<i>The Versatile Home</i>将能够正确显示为斜体。
2. 添加第二段落与动态订单号
要在邮件中添加额外的段落，并插入动态的订单号作为银行转账参考，可以通过字符串拼接或再次调用printf来实现。WooCommerce的订单对象$order提供了获取订单信息的各种方法。
实现步骤：
- 构建第二段落的HTML内容。
- 使用$order->get_order_number()获取当前订单的编号。
- 将完整的HTML内容输出。
完整代码示例：
<?php if ( $order->needs_payment() ) { ?>
<p>
<?php
$allowed_html_tags = array(
'a' => array(
'href' => array(),
),
'i' => array(),
'em' => array(),
);
// 第一段内容
printf(
wp_kses(
/* translators: %1$s Site title, %2$s Order pay link */
__( 'We’re delighted to let you know that the first print of <i>The Versatile Home</i> is now available and we are able to fulfil your pre-order. Your invoice is below and here is a link to make payment: %2$s', 'woocommerce' ),
$allowed_html_tags
),
esc_html( get_bloginfo( 'name', 'display' ) ),
'<a href="' . esc_url( $order->get_checkout_payment_url() ) . '">' . esc_html__( 'click here to pay by credit/debit card or PayPal', 'woocommerce' ) . '</a>'
);
?>
</p>
<p>
<?php
// 获取订单号
$order_number = $order->get_order_number();
// 第二段内容，包含动态订单号
printf(
wp_kses(
/* translators: %1$s Order number */
__( 'Alternatively, you can make payment by bank transfer to Sort Code: 00-00-00, Acct #: 00000000, Acct name: xxxxx, quoting order # %1$s as the reference. As soon as we’ve received the payment we’ll get your order off to you straight away.', 'woocommerce' ),
$allowed_html_tags // 沿用第一段的允许标签列表，尽管这里可能不需要斜体
),
esc_html( $order_number ) // 确保订单号被安全输出
);
?>
</p>
<?php } ?>PHP定制的注意事项
- 安全性： 始终使用wp_kses()、esc_html()、esc_url()等WordPress提供的安全函数来过滤和转义用户输入或动态内容，以防止XSS（跨站脚本攻击）等安全漏洞。
-
可维护性： 直接修改WooCommerce核心文件或插件文件是不可取的，因为更新时这些修改会被覆盖。建议通过以下方式进行：
- 子主题： 在子主题中覆盖WooCommerce的邮件模板文件（路径通常为your-theme/woocommerce/emails/email-customer-processing-order.php等）。
- 钩子（Hooks）： WooCommerce提供了大量的动作和过滤器钩子，可以在不修改核心文件的情况下，插入、修改或移除邮件内容。这是更推荐的专业做法。
- 国际化： 使用__()或_e()函数包装所有用户可见的文本，以便进行翻译。
方法二：借助专业邮件定制插件（如YayMail）简化流程
对于不熟悉PHP编程或希望通过可视化界面快速定制邮件的用户，使用专业的WooCommerce邮件定制插件是更为高效和便捷的选择。
1. 为何选择插件？
- 可视化编辑： 大多数插件提供拖放式编辑器，无需编写代码即可设计邮件布局。
- 丰富的模板： 内置多种预设模板和样式，可快速启动。
- 动态内容块： 轻松插入订单详情、客户信息、产品列表等动态内容。
- 兼容性： 通常与WooCommerce更新保持兼容，减少因版本升级带来的问题。
- 时间效率： 大幅缩短邮件设计和修改的时间。
2. YayMail工作原理简介
YayMail是一个广受欢迎的WooCommerce邮件定制插件，它提供了一个直观的拖放式构建器，允许用户完全控制WooCommerce的各种邮件模板。
- 界面友好： 类似于页面构建器，用户可以通过拖动元素（文本块、图片、按钮、订单详情等）来构建邮件内容。
- 实时预览： 在编辑过程中可以实时查看邮件效果。
- 动态数据支持： 插件内置了WooCommerce的动态字段，用户只需点击即可插入订单号、客户姓名、商品信息等。
- 自定义CSS/HTML： 即使是可视化编辑器，YayMail也通常允许高级用户插入自定义CSS或HTML，以实现更精细的控制。
使用YayMail这类插件，用户无需关心wp_kses的细节，也无需编写复杂的PHP代码来插入斜体或第二段落，所有操作都可以在图形界面中完成，极大地降低了技术门槛。
总结与建议
选择哪种方法取决于您的技术背景、项目需求和对灵活性的要求：
- PHP代码定制 提供了最大的灵活性和控制力，适合有开发经验的用户，或需要实现高度定制化、与现有代码深度集成的场景。但需要注意代码的安全性、可维护性，并推荐使用子主题和钩子。
- 专业邮件定制插件 （如YayMail）则为非开发者或追求效率的用户提供了便捷的可视化解决方案。它降低了技术门槛，能够快速实现美观且功能丰富的邮件模板。
无论选择哪种方式，在正式上线前，务必对定制后的邮件进行充分的测试，确保所有内容（包括动态数据）都能正确显示，并且在不同邮件客户端中都能保持良好的兼容性。
