迅睿CMS热门标签调用实操教程 从零实现网站热门标签展示

一、前置准备与版本适配说明

本教程适配迅睿CMS 4.0及以上所有官方正式版本，操作前请确认你满足以下条件：

• 拥有迅睿CMS后台超级管理员权限，可正常登录后台
• 可通过FTP、主机文件管理器或后台自带的模板编辑器修改当前启用主题的模板文件

二、方法一：新手零代码 后台挂件调用（适合侧边栏/底部）

这种方法不需要写复杂代码，适合新手快速把热门标签放到网站侧边、底部等公共区域，步骤如下：

1. 创建热门标签挂件

登录你的迅睿CMS后台，访问地址为：你的域名/admin.php，登录后依次点击左侧菜单：外观 → 挂件管理 → 添加挂件

在弹出的添加页面，填写以下基础信息：

• 挂件名称：填写「热门标签」（可自定义名称）
• 挂件位置：选择你要展示的位置（比如侧边栏、页脚等，根据你的主题支持的位置选择即可）

2. 配置热门标签调用规则

往下滑动找到「挂件内容」输入框，直接复制粘贴以下完整代码：

``` {php} // 调用10个热门标签，按点击量排序，可修改数字调整展示数量 $tags = get_tags([ 'order' => 'hits desc', 'limit' => 10, 'status' => 1 ]); {/php} {if $tags} {/if} ```

以上代码支持自定义调整：你可以修改代码中第3行的limit => 10，把10改成你需要展示的标签数量，比如要展示20个就改成limit => 20；排序规则hits desc是按点击量从高到低排序，如果需要按标签被使用次数排序，改成total desc即可。

3. 保存生效

填写完成后点击底部的「保存」按钮，然后刷新网站前台，就能看到热门标签已经展示出来了。如果需要调整样式，可以在主题的CSS文件中给.hot-tags类添加自定义样式即可。

三、方法二：模板手动调用（适合任意位置，自定义程度高）

如果需要把热门标签放到首页、内容页等任意模板位置，直接在模板中加调用代码即可，步骤如下：

1. 打开需要添加标签的模板文件

登录迅睿CMS后台，依次点击 外观 → 模板管理 → 我的模板 → 编辑，找到你要添加热门标签的模板文件（比如首页模板index.html，列表模板list.html），点击进入编辑页面。

2. 插入调用代码

把光标定位到你需要展示热门标签的位置，复制粘贴以下完整可运行代码：

``` {php} // 参数说明：order排序规则，limit展示数量，status=1只调用已审核标签 $hot_tags = \Phpcmf\Service::M()->db->table('tags') ->where('status', 1) ->orderBy('hits', 'desc') ->limit(15) ->get() ->getResultArray(); {/php} {if $hot_tags} {/if} ```

可自定义的参数说明：

• 修改代码中的limit(15)，把15改成你需要的标签数量
• 如果需要按标签被关联的文章数量排序，把orderBy('hits', 'desc')改成orderBy('total', 'desc')
• 如果需要只调用某个栏目的热门标签，在where条件后添加->where('catid', 栏目ID)即可，比如只调用栏目ID为2的标签，代码调整为：

  $hot_tags = \Phpcmf\Service::M()->db->table('tags')
  ->where('status', 1)
  ->where('catid', 2)
  ->orderBy('hits', 'desc')
  ->limit(15)
  ->get()
  ->getResultArray();
  

3. 保存更新缓存

粘贴完成后点击「保存」，然后回到迅睿CMS后台首页，点击左上角的「更新缓存」按钮，清除缓存后刷新前台页面，热门标签就正常显示了。

四、常见问题解决

1. 调用后不显示内容怎么办？

按以下步骤逐一排查：

• 检查你的网站有没有添加过标签，没有添加标签自然不会输出内容
• 检查代码中status => 1有没有写错，未审核的标签不会被调用
• 检查是否更新了缓存，迅睿CMS修改模板后必须更新缓存才会生效

2. 怎么实现热门标签云效果（不同热度不同字体大小）？

如果需要根据标签热度自动调整字体大小，可以把循环部分的代码改成以下内容：

``` {loop $hot_tags $tag} {php}$size = $tag['hits'] > 100 ? 14 + rand(2,6) : 12 + rand(1,3);{/php} {$tag.name} {/loop} ```

以上代码会根据点击量自动调整字体大小，也可以根据自己的需求修改数值区间。

3. 怎么调用带指定关键词的热门标签？

如果需要只调用名称带指定关键词的标签，在where条件中添加->like('name', '关键词')即可，完整示例：

``` $hot_tags = \Phpcmf\Service::M()->db->table('tags') ->where('status', 1) ->like('name', '教程') ->orderBy('hits', 'desc') ->limit(15) ->get() ->getResultArray(); ```

把示例中的「教程」换成你需要的关键词即可。