迅睿CMS分页标签使用

你是不是也遇到过这种情况？辛辛苦苦做了个资讯站或者产品列表，数据一多，页面长得能划半天，用户体验直接掉到谷底。或者，你看着后台数据明明有100条，页面上却只显示了10条，剩下的像人间蒸发了一样。别急，这八成就是分页没搞对。今天，咱就用人话聊聊迅睿CMS里这个分页标签到底怎么玩，保证你看完就能上手，让你网站的列表页变得既清爽又专业。

一、 分页标签到底是个啥？为啥非用不可？

咱们先把它说人话。想象一下，你有一本超厚的电话本（这就是你的所有数据），但你不能把整本都直接怼到别人眼前，对吧？你得一页一页地给人看。迅睿CMS里的分页标签，干的就是这个“撕页”和“翻页”的活儿。它自动帮你把一大堆数据切成一小份一小份的，然后生成“上一页”、“1、2、3…”、“下一页”这些按钮。

你不用它行不行？当然不行，除非你想让用户对着几百条数据发呆，或者让页面加载慢到怀疑人生。好的分页，能让用户快速找到目标，也能减轻服务器的压力，对SEO也有好处，搜索引擎蜘蛛也喜欢结构清晰的页面。

二、 核心分页标签：{dr_search_page} 怎么用？

在迅睿CMS里，最常用、最核心的分页标签就是 {dr_search_page}。你基本可以把它理解为一个“万能分页生成器”。

1. 基础用法：直接扔到列表页末尾

这是最简单的场景。假设你做了一个“新闻中心”的列表页模板（通常是 list.html）。当你用列表标签调出一堆文章后，只需要在你想显示分页按钮的位置，写上这个标签就行了。

```html

{module module=news catid=$catid page=1 pagesize=10 order=updatetime}
• {$t.title}
{/module}

{dr_search_page} ```

看，就这么简单。系统会自动根据你当前页面的URL参数和模块、栏目的设置，计算出总共有多少页，然后渲染出分页链接。你啥也不用管，它自己就工作了。

2. 关键参数设置：控制分页的样貌

光秃秃的默认分页不好看？咱们可以用参数来打扮它。{dr_search_page} 支持一堆参数，我挑几个最管用的跟你说。

pagesize：每页显示多少条 这个参数其实更常在调用列表的 {module} 标签里设置，它直接决定了“每一页撕多厚”。比如 `pagesize=15`，就是一页显示15篇文章。

urlrule：自定义分页链接的网址规则 这个是高级玩家必备。默认的分页链接可能长得很丑（比如包含一堆index.php?xxx）。你可以用urlrule把它变成像 `/news/2.html` 这样清爽的静态链接格式。这需要你先在后台设置好URL规则，然后在这里指定对应的规则ID。

简单示例： ```html {dr_search_page pagesize=10 urlrule=你设置的静态规则ID} ```

避坑提醒： pagesize 参数一定要和前面 {module} 标签里的 pagesize 保持一致！不然会出现“显示10条，但分页按20条算”的诡异情况，分页数就对不上了。

三、 高级玩法与细节控制

除了基本的翻页按钮，你可能还有些特殊需求。

1. 在首页、频道页调用分页

有时候，你想在网站首页某个区域调用最新文章，并且也需要分页。这时候，你需要明确告诉分页标签一些“背景信息”，因为它不像在列表页里能自动识别栏目。

你需要加上 `module` 和 `catid` 参数： ```html {dr_search_page module=news catid=栏目ID} ``` 这样，分页标签才知道该去哪个模块的哪个栏目下计算数据总量，从而生成正确的分页。

2. 自定义分页HTML结构，让它更漂亮

默认生成的分页就是一堆带链接的数字，样式很基础。如果你想把它做成那种流行的“加载更多”按钮，或者用Bootstrap的分页样式，就需要自己写点HTML结构了。

这时候，你可以不用 {dr_search_page}，而是用更底层的 分页变量 和 分页函数。系统在列表页会生成一个叫 $pages 的变量，里面包含了总页数、当前页、分页链接数组等信息。

你可以自己循环这个数组来构造HTML： ```html {if $pages}

{/if} ```

这样，你就能完全控制分页的样式和结构了，想加class就加class，想改布局就改布局。

3. 一个常见的坑：“总页数”不对

经常有人问：“我明明有50条数据，每页10条，为什么只显示了3页？”

问题通常出在这几个地方： 1. 缓存问题： 这是头号嫌犯。你更新了数据，但页面或数据缓存没更新。去后台“内容管理”->“更新缓存”里，把相关缓存都清一下试试。 2. 条件过滤： 你的 {module} 标签里可能加了 `status=9`（已审核）之类的条件。如果很多数据是未审核状态，它们不会被计入分页的总数。检查你的调用条件。 3. 标签位置： 确保 {dr_search_page} 标签放在了对应的 {module} 列表循环标签之后，并且在同一层级内。

四、 总结一下核心动作

好了，聊了这么多，我给你梳理一下最关键的操作步骤，你照着做准没错：

1. 确定位置： 在你网站列表页模板（list.html）里，找到文章循环结束的地方。 2. 插入标签： 直接写上 `{dr_search_page}`。 3. 检查数量： 确保它前面的 `{module}` 标签里有 `pagesize` 参数，比如 `pagesize=15`。 4. 美化（可选）： 如果想改链接样式或静态化，加上 `urlrule` 参数。如果想彻底重做样式，就去用 `$pages` 变量自己循环。 5. 刷新测试： 去前台点一点，看看翻页灵不灵，总页数对不对。

分页这个功能，说白了就是网站和用户之间一个默契的约定：“内容太多，咱分批次看，不着急。” 把它弄好，一点都不难。现在就去打开你的迅睿CMS模板文件，找到那个长长的列表，把 `{dr_search_page}` 这个“神器”加上去吧。加完刷新页面看看，是不是瞬间就规整、专业多了？动手试试，遇到问题回头再来看看这几个避坑点，准能搞定。