本文旨在解决WooCommerce中根据订单内特定商品ID及其元数据触发自定义邮件的常见问题。通过分析原始代码的逻辑缺陷，我们提出一种健壮的解决方案，确保即使订单中包含其他商品，也能准确识别目标商品并依据其元数据（如`meno`字段）发送相应的自定义邮件，从而避免邮件触发失败或错误发送的问题。
背景与问题分析
在WooCommerce店铺运营中，根据订单内容触发特定的自定义邮件是一种常见的需求。例如，当订单中包含某个特殊商品（如ID为2805的产品）时，我们可能需要根据该商品的特定元数据（如meno字段）是否为空来发送两种不同的邮件。
然而，在实际开发中，开发者常会遇到一个问题：当订单中仅包含目标商品时，邮件触发功能正常；但一旦订单中同时包含目标商品和其他商品，自定义邮件就无法触发。这通常是由于代码在遍历订单商品时，对关键变量的赋值和判断逻辑存在误区。
我们来看一个典型的错误代码模式：
add_action('woocommerce_order_status_completed', 'send_a_custom_email', 20, 2 );
function send_a_custom_email( $order_id, $order ) {
global $woocommerce;
$order = new WC_Order( $order_id );
$mailer = $woocommerce->mailer();
$product_ids = array( ); // 用于存储符合条件的商品ID
$customer_email = $order->get_billing_email();
$customer_name = $order->get_billing_first_name();
// 遍历订单中的所有商品
foreach ( $order->get_items() as $item ) {
$meta_data = $item->get_meta('meno'); // 获取 'meno' 元数据
$venovanie = $item->get_meta('venovanie'); // 获取 'venovanie' 元数据
$product_id = $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id(); // 获取当前商品ID
if( empty($meta_data) ) {
$product_ids[] = $item->get_variation_id() > 0 ? $item->get_variation_id() : $item->get_product_id();
}
}
// 问题所在：这里的 $product_id 仅代表循环中最后一个商品的ID
if ( ! empty($product_ids) && $product_id == 2805 ) {
// email 1
} else if ( empty($product_ids) && $product_id == 2805 ) {
// email 2
}
}代码缺陷分析：
上述代码的核心问题在于 $product_id 变量的使用。在 foreach 循环内部，$product_id 会被不断地赋值为当前遍历到的商品ID。当循环结束后，$product_id 最终会保留订单中最后一个商品的ID。
这意味着，在循环后的 if 和 else if 条件判断中，$product_id == 2805 实际上是在检查订单的最后一个商品是否为ID 2805。如果订单中包含多个商品，且商品ID 2805不是最后一个，或者根本没有商品ID 2805，那么即使订单中确实存在商品ID 2805并符合其他条件，邮件也无法正确触发，因为这个判断条件已经失效。
为了正确实现需求，我们需要确保：
- 准确地识别订单中是否存在目标商品（ID 2805）。
- 如果存在，则针对该特定商品的元数据进行判断，而不是基于循环中最后一个商品的数据。
解决方案：精准识别与条件判断
要解决上述问题，我们需要调整逻辑，在遍历订单商品时，不仅要检查是否存在目标商品，还要将其作为独立的对象进行处理，以便后续访问其特定的元数据。
以下是优化后的代码实现：
全国首个为手机行业定制的网站，外观豪华、时尚。DIV+CSS构建，符合W3C标准，完美搜索引擎优化迅速提高搜索引擎排名，稳定性、执行效率、负载能力均居国内同类产品领先地位。安装简单，傻瓜式操作，在线下单、支付、发货，轻松管理网站。 多套模板更换，界面更加豪华 完美搜索引擎优化 集成支付宝、财付通、网银等多种在线支付平台 手机、配件商品不同颜色、型号不同价格设置 图片化多种参数设置、搜索、评论 新闻
get_items() as $item_id => $item ) {
// 获取当前订单项的商品ID（考虑变体）
$product_id = $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id();
// 如果找到了目标商品
if ( $product_id == $target_product_id ) {
$found_target_product_item = $item; // 存储该商品项目
break; // 找到后立即退出循环，提高效率
}
}
// 如果订单中存在目标商品 (ID 2805)
if ( $found_target_product_item ) {
// 获取该特定商品项目的 'meno' 元数据
$meno_meta_data = $found_target_product_item->get_meta('meno');
// 获取该特定商品项目的 'venovanie' 元数据 (如果需要)
$venovanie_meta_data = $found_target_product_item->get_meta('venovanie');
$mailer = WC()->mailer(); // 获取WooCommerce邮件发送器实例
// 根据 'meno' 元数据是否为空来触发不同的邮件
if ( empty($meno_meta_data) ) {
// 触发邮件 1 的逻辑
// 示例：
// $subject = '订单 #'.$order_id.' - 特定商品空元数据通知';
// $message = '尊敬的客户，您的订单 #'.$order_id.' 中包含特殊商品，且其“meno”元数据为空。我们将为您提供相应服务。
';
// $mailer->send($order->get_billing_email(), $subject, $message);
error_log("订单 #{$order_id}：目标商品 {$target_product_id} 的 'meno' 元数据为空，触发邮件 1。");
// 在此处添加您的邮件 1 发送代码，例如调用自定义邮件类或使用 $mailer->send()
// 例如：WC()->mailer()->get_emails()['WC_Email_Custom_Email_1']->trigger( $order_id );
} else {
// 触发邮件 2 的逻辑
// 示例：
// $subject = '订单 #'.$order_id.' - 特定商品非空元数据通知';
// $message = '尊敬的客户，您的订单 #'.$order_id.' 中包含特殊商品，且其“meno”元数据为：'.$meno_meta_data.'。我们将为您提供相应服务。
';
// $mailer->send($order->get_billing_email(), $subject, $message);
error_log("订单 #{$order_id}：目标商品 {$target_product_id} 的 'meno' 元数据为 '{$meno_meta_data}'，触发邮件 2。");
// 在此处添加您的邮件 2 发送代码
// 例如：WC()->mailer()->get_emails()['WC_Email_Custom_Email_2']->trigger( $order_id );
}
} else {
// 订单中未找到目标商品，不触发任何自定义邮件
error_log("订单 #{$order_id} 中未找到目标商品 {$target_product_id}。未触发自定义邮件。");
}
}代码详解
-
add_action('woocommerce_order_status_completed', ...):
- 这个钩子确保我们的函数在订单状态变为“已完成”时执行。这是触发售后邮件的常见时机。
- 优先级 20 确保它在其他默认的订单处理之后运行，2 表示函数接收两个参数：$order_id 和 $order 对象。
-
$target_product_id = 2805;:
- 明确定义了我们关注的特定商品ID，方便修改和维护。
-
$found_target_product_item = null;:
- 引入一个新变量，用于在遍历订单项时，存储找到的那个特定商品（WC_Order_Item_Product 对象）。初始化为 null，表示尚未找到。
-
遍历订单项并查找目标商品:
foreach ( $order->get_items() as $item_id => $item ) { $product_id = $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id(); if ( $product_id == $target_product_id ) { $found_target_product_item = $item; break; // 找到后立即停止循环 } }- 这段代码遍历订单中的每一个商品项。
- $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id() 用于获取商品的正确ID，无论是简单商品还是变体商品。
- 一旦找到与 $target_product_id 匹配的商品，就将其完整的 WC_Order_Item_Product 对象赋值给 $found_target_product_item，并使用 break 语句立即退出循环。这样可以避免不必要的遍历，提高效率。
-
基于目标商品进行条件判断:
if ( $found_target_product_item ) { $meno_meta_data = $found_target_product_item->get_meta('meno'); // ... 邮件触发逻辑 } else { // ... 未找到目标商品的逻辑 }- 在循环结束后，我们检查 $found_target_product_item 是否为 null。如果不是 null，说明订单中包含了目标商品。
- 此时，我们可以安全地通过 $found_target_product_item->get_meta('meno') 来获取该特定商品的 meno 元数据，从而进行准确的条件判断。
- 根据 meno_meta_data 是否为空，触发不同的邮件发送逻辑（邮件1或邮件2）。
- 如果 $found_target_product_item 仍然是 null，表示订单中没有目标商品，则不触发任何自定义邮件。
-
邮件发送占位符:
- 代码中使用了 error_log() 作为邮件触发的占位符，在实际应用中，您需要替换为真正的邮件发送逻辑。这可能包括：
- 调用 WooCommerce 现有的邮件类：WC()->mailer()->get_emails()['WC_Email_Your_Custom_Email_Class_ID']->trigger( $order_id );
- 使用 WC()->mailer()->send() 方法发送通用邮件。
- 或者您自定义的邮件发送函数。
- 代码中使用了 error_log() 作为邮件触发的占位符，在实际应用中，您需要替换为真正的邮件发送逻辑。这可能包括：
注意事项与最佳实践
- 代码位置: 将此代码放置在您主题的 functions.php 文件中，或者更推荐的方式是创建一个自定义插件。
- 错误日志: 在开发和调试阶段，error_log() 是一个非常有用的工具，可以帮助您跟踪代码执行情况。在生产环境中，可以考虑将其替换为更完善的日志记录系统。
- 邮件内容定制: 示例代码中的邮件发送逻辑是占位符。在实际应用中，您需要根据业务需求，创建完整的邮件主题、内容和收件人信息。
- 性能考量: 对于非常大的订单（包含数百个商品项），虽然 break 语句可以优化性能，但如果您的逻辑变得更复杂，可能需要进一步考虑数据库查询优化。
- 元数据键名: 确保 get_meta('meno') 中的 meno 是您商品元数据的正确键名。
- 兼容性: 确保您的代码与当前 WooCommerce 版本兼容。WC_Order 和 WC_Order_Item_Product 类的方法在不同版本间可能略有差异，但上述基本操作在大多数现代 WooCommerce 版本中是稳定的。
总结
通过引入一个中间变量来存储找到的特定商品项，并基于该商品项的元数据进行条件判断，我们成功解决了WooCommerce中自定义邮件触发逻辑的常见陷阱。这种方法确保了即使订单中包含多个商品，也能精准地识别目标商品并根据其特有属性触发正确的业务流程。遵循这种结构，您的WooCommerce自定义功能将更加健壮和可靠。
