一、作用
用于独立模块的栏目列表循环查询
二、语法
{category module=模块目录名称 ....} {/category}
三、参数介绍
参数 | 介绍 |
---|---|
module | 模块目录 |
site | 站点id,默认为当前站点 |
id | 指定栏目id查询,多个id以,号分开 |
pid | 指定父级栏目id号 |
order | 排序方式 |
ismain | 开发中,1表示只显示主栏目 |
show | show=1表示显示全部栏目(包括隐藏的栏目),show=0或者不填时就不显示被隐藏的栏目 |
more | more=1表示加载栏目的全部字段,默认显示基础字段 |
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} 这里的【$t.**】t是由return参数值来决定的,比如有些是return=c,那么t就改成c,成为{$c.name}
查询新闻news模块的指定id为1,2,3,4的栏目
{category module=news id=1,2,3,4} 栏目名称{$t.name} 栏目地址{$t.url} {/category} 这里的【$t.**】t是由return参数值来决定的,比如有些是return=c,那么t就改成c,成为{$c.name}
两级循环显示栏目(先循环父栏目,再循环其子栏目)如果有三级栏目,以此类推
{category module=news pid=0 return=c1} 我是父栏目:{$c1.name}
{category module=news pid=$c1.id return=c2} 我是{$c1.name}的子栏目:{$c2.name}
{/category} {/category}
查询news模块中的属性配置
{category module=news more=1} 栏目名称{$t.name} 栏目属性seo标题{$t['setting']['seo']['list_title']} 栏目属性seo关键词{$t['setting']['seo']['list_keywords']} 栏目属性seo描述词{$t['setting']['seo']['list_description']} {/category} 这里的【$t.**】t是由return参数值来决定的,比如有些是return=c,那么t就改成c,成为{$c.name}