解析引擎概述　模板設(shè)計(jì)規(guī)范　代碼參考
標(biāo)記參考：arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart)fieldchannelmytagvotefriendlinkmynewsloopchannelartlistpagelistpagelistpagebreakfieldlist

一、織夢(mèng)模板解析引擎概述在了解DedeCms的模板代碼之前，了解一下織夢(mèng)模板引擎的知識(shí)是非常有意義的。織夢(mèng)模板引擎是一種使用XML名字空間形式的模板解析器，使用織夢(mèng)解析器解析模板的最大好處是可以輕松的制定標(biāo)記的屬性，感覺上就像在用HTML一樣，使模板代碼十分直觀靈活，新版的織夢(mèng)模板引擎不單能實(shí)現(xiàn)模板的解析還能分析模板里錯(cuò)誤的標(biāo)記。

1、織夢(mèng)模板引擎的代碼樣式有如下幾種形式：
{dede:標(biāo)記名稱屬性='值'/}
{dede:標(biāo)記名稱屬性='值'}{/dede:標(biāo)記名稱}
{dede:標(biāo)記名稱屬性='值'}自定義樣式模板(InnerText){/dede:標(biāo)記名稱}

提示：
對(duì)于{dede:標(biāo)記名稱屬性='值'}{/dede:標(biāo)記名稱}這種形式的標(biāo)記，在2.1版中，表示結(jié)束只需要用“{/dede}”，但
V3中需要嚴(yán)格用“{/dede:標(biāo)記名稱}”，否則會(huì)報(bào)錯(cuò)。

2、織夢(mèng)模板引擎內(nèi)置有多個(gè)系統(tǒng)標(biāo)記，這些系統(tǒng)標(biāo)記在任何場(chǎng)合都是能直接使用的。

(1)global標(biāo)記，表示獲取一個(gè)外部變量，除了數(shù)據(jù)庫(kù)密碼之外，能調(diào)用系統(tǒng)的任何配置參數(shù)，形式為：
{dede:globalname='變量名稱'}{/dede:global}
或
{dede:globalname='變量名稱'/}

其中變量名稱不能加$符號(hào)，如變量$cfg_cmspath，應(yīng)該寫成{dede:globalname='cfg_cmspath'/}。

(2)foreach用來(lái)輸出一個(gè)數(shù)組，形式為：
{dede:foreacharray='數(shù)組名稱'}[field:key/][field:value/]{/dede:foreach}

(3)include引入一個(gè)文件，形式為：
{dede:includefile='文件名稱'/}
對(duì)文件的搜索路徑為順序?yàn)椋航^對(duì)路徑、include文件夾，CMS安裝目錄，CMS主模板目錄

3、織夢(mèng)標(biāo)記允許在任何標(biāo)記中使用函數(shù)對(duì)得到的值進(jìn)行處理，形式為：
{dede:標(biāo)記名稱屬性='值'function='youfunction("參數(shù)一","參數(shù)二","@me")'/}
其中@me用于表示當(dāng)前標(biāo)記的值，其它參數(shù)由你的函數(shù)決定是否存在，例如：
{dede:fieldname='pubdate'function='strftime("%Y-%m-%d%H:%M:%S","@me")'/}

二、DedeCms模板制作規(guī)范

　　DedeCms系統(tǒng)的模板是非固定的，用戶可以在新建欄目時(shí)可以自行選擇欄目模板，官方僅提供最基本的默認(rèn)模板，即是內(nèi)置系統(tǒng)模型的各個(gè)模板，DedeCms支持自定義頻道模型，用戶自定義新頻道模型后，需要按該模型設(shè)計(jì)一套新的模板。
一、概念，設(shè)計(jì)和使用模板，必須要理解下面幾個(gè)概念：
1、板塊（封面）模板：
　　指網(wǎng)站主頁(yè)或比較重要的欄目封面使用的模板，一般用“index_識(shí)別”命名，此外，用戶單獨(dú)定義的單個(gè)頁(yè)面或自定義標(biāo)記，也可選是否支持板塊模板標(biāo)記，如果支持，系統(tǒng)會(huì)用板塊模板標(biāo)記引擎去解析后才輸出內(nèi)容或生成特定的文件。
2、列表模板：
　　指網(wǎng)站某個(gè)欄目的所有文章列表的模板，一般用“list_識(shí)別”命名。
3、檔案模板：
　　表示文檔查看頁(yè)的模板，一般用“article_識(shí)別”命名。
4、其它模板：
　　一般系統(tǒng)常規(guī)包含的模板有：主頁(yè)模板、搜索模板、ＲＳＳ、ＪＳ編譯功能模板等，此外用戶也可以自定義一個(gè)模板創(chuàng)建為任意文件。
二、命名，為了規(guī)范起見，織夢(mèng)官方建議使用統(tǒng)一的方式來(lái)命名模板，具體如下：
1、模板保存位置：
　　模板目錄：｛cmspath/templets/樣式名稱（英文，默認(rèn)為default，其中system為系統(tǒng)底層模板，plus為插件使用的模板）/具體功能模板文件｝
　　一般的模板位置：“/templets/default”
2、模板文件命名規(guī)范：
（１）index_識(shí)別：　表示板塊（欄目封面）模板；
（２）list_識(shí)別：　表示欄目列表模板；
（３）article_識(shí)別：　表示內(nèi)容查看頁(yè)（文檔模板，包括專題查看頁(yè)）；
（４）：搜索結(jié)果列表模板；
（５）：主頁(yè)模板；
注解：
你的系統(tǒng)各個(gè)內(nèi)容頻道的[識(shí)別ID]分別為：
例：表示是就是內(nèi)容類型為圖片集的欄目默認(rèn)列表模板。

