dede織夢(mèng)cms模板標(biāo)簽說(shuō)明

1、dede織夢(mèng)cms模板標(biāo)簽說(shuō)明，模版制作解析引擎概述模板設(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)

2、記的屬性，感覺(jué)上就像在用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)格用“/ded嘛記名稱；否則會(huì)報(bào)錯(cuò)。2、織夢(mèng)模板引擎內(nèi)置有多個(gè)系統(tǒng)標(biāo)記，這些系統(tǒng)標(biāo)記在任何場(chǎng)合都是能直接使用的。global標(biāo)記，表示獲取一個(gè)外部變

3、量，除了數(shù)據(jù)庫(kù)密碼之外，能調(diào)用系統(tǒng)的任何配置參數(shù)，形式為：dede:globalname=變量名稱/dede:global或dede:globalname=變量名稱/其中變量名稱不能加$符號(hào)，如變量$cfg_cmspath,應(yīng)該寫成dede:globalname=cfg_cmspath/。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安裝目錄

4、，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=pubdatefunction=strftime（%Y-%m-%d%H:%M:%S,me）/二、DedeCms模板制作規(guī)范DedeCms系統(tǒng)的模板是非固定的， 用戶可以在新建欄目時(shí)可以自行選擇欄目模板，官方僅提供最基本的默認(rèn)模板，即是內(nèi)置系統(tǒng)模型的各個(gè)模板，DedeCms支持自定義頻道模型，用戶自定義新頻道模型后，需要按該模

5、型設(shè)計(jì)一套新的模板。一、概念，設(shè)計(jì)和使用模板，必須要理解下面幾個(gè)概念：1、板塊（封面）模板：指網(wǎng)站主頁(yè)或比較重要的欄目封面使用的模板，一般用“index_H另IID.htm命名，止匕外，用戶單獨(dú)定義的單個(gè)頁(yè)面或自定義標(biāo)記，也可選是否支持板塊模板標(biāo)記，如果支持，系統(tǒng)會(huì)用板塊模板標(biāo)記引擎去解析后才輸由內(nèi)容或生成特定的文件。2、列表模板：指網(wǎng)站莫個(gè)欄目的所有文章列表的模板，一般用“l(fā)ist_R別ID.htm”命名。3、檔案模板：表示文檔查看頁(yè)的模板，一般用“article少別ID.htm”命名。4、其它模板：一般系統(tǒng)常規(guī)包含的模板有：主頁(yè)模板、搜索模板、RSS、JS編譯功能模板等，此外用戶也可以自定

6、義一個(gè)模板創(chuàng)建為任意文件。二、命名，為了規(guī)范起見(jiàn)，織夢(mèng)官方建議使用統(tǒng)一的方式來(lái)命名模板，具體如下：1、模板保存位置：模板目錄：cmspath/templets/樣式名稱 （英文， 默認(rèn)為default,其中system為系統(tǒng)底層模板，plus為插件使用的模板）/具體功能模板文件一般的模板位置：/templets/default”2、模板文件命名規(guī)范:(1)index_識(shí)別ID.htm:表示板塊(欄目封面)模板；(2)list_識(shí)別ID.htm:表示欄目列表模板；(3) article_識(shí)另1ID.htm:表示內(nèi)容查看頁(yè)(文檔模板， 包括專題查看頁(yè))；(4)search.htm:搜索結(jié)果列表模板

