DedeCms模板二次開發(fā)手冊

1、dedecms系統(tǒng)的模板是非固定的，用戶可以在新建欄目時可以自行選擇欄目模板，官方僅提供最基本的默認(rèn)模板，即是內(nèi)置系統(tǒng)模型的各個模板，由于dedecms支持自定義頻道模型，用戶自定義新頻道模型后，還需要按該模型的字段設(shè)計一套新的模板，此外，dedecms也支持使用風(fēng)格的形式使用模板，默認(rèn)風(fēng)格是 default，它表示系統(tǒng)默認(rèn)使用 cmspath/templets/default 這個文件夾的模板，如果你下載了一套新的模板，你可以不必要刪除 default 原有的文件，把下載的模板文件夾命名你想要的風(fēng)格名稱，如 style2 等，然后在后臺修改了默認(rèn)的模板風(fēng)格名稱為 style2 ，那系統(tǒng)將使用

2、 templets/style2 這文件當(dāng)作默認(rèn)模板，但是若你手工指定了欄目模板的位置，則后臺參數(shù)風(fēng)格的定義無效。 一、概念，設(shè)計和使用模板，必須要理解下面幾個概念1、板塊（封面）模板：指網(wǎng)站主頁或比較重要的欄目封面頻道使用的模板，一般用“index_識別id.htm”命名，此外，用戶單獨定義的單個頁面或自定義標(biāo)記，也可選是否支持板塊模板標(biāo)記，如果支持，系統(tǒng)會用板塊模板標(biāo)記引擎去解析后才輸出內(nèi)容或生成特定的文件。2、列表模板：指網(wǎng)站某個欄目的所有文章列表的模板，一般用 “l(fā)ist_識別id.htm” 命名。3、檔案模板：表示文檔查看頁的模板，如文章模板，一般用 “article_識別id.ht

3、m” 命名。4、其它模板：一般系統(tǒng)常規(guī)包含的模板有：主頁模板、搜索模板、編譯功能模板等，此外用戶也可以自定義一個模板創(chuàng)建為任意文件。二、 命名，dedecms模板默認(rèn)命名規(guī)則如下1、模板保存位置：模板目錄：cmspath/templets/樣式名稱（英文，默認(rèn)為default，其中system為系統(tǒng)底層模板，plus為插件使用的模板）/具體功能模板文件2、 模板文件命名規(guī)范：（）index_識別id.htm：表示板塊（欄目封面）模板；（）list_識別id.htm：表示欄目列表模板；（）article_識別id.htm：表示內(nèi)容查看頁（文檔模板，包括專題查看頁）；（）search.htm： 搜

4、索結(jié)果列表模板； （）index.htm： 主頁模板；注解：識別id可以在“頻道模型管理”的地方獲得，當(dāng)然，你也可以在“頻道模型管理”的地方確定某個頻道的模板命名。例：list_image.htm 表示是就是內(nèi)容類型為圖片集的欄目默認(rèn)列表模板。article_article.htm 表示的是文章查看頁模板。三、其它模板說明1、默認(rèn)底層模板位置： cmspath/templets/system功能：在沒有指定標(biāo)記的默認(rèn)底層模板的時候，系統(tǒng)將自動調(diào)用這個文件夾的相應(yīng)文件作為底層模板。2、插件目錄模板位置： cmspath/templets/plus功能：評論、友情鏈接、rss地圖等模板。3、會員后

5、臺模板位置： cmspath/member/templets功能：會員后臺的模板。四、二次開發(fā)dedecms主要的模板解析類是 include/inc_arcpart_view.php、include/inc_arclist_view.php、include/inc_archives_view.php，這些類是與pub_dedetag.php一起工作的，如果你想為文檔模板、列表模板、板塊模板增加一些功能，可以直接修改這幾個類的parsetemplet()或parsetempletsfirst()這類的方法，把標(biāo)記名稱，屬性對應(yīng)試相應(yīng)該的功能函數(shù)即時。 織夢模板標(biāo)記簡介在了解dedecms的模板

