
本教程详细讲解如何在woocommerce邮件通知的页脚中,根据订单中包含的产品分类动态添加自定义内容。文章将纠正`in_array`函数的常见误用,并提供一个使用`array_intersect`来有效判断订单产品是否属于特定分类的“升级安全”解决方案,确保邮件内容个性化且易于维护。
WooCommerce作为流行的电商平台,其邮件通知系统是与客户沟通的重要桥梁。默认的邮件模板提供了基础信息,但在特定业务场景下,我们可能需要根据订单的详细内容,特别是所购商品的分类,来动态调整邮件的某些部分。例如,当客户购买了特定类别的产品时,可能需要在邮件页脚添加特定的公司信息、促销声明或法律条款。本文将聚焦于如何实现基于产品分类的WooCommerce邮件通知页脚定制。
在尝试根据产品分类定制邮件页脚时,一个常见的做法是获取订单中所有产品的分类,然后检查这些分类是否包含在预定义的目标分类列表中。然而,PHP的in_array函数在使用时常被误解。考虑以下原始代码片段中if条件的使用方式:
// 假设 $term_names 已经包含了订单中所有产品的分类名称
if ( in_array('Farm Shop', 'Cowdray Kitchen', 'Cowdray Living', ..., $term_names) ) {
echo 'Cowdray Farm Shop Ltd<br>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()函数是更合适且更健壮的选择。
首先,我们需要在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 );将所有需要触发自定义页脚的目标分类名称定义为一个独立的数组,这提高了代码的可读性和可维护性。
// ... (函数开头部分)
// 定义目标分类列表
$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'
);
// ... (获取订单产品分类的代码)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<br>VAT Number: 970407718';
}
}
// 将自定义函数挂载到 woocommerce_email_footer 动作钩子
// 优先级 10,接受 4 个参数
add_action( 'woocommerce_email_footer', 'custom_woocommerce_email_footer_by_category', 10, 4 );钩子(Hook)使用:
获取产品分类:
array_unique():
array_intersect():
安全性与可维护性:
性能考量:
分类ID vs. 分类名称:
通过本教程,我们学习了如何利用woocommerce_email_footer钩子和array_intersect函数,实现基于产品分类的WooCommerce邮件通知页脚的动态定制。这种方法不仅解决了in_array函数的常见误用问题,还提供了一个结构清晰、易于维护且“升级安全”的解决方案。掌握这种技术,可以帮助您更灵活地个性化您的WooCommerce商店邮件通知,提升客户体验和品牌专业度。
以上就是基于产品分类的WooCommerce邮件通知页脚定制教程的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号