本教程详细介绍了如何通过修改woocommerce主查询来从商店主页排除特定的产品分类。文章将提供一个基于`woocommerce_product_query`钩子的php代码片段，并解释其工作原理，指导您正确识别分类别名（slug），并强调了在`functions.php`或自定义插件中实施此解决方案的最佳实践，确保您的商店页面按预期展示产品。
引言：为何需要排除特定分类
在管理WooCommerce商店时，有时您可能希望某些产品分类不显示在商店主页上。例如，您可能有一个内部使用的“产品目录”分类，或者“缺货”分类，不希望顾客在浏览商店时看到这些分类下的产品。虽然WooCommerce本身提供了多种展示产品的方式（如短代码），但对于默认的商店主页循环，直接排除特定分类需要对WordPress和WooCommerce的查询机制有一定了解。
理解WooCommerce产品查询机制
WooCommerce的商店页面通常依赖于WordPress的WP_Query对象来获取和显示产品。要修改这个默认的产品列表，我们需要在查询执行之前对其进行干预。WordPress提供了pre_get_posts钩子来修改主查询，但对于WooCommerce产品，更推荐使用其专有的钩子，例如woocommerce_product_query。这个钩子在WooCommerce准备其产品查询时触发，允许我们精确地修改查询参数，而不会影响到网站的其他部分或与WordPress的其他查询产生冲突。
尝试使用woocommerce_shortcode_products_query过滤器只对通过短代码生成的查询有效，而直接在pre_get_posts中判断is_shop()有时可能无法完全覆盖WooCommerce的默认商店页面逻辑。因此，woocommerce_product_query通常是处理商店主页产品列表的最佳选择。
核心解决方案：使用 woocommerce_product_query 钩子
要从WooCommerce商店主页排除特定产品分类，我们将利用woocommerce_product_query动作钩子来修改查询的tax_query参数。
Contact Form 7 是 Rock Lobster Inc. 公司长期运行的 WordPress 表单插件，拥有超过 1000 万次活跃安装，并在 contactform7.com 提供官方文档。此技能适用于需要了解网站表单、邮件模板、验证行为和 shortcode 位置在 Contact Form 7 中实际处理方式的代理。
以下是实现此功能的代码片段：
/**
* 从商店页面排除指定产品分类
*
* 此函数通过修改 'tax_query' 参数，确保指定分类下的产品不会在商店主页上显示。
*
* @param WP_Query $q 当前的WP_Query对象。
*/
function custom_exclude_product_category_from_shop( $q ) {
// 确保我们正在修改的是主查询，且不是在管理后台
if ( is_admin() || ! $q->is_main_query() ) {
return;
}
// 获取当前的分类查询数组
$tax_query = (array) $q->get( 'tax_query' );
// 添加新的分类排除规则
$tax_query[] = array(
'taxonomy' => 'product_cat', // 针对产品分类
'field' => 'slug', // 通过分类别名（slug）来识别
'terms' => array( 'product-catalogue' ), // 要排除的分类别名，请替换为您的实际别名
'operator' => 'NOT IN' // 操作符：不包含在指定别名中
);
// 将修改后的分类查询数组设置回查询对象
$q->set( 'tax_query', $tax_query );
}
add_action( 'woocommerce_product_query', 'custom_exclude_product_category_from_shop' );
代码解析
-
function custom_exclude_product_category_from_shop( $q ):
- 这是我们自定义的函数，它接收一个WP_Query对象$q作为参数。这个对象包含了当前查询的所有信息，我们可以对其进行修改。
-
if ( is_admin() || ! $q->is_main_query() ) { return; }:
- 这是一个重要的安全检查。is_admin()确保此逻辑不会在WordPress后台运行，避免影响管理界面的产品列表。! $q->is_main_query()则确保我们只修改页面的主查询，而不是其他辅助查询，从而避免不必要的副作用。
-
$tax_query = (array) $q->get( 'tax_query' );:
- 这行代码获取了当前查询中已存在的分类查询数组。将其转换为数组类型可以确保即使之前没有分类查询，也能安全地添加新的查询。
-
$tax_query[] = array(...):
- 这里是核心逻辑。我们向$tax_query数组中添加了一个新的条件：
- 'taxonomy' => 'product_cat'：指定我们要操作的分类法是WooCommerce的产品分类。
- 'field' => 'slug'：表示我们将使用分类的“别名”（slug）来匹配。
- 'terms' => array( 'product-catalogue' )：这是一个包含要排除的分类别名（slug）的数组。请务必将'product-catalogue'替换为您实际要排除的分类的别名。
- 'operator' => 'NOT IN'：这个操作符是关键，它指示WordPress查询“不包含”在terms数组中指定的分类。
- 这里是核心逻辑。我们向$tax_query数组中添加了一个新的条件：
-
$q->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”，其别名可能是“product-catalogue”。请确保您获取的是正确的别名。
-
将代码添加到您的网站：
- 推荐方法（使用子主题）：将上述PHP代码片段添加到您的子主题的functions.php文件中。这是最佳实践，可以确保在主题更新时您的更改不会丢失。
- 备选方法（使用自定义插件）：如果您不使用子主题或希望将功能模块化，可以创建一个简单的自定义插件来包含此代码。
- 不推荐方法（直接修改主题的functions.php）：如果您直接修改父主题的functions.php文件，那么在主题更新时，您的更改将会被覆盖。
-
替换分类别名：
- 在代码中找到'terms' => array( 'product-catalogue' )这一行。
- 将'product-catalogue'替换为您在步骤1中获取到的实际分类别名。如果您需要排除多个分类，可以在数组中添加更多别名，例如'terms' => array( 'category-slug-1', 'category-slug-2' )。
-
保存并测试：
- 保存文件更改。
- 访问您的WooCommerce商店主页，验证您指定的产品分类及其下的产品是否已被成功排除。
重要注意事项
- 分类别名（Slug）的准确性：请务必使用分类的“别名”（slug），而不是其ID或名称。别名是WordPress用于URL和查询的唯一标识符。一个错误的别名将导致代码无效。
- 钩子选择的重要性：WordPress和WooCommerce提供了大量的动作和过滤器钩子。选择正确的钩子对于确保代码按预期工作至关重要。woocommerce_product_query是修改WooCommerce产品主查询的可靠选择。
- 使用子主题或自定义插件：为了网站的可维护性和避免在主题更新时丢失自定义代码，强烈建议将所有自定义PHP代码放在子主题的functions.php文件或一个自定义插件中。
总结
通过利用woocommerce_product_query钩子并修改WP_Query对象的tax_query参数，您可以有效地从WooCommerce商店主页排除特定的产品分类。这个方法既灵活又强大，能够帮助您更好地控制商店页面的内容展示。遵循本教程的步骤和注意事项，您可以轻松地实现这一功能，提升用户体验并优化商店内容管理。
