WooCommerce邮件头部和底部定制概述
在WooCommerce中，邮件通知是与客户沟通的重要渠道。默认情况下，WooCommerce提供了一套通用的邮件模板，包括所有邮件共用的头部（header）和底部（footer）。当需要对这些通用部分进行修改时，通常可以通过复制 email-header.php 和 email-footer.php 到子主题的 woocommerce/emails/ 目录进行覆盖。然而，这种方法会影响所有发送的邮件，对于仅需定制特定类型邮件（例如“待处理订单”邮件）的头部和底部，这种全局性的修改方式无法满足需求。
问题在于，即使像 customer-on-hold-order.php 这样的特定邮件模板中包含了 do_action( 'woocommerce_email_header', ...) 和 do_action( 'woocommerce_email_footer', ...) 这样的动作钩子，直接修改这些模板文件并不能实现仅针对该邮件的头部和底部定制，因为这些钩子是通用的，被所有邮件模板调用。
利用动作钩子实现精确定制
WooCommerce的 woocommerce_email_header 和 woocommerce_email_footer 动作钩子非常强大，它们在邮件生成过程中被调用，并且会将 $email 对象作为参数传递。这个 $email 对象包含了当前邮件的详细信息，其中最关键的是 $email->id 属性，它标识了当前邮件的类型（例如 customer_on_hold_order）。
通过检查 $email->id 的值，我们可以在这些通用钩子内部添加条件逻辑，从而只对特定类型的邮件应用自定义的头部或底部内容。
定制特定邮件的头部
要定制特定邮件（例如“待处理订单”）的头部，我们需要创建一个函数并将其挂载到 woocommerce_email_header 钩子上。在该函数内部，通过判断 $email->id 是否为 customer_on_hold_order 来决定是否输出自定义内容。
/**
* 定制特定WooCommerce邮件的头部内容。
*
* @param string $email_heading 邮件标题。
* @param WC_Email $email 当前的WC_Email对象。
*/
function custom_woocommerce_email_header_for_on_hold_order( $email_heading, $email ) {
// 检查当前邮件ID是否为“待处理订单”邮件
if ( $email->id == 'customer_on_hold_order' ) {
// 在此处输出您自定义的头部内容。
// 例如，可以是一个带有特定logo或品牌信息的HTML片段。
echo '';
echo '您的订单正在处理中！
';
echo '感谢您的耐心等待。
';
echo '';
}
}
// 挂载函数到woocommerce_email_header钩子，优先级10，接受2个参数
add_action( 'woocommerce_email_header', 'custom_woocommerce_email_header_for_on_hold_order', 10, 2 );在上述代码中，当 $email->id 等于 customer_on_hold_order 时，我们插入了一段自定义的HTML内容作为邮件的头部。您可以根据需要替换 echo 语句中的HTML代码。
定制特定邮件的底部
类似地，定制特定邮件的底部也遵循相同的逻辑。我们需要将函数挂载到 woocommerce_email_footer 钩子上，并通过 $email->id 进行条件判断。
/**
* 定制特定WooCommerce邮件的底部内容。
*
* @param WC_Email $email 当前的WC_Email对象。
*/
function custom_woocommerce_email_footer_for_on_hold_order( $email ) {
// 检查当前邮件ID是否为“待处理订单”邮件
if ( $email->id == 'customer_on_hold_order' ) {
// 在此处输出您自定义的底部内容。
// 例如，可以是一个带有特定联系信息或社交媒体链接的HTML片段。
echo '';
echo '© ' . date('Y') . ' 您的公司名称. 保留所有权利。
';
echo '如有疑问，请联系我们：support@yourcompany.com
';
echo '';
}
}
// 挂载函数到woocommerce_email_footer钩子，优先级10，接受1个参数
add_action( 'woocommerce_email_footer', 'custom_woocommerce_email_footer_for_on_hold_order', 10, 1 );同样，您可以根据需求修改 echo 语句中的HTML内容。
代码放置位置和注意事项
- 代码位置： 将上述PHP代码添加到您当前活跃的子主题的 functions.php 文件中。强烈建议使用子主题，以避免在主题更新时丢失您的自定义代码。如果您没有子主题，也可以暂时放置在主主题的 functions.php 中，但请务必在主题更新前将其迁移。
-
邮件ID识别： 要确定其他邮件类型的 $email->id，您可以临时在钩子函数中打印 $email->id 的值进行调试，或者查阅WooCommerce的官方文档。常见的邮件ID包括：
- new_order (新订单)
- customer_processing_order (订单处理中)
- customer_completed_order (订单已完成)
- customer_refunded_order (订单已退款)
- customer_invoice (客户发票/订单详情)
- customer_note (客户备注)
- customer_reset_password (客户重置密码)
- customer_new_account (客户新账户)
- 内容替换： 示例代码中的 echo 语句用于输出简单的HTML。在实际应用中，您应该根据品牌指南和设计需求，构建更复杂、更美观的HTML内容。
- 兼容性： 提供的代码已在WordPress 5.8.1 和 WooCommerce 5.8.0 版本中测试通过，通常在后续版本中也保持兼容性，因为这些钩子是WooCommerce的核心功能。
总结
通过利用 woocommerce_email_header 和 woocommerce_email_footer 动作钩子，并结合 $email->id 进行条件判断，我们能够实现对WooCommerce特定邮件通知的头部和底部进行精确、有针对性的定制。这种方法避免了对所有邮件模板进行不必要的修改，保持了代码的模块化和可维护性，同时确保了邮件通知的专业性和品牌一致性。
