本教程旨在解决WooCommerce中特定页面（如商店页、分类页）仅显示组合商品时，可能导致供应商页面无法正常显示其独立商品的冲突。通过利用woocommerce_product_query动作钩子并结合WordPress条件标签，我们能够精确控制商品查询逻辑，确保在指定页面仅展示组合商品，同时不影响其他页面（如供应商页面）的正常商品显示，从而避免全局性查询修改带来的负面影响。
挑战：全局商品查询修改的副作用
在woocommerce中，有时我们希望在特定的商品展示页面（例如主商店页）只显示某种特定类型的产品，如组合商品（grouped products）。一种常见的实现方式是使用woocommerce_product_query_tax_query过滤器来修改商品查询的分类条件。然而，这种全局性的修改可能会带来意想不到的副作用。
例如，当我们在functions.php中添加以下代码，旨在让商店页只显示组合商品时：
/** * Show Only Grouped Products in Woocommerce */ add_filter( 'woocommerce_product_query_tax_query', 'only_grouped_products', 20, 1 ); function only_grouped_products( $tax_query ){ $tax_query[] = Array( 'taxonomy' => 'product_type', 'field' => 'name', 'terms' => array('grouped'), ); return $tax_query; }
这段代码确实能使WooCommerce商店页只显示组合商品。但是，它会影响整个网站的所有商品查询，包括由第三方插件（如WooCommerce Product Vendors）生成的供应商页面。这意味着，供应商页面上原本应该显示的独立商品（Simple Products）或其他类型商品将无法显示，因为全局过滤器强制它们也必须是“组合商品”类型，从而导致页面内容缺失。
为了解决这个问题，我们需要引入条件逻辑，确保商品查询的修改只在特定页面生效。
解决方案：利用 woocommerce_product_query 动作实现条件查询
WooCommerce提供了一个强大的动作钩子 woocommerce_product_query，它在商品查询执行之前触发，允许我们直接访问和修改WP_Query对象。结合WordPress的条件标签（Conditional Tags），我们可以精确地控制何时应用商品类型过滤。
以下是优化后的解决方案代码，应放置在主题的functions.php文件或自定义插件中：
/** * WooCommerce特定页面商品查询优化：仅显示组合商品 * 确保在指定页面（如商店页、特定页面、分类页、标签页）显示组合商品， * 同时不影响其他页面（如供应商页面）的商品显示。 */ add_action( 'woocommerce_product_query', 'prefix_custom_pre_get_posts_query' ); function prefix_custom_pre_get_posts_query( $q ) { // 检查当前页面是否为商店页或特定页面（例如“products-portfolio”） 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 ); // 设置修改后的分类查询条件 } // 检查当前页面是否为商品分类归档页 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 ); } // 检查当前页面是否为商品标签归档页 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准备执行商品查询时触发，并且会传递WP_Query对象 $q。这使得我们能够在查询执行前直接修改查询参数，包括分类查询（tax_query）、元数据查询（meta_query）等。
- 相较于 woocommerce_product_query_tax_query 过滤器，使用 woocommerce_product_query 动作更加灵活，因为它允许我们修改整个查询对象，而不仅仅是分类查询部分。
-
条件标签 (is_shop(), is_page(), is_product_category(), is_product_tag()):
- is_shop(): 判断当前页面是否为WooCommerce商店主页。
- is_page(‘products-portfolio’): 判断当前页面是否为ID或slug为products-portfolio的WordPress页面。您可以根据自己的需求替换为实际的页面ID或slug。
- is_product_category(): 判断当前页面是否为WooCommerce商品分类归档页。
- is_product_tag(): 判断当前页面是否为WooCommerce商品标签归档页。
- 通过这些条件标签，我们可以精确地限定代码逻辑的执行范围，确保商品类型过滤只在预期的页面上生效。
-
修改 tax_query:
- $tax_query = (array) $q->get( ‘tax_query’ );: 首先获取当前WP_Query对象中已有的分类查询条件。将其转换为数组以确保后续操作的兼容性。
- $tax_query[] = array(…): 向现有分类查询条件数组中添加一个新的条件，指定product_type分类法，并筛选grouped（组合商品）类型。
- $q->set( ‘tax_query’, $tax_query );: 将修改后的分类查询条件重新设置回WP_Query对象。
-
else 块:
- else { } 部分是关键。当当前页面不满足任何if或elseif条件时（例如，当访问供应商的商店页面时），代码将不会修改WP_Query对象，从而允许这些页面按照其默认的查询逻辑显示所有类型的商品，包括独立商品。
总结
通过上述方法，我们成功解决了WooCommerce特定页面仅显示组合商品与第三方插件（如Product Vendors）供应商页面商品显示冲突的问题。核心思想在于利用woocommerce_product_query动作钩子和WordPress条件标签，实现对商品查询的精细化控制。这种有条件的应用查询修改，不仅能满足特定页面的展示需求，还能避免对网站其他功能产生不必要的负面影响，提升了网站的整体兼容性和用户体验。在实际应用中，请务必在开发或测试环境中进行充分测试，以确保代码的正确性和稳定性。
