HUSKY - WooCommerce Product Filter Professional

WooCommerce 产品筛选器在手机上不显示:原因与解决方法

筛选器在电脑上正常,但在手机上侧边栏不见了,打开筛选器 (Open filter) 按钮始终不出现,或者出现了却点不开。WooCommerce 产品筛选器在手机上不显示,通常并不是插件坏了。HUSKY 的移动模式由三个环节组成:服务器判断访问者使用的是手机,脚本把按钮移动到合适的位置,点击按钮后表单以全屏面板的形式打开。每个环节都可能被主题、页面构建器、缓存或优化插件拦住。本指南会告诉您究竟是哪个环节出了问题,以及如何解决。

HUSKY 移动模式的工作原理

许多主题在手机上根本不显示侧边栏。如果筛选器是侧边栏小工具,又没有做其他设置,仅此一点就足以解释它为什么不见了。移动模式是插件为手机提供的一种方式:用一个按钮来打开筛选器。设置中没有全局的“移动”开关;移动模式是针对每个筛选表单单独启用的:

  • 小工具:在 HUSKY 小工具中将移动模式 (Mobile mode)设为“是”。
  • 短代码:[woof sid="mobile" mobile_mode=1]。sid 属性是必需的;没有它,mobile_mode 会被忽略。
  • 前端构建器:在 [woof_front_builder] 表单的选项中打开移动模式 (Mobile mode)。

当页面是为手机生成时,插件会将该表单隐藏输出,并为它添加两个按钮:打开筛选器 (Open filter) 和关闭筛选器 (Close filter)。在桌面设备上,同一个表单则照常显示。页面在手机上加载时,脚本会把打开筛选器 (Open filter) 按钮从隐藏的表单中移到一个可见的位置:

  1. [woof_mobile] 短代码输出的容器(如果页面中有的话);
  2. 否则就是与 .woocommerce-products-header 匹配的元素,即 WooCommerce 标准归档模板中显示商店或分类标题的区块。

点击按钮会给表单添加 woof_show_filter_for_mobile 类,使它变成覆盖在页面上方的固定全屏面板。在 AJAX 模式下,每次筛选之后面板都会自动关闭,这样访问者就能看到新的产品。

两个事实可以解释大部分问题。第一,“手机”是由服务器根据请求头,通过 WordPress 的 wp_is_mobile() 判断的,而不是根据屏幕宽度。第二,[woof_mobile] 只是标记一个位置:如果同一页面上没有开启移动模式的表单,它什么也不会显示。

“打开筛选器”按钮不出现

模板中没有放置按钮的位置。Elementor 和 Divi 主题构建器模板、Avada 布局、使用 [products] 短代码列出产品的自定义页面,以及许多自定义主题,往往没有 .woocommerce-products-header 区块。这时按钮会一直留在隐藏的表单里。请把 [woof_mobile] 放在按钮应该出现的位置,通常是产品列表上方,放进短代码小工具或区块中。这是最常见的解决办法。它在桌面设备上不会输出任何内容,所以可以一直保留在页面上。

如果无法在该模板中放置短代码,可以用 woof_mobile_btn_place_container 钩子,把按钮指向您自己的元素。为该元素设置一个唯一的 ID(在 Elementor 中:高级 → CSS ID (Advanced → CSS ID)),然后使用它:

