一、作用
用于共享模块的栏目列表循环查询
二、语法
{category module=share ....}
{/category}三、参数介绍
| 参数 | 介绍 |
|---|---|
| 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}
视频教程：循环多级栏目
文档最后更新时间：2022-11-10 02:55:24