我们在用finecms建站时经常会用到调用文章列表的功能,这时我们可以用万能标签list来实现,当然还可以调用其他一些数据,下面我们就来看看list函数的相关参数和使用方法
action 支持"推荐位(position)"、"搜索关键字(keywords)"、"相关文章(relation)"模式,普通数据查询不需要此参数
table 循环表名称,默认为内容表,可以用其他表,插件表格式为:插件名称.表名称(link.linkname)
catid 当前栏目ID号
num 显示数量,还可以写成"num=1,5"相当于limit 1,5
return 返回数组名称,用于循环,默认值为't',调用方式:{$t['title']}
more 值为1时,自动调用内容表的附表内容(也就是自定义的字段)
order 排序,例如: order=id_desc,userid_desc,默认desc排序,可以省掉_desc
join 联合查询表名称(用该表的主键关联),例如:join=member
on 其他表的字段(非join表的自段),必须与join成对出现,否则join失效,例如:join=member on=userid
page 用于分页查询,如果出现了num参数,分页查询将会失效
urlrule 分页URL格式(分页标识符_page_或者[page]),例如:urlrule=$catid-[page].html
pagesize 分页查询每页显示的记录数量(如果出现catid,系统默认会使用该栏目的分页数量)
cache 数据缓存,单位秒,在这缓存时间内调用缓存文件而不再去访问数据库
thumb 值等于1的时候,显示有缩略图的文档;等于0的时候,显示无缩略图的文档(v1.7)
form 调用表单,例如:form=liuyan ,就是调用liuyan的表单数据(v1.7.5)
site 站点id,用于多站点调用,例如: site=2 table=content ,就是调用站点2的内容表(v1.7.5)
fields 为sql语句指定字段,例如: fields=title,url ,与sql语法一致(不能使用`),支持自定义字段名称(v1.7.5)
extend 对特殊sql语句进行延展
使用方法
格式: {list 参数1=值1 参数2=值2 ... 参数N=值N} ... 循环体 ... {/list}
注意:参数和值不能出现引号