WooCommerce 邮件页脚自定义：按分类添加内容

本教程旨在指导开发者如何根据订单中包含的商品分类，动态地向 WooCommerce 邮件通知的页脚添加自定义文本。文章将详细介绍如何获取订单商品分类、正确使用 PHP 数组函数进行条件判断，并提供一个升级安全的完整代码示例，以实现个性化的客户邮件体验。

在电子商务运营中，个性化用户体验对于提升客户满意度和品牌形象至关重要。WooCommerce 提供了强大的扩展能力，允许开发者定制几乎所有方面，包括发送给客户的邮件通知。有时，我们可能需要根据客户订单中商品的特定属性（例如所属分类），在邮件内容中加入特定的信息。本教程将重点讲解如何利用 WooCommerce 的钩子和 PHP 数组处理功能，实现对订单邮件页脚的条件化定制，使其仅在订单包含特定分类商品时才显示额外的文本。

理解 WooCommerce 邮件钩子

WooCommerce 邮件系统设计了多个动作钩子（Action Hooks），允许开发者在邮件生成的不同阶段插入自定义内容。对于邮件页脚，woocommerce_email_footer 是最常用的钩子。它在邮件页脚模板渲染之前触发，并接收以下四个参数：

• $order: WC_Order 对象，包含当前订单的所有信息。
• $sent_to_admin: 布尔值，指示邮件是否发送给管理员。
• $plain_text: 布尔值，指示邮件是否为纯文本格式。
• $email: WC_Email 对象，表示当前正在处理的邮件实例。

通过利用这些参数，我们可以访问订单详情，并根据业务逻辑进行判断。

获取订单中的商品分类

要实现基于商品分类的条件判断，首先需要从当前的订单对象中提取出所有商品的分类信息。一个订单可能包含多个商品，每个商品又可能属于一个或多个分类。因此，我们需要遍历订单中的所有商品，并收集它们各自的分类名称。

以下是获取订单商品分类的基本步骤：

1. 获取订单商品项： 通过 $order->get_items() 方法获取订单中所有的商品项（WC_Order_Item_Product 对象）。
2. 提取商品ID： 对于每个商品项，使用 $item->get_product_id() 获取其对应的商品 ID。
3. 获取商品分类： 利用 WordPress 的 wp_get_post_terms() 函数，传入商品 ID 和分类法名称 'product_cat'，即可获取该商品所属的所有分类对象。为了简化后续处理，我们可以直接指定 'fields' => 'names' 来获取分类的名称数组。
4. 汇总所有分类： 将所有商品的分类名称合并到一个数组中，并去除重复项，以确保每个分类名称只被处理一次。

正确的条件判断逻辑：使用 array_intersect

在收集到订单中所有商品的分类名称后，我们需要将其与预设的目标分类列表进行比较，以判断是否存在交集。这里，使用 PHP 的 array_intersect() 函数是最佳实践。

array_intersect() 函数返回一个数组，其中包含存在于所有输入数组中的值。如果 array_intersect() 的结果不为空，则表示订单中包含了至少一个我们目标列表中的分类。

错误示例回顾与修正： 原始问题中尝试使用 in_array('val1', 'val2', ..., $term_names) 的方式进行判断，这是不正确的。in_array() 函数的第一个参数应为单个值（要查找的元素），第二个参数为数组（要在其中搜索的数组）。它不能直接接受多个独立的字符串作为第一个参数来检查“或”关系。

正确的做法是定义一个包含所有目标分类的数组，然后使用 array_intersect() 与从订单中提取的分类数组进行比较。

完整代码示例

将上述逻辑整合到 functions.php 文件或自定义插件中，即可实现 WooCommerce 邮件页脚的条件定制。

