WooCommerce产品页面高级交叉销售：排除整个分类树显示推荐产品

本教程详细指导如何在WooCommerce产品页面上实现高级交叉销售功能，通过精确排除当前产品所属的整个分类层级（包括父分类、当前分类及其兄弟分类），从而展示来自完全不相关分类的产品。文章将提供详细的PHP代码示例，解释如何获取和过滤分类ID，构建`WP_Query`查询，并给出性能优化与实现注意事项，帮助开发者有效提升店铺的交叉销售策略。

在WooCommerce商店中，产品页面通常会显示相关产品或向上销售产品。然而，有时我们需要一种更高级的交叉销售策略，即在当前产品页面上展示来自完全不相关分类的产品。这意味着，如果一个产品属于某个分类层级（例如父分类 -> 子分类A），我们希望排除所有属于这个父分类及其所有子分类（包括子分类A和其兄弟分类B等）的产品，转而推荐其他分类的产品。这种方法可以帮助客户发现他们可能从未考虑过的、但同样有吸引力的商品，从而增加销售机会。

核心概念：WooCommerce分类排除逻辑

要实现这种高级的分类排除，我们需要理解以下几个关键点：

获取当前产品分类：首先，我们需要识别当前正在查看的产品属于哪些分类。
构建排除分类树：基于当前产品的分类，我们需要向上追溯到其父分类，并向下获取该父分类下的所有子分类。这些分类的ID都将成为我们的排除目标。
使用WP_Query进行查询：利用WordPress强大的WP_Query类，结合tax_query参数，我们可以指定查询条件，特别是使用NOT IN操作符来排除特定分类下的产品。

实现步骤详解

以下是实现这一功能的具体步骤和相应的代码示例。

步骤一：获取当前产品及其相关分类的ID

首先，我们需要获取当前产品的ID，并根据其所属的直接分类，构建一个包含所有需要排除的分类ID的列表。这个列表将包括当前产品的所有直接分类、它们的父分类以及这些父分类下的所有子分类（即当前产品所在分类树的所有成员）。

global $post;
$current_product_id = $post->ID; // 获取当前产品ID
$exclude_category_ids = array(); // 初始化排除分类ID数组

// 1. 获取当前产品的所有直接分类
$product_terms = get_the_terms( $current_product_id, 'product_cat' );

if ( ! empty( $product_terms ) && ! is_wp_error( $product_terms ) ) {
    foreach ( $product_terms as $term ) {
        // 将当前直接分类ID加入排除列表
        $exclude_category_ids[] = $term->term_id;

        // 获取当前分类的父分类ID
        $parent_id = $term->parent;

        if ( $parent_id > 0 ) {
            // 如果有父分类，将父分类ID加入排除列表
            $exclude_category_ids[] = $parent_id;

            // 获取父分类的所有子分类（包括当前分类及其兄弟分类）
            $siblings_and_children = get_terms( array(
                'taxonomy'   => 'product_cat',
                'parent'     => $parent_id,
                'fields'     => 'ids',
                'hide_empty' => false, // 即使分类下没有产品也获取其ID
            ) );
            if ( ! is_wp_error( $siblings_and_children ) ) {
                $exclude_category_ids = array_merge( $exclude_category_ids, $siblings_and_children );
            }
        } else {
            // 如果当前分类是顶级分类，获取其所有子分类
            $children = get_terms( array(
                'taxonomy'   => 'product_cat',
                'parent'     => $term->term_id,
                'fields'     => 'ids',
                'hide_empty' => false,
            ) );
            if ( ! is_wp_error( $children ) ) {
                $exclude_category_ids = array_merge( $exclude_category_ids, $children );
            }
        }
    }
}

// 去重，确保每个分类ID只出现一次，避免重复查询和潜在错误
$exclude_category_ids = array_unique( $exclude_category_ids );

代码解释：

