基于产品分类的WooCommerce邮件通知页脚定制教程

本教程详细讲解如何在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有任何共同的元素，则表示订单中包含至少一个目标分类。

以下是完整的修正代码：

FaceSwapper

FaceSwapper是一款AI在线换脸工具，可以让用户在照片和视频中无缝交换面孔。

下载

/**
 * 根据订单中的产品分类，有条件地修改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 );

代码说明与注意事项

1. 钩子（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 (邮件对象)。

2. 获取产品分类：

   • $order->get_items() 用于获取订单中的所有产品项。
   • $item->get_product_id() 获取每个产品项对应的产品ID。
   • wp_get_post_terms( $product_id, 'product_cat', array('fields' => 'names') ) 是获取产品分类名称的核心函数。通过设置'fields' => 'names'，我们可以直接获得一个包含分类名称的数组，而不需要进一步处理分类对象。

3. array_unique()：

   • 在收集所有分类名称后，使用array_unique()函数可以去除重复的分类名称。这虽然不是强制性的，但可以优化array_intersect的性能，并使$ordered_category_names数组更简洁。

4. array_intersect()：

   • 这是解决此问题的关键。它有效地比较了订单中的产品分类列表和预定义的目标分类列表。如果返回的数组不为空，则意味着订单中至少有一个产品属于目标分类，此时即可输出自定义内容。

5. 安全性与可维护性：

   • 将此代码放置在主题的functions.php文件或自定义插件中，以确保“升级安全”。避免直接修改WooCommerce核心文件或主题文件，因为更新时可能会丢失更改。
   • 将$target_categories列表定义在函数内部或作为常量，便于管理。对于更复杂的场景，可以考虑将其存储在WordPress的设置选项中，以便通过后台界面进行配置，无需修改代码。

6. 性能考量：

   • 对于大多数电商网站而言，即使订单包含多个产品，多次调用wp_get_post_terms的性能开销通常也是可接受的。对于极端情况（例如，一个订单包含数百个SKU），可能需要考虑更高级的缓存策略。

7. 分类ID vs. 分类名称：

   • 虽然本教程使用了分类名称进行匹配，但在实际开发中，使用分类ID进行匹配通常被认为是更健壮的做法。因为分类名称可能会因编辑而改变，但其ID通常是固定的。如果使用ID，则$target_categories数组应包含分类ID，并且wp_get_post_terms的fields参数应调整为'ids'。

总结

通过本教程，我们学习了如何利用woocommerce_email_footer钩子和array_intersect函数，实现基于产品分类的WooCommerce邮件通知页脚的动态定制。这种方法不仅解决了in_array函数的常见误用问题，还提供了一个结构清晰、易于维护且“升级安全”的解决方案。掌握这种技术，可以帮助您更灵活地个性化您的WooCommerce商店邮件通知，提升客户体验和品牌专业度。