PbootCMS内容列表标签怎么用
在PbootCMS中,可以通过特定的标签来调用指定栏目的内容列表。这些标签适用于全站任意位置,并且可以灵活地控制内容的显示方式。以下是详细的使用方法和示例:
1. 当前栏目内容列表
{pboot:list} <a href="[list:link]">[list:title]</a> {/pboot:list}
注意事项:
- 只能在列表页面使用。
- 带分页功能,同一个页面只能使用一次,否则会导致分页冲突。
- 排序方式:从V1.2.2版本开始,默认情况下置顶、推荐、头条具有优先显示。可以使用自定义排序模式,如:
order='date desc,id desc'
表示按照时间倒序,然后按照ID倒序。
控制参数:
num=*
:每页数量,非必填,用于控制分页大小。order=*
:排序方式,非必填,用于输出内容的排序方式,可选:date
、sorting
、istop
、isrecommend
、isheadline
、visits
、likes
、oppose
等字段。支持自定义模式,如:order='date desc,id desc'
或order='sorting desc,id desc'
。从V1.3.7+版本开始还支持random
随机排序。filter=*|x,y
:数据过滤,非必填,用于对列表内容进行过滤筛选,如:filter=title|ASP,PHP
只显示标题含有ASP和PHP的内容。如果需要只显示推荐内容,可以使用:filter=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+),非必填,用于需要从第几条开始。
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] | 标题颜色 |
[list:subtitle] | 副标题 |
[list:tags] | 直接输出tags |
[list:author] | 作者 |
[list:source] | 来源 |
[list:link] | 链接 |
[list:outlink] | 外部链接 |
[list:date] | 发布日期 |
[list:ico] | 缩略图,不存在时自动调用文章第一张图 |
[list:pics] | 多图(V2.0.2新增) |
[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_***] | 调取扩展字段内容 |
示例应用
假设你需要在一个列表页面中调用当前栏目的内容列表,并进行排序和过滤,可以使用如下示例:
<!-- 调用当前栏目的内容列表 --> {pboot:list num="10" order="date desc" isrecommend="1"} <div class="article-item"> <h2><a href="[list:link]">[list:title]</a></h2> <p>作者:[list:author] 来源:[list:source]</p> <p>发布时间:[list:date]</p> <p>描述:[list:description]</p> <img src="[list:ico]" alt="[list:title]" /> </div> {/pboot:list}
通过以上示例,你可以灵活地控制内容列表的显示方式,并根据实际需求进行排序和过滤。