導(dǎo)讀:DEDE技術(shù)DEDE技術(shù)解析引擎概述 模板設(shè)計(jì)規(guī)范 代碼參考 標(biāo)記參考： arclist(artlist,likeart,hotart,imglist,imginfolist,cooldede會(huì)員中心模板dede5.7模板。

解析引擎概述 　模板設(shè)計(jì)規(guī)范 　代碼參考 標(biāo)記參考： arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart) field channel mytag vote friendlink mynews loop channelartlist page list pagelist pagebreak fieldlist 一、織夢(mèng)模板解析引擎概述 在了解DedeCms的模板代碼之前，了解一下織夢(mèng)模板引擎的知識(shí)是非常有意義的。織夢(mèng)模板引擎是一種使用XML名字空間形式的模板解析器，使用織夢(mèng)解析 器解析模板的最大好處是可以輕松的制定標(biāo)記的織夢(mèng)模板網(wǎng)屬性，感覺(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)格用“{/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:global name='變量名稱'}{/dede:global} 或 {dede:global name='變量名稱' /} 其中變量名稱不能加 $ 符號(hào)，如變量 $cfg_cmspath ，應(yīng)該寫成 {dede:global name='cfg_cmspath' /} 。 (2) foreach 用來(lái)輸出一個(gè)數(shù)組，形式為： {dede:foreach array='數(shù)組名稱'}[field:key/] [field:value/]{/dede:foreach} (3) include 引入一個(gè)文件，形式為： {dede:include file='文件名稱' /} 對(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:field name='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í)別ID.htm”命名，此外，用戶單獨(dú)定義的單個(gè)頁(yè)面或自定義標(biāo)記，也可選是否支持板塊模板標(biāo)記，如果支持，系統(tǒng)會(huì)用板塊模板標(biāo)記引擎去解析后才輸出內(nèi)容或生成特定的文件。 2、列表模板： 　　指網(wǎng)站某個(gè)欄目的所有文章列表的模板，一般用 “l(fā)ist_識(shí)別ID.htm” 命名。 3、檔案模板： 　　表示文檔查看頁(yè)的模板，一般用 “article_識(shí)別ID.htm” 命名。 4、其它模板： 　　一般系統(tǒng)常規(guī)包含的模板有：主頁(yè)模板、搜索模板、ＲＳＳ、ＪＳ編譯功能模板等，此外用戶也可以自定義一個(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ī)范： （１）index_識(shí)別ID.htm：　表示板塊（欄目封面）模板； （２）list_識(shí)別ID.htm：　表示欄目列表模板； （３）article_識(shí)別ID.htm：　表示內(nèi)容查看頁(yè)（文檔模板，包括專題查看頁(yè)）； （４）search.htm： 搜索結(jié)果列表模板； （５）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: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，在列表模板和檔案模板中一般不需要指定，在封面模板中允許用","分開(kāi)表示多個(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)鍵字用","分開(kāi) [11] channelid='數(shù)字' 表示特定的頻道類型，內(nèi)置的頻道：專題(-1)、文章(1)、圖集(2)、flash(4)、軟件(3) [12] limit='起始,結(jié)束' 表示限定的記錄范圍，row屬性必須等于"結(jié)束 - 起始"，mysql的limit語(yǔ)句是由0起始的，如 “l(fā)imit 0,5”表示的是取前五筆記錄，“l(fā)imit 5,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 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'> 變量調(diào)用方法：[field:varname /] 如： {dede:arclist infolen='100'} [field:textlink /] <br> [field:info /] <br> {/dede:arclist} 2、field 標(biāo)記 這個(gè)標(biāo)記用于獲取特定欄目或檔桉的字段值及常用的環(huán)境變量值 適用范圍：封面模板、列表模板、文檔模板 (1)基本語(yǔ)法 {dede:field name=''/} (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:channel row='' 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:channel type='top'} <a href='[field:typelink /]'>[field:typename/]</a> {/dede:channel} 4、mytag 標(biāo)記 用于獲取自定義標(biāo)記的內(nèi)容 適用范圍：封面模板、列表模板、文檔模板 (1)基本語(yǔ)法 {dede:mytag typeid='' 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:vote id='投票ID' lineheight='22' tablewidth='100%' titlebgcolor='#EDEDE2' titlebackground='' tablebgcolor='#FFFFFF'} {/dede:vote} 6、friendlink 標(biāo)記，等同 flink 用于獲取友情鏈接 適用范圍：封面模板 (1)基本語(yǔ)法 {dede:flink type='' 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:mynews row='條數(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ǔ)法： 織夢(mèng)模板網(wǎng)站{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> <div style='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í)欄目，如果你想用特定的欄目，可以用","分開(kāi)多個(gè)ID。 col=2 分多列顯示 tablewidth='100%' 外圍表格的大小 10、page 標(biāo)記 表示分頁(yè)頁(yè)面的附加參數(shù) 適用范圍：列表模板 語(yǔ)法： {dede:page pagesize="每頁(yè)結(jié)果條數(shù)"/} 11、list 標(biāo)記 表示列表模板里的內(nèi)容列表 語(yǔ)法： {dede:list col='' 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:pagelist listsize="3"/} listsize 表示 [1][2][3] 這些項(xiàng)的長(zhǎng)度 x 2 13、pagebreak 標(biāo)記 用途：表示文檔的分頁(yè)鏈接列表。 適用范圍：僅文檔模板。 語(yǔ)法：{dede:pagebreak /} 14、 fieldlist 標(biāo)記 用途：獲得附加表的所有字段信息。 適用范圍：僅文檔模板。 語(yǔ)法： {dede:fieldlist} [field:name /] ： [field:value /] <br> {/dede:fieldlist}

關(guān)鍵詞標(biāo)簽: DEDE技術(shù) 使用方法 模板