一、语法

{tag ....}{/tag}


二、参数介绍

参数
介绍
site
站点id,默认当前站点,填写其他站点id表示查询其他站点的模块数据
tag关键词,多个以,分开,匹配相关关键词
num
表示显示数量,支持定点查询,例如1,2表示从第1条记录开始,共显示2条数据
cache
缓存时间单位秒,默认关闭缓存
order排序字段;当值为rand,随机显示
return
默认返回变量为t,调用方式就是{$t.字段值}(多级list查询必须设置return=其他字母)

支持自定义字段作为查询条件


三、返回变量

变量
参数
{$debug}
当查询不到数据时,会返回错误信息,调试模板时很有用哦(写在循环标签以外)
{$return}当前查询的结果集数组
{$count}当前查询的记录,当存在分页时,表示当前页的记录数(写在循环标签以外)
{$pages}
显示分页代码(写在循环标签以外)
{$key}
当前记录指针位置,从0开始(写在循环标签以内)
当存在return=字母时,以上变量都要写成这种格式{$变量_字母},例如{list ...reutrn=a}时,变量格式{$key_a}


四、显示字段

{$t.字段名称}或者{$t['字段名称']}


五、相关例子

1、显示40个标签

{tag num=40}
<a href="{$t.url}" title="点击量:{$t.hits}">{$t.name}</a>
{/tag}


2、显示文章show.html的相关20个标签

{tag tag=$tag order=rand num=20}
<a href="{$t.url}" title="点击量:{$t.hits}">{$t.name}</a>
{/tag}


3、随机显示20个标签

{tag num=20 order=rand}
<a href="{$t.url}" title="点击量:{$t.hits}">{$t.name}</a>
{/tag}


4、显示点击率最高的20个标签

{tag num=20 order=hits}
<a href="{$t.url}" title="点击量:{$t.hits}">{$t.name}</a>
{/tag}