本教程详细指导如何在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 '';
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 都是数据库
