WooCommerce添加订单邮件收件人方法

想让WooCommerce订单邮件更智能？本文教你如何**根据订单商品属性动态添加收件人**，实现精准通知！通过`woocommerce_email_recipient_new_order` 过滤器，我们可以轻松检查订单中的商品，并根据其属性（如颜色、尺寸等）自动添加相应的邮箱地址到新订单通知中。例如，订单包含“定制服务A”产品时，自动通知负责该服务的团队。本文提供完整代码示例，详细讲解如何利用 `wc_product_has_term()` 函数匹配商品属性，并动态修改收件人列表。告别手动分发，提升订单处理效率，快来学习WooCommerce邮件定制技巧吧！让你的订单邮件更智能、更高效！

本教程详细讲解如何在 WooCommerce 中根据订单内商品的特定属性（如变体属性）动态添加自定义邮件收件人。通过利用 `woocommerce_email_recipient_new_order` 过滤器，我们能够检查订单中的每个商品及其属性，并据此将额外的邮箱地址添加到新订单通知的收件人列表中，从而实现更精细化的订单邮件分发策略。

引言：定制 WooCommerce 订单邮件收件人的需求

在 WooCommerce 运营中，有时我们可能需要根据订单中包含的特定商品属性（例如，某个商品的颜色、尺寸或特定的定制选项）将新订单通知发送给不同的团队或个人。例如，如果订单中包含“定制服务A”的产品，则需要同时通知负责该服务的团队。WooCommerce 默认的邮件设置无法直接实现这种基于商品属性的动态分发。

为了解决这一问题，我们可以利用 WooCommerce 提供的 woocommerce_email_recipient_new_order 过滤器。这个过滤器允许我们在新订单邮件发送之前，修改其收件人列表。通过编写自定义函数，我们可以遍历订单中的商品，检查它们的属性，并根据匹配结果动态地添加额外的收件人邮箱。

核心实现：基于商品属性动态添加收件人

以下是实现这一功能的完整代码示例。此代码将检查订单中的每个商品，无论是简单商品还是变体商品，只要其包含特定的全局属性术语（例如 pa_d 属性下的 d1 或 d2 术语），就会将相应的自定义邮箱添加到新订单通知的收件人列表中。

/**
 * 根据订单中商品的特定属性动态添加自定义邮件收件人。
 *
 * @param string   $recipient 原始收件人字符串。
 * @param WC_Order $order     WC_Order 对象。
 * @return string  修改后的收件人字符串。
 */
add_filter( 'woocommerce_email_recipient_new_order', 'custom_email_recipient_by_product_attribute', 10, 2 );

function custom_email_recipient_by_product_attribute( $recipient, $order ) {
    // 确保 $order 是一个 WC_Order 实例
    if ( ! is_a( $order, 'WC_Order' ) ) {
        return $recipient;
    }

    // 定义额外的收件人邮箱
    // 请将这些邮箱替换为实际的收件人地址
    $additional_email1 = "team_d1@example.com";
    $additional_email2 = "team_d2@example.com";

    // 定义要匹配的属性术语 slug
    // 例如，如果您的全局属性是“颜色”，其分类法名称可能是“pa_color”
    // 术语 slug 可能是“red”、“blue”等
    $term_slug1 = "d1"; // 第一个要匹配的术语 slug
    $term_slug2 = "d2"; // 第二个要匹配的术语 slug
    $attribute_taxonomy = "pa_d"; // 全局属性的分类法名称（例如 'pa_color', 'pa_size'）

    $has_matching_term = false; // 标记是否已找到匹配的属性术语

    // 遍历订单中的每个商品项
    foreach ( $order->get_items() as $item ) {
        // 获取商品对象。此方法对简单商品和变体商品都有效。
        $product = $item->get_product();

        // 如果无法获取商品对象，则跳过当前商品项
        if ( ! $product ) {
            continue;
        }

        // 使用 wc_product_has_term() 检查商品是否包含特定的属性术语。
        // 这个函数能够可靠地检查简单商品或变体商品是否拥有指定分类法下的某个术语。
        if ( wc_product_has_term( $product, $term_slug1, $attribute_taxonomy ) ) {
            // 如果找到匹配项，将额外的邮箱地址添加到收件人列表
            $recipient .= ',' . $additional_email1;
            $has_matching_term = true;
        }

        if ( wc_product_has_term( $product, $term_slug2, $attribute_taxonomy ) ) {
            // 如果找到匹配项，将额外的邮箱地址添加到收件人列表
            $recipient .= ',' . $additional_email2;
            $has_matching_term = true;
        }

        // 如果已经找到匹配项并添加了相应的收件人，则可以停止遍历，
        // 避免不必要的检查和重复添加相同的邮箱。
        if ( $has_matching_term ) {
            break;
        }
    }

    return $recipient; // 返回修改后的收件人字符串
}

