本教程详细讲解如何在 woocommerce 商店中，根据订单内是否存在特定商品id及其元数据，精确触发自定义邮件。针对多商品订单导致邮件触发逻辑失效的问题，本文提供了一种健壮的解决方案，确保邮件仅在目标商品存在时按其元数据条件发送，避免了常见逻辑错误。
在 WooCommerce 开发中，根据订单内容触发自定义邮件是一项常见需求。然而，当邮件触发逻辑依赖于订单中是否存在某个特定商品及其元数据时，如果订单中包含多种商品，可能会遇到邮件触发失效的问题。这通常是由于在遍历订单商品时，条件判断错误地使用了循环中最后一个商品的ID，而非目标商品的ID。本教程将深入探讨这一问题，并提供一个健壮的解决方案。
理解问题根源
考虑一个场景：您希望当订单中包含商品ID 2805 时，根据该商品的 meno 元数据是否为空来发送不同的自定义邮件。然而，当一个订单既包含商品 2805 又包含其他商品时，您的自定义邮件逻辑可能无法按预期触发。
原始代码片段可能如下所示：
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();
// ... 其他初始化代码 ...
foreach ( $order->get_items() as $item ) {
$meta_data = $item->get_meta('meno');
$product_id = $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id();
// 此处逻辑可能将所有符合条件的商品ID放入数组
// 但 $product_id 在循环结束后会是最后一个商品的ID
if( empty($meta_data) ) {
// ...
}
}
// 问题所在：这里的 $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 循环结束后，会保留订单中最后一个商品的ID。这意味着，如果订单中包含商品 2805，但它不是订单中的最后一个商品，那么外部的 if 或 else if 条件中的 $product_id == 2805 将始终为 false，导致邮件无法触发。即使 !empty($product_ids) 可能为真，整个条件也会失败。
解决方案：精准定位目标商品
为了解决这个问题，我们需要修改逻辑，首先明确地在订单中查找目标商品（ID 2805）。一旦找到，就基于该特定商品的元数据来决定发送哪封邮件。如果目标商品不存在于订单中，则不发送任何邮件。
以下是优化后的代码实现：
<?php
/**
* 针对 WooCommerce 订单状态为“已完成”时，根据特定商品ID及其元数据触发自定义邮件。
*
* @param int $order_id 订单ID。
* @param WC_Order $order WC_Order 对象。
*/
add_action('woocommerce_order_status_completed', 'custom_conditional_product_email_trigger', 20, 2 );
function custom_conditional_product_email_trigger( $order_id, $order ) {
// 确保 $order 是一个有效的 WC_Order 对象
if ( ! is_a( $order, 'WC_Order' ) ) {
$order = wc_get_order( $order_id );
}
// 如果订单对象无效，则直接返回
if ( ! $order ) {
error_log( "Error: Could not retrieve WC_Order object for order ID {$order_id}." );
return;
}
// 定义我们关注的目标商品ID
$target_product_id = 2805;
// 初始化一个变量来存储目标商品订单项，如果找到的话
$found_target_product_item = null;
// 遍历订单中的所有商品项，查找目标商品
foreach ( $order->get_items() as $item_id => $item ) {
// 获取商品ID，处理变体商品
$product_id = $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id();
// 如果找到目标商品
if ( (int) $product_id === (int) $target_product_id ) {
$found_target_product_item = $item; // 存储该商品项
break; // 找到后即可退出循环，因为我们只关心这个特定商品
}
}
// 只有当目标商品存在于订单中时才继续执行邮件触发逻辑
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');
// 根据 'meno' 元数据是否为空来决定发送哪封邮件
if ( empty( $meno_meta_data ) ) {
// --- 邮件 1 触发逻辑 ---
// 示例：发送自定义邮件1
// global $woocommerce;
// $mailer = $woocommerce->mailer();
// $mailer->get_emails()['WC_Email_Custom_1']->trigger($order_id);
// 实际应用中替换为您的邮件发送代码
error_log( "Order {$order_id}: Triggering Email 1 (Product {$target_product_id} found, 'meno' is empty)." );
// TODO: 在此处调用您的自定义邮件发送函数或类
// 例如: YourCustomEmailClass::sendEmail1($order_id, $found_target_product_item);
} else {
// --- 邮件 2 触发逻辑 ---
// 示例：发送自定义邮件2
// global $woocommerce;
// $mailer = $woocommerce->mailer();
// $mailer->get_emails()['WC_Email_Custom_2']->trigger($order_id);
// 实际应用中替换为您的邮件发送代码
error_log( "Order {$order_id}: Triggering Email 2 (Product {$target_product_id} found, 'meno' is NOT empty)." );
// TODO: 在此处调用您的自定义邮件发送函数或类
// 例如: YourCustomEmailClass::sendEmail2($order_id, $found_target_product_item);
}
} else {
// 目标商品未在订单中找到，不发送任何邮件
error_log( "Order {$order_id}: Product {$target_product_id} not found in order. No custom email triggered." );
}
}代码解析与注意事项
- 钩子 (add_action): woocommerce_order_status_completed 确保只有在订单状态变为“已完成”时才执行此函数。优先级 20 允许其他更早的动作先执行。
- 订单对象验证: wc_get_order( $order_id ) 是获取订单对象的推荐方式，它比直接 new WC_Order( $order_id ) 更健壮，尤其是在钩子函数中 $order 参数可能未完全初始化时。
- 目标商品ID: 将目标商品ID 2805 明确定义为 $target_product_id，提高了代码的可读性和可维护性。
-
精准查找:
- 我们引入了一个变量 $found_target_product_item，用于存储找到的目标商品项。
- 在 foreach 循环中，我们遍历每个订单商品项，获取其产品ID（同时处理变体商品）。
- 一旦找到与 $target_product_id 匹配的商品，我们将其存储到 $found_target_product_item 中，并立即使用 break 语句退出循环。这是因为我们只需要知道目标商品是否存在及其元数据，不需要继续遍历。
-
条件判断:
- 在循环结束后，我们首先检查 $found_target_product_item 是否为 null。如果不是 null，则表示商品 2805 存在于订单中，此时才继续执行邮件触发逻辑。
- 然后，我们从 $found_target_product_item 中直接获取其 meno 元数据。
- 根据 meno_meta_data 是否为空，执行相应的邮件触发逻辑（邮件1或邮件2）。
-
邮件发送逻辑:
- 代码中的 error_log() 语句是调试和验证逻辑的占位符。
- 在实际应用中，您需要将 TODO 部分替换为调用您自定义的 WooCommerce 邮件类或函数来发送实际的邮件。例如，如果您创建了名为 WC_Email_Custom_1 的自定义邮件类，您可以通过 $mailer->get_emails()['WC_Email_Custom_1']->trigger($order_id); 来触发它。
- 错误日志: 引入 error_log() 可以帮助您在开发和生产环境中跟踪函数的执行情况，判断何时触发了邮件，何时没有，以及原因。
总结
通过上述优化，您的自定义邮件触发逻辑将变得更加精确和健壮。它不再受订单中其他商品的影响，能够准确地识别目标商品，并根据其特定的元数据来发送相应的邮件。这种模式适用于任何需要基于订单中特定商品条件来执行操作的场景，确保您的业务逻辑能够按预期工作。请务必将占位符替换为实际的邮件发送代码，并在部署前进行充分测试。
