woocommerce 提供了丰富的邮件通知功能，但在实际运营中，我们可能仅需针对特定类型的邮件（例如“待处理订单”通知）定制其头部或底部，而非全局修改所有邮件模板。直接修改通用模板文件（如email-header.php和email-footer.php）或简单地将其复制到子主题可能无法满足这种精细化需求，因为这些操作通常会影响所有邮件。本文将深入指导您如何利用woocommerce的动作钩子，实现对特定邮件头部和底部的精准控制。
理解WooCommerce邮件钩子与邮件对象
WooCommerce在生成邮件内容时，会在邮件的头部和底部插入特定的动作钩子：woocommerce_email_header 和 woocommerce_email_footer。这些钩子是WordPress和WooCommerce体系中重要的扩展点，允许开发者在不修改核心文件的情况下注入自定义代码。
关键在于，当这些钩子被触发时，它们会传递一个 $email 对象。这个对象包含了当前邮件的详细信息，其中最重要的是其唯一标识符 $email->id。通过检查这个ID，我们就能识别出当前的邮件类型，从而实现条件化的定制。
识别特定邮件类型
WooCommerce为每种邮件类型分配了一个唯一的ID。例如，“待处理订单”邮件的ID是 customer_on_hold_order。在我们的自定义代码中，可以通过 if ( $email->id === 'your_email_id' ) 这样的条件语句来针对特定邮件执行操作。
实现头部定制
要定制特定邮件的头部，您需要将以下PHP代码添加到您的子主题的 functions.php 文件中。
/**
* 针对特定WooCommerce邮件定制头部内容
*
* @param string $email_heading 邮件标题，通常是邮件的H1标题
* @param object $email WC_Email 对象，包含当前邮件的所有信息
*/
function custom_woocommerce_email_header_for_specific_email( $email_heading, $email ) {
// 目标邮件类型：例如 'customer_on_hold_order' (待处理订单邮件)
// 您可以根据需要修改此ID以匹配其他邮件类型
if ( $email->id === 'customer_on_hold_order' ) {
// 在此处输出您自定义的头部HTML内容
// 示例：可以包含品牌Logo、自定义欢迎语或特别通知
echo '';
echo '尊敬的顾客，您的订单正在处理中！
';
echo '感谢您的耐心等待。
';
echo '';
}
}
// 挂载到 woocommerce_email_header 钩子
// 10 是优先级，2 表示函数接受2个参数 ($email_heading, $email)
add_action( 'woocommerce_email_header', 'custom_woocommerce_email_header_for_specific_email', 10, 2 );代码解释：
- custom_woocommerce_email_header_for_specific_email 函数定义了我们的定制逻辑。
- $email->id === 'customer_on_hold_order' 是关键的条件判断，确保只有“待处理订单”邮件才会执行内部代码。
- echo 语句用于输出自定义的HTML内容。您可以根据品牌需求和设计，替换为任何有效的HTML结构和内联CSS样式。
- add_action 将我们的函数挂载到 woocommerce_email_header 钩子上。优先级 10 是默认值，2 表示我们的函数期望接收两个参数。
实现底部定制
类似地，要定制特定邮件的底部，您需要将以下PHP代码添加到您的子主题的 functions.php 文件中。
/**
* 针对特定WooCommerce邮件定制底部内容
*
* @param object $email WC_Email 对象，包含当前邮件的所有信息
*/
function custom_woocommerce_email_footer_for_specific_email( $email ) {
// 目标邮件类型：例如 'customer_on_hold_order' (待处理订单邮件)
if ( $email->id === 'customer_on_hold_order' ) {
// 在此处输出您自定义的底部HTML内容
// 示例：可以包含版权信息、联系方式、社交媒体链接等
echo '';
echo '© ' . date('Y') . ' 您的商店名称. 版权所有.
';
echo '如有疑问，请访问我们的 帮助中心。
';
echo '';
}
}
// 挂载到 woocommerce_email_footer 钩子
// 10 是优先级，1 表示函数接受1个参数 ($email)
add_action( 'woocommerce_email_footer', 'custom_woocommerce_email_footer_for_specific_email', 10, 1 );代码解释：
- custom_woocommerce_email_footer_for_specific_email 函数定义了底部定制逻辑。
- 同样通过 $email->id === 'customer_on_hold_order' 进行条件判断。
- echo 语句输出自定义的底部HTML内容。
- add_action 将函数挂载到 woocommerce_email_footer 钩子上，并指定接收1个参数。
注意事项与最佳实践
- 使用子主题: 务必将所有自定义代码放入您网站的子主题（Child Theme）的 functions.php 文件中。这能确保在主题更新时，您的修改不会被覆盖，从而保证网站的稳定性和可持续性。
- HTML 内容与邮件客户端兼容性: 在 echo 语句中，您可以输出完整的HTML结构，包括样式。请确保输出的HTML是有效的，并且与各种邮件客户端兼容。由于许多邮件客户端对外部CSS和某些高级CSS属性的支持有限，建议使用内联CSS或基本的HTML标签来保证最佳显示效果。
- 充分测试: 在将代码部署到生产环境之前，务必在开发或测试环境中充分测试您的修改。发送测试邮件，并在不同的邮件客户端（如Gmail、Outlook、手机邮件应用等）中检查显示效果，确保邮件显示正常，且只影响目标邮件类型。
-
查找其他邮件ID: 如果您需要定制其他WooCommerce邮件类型，请查找对应的 $email->id。常见的ID包括：
- new_order (新订单)
- customer_processing_order (客户处理中订单)
- customer_completed_order (客户已完成订单)
- customer_refunded_order (客户已退款订单)
- customer_invoice (客户发票/订单详情)
- customer_new_account (客户新账户)
- customer_reset_password (客户重置密码) 您可以通过在 woocommerce_email_header 或 woocommerce_email_footer 钩子中临时 var_dump($email->id); 来调试获取当前邮件的ID。
- 替代默认输出: 上述方法是在WooCommerce默认的头部/底部内容之外添加或在默认内容之前/之后插入内容。如果您想完全替换WooCommerce默认的头部或底部，可能需要移除默认的钩子操作，但这通常不推荐，除非您对WooCommerce的邮件结构有深入理解，并且能够完全重构其默认输出。
总结
通过巧妙地利用WooCommerce的动作钩子 (woocommerce_email_header 和 woocommerce_email_footer) 和 $email 对象提供的邮件ID，开发者可以实现对特定邮件通知的头部和底部进行精准定制。这种方法不仅提供了极大的灵活性，避免了对所有邮件的冗余修改，也确保了商店通知的专业性和个性化，从而有效提升了用户的整体购物体验。
