WooCommerce 特定邮件通知头部与底部高级定制指南-php教程-PHP中文网

WooCommerce 特定邮件通知头部与底部高级定制指南

心靈之曲

发布： 2025-08-07 12:34:26

原创

366人浏览过

WooCommerce 特定邮件通知头部与底部高级定制指南

本教程详细介绍了如何在 WooCommerce 中针对特定邮件类型（如“客户订单待处理”）单独定制其邮件头部和底部。通过利用 woocommerce_email_header 和 woocommerce_email_footer 动作钩子，并结合 $email->id 参数进行条件判断，开发者可以精准地修改特定邮件的显示内容，而非影响所有邮件模板。文章提供了完整的 PHP 代码示例和实现步骤，帮助您高效实现个性化的邮件通知。

在 woocommerce 商店运营中，发送给客户的邮件通知是重要的沟通渠道。虽然 woocommerce 提供了全局的邮件模板设置，但有时我们可能需要为特定类型的邮件（例如“客户订单待处理”邮件）定制其头部或底部内容，而又不影响其他邮件。直接修改 email-header.php 或 email-footer.php 模板文件会影响所有邮件，这并非我们所期望的精准定制。本文将深入探讨如何利用 woocommerce 的动作钩子机制，实现对特定邮件的头部和底部内容的精细化控制。

理解 WooCommerce 邮件钩子与参数

WooCommerce 的邮件模板，如 customer-on-hold-order.php，内部调用了两个关键的动作钩子来输出邮件的头部和底部：

do_action( 'woocommerce_email_header', $email_heading, $email );
do_action( 'woocommerce_email_footer', $email );

这些钩子是全局性的，意味着它们在所有 WooCommerce 邮件被发送时都会触发。然而，关键在于这些钩子会传递一个 $email 对象作为参数。这个 $email 对象包含了当前邮件的详细信息，其中最重要的是 id 属性，它唯一标识了邮件类型（例如 customer_on_hold_order、new_order 等）。

通过检查 $email->id，我们可以在全局钩子中实现条件逻辑，从而只对特定类型的邮件执行自定义操作。

实现特定邮件头部定制

要定制“客户订单待处理”邮件的头部，我们需要在 woocommerce_email_header 钩子上添加一个自定义函数。在这个函数内部，我们将检查 $email->id 是否为 customer_on_hold_order。

Grammarly

Grammarly是一款在线语法纠正和校对工具，伟大的AI辅助写作工具

253

查看详情

/**
 * 针对 'customer_on_hold_order' 邮件定制头部内容
 *
 * @param string $email_heading 邮件标题。
 * @param WC_Email $email WC_Email 对象，包含当前邮件的详细信息。
 */
function custom_on_hold_order_email_header( $email_heading, $email ) {
    // 检查当前邮件是否为 'customer_on_hold_order' 类型
    if ( $email->id == 'customer_on_hold_order' ) {
        // 在这里输出你希望在 '客户订单待处理' 邮件头部显示的内容
        // 例如，可以是一个自定义的欢迎语、提示信息或品牌元素
        echo '<p style="text-align: center; color: #555; font-size: 14px;">尊敬的客户，您的订单目前处于待处理状态。</p>';
        // 注意：如果你想替换默认的头部，可能需要更复杂的逻辑，
        // 这里只是在默认头部之后或之前添加内容。
        // 如果要完全替换，你需要移除默认的钩子回调，但这通常不推荐。
    }
}
// 将自定义函数添加到 woocommerce_email_header 钩子
// 10 是优先级，2 表示函数接受 2 个参数
add_action( 'woocommerce_email_header', 'custom_on_hold_order_email_header', 10, 2 );

登录后复制

实现特定邮件底部定制

同理，要定制“客户订单待处理”邮件的底部，我们需要在 woocommerce_email_footer 钩子上添加一个自定义函数。

/**
 * 针对 'customer_on_hold_order' 邮件定制底部内容
 *
 * @param WC_Email $email WC_Email 对象，包含当前邮件的详细信息。
 */
function custom_on_hold_order_email_footer( $email ) {
    // 检查当前邮件是否为 'customer_on_hold_order' 类型
    if ( $email->id == 'customer_on_hold_order' ) {
        // 在这里输出你希望在 '客户订单待处理' 邮件底部显示的内容
        // 例如，可以是一个特定的联系方式、常见问题链接或促销信息
        echo '<div style="text-align: center; margin-top: 20px; padding-top: 10px; border-top: 1px solid #eee;">';
        echo '<p style="font-size: 12px; color: #888;">如有任何疑问，请随时联系我们的客服团队。</p>';
        echo '<p style="font-size: 12px; color: #888;">感谢您的耐心等待！</p>';
        echo '</div>';
    }
}
// 将自定义函数添加到 woocommerce_email_footer 钩子
// 10 是优先级，1 表示函数接受 1 个参数
add_action( 'woocommerce_email_footer', 'custom_on_hold_order_email_footer', 10, 1 );

登录后复制

代码集成与注意事项

代码位置： 将上述 PHP 代码添加到您当前活动主题的 functions.php 文件中。强烈建议使用子主题（Child Theme），以避免在主题更新时丢失您的自定义代码。如果您没有子主题，直接修改父主题的 functions.php 会在主题更新后被覆盖。
测试： 在部署到生产环境之前，务必在开发或测试环境中进行充分测试。您可以手动将订单状态更改为“待处理”来触发相应的邮件发送，然后检查收到的邮件是否包含您自定义的头部和底部内容。
内容替换与追加： 上述示例代码是在默认头部/底部内容之后（或之前，取决于钩子的优先级和默认回调函数的执行顺序）追加内容。如果您希望完全替换默认的头部或底部，则需要更复杂的逻辑，可能涉及移除默认的钩子回调函数，但这通常不推荐，因为它可能会影响 WooCommerce 邮件的正常结构。在大多数情况下，通过 CSS 隐藏默认元素或在默认元素周围包裹自定义内容是更好的选择。
HTML 与 CSS： 在 echo 语句中输出的 HTML 和内联 CSS 应该符合邮件客户端的兼容性标准。避免使用复杂的 CSS 属性，因为许多邮件客户端对 CSS 的支持有限。
目标邮件类型： 除了 customer_on_hold_order，您还可以根据需要修改 $email->id 来针对其他邮件类型进行定制，例如：
- new_order (新订单)
- cancelled_order (已取消订单)
- failed_order (失败订单)
- customer_processing_order (客户订单处理中)
- customer_completed_order (客户订单已完成)
- customer_refunded_order (客户订单已退款)
- customer_note (客户备注)
- customer_reset_password (客户重置密码)
- customer_new_account (客户新账户)

总结

通过利用 WooCommerce 提供的动作钩子及其传递的 $email 对象，我们可以实现对特定邮件通知的头部和底部内容的精准定制。这种方法避免了修改核心模板文件，确保了代码的健壮性和可维护性。遵循本教程的指导，您可以轻松地为您的 WooCommerce 商店创建更具个性化和专业性的邮件通知体验。

以上就是WooCommerce 特定邮件通知头部与底部高级定制指南的详细内容，更多请关注php中文网其它相关文章！