6、代碼之前，了解一下織夢模板引擎的知識是非常有意義的。織夢模板引擎是一種使用xml名字空間形式的模板解析器，使用織夢解析器解析模板的最大好處是可以輕松的制定標(biāo)記的屬性，感覺上就像在用html一樣，使模板代碼十分直觀靈活，新版的織夢模板引擎不單能實現(xiàn)模板的解析還能分析模板里錯誤的標(biāo)記。1、織夢模板引擎的代碼樣式有如下幾種形式：dede:標(biāo)記名稱 屬性=值/dede:標(biāo)記名稱 屬性=值/dede:標(biāo)記名稱dede:標(biāo)記名稱 屬性=值自定義樣式模板(innertext)/dede:標(biāo)記名稱提示：如果使用帶底層模板的標(biāo)記，必須嚴(yán)格用dede:標(biāo)記名稱 屬性=值/dede:標(biāo)記名稱 這種格式，否則會報錯。

7、2、織夢模板引擎內(nèi)置有多個系統(tǒng)標(biāo)記，這些系統(tǒng)標(biāo)記在任何場合都是能直接使用的。(1) global 標(biāo)記，表示獲取一個外部變量，除了數(shù)據(jù)庫密碼之外，能調(diào)用系統(tǒng)的任何配置參數(shù)，形式為：dede:global name=變量名稱/dede:global或dede:global name=變量名稱/。其中變量名稱不能加 $ 符號，如變量 $cfg_cmspath ，應(yīng)該寫成 dede:global name=cfg_cmspath/ 。(2) foreach 用來輸出一個數(shù)組，形式為：dede:foreach array=數(shù)組名稱field:key/ field:value/dede:foreach(

8、3) include 引入一個文件，形式為：dede:include file=文件名稱 ismake=是否為dede板塊模板(yes/no)/，對文件的搜索路徑為順序為：絕對路徑、include文件夾，cms安裝目錄，cms主模板目錄。3、織夢標(biāo)記允許在任何標(biāo)記中使用函數(shù)對得到的值進行處理，形式為：dede:標(biāo)記名稱 屬性=值 function=youfunction(參數(shù)一,參數(shù)二,me)/其中 me 用于表示當(dāng)前標(biāo)記的值，其它參數(shù)由你的函數(shù)決定是否存在，例如：dede:field name=pubdate function=strftime(%y-%m-%d %h:%m:%s,me)/4

9、、織夢標(biāo)記允許有限的編程擴展。格式為：dede:tagname runphp=yes$aaa = me;me = 123456;/dede:tagname me 表示這個標(biāo)記本身的值，因此標(biāo)記內(nèi)編程是不能使用echo之類的語句的，只能把所有返回值傳遞給me。此外由于程序代碼占用了底層模板innertext的內(nèi)容，因此需編程的標(biāo)記只能使用默認(rèn)的innertext?？棄魞?nèi)容管理系統(tǒng)模板標(biāo)簽代碼參考【arclist 標(biāo)記】 這個標(biāo)記是dedecms最常用的一個標(biāo)記，也叫自由列表標(biāo)記，其中 hotart、coolart、likeart、artlist、imglist、imginfolist、speca

10、rt、autolist 這些標(biāo)記都是由這個標(biāo)記所定義的不同屬性延伸出來的別名標(biāo)記。 功能說明：獲取指定的文檔列表適用范圍：封面模板、列表模板、文檔模板。 基本語法：dede:arclist typeid= row= col= titlelen= infolen=imgwidth= imgheight= listtype= orderby= keyword=底層模板(innertext)/dede:arclist 屬性說明：1 typeid= 表示欄目id，在列表模板和檔案模板中一般不需要指定，在封面模板中允許用,分開表示多個欄目；2 row= 表示返回文檔列表總數(shù)；3 col= 表示分多少列顯

11、示（默認(rèn)為單列）；4 titlelen= 表示標(biāo)題長度；5 infolen= 表示內(nèi)容簡介長度；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時，表示專題，等同于標(biāo)記dede:sp

12、ecart/dede:specart以上屬性值可以聯(lián)合使用，如： type=commend image 表示推薦的圖片文檔9 orderby= 表示排序方式，默認(rèn)值是 senddate 按發(fā)布時間排列。 orderby=hot 或 orderby=click 表示按點擊數(shù)排列 orderby=pubdate 按出版時間排列（即是前臺允許更改的時間值） orderby=sortrank 按文章的新排序級別排序（如果你想使用置頂文章則使用這個屬性） orderby=id 按文章id排序 orderby=postnum 按文章評論次數(shù)排序 orderby=rank 隨機獲得指定條件的文檔列表10 o

