迅睿CMS内容标签调用实战指南

这事儿吧，很多刚接触迅睿CMS的朋友，一看后台那堆标签就头疼。参数多，写法杂，官方文档又说得太“技术”，想快速实现个效果，得折腾老半天。其实说白了，内容标签调用就是和CMS系统“对话”，你问得越清楚，它给得越准。今天咱就唠点实在的，把那些最常用、最核心的标签调用掰开揉碎了讲，保你听完有种“原来这么回事”的豁然开朗感。

一、 基础调用：先学会“点菜”

你有没有发现，不管多复杂的页面，核心就两步：告诉系统你要什么，告诉系统怎么展示。迅睿的`{module}`标签就是你的“点菜单”。

1. 列表调用：把最新文章“端上来”

想调最新文章列表？别再到处翻代码了，记住这个万能开头：

``` {module module=news order=updatetime num=5}

{$t.title}

{/module} ```

这里面的`module=news`就是告诉厨房（系统）：“我要新闻模块的菜”。`order=updatetime`是按更新时间排序，相当于“要刚出锅的”。`num=5`就是“先来5份”。重点来了：`{$t.url}`和`{$t.title}`就是端上来的“菜”本身，一个链接，一个标题。你试试把`order`改成`inputtime`（按发布时间排），感觉立马不一样。

2. 单篇调用：精准要“那道招牌菜”

有时候你不想要一桌菜，就想精准要某一道，比如ID=123的那篇文章。这时候得用`{content}`标签：

``` {content id=123}

{$title}

{$content}

{/content} ```

看，这就直接把ID123的标题和正文全“端”出来了。很多新手会在这里迷糊，分不清`{module}`和`{content}`。简单记：批量要列表用`{module}`，精准要一篇用`{content}`。

二、 进阶筛选：别光上菜，我要“辣的”

光会点菜还不够，你得会提要求。比如“我要新闻模块里，分类ID是5的，带缩略图的，最热的10篇文章”。听起来复杂？分解开就这么写：

``` {module module=news catid=5 thumb=1 order=views num=10} {/module} ```

这里加了几个关键“调料”：`catid=5`（只要5号分类的），`thumb=1`（必须带缩略图），`order=views`（按点击量从高到低排）。`{if $t.thumb}`这个判断句更是精髓——万一有的菜没辣椒（缩略图），咱就不摆辣椒图标，避免页面显示个裂图，多难看。

三、 玩转字段：把“菜里的葱花”也挑出来

官方字段就那几个，但咱自己加的字段怎么调用？很多人卡在这儿。比如你给新闻模块加了个“来源”字段，字段名是`source`。调用它简单得你不敢相信：

``` {module module=news}

{$t.title} | 来源：{$t.source}

{/module} ```

对，就这么直接！系统会自动把你自定义的字段，也挂到`$t`这个对象下面。`{$t.字段名}`，齐活。这就像你不仅点了菜，还能指定厨子把香菜单独放小碟里，自己随意加。

四、 分页调用：一桌摆不下，分几桌上

列表长了不分页，用户体验那是真扎心。迅睿的分页调用，其实就多一个参数`page=1`和标签`{$pages}`：

``` {module module=news num=10 page=1 urlrule=index.php?page=[page]} {/module} ```

`page=1`开启分页模式，`{$pages}`就是系统生成的分页导航链接。那个`urlrule`是定制链接规则的，如果你改了分页链接样式，这里就得跟着调。不然点下一页就404，白忙活。

几个“血泪”经验总结

• 缓存是个双刃剑：标签里加个`cache=3600`，一小时缓存，页面速度飞起。但后台更了内容前台没变？八成是缓存没更新，要么清缓存，要么开发阶段先关掉。
• 标签嵌套别太深：一个`{module}`里再套`{module}`，性能掉得哗哗的。尽量一次查询拿全数据，用PHP逻辑在循环里处理。
• 善用调试：在标签里加个`{debug}`，或者直接`

  {php print_r($t)}

  `，把变量内容打印出来看看，比瞎猜强一百倍。很多问题一看就明白：“哦，原来这个字段名它叫这个！”

说到底，迅睿的标签调用就像搭积木，基础块就那几个，但组合起来千变万化。最怕的就是死记硬背，今天我这么一唠，你是不是发现核心逻辑就那几条？剩下的，无非是根据你的“菜谱”（设计稿），灵活组合这些“调料”（参数）罢了。多试几次，错了就调，慢慢你就发现，跟CMS系统“对话”，其实挺有意思。