首页/开发手册/内容列表标签

开发手册

SoeayCMS 安装、标签使用与二次开发完整指南

内容列表标签

内容列表标签用于循环输出文章列表,读取 soeay_content 表数据。

基本语法

{soeay:list scode=2 num=10 order=date dir=desc}
    <a href="[soeay:link]">[soeay:title]</a>
{/soeay:list}

参数说明

参数说明
scode栏目编码,支持逗号分隔
num显示数量,默认10
order排序字段:id/date/visits/sorting/istop/isrecommend,各字段含义与默认方向见下方「排序规则」
dir排序方向:asc 升序 / desc 降序;省略时 sorting 默认 asc(排序号小的在前),其余字段默认 desc
isrecommend只显示推荐内容
isheadline只显示头条内容

排序规则

通过 order 指定排序字段、dir 指定排序方向。置顶内容(istop=1)无论按哪个字段排序都始终排在最前;当排序值相同时,按内容 ID 倒序排列(后录入的在前)。

order 取值排序依据省略 dir 时的默认方向
date按发布时间排序,即后台「内容编辑 → 高级选项 → 发布时间」中可手动修改的日期时间(不是系统录入时间 create_time);desc 时最新发布的在前desc
sorting按后台设置的排序号排序,数字越小越靠前,用于人工固定栏目内的展示顺序asc
id按内容 ID 排序,ID 越大表示录入越晚desc
visits按浏览量(人气)排序,浏览量高的在前desc
istop按置顶状态排序(置顶内容始终享有最高优先级)desc
isrecommend按推荐状态排序,推荐内容在前desc
{soeay:list scode=2 num=10 order=date}            按发布时间从新到旧(最常用)
{soeay:list scode=2 num=10 order=sorting}         按后台排序号从小到大
{soeay:list scode=2 num=10 order=visits dir=asc}  按浏览量从低到高

提示:需要按发布时间排序时使用 order=date;在后台调整某篇内容「高级选项」中的发布时间后,前台列表顺序会随之改变。

循环变量

[soeay:i] / [soeay:num]   序号
[soeay:id]                 内容ID
[soeay:title]              标题
[soeay:subtitle]           副标题
[soeay:ico]                缩略图(支持 width/height 缩略图参数)
[soeay:date] / [soeay:time]   发布日期(可加 style=Y-m-d 格式化)
[soeay:visits]             浏览量
[soeay:author]             作者
[soeay:source]             来源
[soeay:link] / [soeay:url] 详情页链接
[soeay:filename]           自定义URL名
[soeay:sort_name]          所属栏目名称

高级参数

参数说明
subscode副栏目编码,支持逗号分隔。用于筛选被指定为某栏目副栏目的内容。
lfield限制查询字段,逗号分隔,如 lfield=title,ico,date。可减少数据库查询量,提升性能。
{soeay:list scode=2 subscode=5 num=5 lfield=title,ico,date}
    <a href="[soeay:link]">
        <img src="[soeay:ico]" alt="[soeay:title]">
        <span>[soeay:title len=20]</span>
    </a>
{/soeay:list}

日期格式化

[soeay:date style=Y-m-d]
[soeay:date style=Y.m.d]