一、语法
{tag ....}{/tag}二、参数介绍
| 参数 | 介绍 |
|---|---|
| site | 站点id，默认当前站点，填写其他站点id表示查询其他站点的模块数据 |
| tag | 关键词，多个以,分开，匹配相关关键词 |
| num | 表示显示数量，支持定点查询，例如1,2表示从第1条记录开始，共显示2条数据 |
| cache | 缓存时间单位秒，默认关闭缓存 |
| order | 排序字段；当值为rand，随机显示 |
| return | 默认返回变量为t，调用方式就是{$t.字段值}（多级查询必须设置return=其他字母，只能作为最后一个参数使用） |
支持自定义字段作为查询条件
三、返回变量
| 变量 | 参数 |
|---|---|
| {$debug} | 当查询不到数据时，会返回错误信息，调试模板时很有用哦（写在循环标签以外） |
| {$return} | 当前查询的结果集数组 |
| {$count} | 当前查询的记录，当存在分页时，表示当前页的记录数（写在循环标签以外） |
| {$pages} | 显示分页代码（写在循环标签以外） |
| {$key} | 当前记录指针位置，从0开始（写在循环标签以内） |
| 当存在return=字母时，以上变量都要写成这种格式{$变量_字母}，例如{list ...reutrn=a}时，变量格式{$key_a} | |
四、显示字段
在线生成显示字段：https://www.xunruicms.com/doc/code/field.html--t
五、相关例子
1、显示40个标签
{tag num=40}
<a target="_blank" href="{$t.url}" title="点击量：{$t.hits}">{$t.name}</a>
{/tag}2、显示文章show.html的相关20个标签
{php $taga=urlencode($tag);}{tag tag=$taga order=rand num=20}
<a target="_blank" href="{$t.url}" title="点击量：{$t.hits}">{$t.name}</a>
{/tag}3、随机显示20个标签
{tag num=20 order=rand}
<a target="_blank" href="{$t.url}" title="点击量：{$t.hits}">{$t.name}</a>
{/tag}4、显示点击率最高的20个标签
{tag num=20 order=hits}
<a target="_blank" href="{$t.url}" title="点击量：{$t.hits}">{$t.name}</a>
{/tag}
文档最后更新时间：2022-09-13 08:35:27