WooCommerce 筛选器分页不起作用:原因与解决方法
WooCommerce 筛选器分页不起作用,通常有以下几种表现:分页链接指向 /wp-admin/admin-ajax.php?paged=2,页面空白且只有一个 0,筛选结果末尾出现空页面或 404,第 2 页丢失了筛选条件,或者无限滚动在第一次筛选后就停止。每种症状都有各自的原因,而且大多数源于主题构建分页的方式,而不是筛选器。请先看下面的表格,再转到对应的章节。
| 您看到的现象 | 可能的原因 |
|---|---|
链接指向 admin-ajax.php?paged=2,页面空白并显示 0 | AJAX 模式遇到非标准的分页标记 |
| 筛选后出现两个分页,或两行“显示 1–12 共 40 个结果” | 主题在 HUSKY 刷新的区域之外输出了自己的元素 |
| 页数多于产品所需,最后几页是 404 或空白 | HUSKY、主题和构建器中的“每页产品数”不一致 |
| 在第 3 页更改筛选条件后网格为空 | 旧的页码被带入了新的筛选链接 |
| 转到第 2 页后筛选器失效或没有样式 | 主题自带的 AJAX 分页、加载更多或无限滚动 |
| 第 2 页没有筛选器,或第 2 页显示未筛选的产品 | 筛选器放在页面内容中,或分页链接丢失了筛选条件 |
| 筛选后完全没有分页 | 自定义模板,或在循环钩子之外输出分页的主题 |
指向 admin-ajax.php 的链接:AJAX 模式与主题标记
当尝试将商店 AJAX 化 (Try to ajaxify the shop)设为是 (Yes)(或在页面上使用 [woof_products is_ajax=1])时,HUSKY 不会重新加载页面。它通过 admin-ajax.php 向服务器请求新的产品,并替换产品区块,其中包括分页。由于新的分页是在 AJAX 请求内部生成的,它的链接指向 admin-ajax.php?paged=2。这些链接本来就不是用来点击跳转的:HUSKY 会捕获对 .woocommerce-pagination a.page-numbers 的点击,读取页码,并通过 AJAX 加载该页。
如果主题更改了分页标记(外层容器使用了不同的类、链接没有 page-numbers 类、使用自己的分页函数),点击就不会被捕获,浏览器会打开原始链接。WordPress 对没有 action 的 admin-ajax.php 请求返回 0,这就是那个空白页。HUSKY 期望的标记是 WooCommerce 自己的标记:
<nav class="woocommerce-pagination">
<ul class="page-numbers">
<li><span aria-current="page" class="page-numbers current">1</span></li>
<li><a class="page-numbers" href="https://example.com/shop/page/2/">2</a></li>
<li><a class="next page-numbers" href="https://example.com/shop/page/2/">→</a></li>
</ul>
</nav>
请在浏览器中检查您的分页并进行比对。覆盖了 woocommerce/loop/pagination.php 或使用自有分页的主题,可以在子主题中修复(容器类名里哪怕只是 woocmmerce-pagination 这样的拼写错误就足以破坏它),但可靠的办法无需任何代码:切换到重定向模式。打开插件设置的选项 (Options)选项卡,将尝试将商店 AJAX 化 (Try to ajaxify the shop)设为否 (No)并保存;在使用短代码的页面上使用 is_ajax=0。此后每次筛选都会重新加载页面,分页则是主题的常规分页。无法仅对分页关闭 AJAX。另请参阅 AJAX 模式下的分页问题。
如果该选项提示已保存,却又回到了是 (Yes),说明涡轮模式已启用。涡轮模式只能配合 AJAX 工作,并在每次页面加载时把该选项重新打开;请先停用涡轮模式。
重复的分页,或不更新的结果数量
有些主题会在 HUSKY 所替换的区块之外输出结果数量、排序或分页。AJAX 筛选之后,您会在新元素旁边看到主题遗留的旧元素,或者一个仍然描述未筛选商店的数量。对于结果数量,请在高级 → 选项 → 结果数量的 CSS 选择器 (Advanced → Options → Result count css selector)中填入它的选择器,通常是 .woocommerce-result-count;这样 HUSKY 会在每次筛选后重绘它(排序下拉菜单的 CSS 选择器 (Order dropdown css selector)对排序起同样的作用)。如果仍有重复,重定向模式可以消除它们。
多余的页面与结果末尾的 404
WordPress 根据页面的主查询来判断 /page/7/ 是否存在:如果主查询有六页,那么无论该页上的产品网格显示什么,第 7 页都是 404。当可见的网格与主查询对每页产品数的计算不一致时,问题就出现了,例如构建器小工具每页显示 30 个,而主查询使用主题的 12 个:分页与实际存在的页码不再一致,页面变成空白,或在中途以 404 结束。HUSKY 自己的设置高级 → 选项 → 每页产品数 (Advanced → Options → Products per page)仅在筛选器处于活动状态时才生效(其默认值 -1 表示“不管理”),所以与它的不一致只在筛选之后才会出现。
- 找出所有设置该数字的位置:主题或 WooCommerce 的商品目录设置、构建器的产品小工具,以及 HUSKY 的每页产品数 (Products per page)。
- 在所有位置设置相同的数字,或者把 HUSKY 的设为
-1,使它不产生干扰。 - 在没有筛选器的情况下测试:暂时停用 HUSKY,直接打开一个较大的页码,例如
/shop/page/17/。如果此时是 404,说明不一致出在主题与构建器之间,而不在筛选器。
如果页数仅在筛选时仍然过多,那么主题很可能是根据另一个查询计算分页的;修复分页显示过多页面的问题中有一段代码,可强制使用筛选后查询的总数。Avada 有它自己的情况,详见 Avada:分页时丢失筛选器。
在第 2 页或之后更改筛选条件后出现空页面
访问者在第 3 页更改了筛选条件。新结果只有一页,所以如果新链接仍然请求第 3 页,网格就会为空,或者页面是 404。对于标准分页,HUSKY 会避免这种情况:它会从构建的链接中移除 /page/N/ 和 WooCommerce 的 product-page 参数,并且在 AJAX 模式下每次更改都会重置到第 1 页。查询字符串中的其他页码参数会随地址的其余部分一同复制到新链接中,例如使用朴素固定链接的站点上的 ?paged=3,或页面构建器自己的分页参数。请使用美观的固定链接(设置 → 固定链接 (Settings → Permalinks),除朴素 (Plain)之外的任何结构)和标准的 WooCommerce 分页,并在更改筛选条件后检查地址:其中不应包含页码。
主题的 AJAX 分页、加载更多与无限滚动
许多主题有自己的 AJAX 商店:分页、“加载更多”按钮、无限滚动、AJAX 排序,或者网格/列表切换,它们无需刷新就能替换产品和侧边栏。HUSKY 在页面加载时(以及在它自己的 AJAX 刷新之后)初始化其表单。当主题换入新的侧边栏 HTML 时,新的筛选元素从未被初始化,于是筛选器不再响应、丢失样式,或发送错误的值。主题的加载更多请求还会为“下一页”构建自己的查询,并不知道筛选器的存在,这就是它可能把未筛选的产品添加到已筛选列表中的原因。
- 关闭主题的 AJAX 分页、AJAX 商店、无限滚动和加载更多选项,并用标准分页测试。这能解决大多数情况。
- 对于无限滚动,HUSKY 内置了对免费插件 YITH Infinite Scrolling 的支持:每次 AJAX 筛选之后,它会重新初始化滚动并修正下一页链接。请使用已筛选产品的无限滚动中列出的选择器。
- 任何其他需要在 AJAX 筛选之后重新启动的脚本,都可以监听
woof_ajax_done事件,详见 woof_ajax_done 事件。具体用哪个调用来重启取决于那个脚本本身,请向其作者咨询。
/*
* Runs after every HUSKY AJAX filtering.
* Put it in a JavaScript file of your child theme.
*/
jQuery(document).on('woof_ajax_done', function () {
// call the init function of your infinite scroll or load-more script here
});
除了放进主题文件,该函数的主体也可以放入高级 → 代码 → AJAX 完成后的 JavaScript 代码 (Advanced → Code → JavaScript code after AJAX is done)。
第 2 页上的筛选器丢失或被遗忘
- 筛选器在第 2 页消失。它被放在了商店页面的内容或分类描述中。WooCommerce 只在归档的第一页输出这两者。请把筛选器放在侧边栏小工具、每个页面都会出现的主题区域,或描述之外的构建器区块中。
- 第 2 页显示未筛选的产品。在重定向模式下,标准的 WooCommerce 分页会在其链接中保留筛选条件(
/shop/page/2/?swoof=1&pa_color=red)。把鼠标悬停在页码链接上:如果缺少swoof=1和您的筛选值,说明主题构建了不带查询字符串的自有链接;请切换到标准分页,或修复主题的链接函数。 - 第 2 页重定向到商店或丢失分类。改写产品 URL 或归档别名的插件和自定义代码,可能与筛选链接冲突。请在停用它们的情况下测试;一个已知的情况参见 HUSKY 与 Permalinks Manager Pro。
筛选后没有分页
在 AJAX 模式下,刷新的区块包含 WooCommerce 在 woocommerce_after_shop_loop 钩子上输出的全部内容,而 WooCommerce 的分页就在那里。如果主题从该钩子上移除了分页,并在别处输出自己的分页,那么在第一次 AJAX 筛选之后它就会丢失;重定向模式可以避免这个问题。如果您构建了自己的归档模板,请自行在产品循环之后输出分页:
<?php
// In your WooCommerce archive template (child theme), after the product loop:
woocommerce_pagination();
?>
自定义模板还需要标准的商店循环钩子,AJAX 模式才能正常工作;筛选器 URL 改变但产品没有变化说明了需要哪些钩子。
若想在翻页后让访问者回到产品顶部,请参阅 AJAX 筛选后的自动滚动,或者在重定向模式下参阅重定向模式下自动滚动到产品。
WooCommerce 筛选器分页不起作用时的检查清单
- 在清除所有缓存之后,已在重定向模式下测试(尝试将商店 AJAX 化 (Try to ajaxify the shop) = 否 (No),涡轮模式关闭,短代码中
is_ajax=0)。 - 分页标记是
nav.woocommerce-pagination,其中链接为a.page-numbers。 - 主题、构建器和 HUSKY 中的每页产品数相同,或者 HUSKY 的为
-1。 - 主题的 AJAX 分页、加载更多和无限滚动已关闭,或在
woof_ajax_done上重新初始化。 - 已筛选页面上的分页链接包含
swoof=1和筛选值,并且更改筛选条件后不会残留旧的页码。 - 筛选器位于侧边栏或模板区域,而不是商店或分类描述中。
如果在重定向模式下使用主题的标准分页后分页仍然失败,请在 HUSKY 支持论坛上新建主题,并附上页面链接以及出问题页面的地址。