{dede:arclist typeid='' row='' col='' titlelen='' infolen=''

imgwidth='' imgheight='' listtype='' orderby='' keyword=''}

底層模板(InnerText)

{/dede:arclist}

[1] typeid='' 表示欄目ID，在列表模板和檔案模板中一般不需要指定，在封面模板中允許用"，"分開(kāi)表示多個(gè)欄目；

[2] row='' 表示返回文檔列表總數；

[3] col='' 表示分多少列顯示（默認為單列）；

[4] titlelen='' 表示標題長(cháng)度；

[5] infolen='' 表示內容簡(jiǎn)介長(cháng)度；

[6] imgwidth='' 表示縮略圖寬度；

[7] imgheight='' 表示縮略圖高度；

[8] type='' 表示檔案類(lèi)型，其中空值、不使用這個(gè)屬性或type='all'時(shí)為普通文檔

§ type='commend'時(shí)，表示推薦文檔，等同于 {dede:coolart}{/dede:coolart}

§ type='image'時(shí)，表示必須含有縮略圖片的文檔，等同于{dede:imglist}{/dede:imglist}、{dede:imginfolist}{/dede:imginfolist}

§ type='spec'時(shí)，表示專(zhuān)題，等同于標記{dede:specart}{/dede:specart}

以上屬性值可以聯(lián)合使用，如： type='commend image' 表示推薦的圖片文檔

[9] orderby='' 表示排序方式，默認值是 senddate 按發(fā)布時(shí)間排列。

§ orderby='hot' 或 orderby='click' 表示按點(diǎn)擊數排列

§ orderby='pubdate' 按出版時(shí)間排列（即是前臺允許更改的時(shí)間值）

§ orderby='sortrank' 按文章的新排序級別排序（如果你想使用置頂文章則使用這個(gè)屬性）

§ orderby='id' 按文章ID排序

§ orderby='postnum' 按文章評論次數排序

§ orderby='rand' 隨機獲得指定條件的文檔列表

[10] orderway='' 值為 desc 或 asc ，指定排序方式是降序還是順向排序，默認為降序。

[11] keyword='' 表示含有指定關(guān)鍵字的文檔列表，多個(gè)關(guān)鍵字用"，"分開(kāi)

[12] channelid='' 表示特定的頻道模型ID，內置的頻道：專(zhuān)題(-1)、文章(1)、圖集(2)、Flash(4)、軟件(3)

[13] limit='起始，結束' 表示限定的記錄范圍，row屬性必須等于"結束 - 起始"，mysql的limit語(yǔ)句是由0起始的，如 “l(fā)imit 0，5”表示的是取前五筆記錄，“l(fā)imit 5，5”表示由第五筆記錄起，取下五筆記錄，使用了本屬性后，row屬性將無(wú)效。

[14] att='數值' 表示自定義屬性值

[15] subday='天數' 表示在多少天以?xún)鹊奈臋n，通常用于獲取指定天數的熱門(mén)文檔、推薦文檔、熱門(mén)評論文檔等

[16] partsort='排列位數' 表示自動(dòng)獲得父欄目的所有子數中排列在第幾位的欄目ID，標記為 {dede:autolist}{/dede:autolist} 時(shí)，使用本屬性才有效。

底層模板字段：

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實(shí)現也是織夢(mèng)標記的一種形式，因此支持使用PHP語(yǔ)法，Function擴展等功能

如： 給當天發(fā)布的內容加上 (new) 標志

[field:senddate runphp='yes']

$ntime = time();

$oneday = 3600 * 24;

