迅睿CMS指定数量内容调用零门槛实操指南 看完就能直接上手

前置准备

你只需要满足以下两个条件即可跟着操作：

• 已经完成迅睿CMS的安装部署，后台可正常访问
• 拥有模板文件的编辑权限，明确需要添加调用代码的位置

一、原生{list}标签调用（推荐，90%场景适用）

{list}是迅睿CMS官方提供的原生内容调用标签，写法简单、性能优异，是指定数量内容调用的首选方案，核心通过num参数控制调用的总数量，操作步骤如下：

步骤1：打开目标模板文件

登录迅睿CMS后台，依次点击进入「扩展」→「模板管理」→「模板编辑」，在左侧文件树中选择你要添加调用代码的模板文件（比如首页模板index.html、文章详情页show.html）。

步骤2：粘贴并修改调用代码

将以下完整代码复制到你需要展示内容的位置，根据需求修改参数即可：

``` {list module=news catid=12 num=3 order=updatetime}

{$t.title} {dr_date($t.updatetime, 'Y-m-d')}

{/list} ```

核心参数说明：

• module=news：news是内容模型的标识，如果是页面模块改成page，产品模型改成product，按需修改
• catid=12：12是你要调用的栏目ID，多个栏目用英文逗号分隔，比如catid=1,2,3，表示调用1、2、3栏目的内容
• num=3：这里的3就是你要指定调用的总数量，需要多少条就改成对应的数字，是核心参数
• order=updatetime：排序规则，updatetime是按更新时间排序，hits是按浏览量排序，id是按发布时间排序，按需修改

特殊场景扩展：从指定位置开始调用

如果你需要跳过前N条内容，从第N+1条开始调用指定数量，可以添加offset参数，示例：调用栏目12，跳过前2条，取后续3条内容，代码如下：

``` {list module=news catid=12 num=3 offset=2 order=updatetime}

{$t.title}

{/list} ```

常用场景示例：详情页调用同栏目指定数量相关内容

在文章详情页调用同栏目下的3条推荐内容，排除当前文章，完整代码：

``` {list module=news catid=$catid num=3 where="id!=$id AND is_recommend=1" order=hits}

{$t.title}

{/list} ```

二、自定义SQL调用（复杂筛选场景适用）

当你有非常复杂的筛选条件，{list}标签无法满足时，可以用原生SQL调用，通过LIMIT关键字指定调用数量，完整可复制示例：调用5条浏览量最高的已发布文章：

``` {php $content_list = $this->db->query("SELECT FROM {pre}news WHERE status=99 ORDER BY hits DESC LIMIT 5")->result_array();} {loop $content_list $t}

{$t.title}

{/loop} ```

核心说明：

• LIMIT 5：这里的5就是指定的调用总数量，需要多少条改对应数字即可，如果需要跳过前2条取5条，写成LIMIT 2,5
• {pre}：这是迅睿CMS的表前缀占位符，不需要修改，系统会自动替换成你安装时设置的表前缀
• status=99：必须保留这个条件，99代表内容已发布，不加会调用到草稿、回收站等未发布内容
• 表名说明：news是内容模型标识，如果你是产品模型，表名就是{pre}product，对应修改即可

三、常见问题排障

1.修改代码后调用数量不对，不生效怎么办？

90%的不生效问题是缓存导致，修改模板后，需要到迅睿后台依次点击「系统」→「更新缓存」，勾选所有缓存选项，点击「确定更新」，刷新前端页面即可看到效果。

2.分页场景下怎么指定总调用数量？

如果需要做分页展示，同时限制总的调用数量，只需要添加total参数即可，示例：每页展示3条，总共调用12条（共4页），写法：

``` {list module=news catid=12 num=3 total=12 page=$page} ...循环内容... {/list} ```

3.调用多个栏目怎么控制总数量？

多个栏目调用只需要统一写一个num参数即可，比如调用栏目1、2总共4条，写法：{list module=news catid=1,2 num=4 ...}，num参数控制的是最终返回的总数量，不需要每个栏目单独设置。

4.需要调用全站点所有栏目的指定数量内容怎么写？

只需要把catid参数设置为0即可，示例：调用全站所有栏目最新发布的6条文章，写法：{list module=news catid=0 num=6 order=updatetime}。