本教程详细讲解如何在woocommerce邮件通知的页脚中，根据订单中包含的产品分类动态添加自定义内容。文章将纠正`in_array`函数的常见误用，并提供一个使用`array_intersect`来有效判断订单产品是否属于特定分类的“升级安全”解决方案，确保邮件内容个性化且易于维护。
引言：个性化WooCommerce邮件通知
WooCommerce作为流行的电商平台，其邮件通知系统是与客户沟通的重要桥梁。默认的邮件模板提供了基础信息，但在特定业务场景下，我们可能需要根据订单的详细内容，特别是所购商品的分类，来动态调整邮件的某些部分。例如，当客户购买了特定类别的产品时，可能需要在邮件页脚添加特定的公司信息、促销声明或法律条款。本文将聚焦于如何实现基于产品分类的WooCommerce邮件通知页脚定制。
问题解析：in_array函数的常见误用
在尝试根据产品分类定制邮件页脚时，一个常见的做法是获取订单中所有产品的分类，然后检查这些分类是否包含在预定义的目标分类列表中。然而，PHP的in_array函数在使用时常被误解。考虑以下原始代码片段中if条件的使用方式：
// 假设 $term_names 已经包含了订单中所有产品的分类名称if ( in_array('Farm Shop', 'Cowdray Kitchen', 'Cowdray Living', ..., $term_names) ) { echo 'Cowdray Farm Shop Ltd
VAT Number: 970407718';}
in_array()函数的设计目的是检查一个单一值是否存在于一个数组中。它的基本语法是 in_array(mixed $needle, array $haystack, bool $strict = false)。在上述代码中，将多个字符串作为独立的参数传递给in_array是错误的。PHP会将其解析为 in_array(‘Farm Shop’, ‘Cowdray Kitchen’)，并忽略后续参数，或者在’Cowdray Kitchen’不是数组时抛出警告，这显然无法达到检查多个分类的目的。
要正确地检查订单中是否有任何产品属于预定义的目标分类列表，我们需要一个能够比较两个数组并找出它们之间共同元素的函数。
解决方案：利用array_intersect进行分类匹配
为了实现“如果订单中的任何产品分类与我们的目标分类列表有交集，则添加自定义页脚”的功能，array_intersect()函数是更合适且更健壮的选择。
1. 获取订单产品分类
首先，我们需要在WooCommerce的邮件页脚钩子中，获取当前订单中所有产品的分类名称。
function custom_woocommerce_email_footer_by_category( $order, $sent_to_admin, $plain_text, $email ) { // 确保 $order 对象存在且有效 if ( ! $order instanceof WC_Order ) { return; } $ordered_category_names = array(); // 遍历订单中的每个产品项 foreach ( $order->get_items() as $item_id => $item ) { $product_id = $item->get_product_id(); // 使用 wp_get_post_terms 获取产品的分类名称 // 'fields' => 'names' 参数可以直接返回分类名称数组 $terms = wp_get_post_terms( $product_id, 'product_cat', array('fields' => 'names') ); if ( ! is_wp_error( $terms ) && ! empty( $terms ) ) { // 将当前产品的分类名称合并到总列表中 $ordered_category_names = array_merge( $ordered_category_names, $terms ); } } // 去除重复的分类名称，确保每个分类只被处理一次 $ordered_category_names = array_unique( $ordered_category_names ); // ... 后续匹配逻辑}add_action( 'woocommerce_email_footer', 'custom_woocommerce_email_footer_by_category', 10, 4 );
2. 定义目标分类列表
将所有需要触发自定义页脚的目标分类名称定义为一个独立的数组，这提高了代码的可读性和可维护性。
// ... (函数开头部分) // 定义目标分类列表 $target_categories = array( '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' ); // ... (获取订单产品分类的代码)
3. 使用array_intersect进行匹配
array_intersect()函数用于计算两个或更多数组的交集。它返回一个包含所有在所有输入数组中都存在的值的数组。在本场景中，如果$ordered_category_names与$target_categories有任何共同的元素，则表示订单中包含至少一个目标分类。
以下是完整的修正代码：
/** * 根据订单中的产品分类，有条件地修改WooCommerce邮件通知的页脚。 * * @param WC_Order $order 订单对象。 * @param bool $sent_to_admin 邮件是否发送给管理员。 * @param bool $plain_text 邮件是否为纯文本格式。 * @param WC_Email $email 邮件对象。 */function custom_woocommerce_email_footer_by_category( $order, $sent_to_admin, $plain_text, $email ) { // 定义需要触发自定义页脚的目标分类列表 $target_categories = array( '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' ); $ordered_category_names = array(); // 确保 $order 对象存在且有效 if ( ! $order instanceof WC_Order ) { return; } // 遍历订单中的每个产品项，收集所有产品的分类名称 foreach ( $order->get_items() as $item_id => $item ) { $product_id = $item->get_product_id(); // 获取产品的分类名称数组 $terms = wp_get_post_terms( $product_id, 'product_cat', array('fields' => 'names') ); if ( ! is_wp_error( $terms ) && ! empty( $terms ) ) { $ordered_category_names = array_merge( $ordered_category_names, $terms ); } } // 去除重复的分类名称，优化后续的交集计算 $ordered_category_names = array_unique( $ordered_category_names ); // 检查订单中是否有任何产品属于目标分类 // array_intersect 返回两个数组的交集，如果交集不为空，则表示有匹配项 $matching_categories = array_intersect( $ordered_category_names, $target_categories ); if ( ! empty( $matching_categories ) ) { // 如果存在匹配的分类，则输出自定义的页脚内容 echo 'Cowdray Farm Shop Ltd
VAT Number: 970407718'; }}// 将自定义函数挂载到 woocommerce_email_footer 动作钩子// 优先级 10，接受 4 个参数add_action( 'woocommerce_email_footer', 'custom_woocommerce_email_footer_by_category', 10, 4 );
代码说明与注意事项
钩子（Hook）使用：
add_action( ‘woocommerce_email_footer’, ‘your_function_name’, 10, 4 ); 是关键。woocommerce_email_footer钩子允许我们在WooCommerce邮件页脚的渲染过程中插入自定义内容。10 是优先级，数字越小越早执行。4 表示你的函数将接受4个参数：$order (订单对象), $sent_to_admin (是否发送给管理员), $plain_text (是否为纯文本邮件), $email (邮件对象)。
获取产品分类：
$order->get_items() 用于获取订单中的所有产品项。$item->get_product_id() 获取每个产品项对应的产品ID。wp_get_post_terms( $product_id, ‘product_cat’, array(‘fields’ => ‘names’) ) 是获取产品分类名称的核心函数。通过设置’fields’ => ‘names’，我们可以直接获得一个包含分类名称的数组，而不需要进一步处理分类对象。
array_unique()：
在收集所有分类名称后，使用array_unique()函数可以去除重复的分类名称。这虽然不是强制性的，但可以优化array_intersect的性能，并使$ordered_category_names数组更简洁。
array_intersect()：
这是解决此问题的关键。它有效地比较了订单中的产品分类列表和预定义的目标分类列表。如果返回的数组不为空，则意味着订单中至少有一个产品属于目标分类，此时即可输出自定义内容。
安全性与可维护性：
将此代码放置在主题的functions.php文件或自定义插件中，以确保“升级安全”。避免直接修改WooCommerce核心文件或主题文件，因为更新时可能会丢失更改。将$target_categories列表定义在函数内部或作为常量，便于管理。对于更复杂的场景，可以考虑将其存储在WordPress的设置选项中，以便通过后台界面进行配置，无需修改代码。
性能考量：
对于大多数电商网站而言，即使订单包含多个产品，多次调用wp_get_post_terms的性能开销通常也是可接受的。对于极端情况（例如，一个订单包含数百个SKU），可能需要考虑更高级的缓存策略。
分类ID vs. 分类名称：
虽然本教程使用了分类名称进行匹配，但在实际开发中，使用分类ID进行匹配通常被认为是更健壮的做法。因为分类名称可能会因编辑而改变，但其ID通常是固定的。如果使用ID，则$target_categories数组应包含分类ID，并且wp_get_post_terms的fields参数应调整为’ids’。
总结
通过本教程，我们学习了如何利用woocommerce_email_footer钩子和array_intersect函数，实现基于产品分类的WooCommerce邮件通知页脚的动态定制。这种方法不仅解决了in_array函数的常见误用问题，还提供了一个结构清晰、易于维护且“升级安全”的解决方案。掌握这种技术，可以帮助您更灵活地个性化您的WooCommerce商店邮件通知，提升客户体验和品牌专业度。
以上就是基于产品分类的WooCommerce邮件通知页脚定制教程的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1325227.html
微信扫一扫 
支付宝扫一扫 