get_the_terms($current_product_id, 'product_cat')：用于获取当前产品所属的所有WooCommerce产品分类。
$term->parent：获取当前分类的父分类ID。
get_terms()：一个强大的WordPress函数，用于获取分类法中的术语（term）。通过设置parent参数，我们可以获取指定父分类下的所有子分类。fields => 'ids'确保我们只获取ID数组，提高效率。hide_empty => false是为了确保即使某个分类下暂时没有产品，其ID也能被正确获取并排除。
array_merge()：用于合并多个数组，将不同来源的分类ID整合到$exclude_category_ids中。
array_unique()：非常重要，用于移除数组中的重复ID，确保最终的排除列表是唯一的。

步骤二：构建WP_Query查询并显示产品

有了需要排除的分类ID列表后，我们就可以构建WP_Query来获取符合条件的产品。

// 确保 $exclude_category_ids 数组不为空，否则可能导致查询所有产品
if ( empty( $exclude_category_ids ) ) {
    // 如果没有需要排除的分类，则可以根据需求选择是否显示产品
    // 在本例中，我们假设至少有一个分类需要排除
    $exclude_category_ids = array(0); // 排除一个不存在的ID，确保tax_query能正常工作但不排除实际分类
}

$args = array(
    'post_type'      => 'product',           // 查询产品类型
    'posts_per_page' => 5,                   // 每次显示5个产品
    'post__not_in'   => array( $current_product_id ), // 排除当前产品本身
    'orderby'        => 'rand',              // 随机排序，增加交叉销售的惊喜感
    'tax_query'      => array(
        array(
            'taxonomy' => 'product_cat',     // 针对产品分类
            'field'    => 'term_id',         // 使用分类ID进行匹配
            'terms'    => $exclude_category_ids, // 需要排除的分类ID列表
            'operator' => 'NOT IN'           // 操作符：不包含在这些ID中
        ),
    ),
    'meta_query' => array(
        array(
            'key'     => '_stock_status',
            'value'   => 'instock', // 只显示有库存的产品
            'compare' => '=',
        ),
    ),
);

$cross_sell_products_query = new WP_Query( $args );

if ( $cross_sell_products_query->have_posts() ) :
    echo '';
    echo '您可能还喜欢这些产品'; // 标题
    echo ''; // 使用WooCommerce的默认产品列表样式
    while ( $cross_sell_products_query->have_posts() ) : $cross_sell_products_query->the_post();
        // 使用WooCommerce的模板部分来显示每个产品，保持样式一致性
        wc_get_template_part( 'content', 'product' );
    endwhile;
    echo '';
    echo '';
endif;

wp_reset_postdata(); // 恢复全局$post数据，避免影响页面其他部分

代码解释：

post_type => 'product'：指定我们要查询的是WooCommerce产品。
posts_per_page => 5：限制每次查询显示的产品数量为5个。您可以根据需要调整此值。
post__not_in => array($current_product_id)：这是一个重要的参数，用于确保查询结果中不包含当前正在查看的产品本身。
orderby => 'rand'：将查询结果随机排序，这对于交叉销售非常有效，每次刷新页面都能看到不同的推荐产品。
tax_query：这是进行分类法查询的关键。
- taxonomy => 'product_cat'：指定我们要查询的产品分类法。
- field => 'term_id'：表示我们将使用分类的ID进行匹配。
- terms => $exclude_category_ids：传入我们之前构建的排除分类ID数组。
- operator => 'NOT IN'：这是核心，它告诉WordPress只返回那些不属于$exclude_category_ids中任何一个分类的产品。
meta_query：可选地，您可以添加此参数来进一步过滤产品，例如只显示有库存的产品 (_stock_status => 'instock')。
wc_get_template_part( 'content', 'product' )：这是一个WooCommerce的辅助函数，用于加载单个产品的模板部分，确保推荐产品的显示样式与您的主题保持一致。
wp_reset_postdata()：在完成自定义循环后，必须调用此函数来恢复全局$post数据，以避免对页面其他部分的WordPress循环造成干扰。

完整代码示例

将上述两个步骤的代码合并，通常可以放置在主题的 functions.php 文件中，然后通过WooCommerce提供的钩子在产品页面上调用，或者直接在 single-product.php 模板文件中合适的位置添加。