13、rderway= 值為 desc 或 asc ，指定排序方式是降序還是順向排序，默認(rèn)為降序。11 keyword= 表示含有指定關(guān)鍵字的文檔列表，多個關(guān)鍵字用,分開12 channelid= 表示特定的頻道模型id，內(nèi)置的頻道：專題(-1)、文章(1)、圖集(2)、flash(4)、軟件(3)13 limit=起始,結(jié)束 表示限定的記錄范圍，row屬性必須等于結(jié)束 - 起始，mysql的limit語句是由0起始的，如 “l(fā)imit 0,5”表示的是取前五筆記錄，“l(fā)imit 5,5”表示由第五筆記錄起，取下五筆記錄，使用了本屬性后，row屬性將無效。14 att=數(shù)值 表示自定義屬性值15 s

14、ubday=天數(shù) 表示在多少天以內(nèi)的文檔，通常用于獲取指定天數(shù)的熱門文檔、推薦文檔、熱門評論文檔等16 partsort=排列位數(shù) 表示自動獲得父欄目的所有子數(shù)中排列在第幾位的欄目id，標(biāo)記為dede:autolist/dede:autolist 時，使用本屬性才有效。 底層模板字段：id(同 id),title,iscommend,color,typeid,ismake,description(同 info),writer,shorttitle,memberidpubdate,senddate,arcrank,click,litpic(同 picname),typedir,typename,

15、arcurl(同 filename),typeurl,stime(pubdate 的0000-00-00格式),textlink,typelink,imglink,image 其中：textlink = titletypelink = typenameimglink = image = 字段調(diào)用方法：field:varname/如：dede:arclist infolen=100field:textlink/field:info/dede:arclist 注：底層模板里的field實現(xiàn)也是織夢標(biāo)記的一種形式，因此支持使用php語法，function擴展等功能如：給當(dāng)天發(fā)布的內(nèi)容加上 (new)

16、 標(biāo)志field:senddate runphp=yes $ntime = time();$oneday = 3600 * 24;if($ntime - me)$oneday) me = (new);else me = ;/field:senddate【field 標(biāo)記】功能說明：用于獲取特定欄目或檔桉的字段值及常用的環(huán)境變量值適用范圍：封面模板、列表模板、文檔模板(1)基本語法dede:field name=字段名/(2) 系統(tǒng)分配的field板塊模板：phpurl,indexurl,indexname,templeturl,memberurl,powerby,webname,specurl

17、 列表模板：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)(3) 文檔所有內(nèi)容字段檔案dede_archives表 和 附加表的所有字段。【channel 標(biāo)記】功能說明：用于獲

18、取欄目列表 適用范圍：封面模板、列表模板、文檔模板 (1)基本語法dede:channel row= type=自定義樣式模板(innertext)/dede:channel (2)屬性 1 row=數(shù)字 表示獲取記錄的條數(shù)（通用在某級欄目太多的時候使用，默認(rèn)是 8） 2 type = top,sun/son,self type=top 表示頂級欄目type=son 或 sun 表示下級欄目type=self 表示同級欄目 其中后兩個屬性必須在列表模板中使用。 (3)底層模板變量 id,typename,typedir,typelink(僅表示欄目的網(wǎng)址) 例：dede:channel typ

19、e=topfield:typename/ /dede:channel 注：在沒有指定typeid的情況下，type標(biāo)記與模板的環(huán)境有關(guān)，如，模板生成到欄目一，那么type=son就表示欄目一的所有子類【type 標(biāo)記】別名 onetype功能說明：表示指定的單個欄目的鏈接適用范圍：封面模板、列表模板、文檔模板(1)語法 dede:type typeid=/dede:type(2)屬性 typeid=欄目id(3)底層模板變量 typename,typelink(僅表示欄目的網(wǎng)址)【autochannel 標(biāo)記】功能說明：表示指定排序位置的單個欄目的鏈接適用范圍：封面模板、列表模板、文檔模板(1

20、)語法 dede:autochannel partsort=/dede:autochannel(2)屬性 partsort=欄目所在的排序位置(3)底層模板變量 typename,typelink(僅表示欄目的網(wǎng)址)【mytag 標(biāo)記】功能說明：用于獲取自定義宏標(biāo)記的內(nèi)容 適用范圍：封面模板、列表模板、文檔模板 (1)基本語法 dede:mytag typeid= name= ismake=/ (2)屬性 1 typeid = 數(shù)字 表示欄目id，默認(rèn)為 0，在沒有設(shè)定的欄目沒有定義這個名稱的標(biāo)記，會按如下搜索方式來搜索“先向上查找父欄目 - 通用標(biāo)記（typeid=0）的同名標(biāo)記”。 2 n

