本文介绍一种简洁可靠的方法，通过钩子干预 woocommerce 循环逻辑，在不修改模板文件的前提下，安全、彻底地隐藏商店首页（shop page）上的所有商品列表及分类展示。
本文介绍一种简洁可靠的方法，通过钩子干预 woocommerce 循环逻辑，在不修改模板文件的前提下，安全、彻底地隐藏商店首页（shop page）上的所有商品列表及分类展示。
在 WooCommerce 中，shop 页面默认会显示商品循环（product loop）以及可能的分类网格（product categories），但有时你可能需要完全清空该页面内容——例如仅保留自定义 Banner、静态介绍文案或引导入口，而隐藏所有动态商品与分类。此时，简单地“移除循环钩子”或错误使用 pre_get_posts（如将 post__in 设为 [0]）往往无效，甚至引发异常（如空白页、PHP 警告或后台查询干扰）。
✅ 推荐方案：重置 WooCommerce 循环上下文
以下代码通过 woocommerce_shop_loop 钩子（在循环开始前触发），主动清除关键全局变量，从而阻止 WooCommerce 渲染任何商品或分类内容：
add_action('woocommerce_shop_loop', 'reset_woocommerce_shop_loop');
function reset_woocommerce_shop_loop() {
if (is_shop()) {
// 清除当前产品对象（避免单个商品误渲染）
unset($GLOBALS['product']);
// 清除循环状态（影响分类/商品展示逻辑、分页、计数等）
unset($GLOBALS['woocommerce_loop']);
}
}
? 为什么这个方法更可靠？
- woocommerce_shop_loop 是 WooCommerce 官方提供的、专用于 shop 页面循环生命周期的钩子，时机精准；
- 直接解除 $product 和 $woocommerce_loop 的全局引用，使后续模板（如 loop/loop-start.php、content-product.php、loop/loop-end.php）因缺少上下文而自动跳过渲染；
- 不干扰主查询（WP_Query），避免 pre_get_posts 方案中常见的 is_main_query() 判断失效、后台查询被误改等问题；
- 兼容性好，适用于 WooCommerce 6.0+ 及主流主题（如 Storefront、Astra、Hello Elementor）。
⚠️ 注意事项：
- 此方案仅隐藏前端展示，不影响数据库、后台商品管理或 REST API；
- 若你同时使用了插件（如 YITH WooCommerce Ajax Product Filter）依赖 woocommerce_loop 数据，请测试兼容性；
- 如需进一步定制（如仅隐藏商品但保留分类），应改用条件性移除钩子（如 remove_action('woocommerce_before_shop_loop', 'woocommerce_catalog_ordering') 等），而非全局清空；
- 建议将代码添加至子主题的 functions.php 文件中，或使用 Code Snippets 插件管理，避免主题更新丢失。
? 补充：若需完全留白 shop 页面，建议配合以下操作
- 在 WordPress 后台 → “WooCommerce → 设置 → 产品 → 显示” 中，将「商店页面显示」设为「无」（但注意：这会禁用整个 shop 页面路由，不推荐）；
- 更优做法：保留 shop 页面，但通过上述代码清空内容后，在页面编辑器中添加自定义区块（如 HTML、图文模块），实现完全可控的静态布局。
综上，unset($GLOBALS['product']) 与 unset($GLOBALS['woocommerce_loop']) 是轻量、安全、符合 WooCommerce 架构的设计级解决方案，远优于强行篡改主查询或暴力移除模板钩子。