// 将此函数添加到主题的 functions.php 或自定义插件中
function display_advanced_cross_sell_products() {
    if ( ! is_product() ) {
        return; // 确保只在产品页面执行
    }

    global $post;
    $current_product_id = $post->ID;
    $exclude_category_ids = array();

    // 1. 获取当前产品的所有直接分类及其相关分类树
    $product_terms = get_the_terms( $current_product_id, 'product_cat' );

    if ( ! empty( $product_terms ) && ! is_wp_error( $product_terms ) ) {
        foreach ( $product_terms as $term ) {
            $exclude_category_ids[] = $term->term_id; // 当前直接分类

            $parent_id = $term->parent;
            if ( $parent_id > 0 ) {
                $exclude_category_ids[] = $parent_id; // 父分类
                $siblings_and_children = get_terms( array(
                    'taxonomy'   => 'product_cat',
                    'parent'     => $parent_id,
                    'fields'     => 'ids',
                    'hide_empty' => false,
                ) );
                if ( ! is_wp_error( $siblings_and_children ) ) {
                    $exclude_category_ids = array_merge( $exclude_category_ids, $siblings_and_children );
                }
            } else {
                // 如果是顶级分类，获取其所有子分类
                $children = get_terms( array(
                    'taxonomy'   => 'product_cat',
                    'parent'     => $term->term_id,
                    'fields'     => 'ids',
                    'hide_empty' => false,
                ) );
                if ( ! is_wp_error( $children ) ) {
                    $exclude_category_ids = array_merge( $exclude_category_ids, $children );
                }
            }
        }
    }

    $exclude_category_ids = array_unique( $exclude_category_ids );

    // 确保 $exclude_category_ids 数组不为空，否则可能导致查询所有产品
    if ( empty( $exclude_category_ids ) ) {
        // 如果没有需要排除的分类，则不执行查询，或者排除一个不存在的ID
        $exclude_category_ids = array(0);
    }

    // 2. 构建 WP_Query 查询并显示产品
    $args = array(
        'post_type'      => 'product',
        'posts_per_page' => 5,
        'post__not_in'   => array( $current_product_id ),
        'orderby'        => 'rand',
        'tax_query'      => array(
            array(
                'taxonomy' => 'product_cat',
                'field'    => 'term_id',
                'terms'    => $exclude_category_ids,
                'operator' => 'NOT IN'
            ),
        ),
        'meta_query' => array(
            array(
                'key'     => '_stock_status',
                'value'   => 'instock',
                'compare' => '=',
            ),
        ),
    );

    $cross_sell_products_query = new WP_Query( $args );

    if ( $cross_sell_products_query->have_posts() ) :
        echo ''; // 添加woocommerce类以便继承样式
        echo '您可能还喜欢这些产品';
        echo '';
        while ( $cross_sell_products_query->have_posts() ) : $cross_sell_products_query->the_post();
            wc_get_template_part( 'content', 'product' );
        endwhile;
        echo '';
        echo '';
    endif;

    wp_reset_postdata();
}

// 将函数挂载到 WooCommerce 的产品页面钩子上
// 例如，在产品摘要之后显示
add_action( 'woocommerce_after_single_product_summary', 'display_advanced_cross_sell_products', 25 );
// 或者在相关产品之后（默认相关产品钩子优先级是20）
// add_action( 'woocommerce_after_single_product_summary', 'display_advanced_cross_sell_products', 30 );

注意事项与优化

代码放置位置：建议将上述代码放置在您主题的 functions.php 文件中，或创建一个自定义插件来管理。直接修改WooCommerce核心文件不是一个好习惯，因为更新时会被覆盖。
钩子选择：add_action( 'woocommerce_after_single_product_summary', 'display_advanced_cross_sell_products', 25 ); 是一个常用的钩子，它会在产品摘要之后显示内容。您可以根据设计需求选择不同的WooCommerce钩子，例如 woocommerce_before_single_product_summary、woocommerce_after_single_product 等，并调整优先级（第三个参数）来控制显示顺序。
性能考虑：get_terms() 和 WP_Query 都是数据库

# php # word # go # wordpress # Array # 循环 # operator # 数据库 # 性能优化

返回目录在线咨询

上一篇：编织梦想：一网打尽创意无限的可能性
下一篇：常见的浏览器Hack技巧整理

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商