菜单导航

内容列表

最近更新:2026-11-18 | 阅读量:11

内容列表标签

适用范围:指定栏目编码时全站可用,适用当前列表

标签作用:用于调取指定栏目的内容列表或自动当前列表

1、当前栏目内容列表


{pboot:list}

<a href= "[list:link]">[list:title]</a>

{/pboot:list}

只能在列表页面使用,带分页,同一个页面只能使用一次带分页的列表,否则会直接报错。


V1.2.2版本开始order排序进行调整,默认情况下置顶、推荐、头条具有优先显示,包括使用date、sorting、visits、likes、oppose时,那么如果要想按照自己的设置来可以使用自定义模式,可以自己任意组合:如order='date desc,id desc' 此时意味着将按照时间倒序,然后添加顺序倒序。如order='sorting desc,id desc' 将先按照后台排序,然后按照id倒序。更多情况自己参照例子定义即可。

控制参数:

num=* 每页数量,非必填,用于控制分页大小

order=* 排序方式,非必填,用于输出内容的排序方式,可选:date、sorting、istop、isrecommend、isheadline、visits、likes、oppose、等字段,其中sorting为按后台填写的排序,122版本开始支持自定义模式,如:order='date desc,id desc' 、order='sorting desc,id desc',(V1.3.7+)还支持random随机排序

filter=*|x,y 数据过滤,非必填。字段仅限 title、istop、isrecommend、isheadline 以及扩展字段 ext_*;默认精确匹配,多值(逗号分隔)为 OR;模糊匹配需另加 fuzzy=1。示例:filter=title|ASP,PHP;只显示推荐:filter=isrecommend|1(V1.2.0+更推荐用下面的 isrecommend=1 方式)

isico=*、ispics=*、istop=*、isrecommend=*、isheadline=* 用于对数据进行特殊筛选,可选值1和0,非必填,比如只调取推荐内容:isrecommend=1

tags=x,y tags方式数据过滤,非必填,用于对列表内容进行过滤筛选,如:tags='ASP,PHP',则为含有asp或php标签的内容,那么可以用 tags={content:tags}来调用当前文章的相关文章

start=* 起始数据(V1.3.2+),非必填,用于需要从第几条开始

lfield=* :lfield 会替换默认查询字段,系统仅自动附加 id,outlink,type,scode,sortfilename,filename,urlname。须列出模板要用的全部字段;勿只写 lfield='titlecolor' 这类单字段,否则 title/date 等不再查询、标签会残留。默认查询不含 tags/titlecolor/source,可用 lfield='*'(等价 a.*,已含这三项),若还要用栏目名等再追加 sortname 等关联字段,例如 lfield='*,sortname'


2、指定栏目内容列表


{pboot:list scode=*}

<a href= "[list:link]">[list:title]</a>

{/pboot:list}

可以全站使用,多个栏目编码使用逗号隔开,如果使用星号,意味全部栏目。指定栏目内容列表默认不分页,当然你还是可以通过page参数控制强制分页,但要注意不可在同一页面使用多个带分页的列表。


如果要使用本循环标签调用当前内容列表,可以使用scode={sort:scode},同时也避免了同一个页面多次调用当前栏目内容时分页冲突问题。


控制参数:

scode=* 栏目编码,必填,用于指定需要调取的栏目编码,读取的内容会同时包含该栏目下子菜单的内容,支持多个栏目如:1,2,3

page=* 是否分页,非必填,用于列表是否执行分页,可设置1或0,本功能适合首页分页等场景

start=* 起始数据(V1.3.2+),非必填,用于需要从第几条开始

其余控制参数同上面当前栏目内容列表


3、可使用的列表标签


[list:n]计数0开始
[list:i]计数1开始
[list:id]编号
[list:scode]栏目编码
[list:subscode]副栏目编码
[list:sortname]栏目名称
[list:subsortname]副栏目名称
[list:sortlink]栏目链接
[list:subsortlink]副栏目链接
[list:title]标题
[list:titlecolor]标题颜色(默认不查;须经 lfield 纳入,可用 lfield='*' 或显式列出全部所需字段,勿只写单字段)
[list:subtitle]副标题
[list:tags]直接输出tags(默认不查;须经 lfield 纳入,用法同上)
[list:author]作者
[list:source]来源(默认不查;须经 lfield 纳入,用法同上)
[list:link]链接
[list:outlink]外部链接
[list:date]发布日期
[list:ico]缩略图,不存在时自动调用文章第一张图,[list:isico]可用于判断,返回1或0
[list:pics]多图,V2.0.2新增[list:ispics]可用于判断,返回1或0
[list:content]内容
[list:enclosure]附件
[list:enclosuresize]附件大小
[list:keywords]关键词
[list:description]描述
[list:istop]是否置顶
[list:isrecommend]是否推荐
[list:isheadline]是否头条
[list:visits]访问数量
[list:likes]点赞数量
[list:oppose]反对数量
[list:likeslink]点赞链接
[list:opposelink]反对链接
[list:ext_***]调取扩展字段内容


常见问题

关于《内容列表》的 FAQ

《内容列表》这篇手册主要讲了什么?

本文介绍PBootCMS内容列表标签的适用范围与调用方法。该标签可用于调取指定栏目的内容列表或自动输出当前列表,支持当前栏目列表和指定栏目列表两种方式,并说明分页使用限制。文章还讲解数量排序过滤筛选起始数据及查询字段等控制参数,同时列出标题链接日期缩略图内容访问量等常用列表标签,帮助开发者灵活调用内容数据并提升模板制作效率。

按照《内容列表》操作遇到代码或报错问题怎么办?

请优先核对代码或配置参数是否完全一致。如果是环境差异或权限问题,建议查阅本站的“常见问题排查”板块,或直接联系我们的技术支持获取协助。

开发手册里的代码可以直接复制到我的 PbootCMS 网站使用吗?

可以直接使用。手册中的代码均经过实际测试。复制使用时,请注意将代码中的文章 ID、栏目编码(scode)等占位符,替换为您自己网站的真实数据即可。