迅睿CMS首页模板标签调用实战指南

一、首页标签调用的核心概念

在迅睿CMS中，首页标签调用是通过模板标签系统实现的。所有标签都遵循统一的语法规则：{模块名 参数=值 参数=值}。首页模板文件位于/template/pc/default/home/index.html，标签调用就是在这个文件中进行的。

标签调用分为两个主要部分：数据查询标签和内容输出标签。数据查询标签负责从数据库获取数据，内容输出标签负责将数据渲染到页面上。

二、环境准备与模板定位

2.1 确认模板文件位置

首先登录迅睿CMS后台，进入"系统设置"→"模板风格"，确认当前使用的模板名称。假设当前模板为"default"，那么首页模板的完整路径是：

/wwwroot/template/pc/default/home/index.html

如果你使用宝塔面板，可以通过文件管理器直接定位到这个文件。如果使用FTP工具，需要确保连接的是网站根目录。

三、常用首页标签详解

3.1 文章列表调用标签

这是首页最常用的标签，用于调用最新的文章列表。基本语法如下：

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

{$t.title} {date('Y-m-d', $t._updatetime)}

{/module} ```

关键参数说明：

• module：指定内容模块，news表示新闻模块
• num：调用数量，这里是10条
• order：排序方式，updatetime按更新时间倒序
• catid：可选的栏目ID，用于指定特定栏目
• more：是否显示更多链接，1为显示，0为不显示

3.2 单页内容调用标签

调用公司简介、联系方式等单页内容：

``` {page id=1}

{$page.title}

{/page} ```

这里的id=1对应后台"内容"→"单页管理"中的页面ID。要查看具体页面的ID，可以进入单页管理，将鼠标悬停在编辑按钮上，浏览器状态栏会显示类似page/edit/id/3的链接，其中的数字就是ID。

3.3 幻灯片调用标签

首页轮播图的调用方法：

``` {slide id=1} {/slide} ```

这里的id=1对应后台"模块"→"幻灯片管理"中创建的幻灯片组ID。创建幻灯片组时，系统会显示该组的ID号。

四、高级调用技巧

4.1 多条件筛选调用

当需要根据多个条件筛选内容时，可以使用组合参数：

``` {module module=news num=8 catid=1,2,3 order=updatetime flag=1,2} {/module} ```

参数解析：

• catid=1,2,3：同时调用栏目ID为1、2、3的内容
• flag=1,2：只调用带有推荐(1)和头条(2)属性的文章
• 多个参数之间用空格分隔，不能使用逗号

4.2 分页调用配置

当内容较多需要分页显示时：

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

关键配置：

• page=1：开启分页功能
• urlrule：分页链接规则，[page]会被替换为页码
• {$pages}：在标签外输出分页链接

4.3 自定义字段调用

如果文章添加了自定义字段，比如"价格"字段，调用方法如下：

``` {module module=product num=5} {/module} ```

要查看某个模块的所有可用字段，可以在后台进入"模块管理"→"字段管理"，选择对应的模块查看字段标识符。

五、标签嵌套与组合使用

5.1 标签嵌套示例

在文章列表中嵌套调用相关图片：

``` {module module=news num=6}

{$t.title}

{if $t.images} {/if}

{$t.description}

{/module} ```

注意：标签嵌套时，内层标签必须完全包含在外层标签的循环体内，不能交叉嵌套。

5.2 条件判断标签

根据不同的条件显示不同的内容：

``` {if $catid==1} {module module=news num=5 catid=1} {elseif $catid==2} {module module=news num=8 catid=2} {else} {module module=news num=10} {/if} ```

六、常见问题解决

6.1 标签调用无内容显示

如果标签调用后没有显示内容，按以下步骤排查：

• 检查模块名称：确认module参数的值是否正确。模块名称可以在后台"模块管理"中查看
• 检查内容状态：确保调用的文章已经发布，且未过期
• 检查栏目权限：确认栏目是否设置了访问权限
• 查看错误日志：打开/config/debug.php，将'level' => 0改为'level' => 1，刷新页面查看具体错误信息

6.2 样式错乱问题

标签调用正常但样式显示异常：

• 检查CSS路径：确保CSS文件路径正确。首页CSS通常位于/template/pc/default/css/index.css
• 检查HTML结构：在浏览器中右键"检查元素"，查看生成的HTML结构是否与CSS选择器匹配
• 清除缓存：进入后台"系统"→"更新缓存"，点击"全部更新"

6.3 性能优化建议

当首页加载较慢时：

• 减少查询数量：将num参数调整到合理范围，一般不超过20条
• 启用缓存：在标签中添加cache=3600参数，单位是秒，表示缓存1小时
• 合并CSS/JS：将多个CSS文件合并为一个，减少HTTP请求
• 使用CDN：将图片等静态资源上传到CDN加速

七、实战案例：完整首页布局

以下是一个典型的首页布局代码示例：

```

{catpos id=0}

{slide id=1}

{$t.title}

{$t.description}

{/slide}

最新动态

{module module=news num=8 order=updatetime}

{$t.title}

{date('Y-m-d', $t._updatetime)} 浏览：{$t.hits}

{$t.description}

{/module}

产品展示

{module module=product num=6 catid=10 order=listorder}

{$t.title}

{$t.price}元

{/module}

```

将上述代码保存到/template/pc/default/home/index.html，然后进入后台"系统"→"更新缓存"，选择"更新URL和程序缓存"，刷新首页即可看到效果。