三、主要標(biāo)記參考

1、arclist標(biāo)記

這個(gè)標(biāo)記是DedeCms最常用的一個(gè)標(biāo)記，其中hotart、coolart、likeart、artlist、imglist、imginfolist、specart這些標(biāo)記都是由這個(gè)標(biāo)記所定義的不同屬性延伸出來(lái)的。

作用：獲取一個(gè)指定的文檔列表

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

(1)基本語(yǔ)法：

{dede:arclist
typeid=''row=''col=''titlelen=''
infolen=''imgwidth=''imgheight=''listtype=''orderby=''keyword=''}

自定義樣式模板(InnerText)

{/dede:arclist}

本標(biāo)記等同于artlist、imglist、imginfolist標(biāo)記，其中與artlist是完全等同的，與imglist、imginfolist僅是默認(rèn)的底層模板不同。


(2)屬性參考：

[1]typeid=''表示欄目ID，在列表模板和檔案模板中一般不需要指定，在封面模板中允許用","分開表示多個(gè)欄目；
[2]row=''表示返回文檔行數(shù)，如果和col聯(lián)合使用，剛結(jié)果數(shù)等于row*col；
[3]col=''表示分多少列顯示（默認(rèn)為單列）；
[4]titlelen=''表示標(biāo)題長(zhǎng)度；
[5]infolen=''表示內(nèi)容簡(jiǎn)介長(zhǎng)度；
[6]imgwidth=''表示縮略圖寬度；
[7]imgheight=''表示縮略圖高度；
[8]type=''表示檔案類型，其中默認(rèn)值或type='all'時(shí)為普通文檔
§type='commend'時(shí)，表示推薦文檔，等同于
§type='image'時(shí)，表示必須含有縮略圖片的文檔
[9]orderby=''表示排序方式，默認(rèn)值是senddate按發(fā)布時(shí)間排列。
§orderby='hot'或orderby='click'表示按點(diǎn)擊數(shù)排列
§orderby='pubdate'按出版時(shí)間排列（即是前臺(tái)允許更改的時(shí)間值）
§orderby='sortrank'按文章的新排序級(jí)別排序（如果你想使用置頂文章則使用這個(gè)屬性）
§orderby='id'按文章ID排序
[10]keyword=''表示含有指定關(guān)鍵字的文檔列表，多個(gè)關(guān)鍵字用","分開
[11]channelid='數(shù)字'表示特定的頻道類型，內(nèi)置的頻道：專題(-1)、文章(1)、圖集(2)、Flash(4)、軟件(3)
[12]limit='起始,結(jié)束'表示限定的記錄范圍，row屬性必須等于"結(jié)束-起始"，mysql的limit語(yǔ)句是由0起始的，如“limit0,5”表示的是取前五筆記錄，“limit5,5”表示由第五筆記錄起，取下五筆記錄。

(3)底層模板變量

ID(同id),title,iscommend,color,typeid,ismake,description(同info),
pubdate,senddate,arcrank,click,litpic(同picname),typedir,typename,
arcurl(同filename),typeurl,stime(pubdate的"0000-00-00"格式),
textlink,typelink,imglink,image

其中：
textlink=<a>title</a>
typelink=<a>typename</a>
imglink=<a><imgsrc='picname'border='0'width='imgwidth'height='imgheight'></a>
image=<imgsrc='picname'border='0'width='imgwidth'height='imgheight'>

變量調(diào)用方法：[field:varname/]

如：
{dede:arclistinfolen='100'}
[field:textlink/]
<br>
[field:info/]
<br>
{/dede:arclist}

2、field標(biāo)記

這個(gè)標(biāo)記用于獲取特定欄目或檔桉的字段值及常用的環(huán)境變量值

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

(1)基本語(yǔ)法

{dede:fieldname=''/}

(2)name屬性的值：

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

列表模板：position,title,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,欄目表dede_arctype的所有字段
其中position為“欄目一>欄目二”這樣形式的鏈接，title則為這種形式的標(biāo)題

文檔模板：position,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,id(同ID,aid),檔案dede_archives表和附加表的所有字段。


3、channel標(biāo)記

用于獲取欄目列表

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

(1)基本語(yǔ)法
{dede:channelrow=''type=''}
自定義樣式模板(InnerText)
{/dede:channel}

(2)屬性

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

[2]type=top,sun,self

type='top'表示頂級(jí)欄目
type='sun'表示下級(jí)欄目
type='self'表示同級(jí)欄目

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

(3)底層模板變量

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

例：
{dede:channeltype='top'}
<a[field:typelink/]'>[field:typename/]</a>
{/dede:channel}

