迅睿CMS中TAG标签循环调用详解与实战

什么是迅睿CMS的TAG标签循环调用

在迅睿CMS中，TAG标签循环调用是指通过系统内置的模板标签语法，将内容关联的TAG（关键词）数据从数据库中查询出来，并按照指定的规则在前端模板中进行循环展示的核心功能。它主要用于构建内容的关键词云、相关文章推荐、内容聚合导航等场景。

其底层逻辑是调用dr_tag_show()等相关函数，通过指定参数（如栏目ID、数量、排序方式）从dr_1_tag等数据表中获取数据集，然后在模板中使用{loop}标签进行遍历输出。

调用前的环境准备与确认

在开始编写调用代码前，必须确保你的操作环境符合以下要求，这是后续所有步骤能够成功执行的基础。

确认CMS版本与模块

打开迅睿CMS后台，在顶部导航栏找到“系统”->“系统体检”，查看“当前版本”。本文所述方法适用于迅睿CMS v4.x版本。同时，确保你操作的栏目或内容模块已经启用了TAG功能。你可以在“内容”->“相关管理”->“TAG关键词”中查看是否有数据，或尝试为某篇文章添加TAG。

定位模板文件

所有模板调用代码均需写入模板文件（.html文件）。根据你的需求，确定需要修改的模板文件路径：

• 首页TAG调用：通常修改 /template/pc/default/home/index.html
• 栏目列表页TAG调用：通常修改 /template/pc/default/栏目目录名/list.html
• 内容详情页TAG调用：通常修改 /template/pc/default/栏目目录名/show.html

你可以通过FTP工具或主机控制面板的文件管理器找到这些文件。强烈建议在修改前，对原文件进行备份。

基础循环调用：获取并展示当前内容TAG

最常见的需求是在文章详情页，展示这篇文章自身关联的所有TAG关键词。

调用代码与插入位置

打开你目标栏目的详情页模板（例如show.html），在你希望TAG显示的位置（如文章标题下方或内容底部），插入以下代码块：

``` {php $tag = dr_tag_show($id);} {if $tag}

本文标签： {loop $tag $t} {$t.name} {/loop}

{/if} ```

代码逐行解析与参数说明

• 第1行 {php $tag = dr_tag_show($id);}：这是一条PHP标签代码。dr_tag_show()是迅睿CMS内置的TAG查询函数。$id是系统在详情页自动生成的当前内容ID变量，函数会根据这个ID去查找关联的TAG数据，并将结果赋值给$tag变量。
• 第2行 {if $tag}：这是一个条件判断标签。只有当$tag变量有数据（即这篇文章确实设置了TAG）时，才会执行{if}和{/if}之间的代码，避免页面上出现空标签的尴尬情况。
• 第4行 {loop $tag $t}：这是核心的循环标签。它会遍历$tag变量这个数组，在每次循环中，将数组的当前单元（一个TAG信息）赋值给$t变量。
• 第5行 {$t.name}：在循环体内，输出每个TAG的链接。{$t.url}是该TAG的独立页面URL，{$t.name}是TAG的名称。链接的target="_blank"属性使其在新窗口打开。

保存模板文件后，刷新文章详情页，即可看到效果。如果文章没有设置TAG，则“本文标签：”这一整段都不会显示。

进阶调用：自定义条件与数据筛选

基础调用依赖于当前内容ID。更多时候，我们需要根据自定义条件获取TAG列表，例如调用全站热门TAG、指定栏目的TAG等。

调用指定栏目的所有TAG

假设你想在网站侧边栏显示“新闻中心”栏目（假设栏目ID为3）下的所有TAG。在侧边栏对应的模板位置插入以下代码：

``` {php $tags = dr_tag_list(3, 20);} {if $tags}

新闻中心热门标签

{loop $tags $tag}
• {$tag.name}({$tag.total})
{/loop}

{/if} ```