21、ame = 標(biāo)記名稱。 3 ismake = yes|no 默認(rèn)為 no 表示mytag里的內(nèi)容不包含其它封面模板的標(biāo)記，yes則表示標(biāo)記內(nèi)容含有其它封面模板標(biāo)記?！緑ote 標(biāo)記】功能說明：用于獲取一組投票表單 適用范圍：封面模板 (1) 基本語法dede:vote id=投票id lineheight=22tablewidth=100% titlebgcolor=#edede2titlebackground= tablebgcolor=#ffffff/dede:vote 注：本標(biāo)記直接生成投票的html表單，為了讓你更方便修改其樣式，建議在后臺-投票管理的地方直接復(fù)制生成的html代碼來使

22、用。【flink 標(biāo)記】，等同 friendlink功能說明：用于獲取友情鏈接 適用范圍：封面模板 (1)基本語法 dede:flink type= row= col= titlelen= tablestyle=/dede:flink(2)屬性1type：鏈接類型，值：a. textall 全部用文字顯示b. textimage 文字和圖得混合排列c. text 僅顯示不帶logo的鏈接d. image 僅顯示帶logo的鏈接-2row：顯示多少行，默認(rèn)為4行3col：顯示多少列，默認(rèn)為6列4titlelen：站點文字的長度5tablestyle： 表示 【mynews 標(biāo)記】功能說明：用于獲

23、取站內(nèi)新聞 適用范圍：封面模板 (1) 基本語法 dede:mynews row=條數(shù) titlelen=標(biāo)題長度innertext/dede:mynews(2)屬性1 row 新聞條數(shù)2 titlelen 標(biāo)題長度(3)底層模板變量field:title/、field:writer/、field:senddate function=strftime(%y-%m-%d %h:%m,me)/(時間)、field:body/【loop 標(biāo)記】功能說明：用于調(diào)用任意表的數(shù)據(jù)，一般用于調(diào)用論壇貼子之類的操作適用范圍：所有模板(1) 基本語法dede:loop table= sort= row= if=

24、 底層模板dede:loop (2) 屬性1 table 表示查詢的數(shù)據(jù)表2 sort 用于排序的字段3 row 返回結(jié)果的條數(shù)4 if 查詢條件(3)底層模板變量這個標(biāo)記的底層模板變量即是被查詢表的所有字段例：獲取dz論壇的最新主題貼子：amp;amp;nbsp;     dede:loop table=pw_threads sort=tid row=8 if=

25、<br>       <a href="/bbs/read.php?tid=field:tid/"> ·field:subject function="cn_substr(me,30)"/  &am

26、p;amp;nbsp;     (field:lastpost function="date(m-d h:m,me)"/)</a> <br/>      

27、 dede:loop【channelartlist 標(biāo)記】功能說明：用于獲取當(dāng)前頻道的下級欄目的內(nèi)容列表 適用范圍：封面模板(1)基本語法dede:channelartlist typeid=0 col=2 tablewidth=100%dede:typefield:typename /更多./dede:typedede:arclist row=8field:title /dede:arclist /dede:channelartlist 除了宏標(biāo)記外，channelartlist 是唯一一個可以直接嵌套其它標(biāo)記的標(biāo)記，不過僅限于嵌套 dede:type/d

28、ede:type 和 dede:arclist/dede:arclist 兩個標(biāo)記。 (2) 屬性1typeid=0 頻道id,默認(rèn)的情況下，嵌套的標(biāo)記使用的是這個欄目id的下級欄目，如果你想用特定的欄目，可以用,分開多個id。 2col=2 分多列顯示 3tablewidth=100% 外圍表格的大小【list 標(biāo)記】功能說明：表示列表模板里的分頁內(nèi)容列表 適用范圍：僅列表模板 list_*.htm(1)基本語法dede:list col= titlelen= infolen= imgwidth= imgheight= orderby= pagesize=/dede:list (2)屬性1c

29、ol 內(nèi)容列數(shù)2titlelen 標(biāo)題長度3infolen 內(nèi)容摘要長度4imgwidth 縮略圖寬5imgheight 縮略圖高6orderby 排序方式，有效的排序方式有 senddate、pubdate、id、click、lastpost、postnum ，默認(rèn)為 sortrank 7pagesize 分頁大小(3)底層模板變量 id(同 id),title,iscommend,color,typeid,ismake,description(同 info),postnum,lastpost,shorttitlepubdate,senddate,arcrank,click,litpic(同 picname),typedir,typename,arc