4、mytag標(biāo)記

用于獲取自定義標(biāo)記的內(nèi)容

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

(1)基本語(yǔ)法

{dede:mytagtypeid=''name=''ismake=''/}

(2)屬性

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

[2]name=''標(biāo)記名稱。

[3]ismake=yes|no默認(rèn)為no表示mytag里的內(nèi)容不包含其它封面模板的標(biāo)記，yes則表示標(biāo)記內(nèi)容含有其它封面模板標(biāo)記。

5、vote標(biāo)記

用于獲取一組投票表單

適用范圍：封面模板

(1)基本語(yǔ)法
{dede:voteid='投票ID'lineheight='22'
tablewidth='100%'titlebgcolor='#EDEDE2'
titlebackground=''tablebgcolor='#FFFFFF'}
{/dede:vote}


6、friendlink標(biāo)記，等同flink

用于獲取友情鏈接

適用范圍：封面模板

(1)基本語(yǔ)法

{dede:flinktype=''row=''col=''titlelen=''tablestyle=''}{/dede:flink}
屬性注解：
[1]type：鏈接類型，值：
a.textall全部用文字顯示
b.textimage文字和圖得混合排列
c.text僅顯示不帶Logo的鏈接
d.image僅顯示帶Logo的鏈接
-------------------------------------
[2]row：顯示多少行，默認(rèn)為4行
[3]col：顯示多少列，默認(rèn)為6列
[4]titlelen：站點(diǎn)文字的長(zhǎng)度
[5]tablestyle：表示<table這里的內(nèi)容>

7、mynews標(biāo)記

用于獲取站內(nèi)新聞

適用范圍：封面模板

(1)基本語(yǔ)法

{dede:mynewsrow='條數(shù)'titlelen='標(biāo)題長(zhǎng)度'}Innertext{/dede:mynews}

Innertext支持的字段為：[field:title/],[field:writer/],[field:senddate/](時(shí)間),[field:body/]

8、loop標(biāo)記

用于調(diào)用任意表的數(shù)據(jù)，一般用于調(diào)用論壇貼子之類的操作，請(qǐng)參閱論壇擴(kuò)展插件。

9、channelartlist標(biāo)記

用于獲取頻道的下級(jí)欄目的內(nèi)容列表

適用范圍：封面模板

語(yǔ)法：

{dede:channelArtlisttypeid=0col=2tablewidth='100%'}
<tablewidth="99%"border="0"cellpadding="3"cellspacing="1"bgcolor="#BFCFA9">
<tr>
<tdbgcolor="#E6F2CC">
{dede:type}
<tableborder="0"cellpadding="0"cellspacing="0"width="98%">
<tr>
<tdwidth='10%'align="center"><imgsrc='[field:globalname='cfg_plus_dir'/]/img/channellist.gif'width='14'height='16'></td>
<tdwidth='60%'>
<a[field:typelink/]">[field:typename/]</a>
</td>
<tdwidth='30%'align='right'>
<a[field:typelink/]">更多...</a>
</td>
</tr>
</table>
{/dede:type}
</td>
</tr>
<tr>
<tdheight="150"valign="top"bgcolor="#FFFFFF">
{dede:arclistrow="8"}
·<a[field:arcurl/]">[field:title/]</a><br>
{/dede:arclist}
</td>
</tr>
</table>
<divstyle='font-size:2px'></div>
{/dede:channelArtlist}

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

{dede:type}{/dede:type}和{dede:arclist}{/dede:arclist}

標(biāo)記。

(1)屬性
typeid=0頻道ID,默認(rèn)的情況下，嵌套的標(biāo)記使用的是這個(gè)欄目ID的下級(jí)欄目，如果你想用特定的欄目，可以用","分開多個(gè)ID。

col=2分多列顯示

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


10、page標(biāo)記

表示分頁(yè)頁(yè)面的附加參數(shù)

適用范圍：列表模板

語(yǔ)法：

{dede:pagepagesize="每頁(yè)結(jié)果條數(shù)"/}

11、list標(biāo)記

表示列表模板里的內(nèi)容列表

語(yǔ)法：

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

底層模板變量

ID(同id),title,iscommend,color,typeid,ismake,description(同info),
pubdate,senddate,arcrank,click,litpic(同picname),typedir,typename,
arcurl(同filename),typeurl,stime(pubdate的"0000-00-00"格式),
textlink,typelink,imglink,image

12、pagelist標(biāo)記

表示分頁(yè)頁(yè)碼列表

適用范圍：列表模板

語(yǔ)法：

{dede:pagelistlistsize="3"/}

listsize表示[1][2][3]這些項(xiàng)的長(zhǎng)度x2

13、pagebreak標(biāo)記

用途：表示文檔的分頁(yè)鏈接列表。
適用范圍：僅文檔模板。
語(yǔ)法：{dede:pagebreak/}

14、fieldlist標(biāo)記
用途：獲得附加表的所有字段信息。
適用范圍：僅文檔模板。
語(yǔ)法：
{dede:fieldlist}
[field:name/]：[field:value/]<br>
{/dede:fieldlist}