本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《定制WooCommerce邮件页眉页脚方法》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

本教程详细阐述了如何在WooCommerce中仅针对特定邮件类型（如“订单待处理”邮件）自定义其页眉和页脚。通过利用WooCommerce提供的 woocommerce_email_header 和 woocommerce_email_footer 动作钩子，并结合 $email 对象中的 id 属性进行条件判断，开发者可以精准地为指定邮件注入定制内容，而无需修改全局邮件模板，确保了灵活性和代码的健壮性。

理解WooCommerce邮件模板与钩子

WooCommerce的邮件系统设计旨在提供一定的灵活性，但其默认的页眉 (email-header.php) 和页脚 (email-footer.php) 模板是全局性的。这意味着，如果您直接修改这些文件（即使是通过子主题覆盖），所做的更改也将应用于所有WooCommerce发送的邮件。这对于需要为所有邮件统一品牌风格的情况是有效的，但当需要为特定邮件类型（例如，仅为“订单待处理”邮件）添加独特的提示或信息时，这种方法就显得力不从心。

WooCommerce通过 do_action 钩子提供了更细粒度的控制。在 email-header.php 和 email-footer.php 以及各个具体的邮件模板（如 customer-on-hold-order.php）中，您会发现以下核心钩子：

// 在邮件内容开始前调用，用于输出页眉
do_action( 'woocommerce_email_header', $email_heading, $email );

// ... 邮件主体内容 ...

// 在邮件内容结束后调用，用于输出页脚
do_action( 'woocommerce_email_footer', $email );

这些钩子的存在是实现特定邮件定制的关键。它们允许我们“挂载”自定义函数，并在钩子被触发时执行我们的代码。重要的是，$email 对象作为参数被传递给这些钩子，它包含了当前邮件的详细信息，其中就包括了邮件的唯一标识符 id。

精准定制策略：利用 $email->id

要实现仅针对特定邮件的页眉和页脚定制，核心策略是利用 woocommerce_email_header 和 woocommerce_email_footer 钩子，并通过检查传递给钩子的 $email 对象的 id 属性来识别目标邮件类型。

例如，WooCommerce的“订单待处理”邮件的 id 通常是 customer_on_hold_order。通过在自定义函数中添加一个条件判断，我们就可以确保只有当 $email->id 与目标邮件的ID匹配时，才输出我们定制的内容。

实施步骤与示例代码

所有代码都应放置在您活动子主题的 functions.php 文件中。强烈建议使用子主题，以避免在主题更新时丢失您的定制代码。

1. 定制“订单待处理”邮件的页眉

我们将创建一个函数，将其挂载到 woocommerce_email_header 钩子上。该函数会接收 $email_heading 和 $email 两个参数。通过检查 $email->id 是否为 customer_on_hold_order，我们可以在特定条件下输出自定义的页眉内容。

/**
 * 为“订单待处理”邮件定制页眉内容。
 *
 * @param string $email_heading 邮件标题。
 * @param object $email         WC_Email 对象实例。
 */
function custom_woocommerce_email_header_for_on_hold( $email_heading, $email ) {
    // 目标邮件ID：customer_on_hold_order
    if ( $email->id === 'customer_on_hold_order' ) {
        // 在此处插入你的自定义页眉内容。
        // 可以是HTML、CSS（内联）或基于PHP逻辑的动态内容。
        echo '
';
        echo '
您的订单正在处理中！
';
        echo '
感谢您的耐心等待，我们会尽快处理您的订单。
';
        echo '
';
    }
}
// 挂载函数到 woocommerce_email_header 钩子
// 10 是优先级，2 表示函数接收2个参数
add_action( 'woocommerce_email_header', 'custom_woocommerce_email_header_for_on_hold', 10, 2 );

2. 定制“订单待处理”邮件的页脚

类似地，我们将创建一个函数，将其挂载到 woocommerce_email_footer 钩子上。该函数接收 $email 一个参数。通过相同的 id 判断，我们可以为特定邮件添加定制的页脚内容。

/**
 * 为“订单待处理”邮件定制页脚内容。
 *
 * @param object $email WC_Email 对象实例。
 */
function custom_woocommerce_email_footer_for_on_hold( $email ) {
    // 目标邮件ID：customer_on_hold_order
    if ( $email->id === 'customer_on_hold_order' ) {
        // 在此处插入你的自定义页脚内容。
        echo '
';
        echo '
此邮件由 [您的公司名称] 发送。
';
        echo '
© ' . date('Y') . ' [您的公司名称]. 保留所有权利。
';
        echo '
如有疑问，请联系我们：[您的联系邮箱]
';
        echo '
';
    }
}
// 挂载函数到 woocommerce_email_footer 钩子
// 10 是优先级，1 表示函数接收1个参数
add_action( 'woocommerce_email_footer', 'custom_woocommerce_email_footer_for_on_hold', 10, 1 );

将上述两段代码添加到您的子主题的 functions.php 文件中，并保存。当WooCommerce发送“订单待处理”邮件时，它将触发这些钩子，并在满足条件时插入您定义的自定义页眉和页脚。

注意事项与最佳实践

1. 始终使用子主题： 这是WordPress开发的黄金法则。直接修改父主题文件会导致在主题更新时丢失所有自定义内容。
2. HTML与CSS注入： 在 echo 语句中，您应该输出完整的HTML片段。考虑到邮件客户端的兼容性，推荐使用内联CSS样式，而不是外部样式表或