本教程详细指导如何在woocommerce商店主页中，通过使用`woocommerce_product_query`动作钩子，精确排除特定商品分类。文章将解释为何常见方法可能无效，并提供一个经过验证的php代码片段，帮助开发者和商店管理员有效地管理商品展示，确保用户在默认循环下浏览时，不会看到不希望出现的商品分类。
理解WooCommerce商店页面分类排除的挑战
在WooCommerce商店中，有时我们需要从主商店页面（通常是显示所有商品的页面）中排除特定的商品分类。这可能是为了隐藏内部产品目录、废弃产品或仅用于特定目的的分类。许多开发者可能会尝试使用pre_get_posts过滤器或woocommerce_shortcode_products_query过滤器来修改WordPress的主查询。然而，对于WooCommerce商店主页默认的产品循环，这些钩子可能无法达到预期效果。
pre_get_posts是一个通用的WordPress查询过滤器，它在任何查询执行之前触发。虽然它非常强大，但WooCommerce在内部处理产品查询时，可能会覆盖或以其他方式绕过pre_get_posts的一些设置，尤其是在is_shop()条件下。而woocommerce_shortcode_products_query则仅适用于通过短代码（如[products]）显示产品的情况，对于默认的商店页面循环并不适用。
为了在WooCommerce商店主页上准确地修改产品查询，我们需要使用一个更专门的WooCommerce钩子。
解决方案：使用woocommerce_product_query动作钩子
woocommerce_product_query是一个在WooCommerce构建其产品查询时触发的动作钩子。通过利用此钩子，我们可以直接访问并修改WooCommerce用于显示产品的查询对象，从而精确地排除特定分类。
实现步骤
-
确定要排除的分类信息 在实施代码之前，您需要知道要排除的商品分类的Slug。Slug是分类的URL友好名称，通常是小写字母和连字符组成。您可以在WordPress后台的“产品” -> “分类”页面找到并编辑每个分类的Slug。
例如，如果您要排除的分类名称是“Z_PRODUCT CATALOGUE”，其Slug可能是product-catalogue。
-
添加代码到您的网站 将以下PHP代码添加到您主题的functions.php文件或通过自定义插件添加。强烈建议使用子主题的functions.php文件，以避免在主题更新时丢失更改。
/** * 从WooCommerce商店页面排除指定商品分类 * * 此函数通过修改WooCommerce的产品查询，将特定分类从商店主页中排除。 * 使用 'woocommerce_product_query' 动作钩子确保在WooCommerce构建查询时生效。 * * @param WP_Query $q 当前的WP_Query对象。 */ function mystore_exclude_category_from_shop( $q ) { // 确保我们只在非管理后台、非搜索页面，且是主查询时执行 // 并且确保在商店页面或产品归档页面生效 if ( is_admin() || is_search() ) { return; } // 获取当前的tax_query（分类查询）数组 $tax_query = (array) $q->get( 'tax_query' ); // 添加新的分类排除条件 $tax_query[] = array( 'taxonomy' => 'product_cat', // 指定分类法为产品分类 'field' => 'slug', // 指定通过分类的slug进行匹配 'terms' => array( 'product-catalogue' ), // 替换为您要排除的分类slug 'operator' => 'NOT IN' // 操作符：不包含在指定terms中 ); // 将修改后的tax_query设置回查询对象 $q->set( 'tax_query', $tax_query ); } add_action( 'woocommerce_product_query', 'mystore_exclude_category_from_shop' );
代码解析
- function mystore_exclude_category_from_shop( $q ): 定义了一个名为mystore_exclude_category_from_shop的函数，它接收当前的WP_Query对象作为参数$q。
- if ( is_admin() || is_search() ) { return; }: 这是一个安全检查，确保此逻辑只在前端执行，并且不影响搜索结果。
- $tax_query = (array) $q->get( 'tax_query' );: 获取当前查询中已存在的分类查询条件。将其转换为数组，以防其为空或不是数组。
-
$tax_query[] = array(...): 向分类查询数组中添加一个新的条件。
- 'taxonomy' => 'product_cat': 指定我们要操作的分类法是WooCommerce的产品分类。
- 'field' => 'slug': 指定我们使用分类的Slug来匹配。
- 'terms' => array( 'product-catalogue' ): 这是一个数组，包含您希望排除的所有分类的Slug。请务必将'product-catalogue'替换为您实际要排除的分类Slug。如果您需要排除多个分类，可以在此数组中添加更多Slug，例如array('slug-1', 'slug-2')。
- 'operator' => 'NOT IN': 这个操作符指示WordPress查询，结果不应包含terms数组中指定的分类。
- $q->set( 'tax_query', $tax_query );: 将更新后的分类查询条件设置回WP_Query对象，从而修改了WooCommerce的产品查询。
- add_action( 'woocommerce_product_query', 'mystore_exclude_category_from_shop' );: 将我们的函数挂载到woocommerce_product_query动作钩子上，确保它在WooCommerce构建产品查询时被调用。
注意事项与最佳实践
- 验证分类Slug: 在部署代码之前，务必仔细检查您要排除的分类的Slug是否准确无误。错误的Slug将导致代码无效。
- 代码放置位置: 强烈建议将此类自定义代码放置在子主题的functions.php文件中，或者使用一个自定义插件。直接修改父主题的functions.php文件会导致在主题更新时丢失所有更改。
- 缓存问题: 在添加或修改代码后，如果您的网站使用了缓存插件或服务器端缓存，请务必清除所有缓存，以确保更改能够立即生效。
- 冲突排查: 如果在应用此代码后遇到问题，请暂时禁用其他插件，特别是那些可能也修改产品查询的插件，以排查是否存在冲突。
- 测试: 在生产环境部署之前，务必在开发或测试环境中充分测试此功能，确保它按预期工作，并且没有引入其他意外问题。
总结
通过利用woocommerce_product_query动作钩子，我们可以有效地控制WooCommerce商店页面上显示的产品分类。这种方法比使用通用钩子（如pre_get_posts）更具针对性，能够确保在WooCommerce默认产品循环中准确地排除指定分类。遵循本教程的步骤和注意事项，您将能够轻松地实现这一功能，从而更好地管理您的WooCommerce商店内容。
