本教程详细介绍了如何通过自定义代码片段，将特定产品分类从WooCommerce商店主页中排除。文章重点利用`woocommerce_product_query`动作钩子来修改产品查询，确保默认的商店页面循环能够正确过滤掉不希望展示的分类，并提供了详细的代码示例、使用方法及注意事项，帮助开发者精确控制产品展示。
理解WooCommerce产品分类排除的需求
在运营WooCommerce商店时，有时需要将某些特定的产品分类从主商店页面中隐藏，例如“缺货商品”、“内部测试商品”或“产品目录”等不适合直接向客户展示的分类。虽然WordPress提供了pre_get_posts钩子来修改主查询，但对于WooCommerce的默认商店页面循环，直接使用该钩子或针对短代码的过滤器可能无法达到预期效果。这是因为WooCommerce有其特定的查询处理机制。
核心解决方案：利用 woocommerce_product_query 钩子
为了可靠地从WooCommerce商店页面排除特定产品分类，最有效的方法是使用woocommerce_product_query动作钩子。这个钩子在WooCommerce构建产品查询时触发，允许我们直接修改查询参数，从而实现分类的排除。
以下是实现此功能的代码片段：
/**
* 从WooCommerce商店页面排除指定产品分类。
*
* 此函数通过修改产品查询的tax_query参数，
* 确保指定分类的产品不会在商店主页或搜索结果中显示。
*
* @param WP_Query $query 当前的WP_Query对象。
*/
function custom_exclude_product_category_from_shop( $query ) {
// 确保我们只修改主查询，并且不是在管理后台或搜索页面。
// 如果需要排除搜索结果中的分类，请移除 is_search() 条件。
if ( is_admin() || is_search() ) {
return;
}
// 获取当前的分类查询参数（如果存在）
$tax_query = (array) $query->get( 'tax_query' );
// 添加新的分类排除条件
$tax_query[] = array(
'taxonomy' => 'product_cat', // 指定分类法为产品分类
'field' => 'slug', // 使用分类的slug进行匹配
'terms' => array( 'product-catalogue' ), // 需要排除的分类slug数组
'operator' => 'NOT IN' // 操作符，表示不包含在指定term中
);
// 将修改后的分类查询参数设置回查询对象
$query->set( 'tax_query', $tax_query );
}
add_action( 'woocommerce_product_query', 'custom_exclude_product_category_from_shop' );代码解析：
- custom_exclude_product_category_from_shop( $query ) 函数： 这是我们的回调函数，它接收一个WP_Query对象作为参数，该对象代表了当前的产品查询。
- 条件判断： if ( is_admin() || is_search() ) { return; } 这一行是可选的，用于防止在WordPress后台或搜索结果页意外修改查询。如果你的需求是也在搜索结果中排除该分类，可以移除 is_search() 条件。
- 获取现有 tax_query： $tax_query = (array) $query->get( 'tax_query' ); 这行代码获取了当前查询中已有的分类查询参数。将其转换为数组形式是为了方便添加新的条件。
-
添加排除条件：
- 'taxonomy' => 'product_cat'：指定我们要操作的是产品分类（product_cat是WooCommerce产品分类的内部名称）。
- 'field' => 'slug'：指定我们通过分类的slug（别名）来识别分类。你也可以使用'id'并提供分类ID数组。
- 'terms' => array( 'product-catalogue' )：这是最关键的部分。你需要将'product-catalogue'替换为你希望排除的分类的实际slug。如果你需要排除多个分类，可以在数组中添加更多slug，例如 array( 'slug-1', 'slug-2' )。
- 'operator' => 'NOT IN'：这个操作符告诉WordPress，我们希望查询结果中不包含terms数组中指定的分类。
- 设置 tax_query： $query->set( 'tax_query', $tax_query ); 将修改后的tax_query重新设置回WP_Query对象，从而影响最终的产品查询结果。
- add_action( 'woocommerce_product_query', 'custom_exclude_product_category_from_shop' );： 这行代码将我们的函数挂载到woocommerce_product_query动作钩子上，确保在WooCommerce构建产品查询时执行我们的代码。
如何实施
-
找到分类 Slug：
- 登录到WordPress后台。
- 导航到 产品 > 分类。
- 找到你想要排除的分类，其“别名”（Slug）列就是你需要的值。例如，如果分类名称是“Z_PRODUCT CATALOGUE”，其Slug可能是product-catalogue。请务必核对准确。
-
将代码添加到你的网站：
- 推荐方法： 将上述代码添加到你的子主题（Child Theme）的functions.php文件中。这样做可以确保在主题更新时你的修改不会丢失。
- 替代方法： 如果你没有子主题，可以创建一个自定义插件来管理这些代码片段。这比直接修改父主题的functions.php更安全。
注意事项与故障排除
- 分类 Slug 的准确性： 确保你在代码中使用的分类slug与你WooCommerce后台的实际分类slug完全匹配。一个小的拼写错误都可能导致代码无效。
- 缓存问题： 在添加或修改代码后，如果你的网站使用了缓存插件（如WP Super Cache, W3 Total Cache, LiteSpeed Cache等），请务必清除所有网站缓存。浏览器缓存也可能需要清除。
- 钩子的选择： 像pre_get_posts这样的通用WordPress钩子，在某些情况下可能被WooCommerce的内部逻辑覆盖或以不同的方式处理。woocommerce_product_query是专门为WooCommerce产品查询设计的，因此在修改产品列表方面更为可靠。
- 多分类排除： 如果需要排除多个分类，只需在'terms'数组中添加它们的slug即可：'terms' => array( 'slug-a', 'slug-b', 'slug-c' )。
- 代码位置： 永远不要直接修改WooCommerce插件的核心文件，因为插件更新会覆盖你的修改。使用子主题的functions.php或自定义插件是最佳实践。
总结
通过利用woocommerce_product_query动作钩子，我们可以精确地控制哪些产品分类会显示在WooCommerce商店主页上。这个方法比尝试修改短代码或通用查询钩子更具针对性和可靠性，确保了即使在WooCommerce默认循环下也能实现所需的分类排除。遵循本教程的步骤和注意事项，你可以轻松地管理商店页面的产品展示。
