一、作用
用于独立模块的栏目列表循环查询
二、语法
{category module=模块目录名称 ....} {/category}
三、参数介绍
参数 | 介绍 |
---|---|
module | 模块目录 |
site | 站点id,默认为当前站点 |
id | 指定栏目id查询,多个id以,号分开 |
pid | 指定父级栏目id号 |
more | 表示显示数量,支持定点查询,例如1,2表示从第1条记录开始,共显示2条数据 |
num | 表示显示数量,不支持定点查询,只能填写整数 |
cache | 缓存时间单位秒,默认关闭缓存;当cache=3600时,表示缓存时间1小时 |
return | 默认返回变量为t,调用方式就是{$t.字段值}(多级查询必须设置return=其他字母) |
不支持自定义字段作为查询条件
四、返回变量
变量 | 参数 |
---|---|
{$return} | 当前查询的结果集数组 |
{$debug} | 显示当前查询的sql语句,调试模板时候很有用哦(写在标签以外) |
{$key} | 当前记录指针位置,从0开始(写在标签以内) |
当存在return=字母时,以上变量都要写成这种格式{$变量_字母},例如{list ...reutrn=a}时,变量格式{$key_a} | |
{$is_first} | 判断是否第一条,{if $is_first}第一条{/if} |
{$is_last} | 判断是否最后一条,{if $is_last}最后一条{/if} |
五、显示字段
{$t.字段名称}或者{$t['字段名称']}
六、相关例子
查询新闻news模块的所有顶级栏目
{category module=news pid=0} 栏目名称{$t.name} 栏目地址{$t.url} {/category}
查询新闻news模块的指定id为1,2,3,4的栏目
{category module=news id=1,2,3,4} 栏目名称{$t.name} 栏目地址{$t.url} {/category}
两级循环显示栏目(先循环父栏目,再循环其子栏目)如果有三级栏目,以此类推
{category module=news pid=0 return=c1} 我是父栏目:{$c1.name}<br> {category module=news pid=$c1.id return=c2} 我是{$c1.name}的子栏目:{$c2.name}<br> {/category} {/category}
查询news模块中的属性配置
{category module=news more=1} 栏目名称{$t.name} 栏目属性seo标题{$t['setting']['seo']['list_keywords']} {/category}