get_items() as $item_id => $item) {
        // 获取当前商品项的实际产品 ID
        $product_id = $item->get_product_id();

        // 确保产品 ID 有效，防止处理虚拟或无效商品
        if (!$product_id) {
            continue;
        }

        // 获取该商品所属的所有产品分类名称
        // 'fields' => 'names' 参数确保只返回分类的名称数组
        $terms = wp_get_post_terms($product_id, 'product_cat', ['fields' => 'names']);

        // 如果获取到了分类，则将其合并到总的分类名称数组中
        if (!empty($terms)) {
            $all_product_category_names = array_merge($all_product_category_names, $terms);
        }
    }

    // 对收集到的所有分类名称进行去重处理，确保每个分类名称只被检查一次
    $unique_product_category_names = array_unique($all_product_category_names);

    // 定义一个数组，包含所有触发自定义页脚的目标分类名称
    $target_categories = [
        'Farm Shop', 'Cowdray Kitchen', 'Cowdray Living', 'The Meditator',
        'Cowdray Hampers', 'Cowdray Supper Kits', 'Grocery', 'Butchery',
        'Deli', 'Pantry', 'Houseplants and Flowers', 'Picnic Hampers',
        'Afternoon Tea', 'Drinks', 'Wreaths'
    ];

    // 使用 array_intersect 检查订单中的分类与目标分类是否存在交集
    // 如果存在交集，则表示订单中包含了至少一个目标分类的商品
    $matching_categories = array_intersect($target_categories, $unique_product_category_names);

    // 如果匹配到的分类数组不为空，则输出自定义的页脚文本
    if (!empty($matching_categories)) {
        echo 'Cowdray Farm Shop Ltd
VAT Number: 970407718';
    }
}

// 将自定义函数挂载到 WooCommerce 的邮件页脚钩子 'woocommerce_email_footer' 上
// 优先级 10（默认），接收 4 个参数
add_action('woocommerce_email_footer', 'farm_shop_woocommerce_email_footer_conditional', 10, 4);

代码说明与注意事项

1. 函数命名： 建议使用具有描述性的函数名，并添加前缀以避免与其他插件或主题的函数名冲突（例如 farm_shop_）。
2. 获取商品 ID： 对于 WC_Order_Item_Product 对象，应使用 $item->get_product_id() 方法来获取商品 ID，而不是直接访问数组键 $item['product_id']，这更符合 WooCommerce 对象的面向对象设计。
3. wp_get_post_terms()： 此函数用于获取指定文章（商品）的分类。通过 'fields' => 'names' 参数，我们可以直接获取分类名称数组，避免了额外的循环来提取名称。
4. array_unique()： 在将所有商品的分类名称合并后，使用 array_unique() 可以去除重复的分类名称，提高后续 array_intersect() 的效率，尽管 array_intersect() 也能正确处理重复项。
5. array_intersect()： 这是本解决方案的核心。它能够高效地找出两个数组之间的共同元素。如果返回的数组不为空，则说明存在匹配项。
6. 代码放置位置： 建议将此代码放置在子主题的 functions.php 文件中。如果直接修改父主题的 functions.php，在主题更新时您的修改将会丢失。对于更复杂的逻辑或希望代码独立于主题，可以考虑创建一个自定义插件。
7. 缓存： 在开发和测试过程中，请注意 WooCommerce 和 WordPress 可能存在的缓存机制。在修改代码后，可能需要清除相关缓存才能看到效果。
8. 文本格式： 邮件页脚的输出内容可以是 HTML 格式（如示例中的
   标签），WooCommerce 会根据邮件类型（HTML 或纯文本）进行适当处理。如果需要为纯文本邮件提供不同的内容，可以利用 $plain_text 参数进行条件判断。

总结

通过本教程，您应该已经掌握了如何利用 WooCommerce 提供的钩子和 PHP 数组处理函数，根据订单中商品的分类，动态地定制邮件通知的页脚内容。这种方法不仅功能强大，而且具有良好的可扩展性和升级安全性。通过灵活运用这些技巧，您可以为客户提供更加个性化和专业的购物体验。记住，在进行任何代码修改时，始终建议在开发环境中进行测试，并在生产环境部署前进行充分验证。