一、语法

{list action=category module=模块名称 ....}{/list}

简写(3.2.19以上版本支持):{category module=模块名称 ....}{/category}


二、参数介绍(红色表示必填参数,蓝色表示系统默认参数)

参数
介绍
action
category
module
模块名称,默认当前模块(仅在模块模板中有效),例如新闻模块,填写news
site
站点id,默认当前站点,填写其他站点id表示查询其他站点的模块数据
id
栏目id,支持多个栏目以小写分号分开,例如1,2,3,4
show有show参数表示显示隐藏导航(无论show=几都有效)
pid当前id下的所有下级栏目,pid只能是一个整数,当期为0时表示顶级栏目
num
表示显示数量,只能是一个整数
letter首字母匹配的栏目
more当more=1时,才显示栏目的setting内容和自定义扩展属性内容
return
默认返回变量为t,调用方式就是{$t.字段值}(多级list查询必须设置return=其他字母,否则你懂得)


三、返回变量

变量
参数
{$error}
当查询不到数据时,会返回错误信息,调试模板时很有用哦(写在list标签以外)
{$count}当前查询的记录,当存在分页时,表示当前页的记录数(写在list标签以外)
{$key}
当前记录指针位置,从0开始(写在list标签以内)
当存在return=字母时,以上变量都要写成这种格式{$变量_字母},例如{list ...reutrn=a}时,变量格式{$key_a}
{$is_first}判断是否第一条,{if $is_first}第一条{/if}
{$is_last}判断是否最后一条,{if $is_last}最后一条{/if}


四、显示字段

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

其他字段请参看后台“数据结构”中单击相应的表就知道了,字段有说明的


五、相关例子

1、查询新闻news模块的所有顶级栏目

{list action=category module=news pid=0}
栏目名称{$t.name}
栏目地址{$t.url}
{/list}


2、查询当期模块的指定id为1,2,3,4的栏目

{list action=category module=news id=1,2,3,4}
栏目名称{$t.name}
栏目地址{$t.url}
{/list}


3、两级循环显示栏目(先循环父栏目,再循环其子栏目)

{list action=category pid=0 return=c1}
    我是父栏目:{$c1.name}<br>
    {list action=category pid=$c1.id return=c2}
        我是{$c1.name}的子栏目:{$c2.name}<br>
    {/list}
{/list}

如果有三级栏目,以此类推,不再举例了,我相信你的能力


4、查询news模块中的以a字母开头的栏目

{list action=category module=news letter=a}
栏目名称{$t.name}
栏目地址{$t.url}
{/list}

5、查询news模块中的属性配置

{list action=category module=news more=1}
栏目名称{$t.name}
栏目属性seo标题{$t['setting']['seo']['list_keywords']}
{/list}


文档最后更新时间:2018-09-29 12:29:17