关键参数解析：dr_tag_list(3, 20)中的3是栏目ID，20是调用的最大数量。函数会返回栏目ID=3的栏目下，所有使用过的TAG列表，并按使用频率排序。{$tag.total}可以输出该TAG在该栏目下被多少篇文章使用。

调用全站热门TAG（标签云）

要生成一个全站热门TAG的“标签云”，可以使用以下代码：

``` {php $tags = dr_tag_list(0, 50, 100);} {if $tags} {/if} ```

关键参数解析：dr_tag_list(0, 50, 100)中，第一个参数0代表全站（不限栏目）；第二个参数50是调用数量；第三个参数100是“总数量大于此值的TAG才显示”，这里设置为100，意味着只有被超过100篇文章使用的TAG才会被列出，这可以有效过滤掉冷门词，形成真正的“热门”标签云。

样式逻辑：循环体内，{php $size = 14 + ceil($tag[‘total’]/5);}这一行根据TAG的使用次数（$tag[‘total’]）动态计算字体大小。使用次数越多，字体越大。你可以调整14（基础字号）和5（缩放系数）来获得理想的视觉效果。

高阶应用：多维度排序与缓存优化

按字母顺序或最新使用排序

dr_tag_list()函数默认按使用次数（total）降序排序。你可以通过第四个参数指定排序方式：

• 按名称字母排序：{php $tags = dr_tag_list(0, 30, 0, ‘name’);}
• 按最新使用时间排序：{php $tags = dr_tag_list(0, 30, 0, ‘inputtime desc’);}

为TAG调用添加缓存

对于全站热门TAG这类更新不频繁但查询频繁的数据，添加缓存能显著降低数据库压力，提升页面加载速度。使用dr_get_cache()和dr_set_cache()函数：

``` {php $cache_name = 'site_hot_tags'; // 缓存唯一标识 $tags = dr_get_cache($cache_name); // 尝试读取缓存 if (!$tags) { // 如果缓存不存在或已过期 $tags = dr_tag_list(0, 30, 100); // 从数据库查询 dr_set_cache($cache_name, $tags, 3600); // 将查询结果缓存，有效期3600秒（1小时） } } {if $tags} ... // 显示TAG的循环代码 {/if} ```

代码逻辑：系统首先尝试读取名为site_hot_tags的缓存。如果读到了，就直接使用缓存数据；如果没读到（比如首次运行或缓存过期），则执行dr_tag_list()查询数据库，并将查询结果立刻保存到缓存中，设置1小时的有效期。这样在接下来的1小时内，所有用户访问都会直接读取缓存，而不会查询数据库。

排错指南与效果验证

如果调用后页面上没有显示或显示异常，请按以下步骤排查：

1. 检查语法与标签闭合：确保所有{和}、{loop}和{/loop}、{if}和{/if}都是成对且正确嵌套的。一个缺失的闭合标签会导致整个模板解析失败。
2. 检查变量名与参数：确认函数名（如dr_tag_show）拼写正确。确认$id等变量在当前的模板上下文中是存在的（详情页的show.html中肯定存在）。
3. 检查数据是否存在：在后台确认目标栏目或文章是否已经添加了TAG关键词。调用代码逻辑正确，但数据库中没有数据，同样不会显示。
4. 清除模板缓存：迅睿CMS会编译和缓存模板。修改模板后，必须进入后台“系统”->“系统体检”->“缓存清理”，勾选“模板缓存”并清理，修改才能生效。
5. 查看网页源代码：在浏览器页面右键点击“查看网页源代码”。如果在源代码中能看到你写的模板标签（如{loop…}）原样输出，说明模板引擎没有解析它，这通常是语法错误或文件位置错误导致的。如果源代码中标签消失了，变成了HTML结构，说明解析成功，此时若样式不对，则应检查循环体内输出的HTML结构和CSS样式。

通过以上从基础到高阶的步骤，你可以在迅睿CMS的任何模板位置，灵活、高效地实现TAG标签的循环调用，从而丰富网站的内容关联性与导航维度。