== 文章列表 ==
获取任意栏目下的文章列表
{:list="news",page=false,pagebtn=2,mod=0,bcat=0,scat="",lcat="",star=0,size=0,order="time_add desc",none="暂无记录"}...循环...{:end}
list="news" 可选,为空则是自动获取当前栏目,栏目唯一标识,标识设置为 special,则为列出专题下的文章
page=false 可选,是否分页模式,默认为true,如果不是用于分页仅仅用于短列表,请加上page=false,否则以分页形式加载,如果是在首页则page=false,其它值无效
pagebtn=2 可选,默认2,控制分页按钮数,按钮数=pagebtn*2+1(4.2.6++)
mod=0 可选,默认0输出用于循环的数组,1~5表示直接输出内置的列表样式(4.2.6++)
bcat=0 可选,栏目ID,不支持多个,page=true时的默认值为tcz['bcat']
scat="" 可选,一级类ID,支持多个,用英文逗号分隔,page=true时的默认值为tcz['scat']
lcat="" 可选,二级类ID,支持多个,用英文逗号分隔,page=true时的默认值为tcz['lcat']
star=0 可选,是否星标文章,默认star=0不限,star=9表示列出所有星标文章,当值在1~5时,表示列出对应星标等级的文章,此功能通常用于显示推荐文章
size=0 可选,列表数量,page=false时默认值为不限,page=true时的默认值为后台“栏目模块”中设置的“每页列表数”
order="time_add desc" 可选,排序方式,默认为自动排序
none="暂无记录" 可选,默认不提示,没有记录时显示的信息
示例一(内置样式,分页列表):
{:list="news",mod=1,size=10}
示例二(自定义样式,分页列表):
{list="news",size=10} <a href="{:link="article",mod="url"}">{:val="title"}</a> 时间:{:val="time_add"} 人气:{:val="hits"} 评论:{:val="comment"} {:end}
以上样式,同一页面中加上 {list.page} 显示分页链接,{:list.record} 表示记录总数,{list.menu} 表示当前列表所在栏目的所有分类
如果不是分页列表,仅仅输出指定数量的记录:
{:list="news",page=false,mod=1,size=10}
相比之下,仅仅是多了一个page=false,建议如果不是分页的话,一定要加上page=false,才不至于冲突出错,同时也可以提高系统运行效果
关于列表循环中文章链接标签
{:link="article",mod="full",extlink=true}
link="article" 必需,固定值
mod="full" 可选,默认full,参数有full(完整链接包含标题)、url(仅链接)、color(后台设定的色彩代码)
extlink=true 可选,是否启用外部链接,默认true,参数有true、false