易优cms artlist 文章列表调用标签使用方法

artlist 文档列表(配合arcpagelist标签可实现ajax瀑布流分页)

[基础用法]

标签：artlist

描述：获取网站栏目（如：文章、产品、图集、软件等）的一些文章。

用法：

{eyou:artlist typeid='栏目ID' limit='0,10' flag='c' titlelen='30' infolen='160' orderby='add_time'}

<a href='{$field.arcurl}'>{$field.title}</a>

{/eyou:artlist}

属性：

typeid='' 栏目ID,在列表模板和内容页模板中一般不需要指定，在首页模板中允许用","分开调用多个栏目文章，但必须是同一个模型下的多个栏目ID，比如：文章模型、产品模型、图集模型等，注：指定的栏目是不包含子栏目内的文章的；

notypeid='' 同typeid，但这里是表示不包含这些属性，与typeid不能同时存在；

tagid='' 在所有的artlist标签中是唯一不可重复，对应arcpagelist标签的tagid名称，与arcpagelist配合使用可实现ajax瀑布流分页；

loop='10' 返回文档列表总数（建议不要与limit属性同时存在，否则loop无效）

limit='起始ID,记录数' （起始ID从0开始）表示限定的记录范围（如：limit='1,3' 表示在3条记录中，排除前面1条，也就是只取得剩余的后面所有记录）

aid='' 指定单个文档ID

idlist='' 指定多个文档ID，以逗号分隔开

idrange='' 筛选aid范围，如idrange='1-3'  aid在1-3区间的数据（aid等于1,2,3）

titlelen='30' 标题长度

infolen='160' 表示内容简介长度

addfields='' 自定义字段名，多个字段之间用英文逗号隔开，比如：addfields='price,spce'

orderby='new' 文档排序方式

----orderby='hot' 或 orderby='click' 表示按点击数从高到低排序

----orderby='add_time' 按发布时间最新排序

----orderby='update_time' 按更新时间最新排序

----orderby='aid' 按ID从大到小排序

----orderby='sort_order' 按排序号从大到小排序

----orderby='rand' 随机排序，对性能有一定影响，不推荐使用

----orderby='is_recom desc, sort_order asc' 自定义多字段组合排序

ordermode='desc' 排序类型：desc表示从大到小，asc表示从小到大

modelid='' 频道ID，优先级高于栏目ID，仅次于文档ID

keyword='' 含有指定关键字的文档列表，多个关键字用","分

flag='t,c' 自定义属性值：推荐[c]跳转[j]

noflag='' 同flag，但这里是表示不包含这些属性

empty='' 没有数据时显示的文案

mod='' 每隔N行输出的内容

thumb='on' 默认使用缩略图，on为开启，off为关闭

arcrank='on' 默认不展示阅读权限，on为开启，off为关闭，示例在下方

id='' 可以任意指定循环里的变量名替代field，假设id='field1'，模板调用如：{$field.title} 变成 {$field1.title}

注：如果是标签内套标签，请重新定义id，以防变量名重复，获取的内容受影响

模板调用如：

{eyou:artlist typeid='栏目ID'  id='field' }

<li>

<div class="title"><a href="{$field.arcurl}" title="{$field.title}">{$field.title}</a></div>

{eyou:tag sort='now' getall='0' loop='100'   id='field1' }

<div class="tags"><a href='{$field1.link}'>{$field1.tag}</a></div>

{/eyou:tag}

</li>

{/eyou:artlist}

涉及表字段：

请查阅易优cms官方提供的数据字典，找到表名 ey_archives

-------------------------------效果展示--------------------------------

1，调用指定栏目文章

模板调用代码

{eyou:artlist typeid='2' loop='5' titlelen='30' }

<li><a href="{$field.arcurl}" title="{$field.title}">{$field.title}</a></li>

{/eyou:artlist}

网站前端显示效果（css样式请自行填充）

【更多示例】

-------------------------------示例1--------------------------------

描述：每隔3条输出文档记录

{eyou:artlist typeid='栏目ID' limit='0,10' mod='3'}

{eyou:eq name='mod' value='0'}

<a href='{$field.arcurl}'>{$field.title}</a>

{/eyou:eq}

{/eyou:artlist}

-------------------------------示例2--------------------------------

描述：mod属性还用于控制一定记录样式，每隔3条增加样式，比如：3、6、9……

{eyou:artlist 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:artlist}

-------------------------------示例3--------------------------------

描述：内置变量输出数据索引与记录顺序，key 表示索引，默认从0开始；i 表示顺序，默认从1开始。

{eyou:artlist typeid='栏目ID' limit='0,5'}

{$key} - {$i}

{/eyou:artlist}

效果：

0 - 1

1 - 2

2 - 3

3 - 4

4 - 5

-------------------------------示例4--------------------------------

描述：没有记录时输出文案提示，属性empty支持直接传入html语法（html里只支持双引号，禁止单引号）

{eyou:artlist typeid='栏目ID' limit='0,10' empty='暂时没有数据'}

<a href='{$field.arcurl}'>{$field.title}</a>

{/eyou:artlist}

-------------------------------示例5--------------------------------

描述：自定义变量名

{eyou:artlist typeid='栏目ID' limit='0,10' id='field2'}

<a href='{$field2.arcurl}'>{$field2.title}</a>

{/eyou:artlist}

typeid='' 栏目ID,在列表模板和内容页模板中一般不需要指定，在首页模板中允许用","分开表示多个栏目，但必须是同一个模型下的多个栏目ID，比如：文章模型、产品模型、图集模型等；

-------------------------------示例6--------------------------------

描述：列表显示阅读权限的会员等级值和会员等级名称

{eyou:artlist typeid='栏目ID' limit='0,10' id='field'}

会员等级名称：{$field.level_name}

会员等级值：{$field.level_value}

{/eyou:artlist}