编辑“EXCMS标签 contentlist内容列表标签”

<span style="border:1px solid #000; float:right; text-align:center; padding:6px;"><strong>导航：</strong>[[EXCMS模板标签#全局标签|返回上一页]]</span>
<div style="clear:both;"></div>
[[EXCMS]]模板标签介绍，“contentlist内容列表标签”：

'''标签名称'''：contentlist

'''功能说明'''：获取内容列表

'''适用范围'''：全局使用

'''基本语法'''：{contentlist channelid= row= titlelen= infolen= imgwidth= imgheight= orderby= orderway= keyword= limit= modelid= subday= idlist= recommend= distillate= field= image= }{contentlistelse}{/contentlist}

'''属性说明'''：
{|border="1" style="text-align:center; width:980px;"
!名称  	  	  	
!默认值
!是否必填
!描述
|-
|channelid
|0
|否
|表示栏目ID，在栏目模板和封面模板中不需要指定，多个栏目ID可用","，默认为0，也就是相当于顶级栏目。
|-
|row
|所有
|否
|表示返回内容列表数量。
|-
|titlelen
|全部
|否
|表示标题显示的长度。
|-
|infolen
|全部
|否
|表示内容描述显示的长度。
|-
|imgwidth
|空
|否
|表示缩略图宽度。
|-
|imgheight
|空
|否
|表示缩略图高度。
|-
|recommend
|空
|否
|表示自定义属性值；自定义属性值可以为以下这些值：
头条[head]，焦点［focus]，推荐[recommend]，FLASH[flash]，首页头条[indexhead]，滚动 [scroll]，首页焦点[indexfocus]，首页推荐[indexrmd]。
|-
|orderby
|contentid
|否
|表示排序方式,默认值是 ''contentid' 按内容ID排列。
orderby='hot' 或 orderby='click' 或orderby='hits'表示按点击数排列
orderby='pubdate'或'publishdate' 按发布时间排列
orderby=''contentid'按内容ID排序
orderby='near'
orderby='lastpost' 按评论最后回复时间排序
orderby='postnum' 按内容评论次数排序
orderby='rand' 随机获得指定条件的文档列表
|-
|orderway
|desc
|否
|值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序。
|-
|keyword
|空
|否
|表示含有指定[[关键字]]的内容列表，多个关键字用","分开
|-
|modelid
|空
|否
|表示特定的模型ID，内置的模型：文章(1)、图集(2)、软件(3)、[[Flash]](4)。
|-
|limit
|空
|否
|limit=起始,结束， 表示限定的记录范围，与row属性区别是rowf起始位置永远是从0开始的，mysql的limit语句是由0起始的，如 “limit 0,6”表示的是取前六条记录，“limit 5,6”表示由第五笔记录起，取下六条记录，使用了本属性后，row属性将无效。
|-
|subday
|全部
|否
|表示查找在多少天以内的发布的内容，通常用于获取指定天数的热门文档、推荐文档、热门评论文档等。
|-
|idlist
|空
|否
|表示获取指定内容ID的内容列表，内容ID之间用","隔开。
|-
|distillate
|0
|否
|获取精华内容，参数表示指定等级，0：非精华，1：精华级别1，2：精华级别2，3：精华级别3。
|-
|field
|所有字段
|否
|获取指定内容表中字段。
|-
|image
|空
|否
|获取是否带有缩略图的内容。默认为全部，true带缩略图，false不带缩略图。
|-
|item
|空
|否
|通过item属性可访问contentlist标签自身的属性，如果当前标签指定了栏目，contentlist中的item属性包含了当前栏目表的所有字段信息，否则为空，contentlist自身属性可以通过{$name.property}访问，其中"$name"是item指定的变量名称，property是指当前栏目表的字段信息。

|}
<br />
{|border="1" style="text-align:center; width:900px;"
!底层模板字段：contentlist标签支持内容数据表的所有字段，如下
|-
|contentid, modelid, channelid, channelcross, title, shorttitle, metatitle, keywords, tags, description, source, author, isthumb, thumb, titleatt, likekeywords, likecontentid, forward, template, filename, ishtml, checked, userid, username, publishdate, modifieddate, createddate, distillate, recommend, credits, comment, sort, path

|}
<br />
{|border="1" style="text-align:center; width:900px;"
!支持内容数据表的所有字段以外，系统提供了一些附加字段
|-
|url, encrypt_contentid, info, fulltitle, channel

|}
contentlist标签字段的说明请点击[[EXCMS标签 系统全局变量|这里]]

'''例子'''：显示10条最新发布内容
<pre>
01	<!-- 最新内容开始 -->
02	<div class="side">
03	<div class="gblock">
04	<div class="tab"><h2 class="title"><a href="{$EXCMS.domain}/list.php?channelid={$_PAGE_CHANNEL.channelid}&type=newest">最新</a></h2></div>
05	<div class="gblock_body">
06	<ul class="list font12">
07	 
08	<!-- 显示10条最新发布内容 -->
09	{contentlist row=10}
10	    {loop item=cnt}
11	        <li><a href="{$cnt.href}" target="_blank">{$cnt.title}</a></li>
12	    {/loop}
13	{/contentlist}
14	<!-- 结束contentlist -->
15	 
16	</ul>
17	</div>
18	<div class="gblock_bom"><em></em></div>
19	</div>
20	<!-- 结束最新内容开始 -->
21	</div>
</pre>
上例输出结果： 
<div>
[[Image:excms552.jpg]]
</div>

'''例2'''：显示最新发布的推荐内容
<pre>
01	<div class="gblock mt10">
02	<div class="tab"><h2 class="title"><a href="{$EXCMS.domain}/list.php?channelid={$_PAGE_CHANNEL.channelid}&type=recommend">推荐</a></h2>
</div>
03	<div class="gblock_body">
04	<ul class="list font12">
05	 
06	<!-- 显示10条最新发布推荐内容 -->
07	{contentlist row=10 recommend=recommend}
08	    {loop item=cnt}
09	    <li><a href="{$cnt.href}" target="_blank">{$cnt.title}</a></li>
10	    {/loop}
11	{/contentlist}
12	<!-- 结束contentlist -->
13	 
14	</ul>
15	</div>
16	<div class="gblock_bom"><em></em></div>
17	</div>
</pre>
上例输出结果： 
<div>
[[Image:excms553.jpg]]
</div>






[[category:EXCMS]]