在WooCommerce中，有时我们需要根据特定页面的需求，筛选展示不同类型的产品。例如，您可能希望在商店主页（Shop Page）仅显示“组合产品”（Grouped Products），而在其他页面，如供应商页面、产品分类页或产品标签页，则显示所有类型的产品。如果采用不当的筛选方法，例如使用全局的查询过滤器，可能会导致整个网站的产品显示逻辑被修改，从而影响到原本不应受影响的页面，如第三方插件（如Product Vendors）生成的供应商页面。
问题根源：全局过滤器的不当使用
最初，为了在WooCommerce商店页面仅显示组合产品，开发者可能会使用woocommerce_product_query_tax_query过滤器，并添加一个针对product_type分类法的查询条件。
/**
* 示例：不当的全局过滤器，可能导致全站影响
*/
add_filter( 'woocommerce_product_query_tax_query', 'only_grouped_products_global', 20, 1 );
function only_grouped_products_global( $tax_query ){
$tax_query[] = array(
'taxonomy' => 'product_type',
'field' => 'name',
'terms' => array('grouped'),
);
return $tax_query;
}这段代码的问题在于，woocommerce_product_query_tax_query是一个在所有产品查询中都会触发的全局过滤器。这意味着，无论用户访问的是商店主页、产品分类页、产品标签页，甚至是供应商页面（由其他插件生成，其内部也可能调用WooCommerce的产品查询），此过滤器都会生效，强制所有产品查询只返回组合产品。这导致供应商页面无法显示其下的单品产品，与预期不符。
解决方案：基于页面条件的精确控制
要解决这个问题，我们需要引入条件逻辑，确保产品类型筛选仅在特定页面生效。这可以通过使用woocommerce_product_query动作钩子，并结合WordPress的条件标签（如is_shop()、is_page()、is_product_category()等）来实现。
woocommerce_product_query动作在产品查询对象（WP_Query）被执行之前触发，允许我们直接修改查询参数。通过在此钩子内判断当前页面类型，我们可以有选择性地添加或修改分类法查询（tax_query）。
以下是实现此功能的优化代码：
/**
* 根据页面条件显示特定产品类型
* 将此代码添加到主题的 functions.php 文件或自定义插件中
*/
add_action( 'woocommerce_product_query', 'prefix_custom_pre_get_posts_query' );
function prefix_custom_pre_get_posts_query( $q ) {
// 确保只在主查询中修改，避免影响其他辅助查询
if ( ! $q->is_main_query() ) {
return;
}
// 条件1：在商店主页或特定页面（如产品组合页面）显示组合产品
if ( is_shop() || is_page('products-portfolio') ) {
$tax_query = (array) $q->get( 'tax_query' ); // 获取现有分类法查询
$tax_query[] = array(
'taxonomy' => 'product_type',
'field' => 'name',
'terms' => array( 'grouped' ), // 仅显示“组合产品”类型
);
$q->set( 'tax_query', $tax_query ); // 设置修改后的查询
}
// 条件2：在产品分类页显示组合产品（如果需要）
elseif ( is_product_category() ) {
$tax_query = (array) $q->get( 'tax_query' );
$tax_query[] = array(
'taxonomy' => 'product_type',
'field' => 'name',
'terms' => array( 'grouped' ),
);
$q->set( 'tax_query', $tax_query );
}
// 条件3：在产品标签页显示组合产品（如果需要）
elseif ( is_product_tag() ) {
$tax_query = (array) $q->get( 'tax_query' );
$tax_query[] = array(
'taxonomy' => 'product_type',
'field' => 'name',
'terms' => array( 'grouped' ),
);
$q->set( 'tax_query', $tax_query );
}
// else 块是隐式的：如果以上条件都不满足，则不修改查询，
// 意味着在其他页面（如供应商页面）将显示所有产品类型。
}代码解析与注意事项
- add_action( 'woocommerce_product_query', ... ): 这是将我们的自定义函数挂载到WooCommerce产品查询过程的关键动作钩子。
- function prefix_custom_pre_get_posts_query( $q ): 我们的自定义函数，它接收一个WP_Query对象 $q，我们可以通过这个对象来修改查询参数。
- if ( ! $q->is_main_query() ) { return; }: 这是一个非常重要的安全检查。is_main_query()确保我们只修改WordPress的主查询。WordPress在页面加载过程中会执行多个查询（例如菜单查询、小部件查询等），如果不加此判断，可能会错误地修改这些辅助查询，导致不可预期的行为。
-
条件判断 (if/elseif):
- is_shop(): 判断当前是否为WooCommerce的商店主页。
- is_page('products-portfolio'): 判断当前是否为特定ID或别名为products-portfolio的页面。您可以将其替换为任何您希望应用此规则的自定义页面别名或ID。
- is_product_category(): 判断当前是否为WooCommerce的产品分类归档页。
- is_product_tag(): 判断当前是否为WooCommerce的产品标签归档页。
- 您可以根据实际需求添加更多条件标签，例如 is_tax('custom_taxonomy_slug') 来针对自定义分类法归档页。
- $tax_query = (array) $q->get( 'tax_query' );: 获取当前查询中已存在的分类法查询数组。将其转换为数组类型以确保后续操作的兼容性。
-
添加分类法查询:
- 'taxonomy' => 'product_type': 指定我们要筛选的分类法是产品类型。
- 'field' => 'name': 指定我们通过分类法的名称（slug）进行匹配。
- 'terms' => array( 'grouped' ): 指定我们要匹配的产品类型为“grouped”（组合产品）。如果您想显示其他类型，如simple（简单产品）、variable（可变产品）等，可以修改此数组。
- $q->set( 'tax_query', $tax_query );: 将修改后的分类法查询数组重新设置回查询对象中，从而影响最终的产品查询结果。
- 隐式else块: 代码中没有显式的else {}块。这意味着，如果当前页面不满足任何if或elseif条件，我们的函数将不会对$q对象进行任何修改。因此，在这些未被条件语句覆盖的页面（例如供应商页面），WooCommerce将执行其默认的产品查询，显示所有产品类型，从而解决了供应商页面产品不显示的问题。
部署与测试
- 将上述代码片段添加到您的WordPress主题的functions.php文件末尾。强烈建议在子主题中进行此操作，以避免主题更新时代码丢失。
- 或者，您可以创建一个简单的自定义插件来管理此类功能，这是一种更推荐的实践方式，可以保持代码的模块化和独立性。
- 保存文件后，访问您的商店主页、产品分类页、产品标签页以及供应商页面，验证产品显示是否符合预期。
总结
通过利用woocommerce_product_query动作钩子和WordPress的条件标签，我们能够精确控制WooCommerce产品查询的行为。这种方法避免了全局过滤器可能带来的副作用，确保了不同页面能够根据其特定需求展示相应的产品类型，从而提供了更灵活和健壮的电商网站产品管理方案。在开发过程中，始终考虑代码对整个网站的影响范围，并优先选择有针对性的解决方案，是避免潜在冲突的关键。