/*
 * HUSKY: where to put the mobile "Open filter" button.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_mobile_btn_place_container', function ($selector) {
    return '#filter-button-place';
});

请使用只匹配一个元素的选择器。像 .elementor-widget-container 这样范围很广的类,会把按钮复制到页面上每一个匹配的元素中。如果页面上有 [woof_mobile] 容器,则不会使用该钩子。

按钮缺失的其他原因:

  • 该位置在手机上被主题隐藏(例如只在桌面设备上显示的页眉或工具栏)。请选择一个在手机上可见的位置。
  • 按钮起初显示,筛选后消失:[woof_mobile] 容器位于会被 AJAX 替换的产品列表内部。请把它移到列表上方。
  • JavaScript 优化会把脚本推迟到第一次点击或滚动时才执行(WP Rocket 及类似功能中的“延迟 JavaScript 执行”)。按钮只有在插件脚本运行时才会被移动。请将 /wp-content/plugins/woocommerce-products-filter/ 从延迟、推迟和合并中排除,然后清除缓存。详情请参阅筛选器与 WP Rocket 及缓存。
  • CSS 优化(合并或“移除未使用的 CSS”)删掉了插件的样式,导致按钮虽然存在于页面中,却被隐藏或没有样式。同样要把插件的 CSS 排除在外。
  • 您是在平板电脑上测试。iPad 上的 Safari 和较大尺寸 Android 平板上的 Chrome 默认请求网站的桌面版,因此这些平板得到的是桌面布局。如果主题在平板宽度下隐藏侧边栏,筛选器在那里就会消失;请用 CSS 显示侧边栏,或者把表单放在内容区域中。

按钮有了,但什么也打不开

表单位于被隐藏的容器内。按钮已经移了出来,但面板仍然是表单本身,还在原来的位置。如果主题在手机上用 display: none 隐藏侧边栏,面板就会在一个隐藏的盒子里打开,因而看不见。有三种解决办法:

  • 用 CSS 在手机上显示侧边栏。其中的 HUSKY 表单在点击按钮之前仍然保持隐藏,但该侧边栏中的其他小工具也会变得可见,因此这种方法适合只放了筛选器的侧边栏。
  • 把开启移动模式的表单从侧边栏移到内容区域,例如放在产品列表上方。
  • 小工具只留给桌面设备使用(其移动模式 (Mobile mode)设为“否”),并让插件仅在手机上于产品列表上方放置一个筛选器:选项 → 自动设置筛选器 → 是,但仅限移动设备 (Options → Set filter automatically → Yes, but only for mobile devices),再加上设计 → 默认隐藏自动筛选器 → 是 (Design → Hide auto filter by default → Yes),以得到显示/隐藏按钮。这需要模板运行标准的 WooCommerce 产品循环。

第一种方法的典型规则如下,选择器请根据您的主题调整:

/* Theme hides #secondary (sidebar) on phones: keep it for the HUSKY panel */
@media (max-width: 768px) {
    body.woocommerce-page #secondary {
        display: block;
    }
}

当筛选器位于主题的侧滑抽屉或 Elementor 弹出窗口内时,也会出现同样的问题:抽屉或弹出窗口有自己的显示逻辑和脚本,面板无法从其内部打开。请在抽屉和 HUSKY 移动模式之间二选一,不要同时使用。

sid 中含有空格。像 sid="flat_grey woof_auto_3_columns" 这样的皮肤写法对表单的外观有效,但在 3.4.6 版本中,移动按钮找不到 sid 由两个单词组成的表单。对于开启移动模式的表单,请使用单个单词的 sid。

页面上有两份筛选器。页面构建器中常常有一个桌面版区块,以及一个通过响应式可见性隐藏的手机版副本。两份都存在于 HTML 中,只是被 CSS 隐藏,因此两个标识符相同的表单会互相冲突:分区无法展开,出现两个筛选器图标,或者按钮打开的是您看不到的那一份。每个页面只保留一个筛选器,把手机的处理交给移动模式。

脚本错误。在手机上打开页面,或者在桌面浏览器的设备模拟中刷新后,检查浏览器控制台。在 HUSKY 之前加载的任何脚本出错,也会让它停止工作。

桌面显示移动布局,手机显示桌面布局

由于判断是在页面生成时做出的,如果页面缓存为所有人只保存一份副本,它就会提供最先访问的那类设备的页面。于是桌面访问者会看到打开筛选器 (Open filter) 按钮和一个隐藏的表单,或者手机访问者看到完整的侧边栏却没有按钮,而且每次清除缓存后情况都会变化。解决办法在缓存上,而不是筛选器上:

  • WP Rocket:启用移动设备缓存,并勾选为移动设备使用单独的缓存文件 (Separate cache files for mobile devices)。
  • LiteSpeed Cache:打开缓存移动端 (Cache Mobile)。
  • Cloudflare 页面缓存、Varnish 或主机商缓存:按设备类型缓存,或者将商店页和分类页排除在缓存之外。

