arclist 文档列表(不适用于分页列表)
 
[基础用法]
名称:arclist
功能:获取系统主从表模型(如:文章、软件、图集、产品等)的一列文档,也称自由列表块标记。
语法:
{eyou:arclist typeid='栏目ID' limit='0,10' flag='c' titlelen='30' infolen='160' orderby='rand'}
<a href='{$field.arcurl}'>{$field.title}</a>
{/eyou:arclist}
参数:
typeid='' 栏目ID,在列表模板和内容页模板中一般不需要指定,在首页模板中允许用","分开表示多个栏目,但必须是同一个模型下的多个栏目ID,比如:文章模型、产品模型、图集模型等;
notypeid='' 同typeid,但这里是表示不包含这些属性,与typeid不能同时存在;
row='10' 返回文档列表总数(建议不要与limit属性同时存在,否则row无效)
limit='起始ID,记录数' (起始ID从0开始)表示限定的记录范围(如:limit='1,2' 表示从ID为1的记录开始,取2条记录)
titlelen='30' 标题长度
infolen='160' 表示内容简介长度
addfields='' 自定义字段名,多个字段之间用英文逗号隔开,比如:addfields='price,spce'
orderby='now' 文档排序方式
  • orderby='hot' 或 orderby='click' 表示按点击数从高到低排序
  • orderby='now' 按发布时间最新排序
  • orderby='sort_order' 按排序号从小到大排序
  • orderby='rand' 随机排序
  • orderby='is_recom desc, sort_order asc' 自定义多字段组合排序
channelid='' 频道ID,优先级高于栏目ID,仅次于文档ID
flag='t,c' 自定义属性值:推荐[c]跳转[j]
noflag='' 同flag,但这里是表示不包含这些属性
empty='' 没有数据时显示的文案
mod='' 每隔N行输出的内容
id='' 可以任意指定循环里的变量名替代field,假设id='field1',模板调用如:{$field.title} 变成 {$field1.title}
底层字段:
请查阅易优Cms官方提供的数据字典,找到表名 ey_archives

-------------------------------效果展示--------------------------------
1,调用指定栏目文章
模板调用代码
{eyou:arclist typeid='2' row='5' titlelen='30' }
<li><a href="{$field.arcurl}" title="{$field.title}">{$field.title}</a></li>
{/eyou:arclist}
网站前端显示效果(css样式请自行填充)

 
 
【更多示例】
-------------------------------示例1--------------------------------
描述:每隔3条输出文档记录
{eyou:arclist typeid='文档ID' limit='0,10' mod='3'}
{eyou:eq name='mod' value='0'}
<a href='{$field.arcurl}'>{$field.title}</a>
{/eyou:eq}
{/eyou:arclist}
-------------------------------示例2--------------------------------
描述:mod属性还用于控制一定记录样式,每隔3条增加样式,比如:3、6、9……
{eyou:arclist typeid='文档ID' limit='0,10' mod='3'}
<li {eyou:eq name='mod' value='0'}class="样式名"{/eyou:eq}>
  <a href='{$field.arcurl}'>{$field.title}</a>
</li>
{/eyou:arclist}
-------------------------------示例3--------------------------------
描述:内置变量输出数据索引与记录顺序,key 表示索引,默认从0开始;i 表示顺序,默认从1开始。
{eyou:arclist typeid='文档ID' limit='0,5'}
{$key} - {$i}
{/eyou:arclist}
效果:
0 - 1
1 - 2
2 - 3
3 - 4
4 - 5
-------------------------------示例4--------------------------------
描述:没有记录时输出文案提示,属性empty支持直接传入html语法(html里只支持双引号,禁止单引号)
{eyou:arclist typeid='文档ID' limit='0,10' empty='暂时没有数据'}
<a href='{$field.arcurl}'>{$field.title}</a>
{/eyou:arclist}
-------------------------------示例5--------------------------------
描述:自定义变量名
{eyou:arclist typeid='文档ID' limit='0,10' id='field2'}
<a href='{$field2.arcurl}'>{$field2.title}</a>
{/eyou:arclist}
typeid='' 栏目ID,在列表模板和内容页模板中一般不需要指定,在首页模板中允许用","分开表示多个栏目,但必须是同一个模型下的多个栏目ID,比如:文章模型、产品模型、图集模型等;