如何在WooCommerce商店页面排除特定产品分类

本教程详细介绍了如何通过自定义代码片段，将特定产品分类从WooCommerce商店主页中排除。文章重点利用`woocommerce_product_query`动作钩子来修改产品查询，确保默认的商店页面循环能够正确过滤掉不希望展示的分类，并提供了详细的代码示例、使用方法及注意事项，帮助开发者精确控制产品展示。

理解WooCommerce产品分类排除的需求

在运营WooCommerce商店时，有时需要将某些特定的产品分类从主商店页面中隐藏，例如“缺货商品”、“内部测试商品”或“产品目录”等不适合直接向客户展示的分类。虽然WordPress提供了pre_get_posts钩子来修改主查询，但对于WooCommerce的默认商店页面循环，直接使用该钩子或针对短代码的过滤器可能无法达到预期效果。这是因为WooCommerce有其特定的查询处理机制。

核心解决方案：利用 woocommerce_product_query 钩子

为了可靠地从WooCommerce商店页面排除特定产品分类，最有效的方法是使用woocommerce_product_query动作钩子。这个钩子在WooCommerce构建产品查询时触发，允许我们直接修改查询参数，从而实现分类的排除。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

56

查看详情

以下是实现此功能的代码片段：

/**
 * 从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' );

代码解析：

1. custom_exclude_product_category_from_shop( $query ) 函数： 这是我们的回调函数，它接收一个WP_Query对象作为参数，该对象代表了当前的产品查询。
2. 条件判断： if ( is_admin() || is_search() ) { return; } 这一行是可选的，用于防止在WordPress后台或搜索结果页意外修改查询。如果你的需求是也在搜索结果中排除该分类，可以移除 is_search() 条件。
3. 获取现有 tax_query： $tax_query = (array) $query-youjiankuohaophpcnget( 'tax_query' ); 这行代码获取了当前查询中已有的分类查询参数。将其转换为数组形式是为了方便添加新的条件。
4. 添加排除条件：
   • '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数组中指定的分类。
5. 设置 tax_query： $query->set( 'tax_query', $tax_query ); 将修改后的tax_query重新设置回WP_Query对象，从而影响最终的产品查询结果。
6. add_action( 'woocommerce_product_query', 'custom_exclude_product_category_from_shop' );： 这行代码将我们的函数挂载到woocommerce_product_query动作钩子上，确保在WooCommerce构建产品查询时执行我们的代码。

如何实施

1. 找到分类 Slug：
   • 登录到WordPress后台。
   • 导航到 产品 > 分类。
   • 找到你想要排除的分类，其“别名”（Slug）列就是你需要的值。例如，如果分类名称是“Z_PRODUCT CATALOGUE”，其Slug可能是product-catalogue。请务必核对准确。
2. 将代码添加到你的网站：
   • 推荐方法： 将上述代码添加到你的子主题（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默认循环下也能实现所需的分类排除。遵循本教程的步骤和注意事项，你可以轻松地管理商店页面的产品展示。

以上就是如何在WooCommerce商店页面排除特定产品分类的详细内容，更多请关注php中文网其它相关文章！