修改后请清除所有缓存。滑出式扩展的移动端可见性,以及自动设置筛选器 (Set filter automatically) 的取值是,但仅限移动设备 (Yes, but only for mobile devices) 和是,但仅限桌面设备 (Yes, but only for desktop) 也是如此,它们同样使用 wp_is_mobile()。

出于同样的原因,调整桌面浏览器窗口的大小永远不会让筛选器切换到移动模式。请在真实的手机上、退出登录状态下测试,或者使用浏览器的设备模拟并刷新页面。

打开后的面板中出现的问题

下拉菜单折叠、为空,或者会弹出键盘。Chosen 和 SelectWoo 下拉菜单在页面加载时计算宽度,而此时表单仍处于隐藏状态,而且它们自带的搜索框会唤起手机键盘。最干脆的解决办法是设计 → 下拉菜单皮肤 → 原生 (Design → Drop-down skin → Native):这样手机会显示其自带的选择列表,没有搜索框,也没有宽度问题。如果想继续使用 Chosen 或 SelectWoo,请为它们设置最小宽度:

/* HUSKY: drop-downs collapsed in a hidden or narrow container */
.woof .chosen-container,
.woof .select2-container {
    min-width: 200px;
}

面板是透明的、被固定页眉遮住,或者文字看不见。面板默认略有透明,并使用 z-index: 9999,而一些固定页眉的层级比它更高。请在您的自定义 CSS 中调整:

/* HUSKY mobile panel: opaque, above the sticky header, readable text */
.woof_show_filter_for_mobile.woof {
    opacity: 1;
    z-index: 100000;
}
.woof_show_filter_for_mobile.woof h4,
.woof_show_filter_for_mobile.woof label {
    color: #333;
}

如果面板打开后仍在页眉下方(页眉处于一个面板无法越过的层叠上下文中),请在第一条规则中添加 padding-top: 90px;,让关闭筛选器 (Close filter) 按钮从页眉下方开始。

每点一下面板就关闭。启用自动提交和 AJAX 后,每次选择都会执行筛选,面板随即关闭以显示结果。如果访问者通常会组合多个选项,请为此表单关闭自动提交:[woof sid="mobile" mobile_mode=1 autosubmit=0],这样他们先选择,然后再点击筛选按钮。

iPhone 上的小问题。文本搜索框中占位符错位,可用 .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; } 修复。标签型筛选器的产品计数器偏离标签,可用 .woof_container_label .woof_list_label li { position: relative; } 修复。

修改按钮

按钮的外观在设计 (Design)选项卡中设置:移动筛选按钮图片 (Image for mobile filter button)、移动筛选按钮文字 (Text for mobile filter button)、关闭移动筛选器的图片 (Image to close mobile filter) 和关闭移动筛选器的文字 (Text to close mobile filter)。在图片字段中输入 -1 表示只显示文字,在文字字段中同样输入则表示只显示图标。间距和颜色是针对 .woof_show_mobile_filter 的普通 CSS,例如 .woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }。

基本的设置步骤请参阅如何在移动设备上显示筛选器;主短代码的全部属性请参阅 [woof] 参考。

检查清单

  • 页面上只有一个筛选表单,并且已开启移动模式(小工具选项,或带单词 sid 的 mobile_mode=1,或前端构建器选项)。
  • [woof_mobile] 放在按钮应该出现的位置,处于产品列表之外,并且在手机上可见。
  • 表单本身不在手机上被隐藏的侧边栏、抽屉或弹出窗口内。
  • 插件的 JavaScript 和 CSS 已从延迟、推迟、合并以及移除未使用 CSS 中排除。
  • 页面缓存为移动设备保存了单独的副本,并且所有缓存都已清除。
  • 已在真实手机上,或使用设备模拟并刷新页面,在退出登录状态下测试。

如果筛选器在手机上仍然不显示,请在 HUSKY 支持论坛上新建主题,并附上页面链接、您使用的短代码或小工具设置,以及浏览器控制台中的错误。