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

---

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

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

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

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

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

ViiTor AI

一个强大的多语言AI语音合成和视频转译平台

9414 查看详情

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

/**
 * 从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->get( '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中文网其它相关文章！

# 产品展示  # 企业不做seo  # 渭南公司网站优化  # 蚌埠推广公司招商网站有哪些  # 石湾网站优化专家招聘  # 平舆全网推广营销费用  # 长沙企业网络推广做网站  # 营销推广培训心得  # 西秀区网站建设公司  # 新网站如何做网站推广呢  # 营销推广的工具app  # 如何在  # 怎么看  # php  # 组中  # 多个  # 这是  # 自定义  # 搜索结果  # 回调  # 产品分类  # 回调函数  # 浏览器  # wordpress  # go  # word 

相关栏目： 【 Google疑问12 】 【 Facebook疑问10 】 【 优化推广96088 】 【 技术知识133117 】 【 IDC资讯59369 】 【 网络运营7196 】 【 IT资讯61894 】

相关推荐： poki官网最新入口 poki小游戏大全入口  《小宇宙》标记不友善评论方法  CSS过渡如何实现按钮悬停效果_transition属性控制背景颜色变化  《深林》冬季章节图文攻略  《桃源记2》资源采集攻略  鲨鱼剧场app金币获取方法  Final Cut Pro视频加EQ教程  Sublime怎么格式化HTML代码_Sublime前端代码美化插件使用指南  《美篇》取消会员自动续费方法  CSS过渡与滚动滚动事件结合应用_scroll与transition动画  苹果手机聊天记录删除了如何恢复  12306夜间购票失败？ | 查看官方公布的暂停服务公告与应对方案  在XML中嵌入二进制数据（如图片）的最佳实践是什么？ Base64编码与解析注意事项  解决CSS布局中意外顶部空白问题的教程  PointNet++语义分割模型中类别变更引发的断言错误及标签处理策略  怎样设置开机后自动运行某个程序_Windows启动文件夹与任务计划【自动化】  Win11便笺在哪打开 Win11桌面便笺（Sticky Notes）使用方法【详解】  荣耀Magic6 Pro拍照成像偏暗_荣耀Magic6 Pro夜景优化  Selenium自动化：利用键盘模拟解决复杂日期输入框输入问题  优化2xN网格最大路径和的动态规划算法实践  抖音官网入口快速访问 抖音网页版账号注册解析  德邦物流在线查询系统 德邦快递货物运输追踪  diskgenius分区工具如何设置Bios启动项  PHP中实现JSON数据数组分页的教程  steam缓存文件在哪儿_steam缓存文件的路径查找方法与结构说明  食品生产用水只要符合国家规定的生活饮用水卫生标准就可以吗  Linux如何优化系统启动流程_Linux启动项优化方案  byrutor直接访问入口 byrutor官方游戏库  Go语言反射机制下访问嵌入结构体中的被遮蔽方法  Golang如何使用log记录日志信息_Golang log日志记录方法总结  一点万象签到领积分指南  发布小红书怎么屏蔽粉丝？屏蔽粉丝能看到吗？  Excel怎么用XLOOKUP函数实现双向查找_ExcelXLOOKUP替代VLOOKUP+HLOOKUP的高级用法  《理想汽车》权限管理设置方法  《兴业银行》注册登录方法  申通快递物流信息查询 申通快递包裹状态追踪  《崩坏：星穹铁道》3.6版本异相仲裁打法及配队推荐  《oppo商城》维修服务位置  如何高效地基于键列值映射DataFrame中的多个列  优化长HTML属性值：SonarQube警告与实用策略  excel怎么制作考勤表 excel考勤模板与函数公式讲解  PSD转AI文件的简单方法  《搜书吧》阅读书籍方法  《雅迪智行》用手机开锁方法  C++ bind函数使用教程_C++参数绑定与函数适配器的应用  支付宝如何解绑云闪付_支付宝与云闪付账户关联解除方法  哔哩哔哩黑名单怎么查看  如何在CSS中使用absolute实现登录弹窗居中_transform translate结合  电脑双系统如何安装和卸载 Windows和Linux双系统安装教程【详解】  《海贝音乐》均衡器设置方法 

 2025-11-03