代码详解

1. 过滤器挂钩 (add_filter):

   • woocommerce_email_recipient_new_order 是 WooCommerce 提供的一个核心过滤器，用于在发送新订单邮件之前修改收件人列表。
   • custom_email_recipient_by_product_attribute 是我们自定义的回调函数名称。
   • 10 是优先级，数字越小越早执行。
   • 2 表示回调函数接受两个参数：当前的收件人字符串和 WC_Order 对象。

2. 函数定义 (custom_email_recipient_by_product_attribute):

   • 函数接收 $recipient（当前收件人字符串，通常是商店管理员的邮箱）和 $order（一个 WC_Order 对象，包含订单的所有详细信息）。
   • 首先，通过 ! is_a( $order, 'WC_Order' ) 检查 $order 是否确实是一个 WC_Order 实例，以确保代码的健壮性。

3. 配置自定义邮箱和属性:

   • $additional_email1, $additional_email2: 定义了当匹配到特定属性时需要添加的额外邮箱地址。请务必将 example.com 替换为实际的域名和邮箱地址。
   • $term_slug1, $term_slug2: 定义了要匹配的属性术语的 slug。例如，如果您的属性是“颜色”，术语可能是“红色”，其 slug 可能是 red。
   • $attribute_taxonomy: 这是全局商品属性的分类法名称。对于全局属性，其命名约定通常是 pa_ 加上属性的 slug。例如，如果您的全局属性 slug 是 d，那么分类法名称就是 pa_d。您可以在 WooCommerce 后台的“商品”->“属性”中找到这些信息。

4. 遍历订单商品:

   • foreach ( $order->get_items() as $item ): 循环遍历订单中的每一个商品项。
   • $product = $item->get_product(): 这是获取商品对象的关键一步。无论商品是简单商品 (WC_Product_Simple) 还是变体商品 (WC_Product_Variation)，此方法都会返回正确的 WC_Product 子类实例。

5. 检查商品属性:

   • wc_product_has_term( $product, $term_slug, $attribute_taxonomy ): 这是一个 WooCommerce 辅助函数，用于检查给定的 $product 对象是否具有指定 $attribute_taxonomy 下的某个 $term_slug。这个函数能够正确处理简单商品和变体商品，检查它们是否被关联到该术语。
   • 如果 wc_product_has_term() 返回 true，则表示当前商品项具有我们正在寻找的属性。

6. 动态追加收件人:

   • $recipient .= ',' . $additional_email1;: 如果找到匹配的属性，我们将额外的邮箱地址通过逗号连接符追加到 $recipient 字符串中。
   • $has_matching_term = true;: 设置一个标志，表示已经找到至少一个匹配项。

7. 优化循环跳出:

   • if ( $has_matching_term ) { break; }: 一旦找到任何一个匹配的属性术语并添加了相应的收件人，就没有必要继续遍历订单中的其余商品项。这可以提高代码效率，尤其是在订单包含大量商品时。

注意事项与最佳实践

1. 代码放置位置: 将上述代码放置在您的 WordPress 主题的 functions.php 文件中，或者更推荐的方式是创建一个自定义插件来管理此类功能，以确保在主题更新时代码不会丢失。
2. 替换占位符: 务必将代码中的 team_d1@example.com、team_d2@example.com、d1、d2 和 pa_d 替换为您的实际邮箱地址、属性术语 slug 和属性分类法名称。
3. 属性分类法名称: 确保 attribute_taxonomy 变量的值与您的全局属性分类法名称完全匹配。您可以在 WooCommerce 后台的“商品”->“属性”页面查看或编辑您的全局属性，其分类法名称通常是 pa_ 前缀加上属性的 slug。
4. 测试: 在生产环境部署之前，务必在开发或测试环境中进行充分测试，以确保邮件能够正确发送到预期的收件人。
5. 多个匹配项: 如果一个订单包含多个满足条件的商品，或者一个商品同时满足多个条件，本代码会将其对应的邮箱都添加到收件人列表中。如果需要更复杂的逻辑（例如，只添加第一个匹配项的邮箱，或者根据优先级添加），您可能需要调整 break 语句的位置和条件。
6. 性能: 对于大多数商店而言，此代码的性能影响微乎其微。但如果您的订单通常包含数百个商品项，并且您有大量此类过滤器，可能需要考虑进一步的优化。

总结

通过利用 woocommerce_email_recipient_new_order 过滤器和 wc_product_has_term() 函数，我们能够灵活地根据 WooCommerce 订单中商品的特定属性动态调整新订单通知的收件人。这种方法不仅功能强大，而且易于理解和维护，为商店管理员提供了更精细化的订单管理和通知分发能力，有助于提高团队协作效率。

好了，本文到此结束，带大家了解了《WooCommerce添加订单邮件收件人方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！