arclist標記是開源程式織夢系統最常用的一個標記,也叫自由列表標記,其中 hotart、coolart、likeart、artlist、imglist、imginfolist、specart、autolist 這些標記都是由這個標記所定義的不同屬性延伸出來的別名標記。
基本介紹
- 中文名:arclist
- 外文名:arclist
- 又叫:自由列表標記
- 概述:是織夢最常用的一個標記
功能說明,適用範圍,基本語法,屬性說明,底層模板欄位,欄位調用方法,
功能說明
獲取指定的文檔列表。
適用範圍
封面模板、列表模板、文檔模板。
基本語法
{dede:arclist typeid='' row='' col='' titlelen='' infolen=''
imgwidth='' imgheight='' listtype='' orderby='' keyword=''}
底層模板(InnerText)
{/dede:arclist}
屬性說明
[1] typeid='' 表示欄目ID,在列表模板和檔案模板中一般不需要指定,在封面模板中允許用","分開表示多個欄目;
[2] row='' 表示返回文檔列表總數;
[3] col='' 表示分多少列顯示(默認為單列);
[4] titlelen='' 表示標題長度;
[5] infolen='' 表示內容簡介長度;
[6] imgwidth='' 表示縮略圖寬度;
[7] imgheight='' 表示縮略圖高度;
[8] type='' 表示檔案類型,其中空值、不使用這個屬性或type='all'時為普通文檔
§ type='commend'時,表示推薦文檔,等同於 {dede:coolart}{/dede:coolart}
§ type='image'時,表示必須含有縮略圖片的文檔,等同於{dede:imglist}{/dede:imglist}、{dede:imginfolist}{/dede:imginfolist}
§ type='spec'時,表示專題,等同於標記{dede:specart}{/dede:specart}
以上屬性值可以聯合使用,如: type='commend image' 表示推薦的圖片文檔
[9] orderby='' 表示排序方式,默認值是 senddate 按發布時間排列。
§ orderby='hot' 或 orderby='click' 表示按點擊數排列
§ orderby='pubdate' 按出版時間排列(即是前台允許更改的時間值)
§ orderby='sortrank' 按文章的新排序級別排序(如果你想使用置頂文章則使用這個屬性)
§ orderby='id' 按文章ID排序
§ orderby='postnum' 按文章評論次數排序
§ orderby='rand' 隨機獲得指定條件的文檔列表
[10] orderway='' 值為 desc 或 asc ,指定排序方式是降序還是順向排序,默認為降序。
[11] keyword='' 表示含有指定關鍵字的文檔列表,多個關鍵字用","分開
[12] channelid='' 表示特定的頻道模型ID,內置的頻道:專題(-1)、文章(1)、圖集(2)、Flash(4)、軟體(3)
[13] limit='起始,結束' 表示限定的記錄範圍,row屬性必須等於"結束 - 起始",mysql的limit語句是由0起始的,如 “limit 0,5”表示的是取前五筆記錄,“limit 5,5”表示由第五筆記錄起,取下五筆記錄,使用了本屬性後,row屬性將無效。
[14] att='數值' 表示自定義屬性值
[15] subday='天數' 表示在多少天以內的文檔,通常用於獲取指定天數的熱門文檔、推薦文檔、熱門評論文檔等
[16] partsort='排列位數'表示自動獲得父欄目的所有子數中排列在第幾位的欄目ID,標記為 {dede:autolist}{/dede:autolist} 時,使用本屬性才有效。
底層模板欄位
ID(同 id),title,iscommend,color,typeid,ismake,description(同 info),writer,shorttitle,memberid
pubdate,senddate,arcrank,click,litpic(同 picname),typedir,typename,
arcurl(同 filename),typeurl,stime(pubdate 的"0000-00-00"格式),
textlink,typelink,imglink,image
其中:
textlink = <a href='arcurl'>title</a>
typelink = <a href='typeurl'>typename</a>
imglink = <a href='arcurl'><img src='picname' border='0' width='imgwidth' height='imgheight'></a>
image = <img src='picname' border='0' width='imgwidth' height='imgheight'>
欄位調用方法
[field:varname/]
如:
{dede:arclist infolen='100'}
[field:textlink/]
<br>
[field:info/]
<br>
{/dede:arclist}
註:底層模板里的Field實現也是織夢標記的一種形式,因此支持使用PHP語法,Function擴展等功能
如: 給當天發布的內容加上 (new) 標誌
[field:senddate runphp='yes']
$ntime = time();
$oneday = 3600 * 24;
if(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>";
else @me = "";
[/field:senddate]