编辑“YulinCMS ContList标签说明”

<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[YulinCMS|上一页]]</span>
<div style="clear:both;"></div>
==功能说明==
用于调用内容列表

==适用范围==
所有模板

==语法格式== 	
<pre>
 {Yu:ContList 属性1="属性值1" 属性2="属性值2"......}
 {NormalTemplate} 普通项模板 + 底层变量......{/NormalTemplate}   // 普通项模板元素
 {AlterTemplate} 交替项模板 + 底层变量......{/AlterTemplate}   // 交替项模板元素（可选）
 {SeparTemplate} 分隔符模板......{/SeparTemplate}   // 分隔符模板元素（可选）
 {ConditionTemplate} 条件输出模板......{/ConditionTemplate}   // 条件输出模板元素（可选）
 {/Yu:ContList}
</pre>

==模版元素 ==
*'''NormalTemplate '''	在内容列表中的每一行都呈现一次的[[模板]]元素。
*'''AlterTemplate '''	与 NormalTemplate 元素类似，但在内容列表中隔行（交替项）呈现一次。通过设置 AlterTemplate 元素的内容，可以为其指定不同的外观。
*'''SeparTemplate''' 	将呈现在内容列表行之间。如果不设置，则不呈现分隔符内容。
*'''ConditionTemplate '''当专题数量达到 num 的倍数时，输出该模板元素的内容（num 为标签属性 Condition 指定的数字值）
'''备注：'''如果没有使用任何模板元素，则标签中的内容被默认为 NormalTemplate 普通项模板的内容

==标签属性==	
*'''ListType '''内容列表的类型
属性值可以是如下
#'''Normal '''普通内容列表，用于所有模板。
#'''Category '''栏目页内容列表，仅用于栏目页，可实现分页，使用Count属性来指定分页大小。
#'''Relation '''相关内容列表，仅用于内容页模板。
#'''SpecRegion '''专题区域页内容列表，仅用于专题区域页模板。可实现分页，使用Count属性来指定分页大小。
#'''SearchResult '''高级搜索结果页内容列表，仅用于搜索结果页。

不指定该属性，则默认为 Normal 普通内容列表。

*'''Count'''调用内容数量
不指定该参数，则默认调用10篇内容。

当属性 ListType = "Category" 或 "SpecRegion" 时该参数用来指定内容列表的分页大小

*'''Cate''' 调用指定栏目下的内容
属性值可以是
#'''Current '''调用当前栏目的内容（仅用于 栏目页、内容页）
#'''Rand '''调用任意一个栏目下的内容
#'''Id '''调用外层列表标签指定的栏目下的内容

调用指定栏目的内容 例如：Cate="13"

调用多个指定栏目的内容 例如 Cate="2|5|13"

不指定该属性则默认调用所有栏目的内容

当 ListType = "Category" 时该参数无效。

