当前位置：首页 > 文章列表 > 文章 > php教程 > WooCommerce自定义邮件页眉页脚教程

WooCommerce自定义邮件页眉页脚教程

2025-08-15 19:09:55 0浏览收藏

想为你的WooCommerce商店定制特定邮件的页眉页脚吗？本文详细讲解如何利用WooCommerce提供的`woocommerce_email_header`和`woocommerce_email_footer`动作钩子，针对如“待处理订单”等特定邮件类型，独立定制邮件头部和底部内容，而不是全局修改所有邮件模板。通过巧妙地结合 `$email->id` 参数进行条件判断，开发者可以实现对特定邮件通知的页眉和页脚进行精细化控制，避免影响其他邮件模板，从而提升用户体验和品牌一致性。告别千篇一律的邮件样式，让你的WooCommerce邮件更具个性化和专业性！了解更多WooCommerce邮件定制技巧，请继续阅读。

精确定制WooCommerce特定邮件的页眉和页脚

本教程详细介绍了如何在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>&copy; ' . 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特定邮件通知的头部和底部进行精确、有针对性的定制。这种方法避免了对所有邮件模板进行不必要的修改，保持了代码的模块化和可维护性，同时确保了邮件通知的专业性和品牌一致性。

本篇关于《WooCommerce自定义邮件页眉页脚教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！