if(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>";

else @me = "";

[/field:senddate]

【Field 標記，

功能說(shuō)明：用于獲取特定欄目或檔桉的字段值及常用的環(huán)境變量值

適用范圍：封面模板、列表模板、文檔模板

(1)基本語(yǔ)法

{dede:field name='字段名'/}

(2) 系統分配的field

板塊模板：phpurl，indexurl，indexname，templeturl，memberurl，powerby，webname，specurl

列表模板：position，title，phpurl，templeturl，memberurl，powerby，indexurl，indexname，specurl，欄目表dede_arctype的所有字段

其中 position 為 “欄目一 > 欄目二” 這樣形式的鏈接，title則為這種形式的標題

文檔模板：position，phpurl，templeturl，memberurl，powerby，indexurl，indexname，specurl，id(同 ID，aid)

(3) 文檔所有內容字段

檔案dede_archives表 和 附加表的所有字段。

【Channel 標記，

功能說(shuō)明：用于獲取欄目列表

適用范圍：封面模板、列表模板、文檔模板

(1)基本語(yǔ)法

{dede:channel row='' type=''}

自定義樣式模板(InnerText)

{/dede:channel}

(2)屬性

[1] row='數字' 表示獲取記錄的條數（通用在某級欄目太多的時(shí)候使用，默認是 8）

[2] type = top，sun/son，self

type='top' 表示頂級欄目

type='son' 或 'sun' 表示下級欄目

type='self' 表示同級欄目

其中后兩個(gè)屬性必須在列表模板中使用。

(3)底層模板變量

ID，typename，typedir，typelink(僅表示欄目的網(wǎng)址)

例：

{dede:channel type='top'}

<a href='[field:typelink /]'>[field:typename/]</a>

{/dede:channel}

注：在沒(méi)有指定typeid的情況下，type標記與模板的環(huán)境有關(guān)，如，模板生成到欄目一，那么type='son'就表示欄目一的所有子類(lèi)

【Type 標記，別名 onetype

功能說(shuō)明：表示指定的單個(gè)欄目的鏈接

適用范圍：封面模板、列表模板、文檔模板

(1)語(yǔ)法 {dede:type typeid=''}{/dede:type}

(2)屬性 typeid='欄目ID'

(3)底層模板變量

typename，typelink(僅表示欄目的網(wǎng)址)

【Autochannel 標記，

功能說(shuō)明：表示指定排序位置的單個(gè)欄目的鏈接

適用范圍：封面模板、列表模板、文檔模板

(1)語(yǔ)法 {dede:autochannel partsort=''}{/dede:autochannel}

(2)屬性 partsort='欄目所在的排序位置'

(3)底層模板變量

typename，typelink(僅表示欄目的網(wǎng)址)

【Mytag 標記，

功能說(shuō)明：用于獲取自定義宏標記的內容

適用范圍：封面模板、列表模板、文檔模板

(1)基本語(yǔ)法

{dede:mytag typeid='' name='' ismake=''/}

(2)屬性

[1] typeid = '數字' 表示欄目ID，默認為 0，在沒(méi)有設定的欄目沒(méi)有定義這個(gè)名稱(chēng)的標記，會(huì )按如下搜索方式來(lái)搜索“先向上查找父欄目 -> 通用標記（typeid=0）的同名標記”。

[2] name = '' 標記名稱(chēng)。

[3] ismake = yes|no 默認為 no 表示mytag里的內容不包含其它封面模板的標記，yes則表示標記內容含有其它封面模板標記。

【Vote 標記，

功能說(shuō)明：用于獲取一組投票表單

適用范圍：封面模板

(1) 基本語(yǔ)法

{dede:vote id='投票ID' lineheight='22'

tablewidth='100%' titlebgcolor='#EDEDE2'

titlebackground='' tablebgcolor='#FFFFFF'}

{/dede:vote}

注：本標記直接生成投票的HTML表單，為了讓你更方便修改其樣式，建議在后臺->投票管理的地方直接復制生成的HTML代碼來(lái)使用。

【Flink 標記，，等同 friendlink

功能說(shuō)明：用于獲取友情鏈接

適用范圍：封面模板

(1)基本語(yǔ)法

{dede:flink type='' row='' col='' titlelen='' tablestyle=''}{/dede:flink}

(2)屬性

[1]type：鏈接類(lèi)型，值：

a. textall 全部用文字顯示

b. textimage 文字和圖得混合排列

c. text 僅顯示不帶Logo的鏈接

d. image 僅顯示帶Logo的鏈接

-------------------------------------

[2]row：顯示多少行，默認為4行

[3]col：顯示多少列，默認為6列

[4]titlelen：站點(diǎn)文字的長(cháng)度

[5]tablestyle： 表示 <table 這里的內容>

【Mynews 標記，

功能說(shuō)明：用于獲取站內新聞

適用范圍：封面模板

(1) 基本語(yǔ)法

{dede:mynews row='條數' titlelen='標題長(cháng)度'}Innertext{/dede:mynews}

(2)屬性

[1] row 新聞條數

[2] titlelen 標題長(cháng)度

(3)底層模板變量

[field:title/]、[field:writer/]、

[field:senddate function="strftime('%y-%m-%d %H:%M'，@me)"/](時(shí)間)、[field:body/]

【LOOP 標記，

功能說(shuō)明：用于調用任意表的數據，一般用于調用論壇貼子之類(lèi)的操作

適用范圍：所有模板

(1) 基本語(yǔ)法

{dede:loop table=' sort='' row='' if=''}

底層模板

{/dede:loop}

(2) 屬性

[1] table 表示查詢(xún)的數據表

[2] sort 用于排序的字段

[3] row 返回結果的條數

[4] if 查詢(xún)條件

(3)底層模板變量

這個(gè)標記的底層模板變量即是被查詢(xún)表的所有字段

例：獲取Phpwind論壇的Zui新主題貼子

{dede:loop table='pw_threads' sort='tid' row='8' if=''}

·[field:subject function="cn_substr('@me'，30)"/] ([field:lastpost function="date('m-d H:M'，'@me')"/])

{/dede:loop}

【Channelartlist 標記，

功能說(shuō)明：用于獲取當前頻道的下級欄目的內容列表

適用范圍：封面模板

(1)基本語(yǔ)法

{dede:channelArtlist typeid=0 col=2 tablewidth='100%'}

<table width="99%" border="0" cellpadding="3" cellspacing="1" bgcolor="#BFCFA9">

<tr>

<td bgcolor="#E6F2CC">

{dede:type}

<table border="0" cellpadding="0" cellspacing="0" width="98%">

<tr>

<td width='10%' align="center"><img src='[field:global name='cfg_plus_dir'/]/img/channellist.gif' width='14' height='16'></td>

<td width='60%'>

<a href="[field:typelink /]">[field:typename /]</a>

</td>

<td width='30%' align='right'>

<a href="[field:typelink /]">更多...</a>

</td>

</tr>

</table>

{/dede:type}

</td>

</tr>

<tr>

<td height="150" valign="top" bgcolor="#FFFFFF">

{dede:arclist row="8"}

·<a href="[field:arcurl /]">[field:title /]</a><br>

{/dede:arclist}

</td>

</tr>

</table>

<p style='font-size:2px'>&nbsp;</p>

{/dede:channelArtlist}

除了宏標記外，channelArtlist 是唯一一個(gè)可以直接嵌套其它標記的標記，不過(guò)僅限于嵌套

{dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist} 兩個(gè)標記。

(2) 屬性

[1]typeid=0 頻道ID，默認的情況下，嵌套的標記使用的是這個(gè)欄目ID的下級欄目，如果你想用特定的欄目，可以用"，"分開(kāi)多個(gè)ID。

[2]col=2 分多列顯示

[3]tablewidth='100%' 外圍表格的大小

【List 標記，

功能說(shuō)明：表示列表模板里的分頁(yè)內容列表

適用范圍：僅列表模板 list_*.htm

(1)基本語(yǔ)法

{dede:list col='' titlelen=''

infolen='' imgwidth='' imgheight='' orderby='' pagesize=''}{/dede:list}

(2)屬性

[1]col 內容列數

[2]titlelen 標題長(cháng)度

[3]infolen 內容摘要長(cháng)度

[4]imgwidth 縮略圖寬

[5]imgheight 縮略圖高

[6]orderby 排序方式，有效的排序方式有 senddate、pubdate、id、click、lastpost、postnum ，默認為 sortrank

[7]pagesize 分頁(yè)大小

(3)底層模板變量

ID(同 id)，title，iscommend，color，typeid，ismake，description(同 info)，postnum，lastpost，shorttitle

pubdate，senddate，arcrank，click，litpic(同 picname)，typedir，typename，

arcurl(同 filename)，typeurl，stime(pubdate 的"0000-00-00"格式)，

textlink，typelink，imglink，image

注：list標記除了支持檔案表的基本模板變量外，還支持附加表的字段，你可以在模型管理中知道附加表支持列表使用的字段有哪些。

【Page 標記，

功能說(shuō)明：表示分頁(yè)頁(yè)面的附加參數

適用范圍：列表模板

語(yǔ)法： {dede:page pagesize="每頁(yè)結果條數"/}

注：此標記在dedecms3.1中已經(jīng)過(guò)期，dedecms3.1中直接把 pagesize屬性加在 list 標記中，表示記錄分頁(yè)大小。

【Pagelist 標記，

功能說(shuō)明：表示分頁(yè)頁(yè)碼列表

適用范圍：列表模板

(1)語(yǔ)法

{dede:pagelist listsize='3' listitem=''/}

(2)屬性

[1] listsize 表示 [1][2][3] 這些項的長(cháng)度 x 2

[2] listitem 表示頁(yè)碼樣式，可以把下面的值疊加

index首頁(yè)

pre 上一頁(yè)

pageno 頁(yè)碼

next 下一頁(yè)

end 末頁(yè)

option 下拉跳轉框

例： {dede:pagelist listsize='3' listitem='index pre pageno next end option'/}

【Pagebreak 標記，

功能說(shuō)明：表示文檔的分頁(yè)鏈接列表。

適用范圍：僅文檔模板。

語(yǔ)法：{dede:pagebreak/}

【Prenext 標記，

功能說(shuō)明：表示獲取文檔“上一篇／下一篇”的鏈接列表。

適用范圍：僅文檔模板。

(1)語(yǔ)法：{dede:prenext/}

(2)屬性：

[1] get 獲取連接類(lèi)型（僅2007版），get='' 同V4顯示橫排的上下頁(yè)連接， get='pre' 上一篇的連接 get='next' 下一篇連接

注：此標記默認為橫向排列，如果你想用豎向排列，可以用

{dede:prenext function="str_replace(' 下一篇：'，'<'.'br'.' />下一篇：'，@me)"/}

表示

【Pagetitle 標記，

功能說(shuō)明：表示獲取文檔的分頁(yè)標題

適用范圍：僅文檔模板。

(1)語(yǔ)法：{dede:pagetitle style='select'/}

(2)屬性：style 表示分頁(yè)標題的展示樣式

select 表示下拉框、link 表示文字直接鏈接

【Fieldlist 標記，

功能說(shuō)明：獲得附加表的所有字段信息。

適用范圍：僅文檔模板。

語(yǔ)法：

{dede:fieldlist}

[field:name/] ： [field:value/] <br>

{/dede:fieldlist}

【Myad 標記，

功能說(shuō)明：獲取廣告代碼

適用范圍：所有模板。

建議在廣告管理模塊中獲取，在此不作描述

##############################################################

## 以下僅適用于DedeCms2007版

##############################################################

【Ask 標記，

功能說(shuō)明：用于獲取Zui新的問(wèn)答的主題。

適用范圍：非擴展模塊所有模板。

(1)語(yǔ)法：{dede:ask row='' qtype=''}底層模板{/dede:ask}

(2)屬性：

[1] row 記錄條數。

[2] qtype 類(lèi)型 默認為新回復問(wèn)題，commend推薦問(wèn)題 ok已解決問(wèn)題 high高分問(wèn)題

(3)底層模板：

<dd>

<span class="tclass">[<a href='[field:typeurl/]'>[field:tidname/]</a>]</span>

<span class="tlink"><a href="[field:url/]">[field:title/]</a></span>

</dd>

[field:typeurl/] 欄目網(wǎng)址 [field:tidname/] 欄目名稱(chēng)

[field:url/] 問(wèn)題網(wǎng)址 [field:title/] 問(wèn)題標題 [field:id/] 問(wèn)題id

【Sql 標記，

功能說(shuō)明：用于從模板中用一個(gè)SQL查詢(xún)獲得其返回內容。

適用范圍：非擴展模塊所有模板。

(1)語(yǔ)法：{dede:sql sql=""}底層模板{/dede:sql}

(2)屬性：

[1] sql 完整的SQL查詢(xún)語(yǔ)句。

(3)底層模板：

SQL語(yǔ)句中查出的所有字段都可以用[field:字段名/]來(lái)調用。

【Group 標記，

功能說(shuō)明：獲取特定條件的圈子。

適用范圍：非擴展模塊所有模板。

(1)語(yǔ)法：{dede:group row="個(gè)數" orderby='排序條件' }底層模板{/dede:group}

(2)屬性：

[1] row 返回結果個(gè)數。

[2] orderby 排序條件，一般為： 默認 threads 發(fā)貼量，members會(huì )員數，hits瀏覽量，stime創(chuàng )建時(shí)間。

(3)底層模板：

[field:url/]圈子網(wǎng)址 [field:groupname/]圈子名稱(chēng) [field:icon/]圈子圖標 [field:groupid/] 圈子ID

【Groupthread 標記，

功能說(shuō)明：獲取圈子Zui新發(fā)表的主題。

適用范圍：非擴展模塊所有模板。

(1)語(yǔ)法：{dede:groupthread gid='' row='' orderby='' orderway=''}底層模板{/dede:groupthread}

(2)屬性：

[1] gid='' 圈子分類(lèi)，為空或0剛表示所有分類(lèi)

[2] row='' 條數

[3] orderby='' 排序條件 默認 dateline

[4] orderway=' 排序方向 desc 或 asc

(3)底層模板：

[field:url/]圈子網(wǎng)址 [field:groupname/]圈子名稱(chēng) [field:icon/]圈子圖標 [field:groupid/] 圈子ID

【booklist 標記，

功能說(shuō)明：用于獲取Zui新連載圖書(shū)。

適用范圍：連載書(shū)庫。

(1)語(yǔ)法：{dede:booklist row='' booktype='' titlelen='' orderby='' catid='' author='' imgwidth='' imgheight=''}底層模板{/dede:booklist}

(2)屬性：

[1] row='' 行數

[2] booktype='' 圖書(shū)類(lèi)型 1 漫畫(huà)，0 小說(shuō)， -1 或默認 全部

[3] titlelen='' 標題長(cháng)度

[4] orderby='' 排序

[5] catid='' 欄目ID

[6] author='' 作者

[7] imgwidth=''

[8] imgheight=''

(3)底層模板：

contenttitle，contentid，contenturl，dmbookurl，bookurl，catalogurl，cataloglink，booklink，contentlink，imglink，ischeck，booktypename

【catalog 標記，

功能說(shuō)明：用于獲取書(shū)庫的欄目。

適用范圍：連載書(shū)庫。

(1)語(yǔ)法：{dede:catalog type=''}底層模板{/dede:catalog}

(2)屬性：

[1] type 類(lèi)型 默認為頂級欄目，type=son 表示當前欄目的子欄目，指定特定的欄目id則為所指定的欄目。

(3)底層模板：

本標記支持in嵌套，里面的in標記還可以再使用一重樣式

{dede:catalog}

<dd><a href="{in:field name='url'}{/in:field}">{in:field name='classname'}{/in:field}</a></dd>

{/dede:catalog}

列出所有分類(lèi)：

{dede:catalog}

<p class="book_class_form">

<dl>

<dt><a href="{in:field name='url'}{/in:field}">{in:field name='classname'}{/in:field}：</a></dt>

{in:sonlist}<dd> <a href='[field:url/]'>[field:classname/]</a></dd>{/in:sonlist}

</dl>

<p class="clear">

</p>

</p>

{/dede:catalog}

【chapter 標記，

功能說(shuō)明：用于獲取圖書(shū)的章節列表，適用于book_book.htm。

適用范圍：連載書(shū)庫。

(1)語(yǔ)法：{dede:chapter}底層模板{/dede:chapter}

(2)屬性：

(3)底層模板：

url 網(wǎng)址 ch 章節 title 標題

【contentlist 標記，

功能說(shuō)明：用于獲取Zui新圖書(shū)章節。

適用范圍：連載書(shū)庫。

(1)語(yǔ)法：{dede:contentlist row='' booktype='' titlelen='' catid=''}底層模板{/dede:contentlist}

(2)屬性：

[1] row 條數

[2] booktype 圖書(shū)類(lèi)型 1 漫畫(huà)，0 小說(shuō)， -1 或默認 全部

[3] titlelen

[4] catid 欄目ID

(3)底層模板：

contenttitle，contentid，contenturl，dmbookurl，bookurl，catalogurl，cataloglink，booklink，contentlink，imglink，ischeck，booktypename

本標記實(shí)際是由booklist引申的，不同之處是按book的Zui新發(fā)表章節排序