*'''IsChildCate 是否调用所有子栏目内容
属性值为 True(是) 或 False(否) 默认为 True

当 ListType = "Category" 时该参数无效。

*'''Class '''调用指定栏目分类下的内容
属性值可以是
#'''Current''' 调用当前栏目分类的内容（仅用于 栏目页、内容页）
#'''Rand '''调用任意一个栏目分类下的内容

调用指定栏目分类的内容 例如：Class="13"

调用多个指定栏目分类的内容 例如 Class="2|5|13"

不指定该属性则忽略该条件

当 ListType = "Category" 时该参数无效。

*'''CateGroup''' 栏目组别
属性值可以是

'''Rand '''调用任意一个栏目组别下的内容

调用指定栏目组的内容 例如：CateGroup = "1"

调用多个指定栏目组的内容 例如 CateGroup = "2|3|5"

如设置此属性，则只显示栏目组别等于 CateGroup 的内容列表。不指定该属性则忽略该条件

当 ListType = "Category" 时该参数无效。

*'''CateGroupNot''' 非栏目组别
属性值可以是

'''Rand '''调用除任意一个栏目组外的栏目下的内容

调用除指定栏目组外的栏目 例如：CateGroupNot = "1"

如设置此属性，则只显示栏目组不等于 CateGroupNot 的栏目列表。不指定该属性则忽略该条件

当 ListType = "Category" 时该参数无效。

*'''ContGroup'''内容组别
调用指定内容组别的内容 例如：ContGroup = "1"

调用多个指定内容组的内容 例如 ContGroup = "2|3|5"

如设置此属性，则只显示内容组别等于 ContGroup 的内容列表。不指定该属性则忽略该条件

*'''ContGroupNot'''非内容组别
调用除指定内容组别外的内容 例如：GroupNot = "1"

如设置此属性，则只显示内容组别不等于GroupNot的内容列表。不指定该属性则忽略该条件

*'''Where '''调用特定条件的内容
属性值如下所示
#'''SubTitle '''调用带副标题的内容
#'''TitlePicture''' 调用带标题图片的内容
#'''TitleFile '''调用带标题附件的内容
#'''TitleMedia''' 调用带标题媒体的内容
#'''Depict '''调用带摘要内容
#'''Outer '''调用指向外部链接的内容
#'''Top''' 调用已置顶内容
调用某种类型的内容。例如 Where = "TitlePicture" 调用带标题图片的内容

调用多种类型的内容。例如 Where = "TitlePicture|Depict" 调用带标题图片或着带摘要的内容

调用同时具有多种类型的内容.例如 Where = "TitlePicture&Depict" 调用同时带标题图片和摘要的内容

不指定参数则调用所有条件内容。

*'''Flag''' 调用特定标记的内容
属性值如下所示 (可自定义)
#'''Hot '''调用热点内容
#'''Recommend '''调用推荐内容
#'''Topline''' 调用头条内容
#'''Picture '''调用含图片的内容
#'''MultiPicture''' 调用含组图的内容
#'''File '''调用带附件的内容
#'''Flash '''调用带Flash的内容
#'''Audio '''调用带音频的内容
#'''Video '''调用带视频的内容
调用某种标记的内容。例如 Flag = "Picture" 调用含图片的内容

调用多种标记的内容。例如 Flag = "Hot|Picture" 调用热点内容或含图片内容

调用同时具有多种标记的内容.例如 Flag = "Hot&Picture" 调用同时具有热点和含图片的内容

不指定参数则忽略该条件

*'''Spec '''调用指定专题下的内容
属性值可以是
#'''Current''' 调用当前专题下的内容（仅用于 专题内容页、专题分区页）
#'''Id '''调用外层专题列表标签指定专题下的内容

调用指定专题的内容 例如：Spec = "13"

调用多个指定专题的内容 例如 Spec = "12|13|15"

不指定该属性则忽略该条件

*'''SpecRegion''' 调用指定专题区域下的内容
属性值可以是

'''Id''' 调用外层专题区域列表标签指定区域下的内容

调用指定专题区域的内容 例如：SpecRegion = "13"

调用多个指定专题的内容 例如 SpecRegion = "12|13|15"

不指定该属性则忽略该条件

当 ListType = "SpecRegion" 时该参数无效。

*'''Date '''调用指定日期的内容
属性值可以是
#'''Today''' 调用今天的内容
#'''ThisWeek '''调用本周的内容
#'''ThisMonth''' 调用本月的内容
#'''ThisYear '''调用本年的内容
#'''Yesterday '''调用昨天的内容
#'''LastWeek '''调用上周的内容
#'''LastMonth''' 调用上个月的内容
#'''LastYear '''调用去年的内容
也可以调用给定日期值的内容，例如

调用指定日期的内容 Date = "2007-6-13"

调用指定的多个日期的内容 Date = "2007-6-13|2007-6-19"

调用指定日期段的内容 Date = "2007-6-13>2007-6-19"

不指定该参数则默认调用所有日期内容

*'''LastDay '''调用最近几天的内容
例如：LastDay = "7" 只调用最近7天的内容

*'''Keyword''' 调用标题含有指定关键字的内容
给定一个关键字 调用满足条件的内容 例如: Keyword = "word1"

给定多个关键字 调用满足条件的内容 例如: Keyword = "word1|word2|word3" (满足任一关键字即调用)

给定多个关键字 调用满足条件的内容 例如: Keyword = "word1&word2&word3" (同时满足全部关键字才调用)

不指定该属性则忽略该条件

*'''Sort''' 内容排序规则
属性值可以是
#'''AddTime '''按录入时间排序
#'''ClickTotal '''按点击量排序
#'''CommTotal''' 按评论数排序
#'''FileDownTotal '''按标题附件下载数量排序
#'''UpTotal '''按顶数量排序
#'''DownTotal '''按踩数量排序
#'''Id '''按内容编号排序
#'''Rand '''随机排序，可随机获取指定条件的内容列表
不指定该属性默认以AddTime为排序规则

*'''Order''' 内容排序方式
属性值可以是
#'''ASC''' 递增排序
#'''DESC''' 递减排序

不指定该属性默认以DESC方式排序。

*'''Start'''调用内容时的起始位置，和Count配合使用
例如: {Yu:ContList Count="10" Start="30"}.......{/Yu:ContList}

上面例子正好调用了 从第30条 -- 第40条记录之间的 10条 记录

*'''Cols'''内容显示列数
例如： Cols = "2"

不指定该属性则默认列数为1

*'''TableStyle'''列表表格的样式，表示 <table 这里的内容>
此属性和 Cols 属性配合使用，只有Cols大于1时有效。
*'''TrStyle'''列表表格的行样式，表示 <tr 这里的内容>
此属性和 Cols 属性配合使用，只有Cols大于1时有效。
*'''TdStyle''' 列表表格的单元格样式,表示 <td 这里的内容>
此属性和 Cols 属性配合使用，只有Cols大于1时有效。

*'''Condition'''条件输出
例如 Condition = "num"

num为数字。内容数量达到 num 的倍数时，输出 ConditionTemplate 模板元素的内容。

*'''TitleLen'''内容标题的显示字符数量
不指定该属性则默认显示完整的标题

*'''TitleAddStr '''设置内容标题超出部分显示的省略字串
例如: TitleAddStr ="..."

不指定该属性则默认为不追加任何省略字串

*'''DepictLen'''内容摘要的显示字符数量
不指定该属性则默认显示完整的摘要

*'''DepictAddStr''' 设置内容摘要超出部分显示的省略字串
例如: DepictAddStr ="..."

不指定该属性则默认为不追加任何省略字串

*'''BodyLen'''内容主体的显示字符数量
不指定该属性则默认显示完整的内容主体

*'''BodyAddStr''' 设置内容主体超出部分显示的省略字串
例如: BodyAddStr ="..."

不指定该属性则默认为不追加任何省略字串

*'''NormalTemplateName '''普通项模板名称
*'''AlterTemplateName''' 交替项模板名称
*'''SeparTemplateName '''分隔符模板名称
*'''ConditionTemplateName''' 条件输出模板名称

==底层变量==
*'''{@AutoId/}''' 自动Id。按照递增方式自动产生Id，从 1 开始。通常用来表示行号。
*'''{@Id/}''' 内容编号
*'''{@Title/}''' 内容标题
*'''{@FullTitle/}''' 完整标题，此标题不会被截取，通常作为鼠标提示字串
*'''{@SubTitle/}''' 副标题
*'''{@PicPath/}''' 标题图片
*'''{@SPicPath_1/}''' 标题缩略图 （1级 大小 300*200）
*'''{@SPicPath_2/}''' 标题缩略图 （2级 大小 150*100）
*'''{@SPicPath_3/}''' 标题缩略图 （3级 大小 90*60）
*'''{@MediaPath/}''' 标题媒体
*'''{@FilePath/}''' 标题附件
*'''{@FileSize/}''' 附件大小
*'''{@FileDownTotal/}''' 附件下载次数
*'''{@Author/}''' 内容作者
*'''{@Source/}''' 内容来源
*'''{@Body/}''' 内容主体
*'''{@Depict/} '''内容摘要
*'''{@Flag/}''' 内容标记
*'''{@ClickTotal/}''' 内容点击数量
*'''{@CommTotal/} '''评论数量
*'''{@UpTotal/} '''顶数量
*'''{@DownTotal/} '''踩数量
*'''{@ContPath/}''' 内容页路径
*'''{@CommPath/} '''评论路径
*'''{@CateId/}''' 所属栏目的编号
*'''{@CateTitle/} '''所属栏目标题
*'''{@CatePath/}''' 所属栏目路径
*'''{@AddTime/}''' 内容录入时间
*'''{@AdminId/}''' 管理员ID
*'''{@AdminName/}''' 管理员名字

==使用示例==
查看[[YulinCMS ContList标签调用示例|ContList标签的使用示例]]

==相关条目==
*[[锐商CMS]]
*[[PageAdmin]]
*[[Umbraco]]
*[[DedeCMS]]
*[[帝国CMS]]
*[[Drupal]]

==参考来源==
*[http://help.yulincms.com/ 参考来源]

[[category:YulinCMS|C]]
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*