内容列表标签
内容列表标签用于循环输出文章列表,读取 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]
