在 woocommerce 商店运营中，发送给客户的邮件通知是重要的沟通渠道。虽然 woocommerce 提供了全局的邮件模板设置，但有时我们可能需要为特定类型的邮件（例如“客户订单待处理”邮件）定制其头部或底部内容，而又不影响其他邮件。直接修改 email-header.php 或 email-footer.php 模板文件会影响所有邮件，这并非我们所期望的精准定制。本文将深入探讨如何利用 woocommerce 的动作钩子机制，实现对特定邮件的头部和底部内容的精细化控制。
理解 WooCommerce 邮件钩子与参数
WooCommerce 的邮件模板，如 customer-on-hold-order.php，内部调用了两个关键的动作钩子来输出邮件的头部和底部：
- do_action( 'woocommerce_email_header', $email_heading, $email );
- do_action( 'woocommerce_email_footer', $email );
这些钩子是全局性的，意味着它们在所有 WooCommerce 邮件被发送时都会触发。然而，关键在于这些钩子会传递一个 $email 对象作为参数。这个 $email 对象包含了当前邮件的详细信息，其中最重要的是 id 属性，它唯一标识了邮件类型（例如 customer_on_hold_order、new_order 等）。
通过检查 $email->id，我们可以在全局钩子中实现条件逻辑，从而只对特定类型的邮件执行自定义操作。
实现特定邮件头部定制
要定制“客户订单待处理”邮件的头部，我们需要在 woocommerce_email_header 钩子上添加一个自定义函数。在这个函数内部，我们将检查 $email->id 是否为 customer_on_hold_order。
/**
* 针对 'customer_on_hold_order' 邮件定制头部内容
*
* @param string $email_heading 邮件标题。
* @param WC_Email $email WC_Email 对象，包含当前邮件的详细信息。
*/
function custom_on_hold_order_email_header( $email_heading, $email ) {
// 检查当前邮件是否为 'customer_on_hold_order' 类型
if ( $email->id == 'customer_on_hold_order' ) {
// 在这里输出你希望在 '客户订单待处理' 邮件头部显示的内容
// 例如，可以是一个自定义的欢迎语、提示信息或品牌元素
echo '尊敬的客户，您的订单目前处于待处理状态。
';
// 注意：如果你想替换默认的头部，可能需要更复杂的逻辑，
// 这里只是在默认头部之后或之前添加内容。
// 如果要完全替换，你需要移除默认的钩子回调，但这通常不推荐。
}
}
// 将自定义函数添加到 woocommerce_email_header 钩子
// 10 是优先级，2 表示函数接受 2 个参数
add_action( 'woocommerce_email_header', 'custom_on_hold_order_email_header', 10, 2 );实现特定邮件底部定制
同理，要定制“客户订单待处理”邮件的底部，我们需要在 woocommerce_email_footer 钩子上添加一个自定义函数。
/**
* 针对 'customer_on_hold_order' 邮件定制底部内容
*
* @param WC_Email $email WC_Email 对象，包含当前邮件的详细信息。
*/
function custom_on_hold_order_email_footer( $email ) {
// 检查当前邮件是否为 'customer_on_hold_order' 类型
if ( $email->id == 'customer_on_hold_order' ) {
// 在这里输出你希望在 '客户订单待处理' 邮件底部显示的内容
// 例如，可以是一个特定的联系方式、常见问题链接或促销信息
echo '';
echo '如有任何疑问，请随时联系我们的客服团队。
';
echo '感谢您的耐心等待！
';
echo '';
}
}
// 将自定义函数添加到 woocommerce_email_footer 钩子
// 10 是优先级，1 表示函数接受 1 个参数
add_action( 'woocommerce_email_footer', 'custom_on_hold_order_email_footer', 10, 1 );代码集成与注意事项
- 代码位置： 将上述 PHP 代码添加到您当前活动主题的 functions.php 文件中。强烈建议使用子主题（Child Theme），以避免在主题更新时丢失您的自定义代码。如果您没有子主题，直接修改父主题的 functions.php 会在主题更新后被覆盖。
- 测试： 在部署到生产环境之前，务必在开发或测试环境中进行充分测试。您可以手动将订单状态更改为“待处理”来触发相应的邮件发送，然后检查收到的邮件是否包含您自定义的头部和底部内容。
- 内容替换与追加： 上述示例代码是在默认头部/底部内容之后（或之前，取决于钩子的优先级和默认回调函数的执行顺序）追加内容。如果您希望完全替换默认的头部或底部，则需要更复杂的逻辑，可能涉及移除默认的钩子回调函数，但这通常不推荐，因为它可能会影响 WooCommerce 邮件的正常结构。在大多数情况下，通过 CSS 隐藏默认元素或在默认元素周围包裹自定义内容是更好的选择。
- HTML 与 CSS： 在 echo 语句中输出的 HTML 和内联 CSS 应该符合邮件客户端的兼容性标准。避免使用复杂的 CSS 属性，因为许多邮件客户端对 CSS 的支持有限。
-
目标邮件类型： 除了 customer_on_hold_order，您还可以根据需要修改 $email->id 来针对其他邮件类型进行定制，例如：
- new_order (新订单)
- cancelled_order (已取消订单)
- failed_order (失败订单)
- customer_processing_order (客户订单处理中)
- customer_completed_order (客户订单已完成)
- customer_refunded_order (客户订单已退款)
- customer_note (客户备注)
- customer_reset_password (客户重置密码)
- customer_new_account (客户新账户)
总结
通过利用 WooCommerce 提供的动作钩子及其传递的 $email 对象，我们可以实现对特定邮件通知的头部和底部内容的精准定制。这种方法避免了修改核心模板文件，确保了代码的健壮性和可维护性。遵循本教程的指导，您可以轻松地为您的 WooCommerce 商店创建更具个性化和专业性的邮件通知体验。
