PbootCMS内容列表标签怎么用

COS、CDN

在PbootCMS中,可以通过特定的标签来调用指定栏目的内容列表。这些标签适用于全站任意位置,并且可以灵活地控制内容的显示方式。以下是详细的使用方法和示例:

1. 当前栏目内容列表

{pboot:list} <a href="[list:link]">[list:title]</a> {/pboot:list}
 注意事项
  • 只能在列表页面使用。
  • 带分页功能,同一个页面只能使用一次,否则会导致分页冲突。
  • 排序方式:从V1.2.2版本开始,默认情况下置顶、推荐、头条具有优先显示。可以使用自定义排序模式,如:order='date desc,id desc' 表示按照时间倒序,然后按照ID倒序。

控制参数

  • num=*:每页数量,非必填,用于控制分页大小。
  • order=*:排序方式,非必填,用于输出内容的排序方式,可选:datesortingistopisrecommendisheadlinevisitslikesoppose 等字段。支持自定义模式,如: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] &nbsp; 来源:[list:source]</p>     <p>发布时间:[list:date]</p>     <p>描述:[list:description]</p>     <img src="[list:ico]" alt="[list:title]" />   </div> {/pboot:list}

通过以上示例,你可以灵活地控制内容列表的显示方式,并根据实际需求进行排序和过滤。

COS、CDN
热门