7、；(5)index.htm:主頁(yè)模板；注解：你的系統(tǒng)各個(gè)內(nèi)容頻道的識(shí)別ID分別為：例：list_image.htm表示是就是內(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:arclisttypeid=row=col=titlelen=infolen=imgwidth=i

8、mgheight=listtype=orderby=keyword=自定義樣式模板(InnerText)/dede:arclist本標(biāo)記等同于artlist、imglistimginfolist標(biāo)記， 其中與artlist是完全等同的，與imglist、imginfolist僅是默認(rèn)的底層模板不同。(2)屬性參考：1 typeid=表示欄目ID,在列表模板和檔案模板中一般不需要指定， 在封面模板中允許用,”分開(kāi)表示多個(gè)欄目；2 row=表示返回文檔行數(shù)，如果和col聯(lián)合使用，剛結(jié)果數(shù)等于row*col;3 col=表示分多少列顯示（默認(rèn)為單列）；4 titlelen=表示標(biāo)題長(zhǎng)度；5 info

9、len=表示內(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í)間排列。4 orderby=hot或orderby=click表示按點(diǎn)擊數(shù)排列5 orderby=pubdate按由版時(shí)間排列（即是前臺(tái)允許更改的時(shí)間值）6 orderby=sortrank按文章的新排序級(jí)別排序（如果你想使用置頂文章則使用這個(gè)屬性）7 ord

10、erby=id按文章ID排序10 keyword表示含有指定關(guān)鍵字的文檔列表，多個(gè)關(guān)鍵字用，分開(kāi)11 channelid=數(shù)字表示特定的頻道類型，內(nèi)置的頻道：專題（-1）、文章（1）、圖集（2）、Flash（4）、軟件（3）12 limit=起始,結(jié)束表示限定的記錄范圍，row屬性必須等于結(jié)束-起始，mysql的limit語(yǔ)句是由0起始的，如“l(fā)imit0,5裝示的是取前五筆記錄，“l(fā)imit5,5表示由第五筆記錄起，取下五筆記錄。(3)底層模板變量ID（同id）,title,iscommend,color,typeid,ismake,description（同info）,pubdate,se

11、nddate,arcrank,click,litpic（同picname）,typedir,typename,arcurl（同filename）,typeurl,stime（pubdate的0000-00-00格式），textlink,typelink,imglink,image其中：textlink=titletypelink=typenameimglink=image=變量調(diào)用方法：field:varname/如：dede:arclistinfolen=100field:textlink/field:info/dede:arclist2、field標(biāo)記這個(gè)標(biāo)記用于獲取特定欄目或檔校的字段值

12、及常用的環(huán)境變量值適用范圍：封面模板、列表模板、文檔模板(1)基本語(yǔ)法dede:fieldname=/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,t

13、empleturl,memberurl,powerby,indexurl,indexname,specurl,id(同ID,aid),檔案dede_archives表和附力口表的所有字段。3、channel標(biāo)記用于獲取欄目列表適用范圍：封面模板、列表模板、文檔模板(1)基本語(yǔ)法dede:channelrow=type=自定義樣式模板(InnerText)/dede:channel屬性1 row=數(shù)字表示獲取記錄的條數(shù)(通用在莫級(jí)欄目太多的時(shí)候使用，默認(rèn)是8)2 type=top,sun,selftype=top表示頂級(jí)欄目type=sun表示下級(jí)欄目type=self表示同級(jí)欄目其中后兩個(gè)屬性

14、必須在列表模板中使用。(3)底層模板變量ID,typename,typedir,typelink（這里僅表示欄目的網(wǎng)址）例：dede:channeltype=topfield:typename/dede:channel4、mytag標(biāo)記用于獲取自定義標(biāo)記的內(nèi)容適用范圍：封面模板、列表模板、文檔模板(1)基本語(yǔ)法dede:mytagtypeid=name=ismake=/屬性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)為

15、no表示mytag里的內(nèi)容不包含其它封面模板的標(biāo)記，yes則表示標(biāo)記內(nèi)容含有其它封面模板標(biāo)記。5、vote標(biāo)記用于獲取一組投票表單適用范圍：封面模板(1)基本語(yǔ)法dede:voteid=投票IDlineheight=22tablewidth=100%titlebgcolor=#EDEDE2titlebackground=tablebgcolor=#FFFFFF/dede:vote6、friendlink標(biāo)記，等同flink用于獲取友情鏈接適用范圍：封面模板(1)基本語(yǔ)法dede:flinktype=row=col=titlelen=tablestyle=/dede:flink屬性注解：1typ

16、e:鏈接類型，值：a. textall全部用文字顯示b. textimage文字和圖得混合排列c. text僅顯示不帶Logo的鏈接d. image僅顯示帶Logo的鏈接2row:顯示多少行，默認(rèn)為4行3col:顯示多少列，默認(rèn)為6列4titlelen:站點(diǎn)文字的長(zhǎng)度5tablestyle:表示7、mynews標(biāo)記用于獲取站內(nèi)新聞適用范圍：封面模板(1)基本語(yǔ)法dede:mynewsrow=條數(shù)titlelen=標(biāo)題長(zhǎng)度Innertext/dede:mynewsInnertext支持的字段為：field:title/,field:writer/,field:senddate/(時(shí)間),fiel

17、d:body/8、loop標(biāo)記用于調(diào)用任意表的數(shù)據(jù)，一般用于調(diào)用論壇貼子之類的操作，請(qǐng)參閱論壇擴(kuò)展插件。9、channelartlist標(biāo)t己用于獲取頻道的下級(jí)欄目的內(nèi)容列表適用范圍：封面模板語(yǔ)法：dede:channelArtlisttypeid=0col=2tablewidth=100%)dede:typefield:typename/更多/dede:typedede:arclistrow=8field:title/dede:arclist/dede:channelArtlistchannelArtlist是唯一一個(gè)可以直接嵌套其它標(biāo)記的標(biāo)記,不過(guò)僅限于嵌套dede:type/dede:t

18、ype和dede:arclist/dede:arclist標(biāo)記。屬性typeid=0頻道ID,默認(rèn)的情況下，嵌套的標(biāo)記使用的是這個(gè)欄目ID的下級(jí)欄目，如果你想用特定的欄目，可以用,分開(kāi)多個(gè)ID。col=2分多列顯示tablewidth=100%外圍表格的大小10、page標(biāo)記表示分頁(yè)頁(yè)面的附加參數(shù)適用范圍：列表模板語(yǔ)法：dede:pagepagesize=每頁(yè)結(jié)果條數(shù)/表示列表模板里的內(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,