本教程详细介绍了如何在WooCommerce中，针对如“待处理订单”等特定邮件类型，而非所有邮件，独立定制其邮件头部和底部内容。通过利用WooCommerce提供的 woocommerce_email_header 和 woocommerce_email_footer 动作钩子，并结合 $email->id 参数进行条件判断，开发者可以实现对特定邮件通知的页眉和页脚进行精细化控制，避免影响其他邮件模板，从而提升用户体验和品牌一致性。
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 '<div style="background-color: #f0f8ff; padding: 20px; text-align: center;">'; echo '<h1 style="color: #007bff;">您的订单正在处理中！</h1>'; echo '<p>感谢您的耐心等待。</p>'; echo '</div>'; } } // 挂载函数到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 '<div style="background-color: #f0f8ff; padding: 15px; text-align: center; font-size: 0.8em; color: #666;">'; echo '<p>© ' . date('Y') . ' 您的公司名称. 保留所有权利。</p>'; echo '<p>如有疑问，请联系我们：<a href="mailto:support@yourcompany.com">support@yourcompany.com</a></p>'; echo '</div>'; } } // 挂载函数到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特定邮件通知的头部和底部进行精确、有针对性的定制。这种方法避免了对所有邮件模板进行不必要的修改，保持了代码的模块化和可维护性，同时确保了邮件通知的专业性和品牌一致性。
