本教程旨在指导开发者如何根据订单中包含的商品分类，动态地向 WooCommerce 邮件通知的页脚添加自定义文本。文章将详细介绍如何获取订单商品分类、正确使用 PHP 数组函数进行条件判断，并提供一个升级安全的完整代码示例，以实现个性化的客户邮件体验。
在电子商务运营中，个性化用户体验对于提升客户满意度和品牌形象至关重要。WooCommerce 提供了强大的扩展能力，允许开发者定制几乎所有方面，包括发送给客户的邮件通知。有时，我们可能需要根据客户订单中商品的特定属性（例如所属分类），在邮件内容中加入特定的信息。本教程将重点讲解如何利用 WooCommerce 的钩子和 PHP 数组处理功能，实现对订单邮件页脚的条件化定制，使其仅在订单包含特定分类商品时才显示额外的文本。
理解 WooCommerce 邮件钩子
WooCommerce 邮件系统设计了多个动作钩子（Action Hooks），允许开发者在邮件生成的不同阶段插入自定义内容。对于邮件页脚，woocommerce_email_footer 是最常用的钩子。它在邮件页脚模板渲染之前触发，并接收以下四个参数：
- $order: WC_Order 对象，包含当前订单的所有信息。
- $sent_to_admin: 布尔值，指示邮件是否发送给管理员。
- $plain_text: 布尔值，指示邮件是否为纯文本格式。
- $email: WC_Email 对象，表示当前正在处理的邮件实例。
通过利用这些参数，我们可以访问订单详情，并根据业务逻辑进行判断。
获取订单中的商品分类
要实现基于商品分类的条件判断，首先需要从当前的订单对象中提取出所有商品的分类信息。一个订单可能包含多个商品，每个商品又可能属于一个或多个分类。因此，我们需要遍历订单中的所有商品，并收集它们各自的分类名称。
以下是获取订单商品分类的基本步骤：
需要创建、读取、编辑或处理 Word 文档（.docx / .dotx）时使用。触发词：'Word'、'word 文档'、'.docx'、'生成报告'、'制作合同/简历/方案/说明书'、'提取 word 内容'、'在文档里查找替换'、'给文档加页眉页脚/目录/表格'。也用于把任意内容排版成一份正式的 Word 文件。不要用它处理 PDF、Excel 或无关编程任务。中文创作场景尤其适合：小说大纲稿、投稿文档、合同、简历、工作总结。
- 获取订单商品项： 通过 $order->get_items() 方法获取订单中所有的商品项（WC_Order_Item_Product 对象）。
- 提取商品ID： 对于每个商品项，使用 $item->get_product_id() 获取其对应的商品 ID。
- 获取商品分类： 利用 WordPress 的 wp_get_post_terms() 函数，传入商品 ID 和分类法名称 'product_cat'，即可获取该商品所属的所有分类对象。为了简化后续处理，我们可以直接指定 'fields' => 'names' 来获取分类的名称数组。
- 汇总所有分类： 将所有商品的分类名称合并到一个数组中，并去除重复项，以确保每个分类名称只被处理一次。
正确的条件判断逻辑：使用 array_intersect
在收集到订单中所有商品的分类名称后，我们需要将其与预设的目标分类列表进行比较，以判断是否存在交集。这里，使用 PHP 的 array_intersect() 函数是最佳实践。
array_intersect() 函数返回一个数组，其中包含存在于所有输入数组中的值。如果 array_intersect() 的结果不为空，则表示订单中包含了至少一个我们目标列表中的分类。
错误示例回顾与修正： 原始问题中尝试使用 in_array('val1', 'val2', ..., $term_names) 的方式进行判断，这是不正确的。in_array() 函数的第一个参数应为单个值（要查找的元素），第二个参数为数组（要在其中搜索的数组）。它不能直接接受多个独立的字符串作为第一个参数来检查“或”关系。
正确的做法是定义一个包含所有目标分类的数组，然后使用 array_intersect() 与从订单中提取的分类数组进行比较。
完整代码示例
将上述逻辑整合到 functions.php 文件或自定义插件中，即可实现 WooCommerce 邮件页脚的条件定制。
<?php
/**
* 根据订单中商品的分类，条件性地修改 WooCommerce 邮件通知的页脚。
*
* 此函数通过 woocommerce_email_footer 钩子在邮件页脚渲染前执行。
* 它会检查订单中所有商品所属的分类，如果这些分类中包含预定义的任何一个目标分类，
* 就会在邮件页脚添加自定义文本。
*
* @param WC_Order $order WC_Order 对象，包含当前订单的所有信息。
* @param bool $sent_to_admin 指示邮件是否发送给管理员。
* @param bool $plain_text 指示邮件是否为纯文本格式。
* @param WC_Email $email WC_Email 对象，表示当前正在处理的邮件实例。
*/
function farm_shop_woocommerce_email_footer_conditional($order, $sent_to_admin, $plain_text, $email) {
// 初始化一个空数组，用于存储订单中所有商品的分类名称
$all_product_category_names = [];
// 遍历订单中的每一个商品项
foreach ($order->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<br>VAT Number: 970407718';
}
}
// 将自定义函数挂载到 WooCommerce 的邮件页脚钩子 'woocommerce_email_footer' 上
// 优先级 10（默认），接收 4 个参数
add_action('woocommerce_email_footer', 'farm_shop_woocommerce_email_footer_conditional', 10, 4);代码说明与注意事项
- 函数命名： 建议使用具有描述性的函数名，并添加前缀以避免与其他插件或主题的函数名冲突（例如 farm_shop_）。
- 获取商品 ID： 对于 WC_Order_Item_Product 对象，应使用 $item->get_product_id() 方法来获取商品 ID，而不是直接访问数组键 $item['product_id']，这更符合 WooCommerce 对象的面向对象设计。
- wp_get_post_terms()： 此函数用于获取指定文章（商品）的分类。通过 'fields' => 'names' 参数，我们可以直接获取分类名称数组，避免了额外的循环来提取名称。
- array_unique()： 在将所有商品的分类名称合并后，使用 array_unique() 可以去除重复的分类名称，提高后续 array_intersect() 的效率，尽管 array_intersect() 也能正确处理重复项。
- array_intersect()： 这是本解决方案的核心。它能够高效地找出两个数组之间的共同元素。如果返回的数组不为空，则说明存在匹配项。
- 代码放置位置： 建议将此代码放置在子主题的 functions.php 文件中。如果直接修改父主题的 functions.php，在主题更新时您的修改将会丢失。对于更复杂的逻辑或希望代码独立于主题，可以考虑创建一个自定义插件。
- 缓存： 在开发和测试过程中，请注意 WooCommerce 和 WordPress 可能存在的缓存机制。在修改代码后，可能需要清除相关缓存才能看到效果。
-
文本格式： 邮件页脚的输出内容可以是 HTML 格式（如示例中的
标签），WooCommerce 会根据邮件类型（HTML 或纯文本）进行适当处理。如果需要为纯文本邮件提供不同的内容，可以利用 $plain_text 参数进行条件判断。
总结
通过本教程，您应该已经掌握了如何利用 WooCommerce 提供的钩子和 PHP 数组处理函数，根据订单中商品的分类，动态地定制邮件通知的页脚内容。这种方法不仅功能强大，而且具有良好的可扩展性和升级安全性。通过灵活运用这些技巧，您可以为客户提供更加个性化和专业的购物体验。记住，在进行任何代码修改时，始终建议在开发环境中进行测试，并在生产环境部署前进行充分验证。
