本教程详细指导如何在woocommerce中根据订单商品所包含的特定属性（包括简单商品和变体商品）动态添加自定义邮件收件人。通过利用 `woocommerce_email_recipient_new_order` 过滤器，您可以检查订单中的每个商品项及其关联属性，并根据预设条件自动将订单通知发送给额外的指定邮箱，从而实现更精细化的邮件路由管理。
在电子商务运营中，有时需要根据订单中商品的特定属性（例如，某个品牌、特定颜色或尺寸等）将新订单通知发送给额外的收件人。这对于需要特定部门或供应商处理特定类型商品的场景尤其有用。WooCommerce提供了一系列钩子（Hooks）和过滤器（Filters），允许开发者扩展其核心功能，其中 woocommerce_email_recipient_new_order 过滤器便是实现这一需求的关键。
核心概念：WooCommerce邮件过滤器
woocommerce_email_recipient_new_order 过滤器允许您在WooCommerce发送新订单邮件之前，动态修改邮件的收件人列表。该过滤器接收两个参数：当前的收件人字符串和 WC_Order 对象。通过访问 WC_Order 对象，我们可以获取订单中的所有商品及其详细信息，包括它们的属性。
实现步骤与代码示例
以下代码将演示如何通过检查订单中商品的特定属性来添加额外的邮件收件人。该方案兼容简单商品和变体商品，确保无论商品类型如何，只要包含目标属性，相应的邮件就会被发送。
首先，您需要将以下代码添加到您的WordPress主题的 functions.php 文件中，或者最好是添加到自定义插件中。
<?php
/**
* 根据商品属性动态添加WooCommerce新订单邮件收件人。
*
* @param string $recipient 当前邮件收件人字符串。
* @param WC_Order $order WC_Order 对象。
* @return string 修改后的邮件收件人字符串。
*/
add_filter( 'woocommerce_email_recipient_new_order', 'custom_email_recipients_by_product_attribute', 10, 2 );
function custom_email_recipients_by_product_attribute( $recipient, $order ) {
// 确保我们处理的是一个有效的WC_Order对象
if ( ! is_a( $order, 'WC_Order' ) ) {
return $recipient;
}
// --- 配置区域 ---
// 定义额外的收件人邮箱
$additional_email1 = "department1@example.com"; // 替换为您的第一个额外邮箱
$additional_email2 = "department2@example.com"; // 替换为您的第二个额外邮箱
// 定义要匹配的属性的分类法（taxonomy）和属性值（slug）
// 例如，如果您的属性是全局属性 "产品类型"，其slug为 "pa_product-type"
// 请确保这里的 $target_taxonomy 与您WooCommerce后台设置的全局属性slug一致
$target_taxonomy = "pa_d"; // 示例属性分类法 slug (例如 'pa_color', 'pa_brand')
$term_slug1 = "d1"; // 示例属性值 slug
$term_slug2 = "d2"; // 示例属性值 slug
// --- 配置区域结束 ---
$has_matching_attribute = false; // 标记是否找到匹配属性，一旦找到即停止循环
// 遍历订单中的每个商品项
foreach ( $order->get_items() as $item ) {
$product = $item->get_product(); // 获取商品对象 (可以是简单商品或变体)
// 如果无法获取商品对象，则跳过此项
if ( ! $product ) {
continue;
}
// 获取商品（无论是简单商品还是变体）在目标属性分类法下的所有属性值（slugs）
// wc_get_product_terms 函数可以获取指定商品和指定分类法下的所有术语slug
$terms = wc_get_product_terms( $product->get_id(), $target_taxonomy, array( 'fields' => 'slugs' ) );
// 如果商品具有目标属性的任何值
if ( ! empty( $terms ) ) {
foreach ( $terms as $term_slug ) {
// 检查当前属性值是否匹配预设的slug
if ( $term_slug === $term_slug1 ) {
// 如果匹配第一个slug，添加第一个额外邮箱
$recipient .= ',' . $additional_email1;
$has_matching_attribute = true;
break 2; // 找到匹配项，停止所有循环 (包括商品项和属性项的循环)
}
if ( $term_slug === $term_slug2 ) {
// 如果匹配第二个slug，添加第二个额外邮箱
$recipient .= ',' . $additional_email2;
$has_matching_attribute = true;
break 2; // 找到匹配项，停止所有循环
}
}
}
}
return $recipient;
}代码详解
-
add_filter( 'woocommerce_email_recipient_new_order', 'custom_email_recipients_by_product_attribute', 10, 2 );
- 这行代码将我们的自定义函数 custom_email_recipients_by_product_attribute 挂载到 woocommerce_email_recipient_new_order 过滤器上。
- 10 是优先级，数字越小越早执行。
- 2 表示我们的函数将接收两个参数：$recipient 和 $order。
-
function custom_email_recipients_by_product_attribute( $recipient, $order ) { ... }
- 这是实际执行逻辑的函数。
- $recipient：当前邮件的收件人字符串，通常是商店管理员的邮箱。
- $order：一个 WC_Order 对象，包含了订单的所有信息。
-
配置区域
- $additional_email1 和 $additional_email2：定义您希望额外发送邮件的邮箱地址。请务必替换为实际的邮箱。
- $target_taxonomy：这是您要检查的WooCommerce产品属性的分类法（taxonomy）slug。对于全局属性，它通常以 pa_ 开头（例如 pa_color）。请根据您的实际设置进行修改。
- $term_slug1 和 $term_slug2：这些是您希望匹配的特定属性值的 slug。例如，如果您的属性是“颜色”，属性值是“红色”，那么 term_slug 可能就是 red。
-
foreach ( $order->get_items() as $item ) { ... }
- 遍历订单中的每一个商品项。每个 $item 代表订单中的一个商品。
-
$product = $item->get_product();
- 从订单商品项中获取对应的 WC_Product 对象。这个对象可以是 WC_Product_Simple（简单商品）或 WC_Product_Variation（变体商品）。
-
$terms = wc_get_product_terms( $product->get_id(), $target_taxonomy, array( 'fields' => 'slugs' ) );
- 这是获取商品属性值的关键。wc_get_product_terms() 函数能够获取指定商品ID在指定属性分类法下的所有术语（term）的 slug 列表。这对于简单商品和变体商品都有效。
-
条件判断与收件人追加
- if ( ! empty( $terms ) ) { ... }：检查商品是否确实具有目标属性的任何值。
- foreach ( $terms as $term_slug ) { ... }：遍历商品在目标属性分类法下的所有属性值。
- if ( $term_slug === $term_slug1 ) { ... } 和 if ( $term_slug === $term_slug2 ) { ... }：将当前属性值与预设的 $term_slug1 或 $term_slug2 进行比较。
- $recipient .= ',' . $additional_email1;：如果匹配成功，将额外的邮箱地址追加到 $recipient 字符串中。多个邮箱地址应以逗号 , 分隔。
- $has_matching_attribute = true; break 2;：设置标记并使用 break 2 语句，这将跳出内外两层 `
