电话
13363039260
一、作用
用于共享模块的栏目列表循环查询
二、语法
三、参数介绍
参数 | 介绍 |
---|---|
module | share 固定参数 |
site | 站点id,默认为当前站点 |
id | 指定栏目id查询,多个id以,号分开,例如:1,2,3,4,5 |
pid | 指定父级栏目id号 |
order | 排序参数 |
ismain | 开发中,1表示只显示主栏目 |
show | show=1表示显示全部栏目(包括隐藏的栏目),show=0或者不填时就不显示被隐藏的栏目 |
more | more=1栏目的全部字段,否则显示基础字段 |
num | 表示显示数量,支持定点查询,例如1,2表示从第1条记录开始,共显示2条数据 |
cache | 缓存时间单位秒,默认关闭缓存;当cache=3600时,表示缓存时间1小时 |
return | 默认返回变量为t,调用方式就是{$t.字段值}(多级查询必须设置return=其他字母,只能作为最后一个参数使用) |
由于此标签采用缓存数据,不支持自定义字段作为查询条件
四、返回变量
变量 | 参数 |
---|---|
{$debug} | 显示当前查询的sql语句,调试模板时候很有用哦(写在标签以外) |
{$key} | 当前记录指针位置,从0开始(写在标签以内) |
{$return} | 当前查询的结果集数组 |
当存在return=字母时,以上变量都要写成这种格式{$变量_字母},例如{list ...reutrn=a}时,变量格式{$key_a} | |
{$is_first} | 判断是否第一条,{if $is_first}第一条{/if} |
{$is_last} | 判断是否最后一条,{if $is_last}最后一条{/if} |
五、显示字段
在线生成显示字段:https://www.xunruicms.com/doc/code/field.html--t
六、相关例子
查询共享栏目的所有顶级栏目
{category module=share pid=0}
栏目名称{$t.name}
栏目地址{$t.url}
缩略图 {dr_thumb($t.thumb)}
栏目内容{$t.content}
{/category}
这里的【$t.**】t是由return参数值来决定的,比如有些是return=c,那么t就改成c,成为{$c.name}
查询共享栏目的指定id为1,2,3,4的栏目
{category module=share id=1,2,3,4}
栏目名称{$t.name}
栏目地址{$t.url}
{/category}
这里的【$t.**】t是由return参数值来决定的,比如有些是return=c,那么t就改成c,成为{$c.name}
两级循环显示栏目(先循环父栏目,再循环其子栏目)如果有三级栏目,以此类推
{category module=share pid=0 return=c1}
我是父栏目:{$c1.name}
{if $c1.child}
存在子栏目
{category module=share pid=$c1.id return=c2}
我是{$c1.name}的子栏目:{$c2.name}
{/category}
{/if}
{/category}
内容栏目封面模板category.html 调用指定栏目下的所有子栏目
{dr_catpos($catid, '', true, '[name] ')} 获取本栏目封面的名字和链接
pid=指定栏目的id
{category module=share pid=3 return=c1}
{$c1.name}
{/category}
最终效果
查询共享栏目中的属性配置
{category module=share 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}
判断此栏目是否是外链栏目
{category module=share}
栏目名称{$t.name}
{if $t.tid==2}
外链栏目
{/if}
{if $t.tid==1}
内容模块栏目
{/if}
{if $t.tid==0}
单页栏目
{/if}
{/category}
这里的【$t.**】t是由return参数值来决定的,比如有些是return=c,那么t就改成c,成为{$c.name}