解析引擎概述 模板設計規範 代碼參考
標記參考： arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart) field channel mytag vote friendlink mynews loop channelartlist page list pagelist pagebreak fieldlist
一、織夢模板解析引擎概述 在瞭解DedeCms的模板代碼之前，瞭解一下織夢模板引擎的知識是非常有意義的。織夢模板引擎是一種使用XML名字空間形式的模板解析器，使用織夢解析器解析模板的最大好處是可以輕鬆的制定標記的屬性，感覺上就像在用HTML一樣，使模板代碼十分直觀靈活，新版的織夢模板引擎不單能實現模板的解析還能分析模板裡錯誤的標記。
1、織夢模板引擎的代碼樣式有如下幾種形式：
{dede:標記名稱 屬性='值'/}
{dede:標記名稱 屬性='值'}{/dede:標記名稱}
{dede:標記名稱 屬性='值'}自訂樣式模板(InnerText){/dede:標記名稱}
提示：
對於{dede:標記名稱 屬性='值'}{/dede:標記名稱}這種形式的標記，在2.1版中，表示結束只需要用“{/dede}”，但
V3中需要嚴格用“{/dede:標記名稱}”，否則會報錯。
2、織夢模板引擎內建有多個系統標記，這些系統標記在任何場合都是能直接使用的。
(1) global 標記，表示擷取一個外部變數，除了資料庫密碼之外，能調用系統的任何配置參數，形式為：
{dede:global name='變數名稱'}{/dede:global}
或
{dede:global name='變數名稱' /}
其中變數名稱不能加 $ 符號，如變數 $cfg_cmspath ，應該寫成 {dede:global name='cfg_cmspath' /} 。
(2) foreach 用來輸出一個數組，形式為：
{dede:foreach array='數組名稱'}[field:key/] [field:value/]{/dede:foreach}
(3) include 引入一個檔案，形式為：
{dede:include file='檔案名稱' /}
對檔案的搜尋路徑為順序為：絕對路徑、include檔案夾，CMS安裝目錄，CMS主模板目錄
3、織夢標記允許在任何標記中使用函數對得到的值進行處理，形式為：
{dede:標記名稱 屬性='值' function='youfunction("參數一","參數二","@me")'/}
其中 @me 用於表示當前標記的值，其它參數由你的函數決定是否存在，例如：
{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")' /}
二、DedeCms 模板製作規範
DedeCms系統的模板是非固定的，使用者可以在建立欄目時可以自行選擇欄目模板，官方僅提供最基本的預設範本，即是內建系統模型的各個模板，DedeCms支援自訂頻道模型，使用者自訂新頻道模型後，需要按該模型設計一套新的模板。
一、概念，設計和使用模板，必須要理解下面幾個概念：
1、板塊（封面）模板：
指網站首頁或比較重要的欄目封面使用的模板，一般用“index_識別ID.htm”命名，此外，使用者單獨定義的單個頁面或自訂標籤，也可選是否支援板塊模板標記，如果支援，系統會用板塊模板標記引擎去解析後才輸出內容或產生特定的檔案。
2、列表模板：
指網站某個欄目的所有文章列表的模板，一般用 “list_識別ID.htm” 命名。
3、檔案模板：
表示文檔查看頁的模板，一般用 “article_識別ID.htm” 命名。
4、其它模板：
一般系統常規包含的模板有：首頁模板、搜尋模板、ＲＳＳ、ＪＳ編譯功能模板等，此外使用者也可以自訂一個模板建立為任意檔案。
二、 命名，為了規範起見，織夢官方建議使用統一的方式來命名模板，具體如下：
1、模板儲存位置：
模板目錄：｛cmspath/templets/樣式名稱（英文，預設為default，其中system為系統底層模板，plus為外掛程式使用的模板）/具體功能模板檔案｝
一般的模板位置：“/templets/default”
2、 模板檔案命名規範：
（１）index_識別ID.htm： 表示板塊（欄目封面）模板；
（２）list_識別ID.htm： 表示欄目列表模板；
（３）article_識別ID.htm： 表示內容查看頁（文件範本，包括專題查看頁）；
（４）search.htm： 搜尋結果列表模板；
（５）index.htm： 首頁模板；
註解：
你的系統各個內容頻道的[識別ID]分別為：
例：list_image.htm 表示是就是內容類型為圖片集的欄目預設列表模板。
三、主要標記參考
1、arclist 標記
這個標記是DedeCms最常用的一個標記，其中 hotart、coolart、likeart、artlist、imglist、imginfolist、specart 這些標記都是由這個標記所定義的不同屬性延伸出來的。
作用：擷取一個指定的文檔列表
適用範圍：封面模板、列表模板、文件範本
(1)基本文法：
{dede:arclist
typeid='' row='' col='' titlelen=''
infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword=''}
自訂樣式模板(InnerText)
{/dede:arclist}
本標記等同於artlist、imglist、imginfolist標記，其中與artlist是完全等同的，與imglist、imginfolist僅是預設的底層模板不同。
(2)屬性參考：
[1] typeid='' 表示欄目ID，在列表模板和檔案模板中一般不需要指定，在封面模板中允許用","分開表示多個欄目；
[2] row='' 表示返迴文檔行數，如果和col聯合使用，剛結果數等於row * col；
[3] col='' 表示分多少列顯示（預設為單列）；
[4] titlelen='' 表示標題長度；
[5] infolen='' 表示內容簡介長度；
[6] imgwidth='' 表示縮圖寬度；
[7] imgheight='' 表示縮圖高度；
[8] type='' 表示檔案類型，其中預設值或type='all'時為普通文檔
§ type='commend'時，表示推薦文檔，等同於
§ type='image'時，表示必須含有縮圖片的文檔
[9] orderby='' 表示排序方式，預設值是 senddate 按發布時間排列。
§ orderby='hot' 或 orderby='click' 表示按點擊數排列
§ orderby='pubdate' 按出版時間排列（即是前台允許更改的時間值）
§ orderby='sortrank' 按文章的新排序層級排序（如果你想使用置頂文章則使用這個屬性）
§ orderby='id' 按文章ID排序
[10] keyword='' 表示含有指定關鍵字的文檔列表，多個關鍵字用","分開
[11] channelid='數字' 表示特定的頻道類型，內建的頻道：專題(-1)、文章(1)、圖集(2)、Flash(4)、軟體(3)
[12] limit='起始,結束' 表示限定的記錄範圍，row屬性必須等於"結束 - 起始"，mysql的limit語句是由0起始的，如 “limit 0,5”表示的是取前五筆記錄，“limit 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 = title
typelink = typename
imglink =
image =
變數調用方法：[field:varname /]
如：
{dede:arclist infolen='100'}
[field:textlink /]
[field:info /]
{/dede:arclist}
2、field 標記
這個標記用於擷取特定欄目或檔桉的欄位值及常用的環境變數值
適用範圍：封面模板、列表模板、文件範本
(1)基本文法
{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則為這種形式的標題
文件範本：position,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,id(同 ID,aid),檔案dede_archives表和附加表的所有欄位。
3、channel 標記
用於擷取欄目列表
適用範圍：封面模板、列表模板、文件範本
(1)基本文法
{dede:channel row='' type=''}
自訂樣式模板(InnerText)
{/dede:channel}
(2)屬性
[1] row='數字' 表示擷取記錄的條數（通用在某級欄目太多的時候使用，預設是 8）
[2] type = top,sun,self
type='top' 表示頂級欄目
type='sun' 表示下級欄目
type='self' 表示同級欄目
其中後兩個屬性必須在列表模板中使用。
(3)底層模板變數
ID,typename,typedir,typelink(這裡僅表示欄目的網址)
例：
{dede:channel type='top'}
[field:typename/]
{/dede:channel}
4、mytag 標記
用於擷取自訂標籤的內容
適用範圍：封面模板、列表模板、文件範本
(1)基本文法
{dede:mytag typeid='' name='' ismake='' /}
(2)屬性
[1] typeid = '數字' 表示欄目ID，預設為 0，在沒有設定的欄目沒有定義這個名稱的標記，會按如下搜尋方式來搜尋“先向上尋找父欄目 -> 通用標記（typeid=0）的同名標記”。
[2] name = '' 標記名稱。
[3] ismake = yes|no 預設為 no 表示mytag裡的內容不包含其它封面模板的標記，yes則表示標記內容含有其它封面模板標記。
5、vote 標記
用於擷取一組投票表單
適用範圍：封面模板
(1) 基本文法
{dede:vote id='投票ID' lineheight='22'
tablewidth='100%' titlebgcolor='#EDEDE2'
titlebackground='' tablebgcolor='#FFFFFF'}
{/dede:vote}
6、friendlink 標記，等同 flink
用於擷取友情連結
適用範圍：封面模板
(1)基本文法
{dede:flink type='' row='' col='' titlelen='' tablestyle=''}{/dede:flink}
屬性註解：
[1]type：連結類型，值：
a. textall 全部用文字顯示
b. textimage 文字和圖得混合排列
c. text 僅顯示不帶Logo的連結
d. image 僅顯示帶Logo的連結
-------------------------------------
[2]row：顯示多少行，預設為4行
[3]col：顯示多少列，預設為6列
[4]titlelen：網站文字的長度
[5]tablestyle： 表示
7、mynews 標記 用於擷取站內新聞 適用範圍：封面模板 (1) 基本文法 {dede:mynews row='條數' titlelen='標題長度'}Innertext{/dede:mynews} Innertext支援的欄位為：[field:title /],[field:writer /],[field:senddate /](時間),[field:body /] 8、loop 標記 用於調用任意表的資料，一般用於調用論壇貼子之類的操作，請參閱論壇擴充外掛程式。 9、channelartlist 標記 用於擷取頻道的下級欄目的內容列表 適用範圍：封面模板 文法： {dede:channelArtlist typeid=0 col=2 tablewidth='100%'}
{dede:type}
{/dede:type}
|
{dede:arclist row="8"}
·[field:title /]
{/dede:arclist}
|
{/dede:channelArtlist}
channelArtlist 是唯一一個可以直接嵌套其它標記的標記，不過僅限於嵌套
{dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist}
標記。
(1) 屬性
typeid=0 頻道ID,預設的情況下，嵌套的標記使用的是這個欄目ID的下級欄目，如果你想用特定的欄目，可以用","分開多個ID。
col=2 分多列顯示
tablewidth='100%' 外圍表格的大小
10、page 標記
表示分頁頁面的附加參數
適用範圍：列表模板
文法：
{dede:page pagesize="每頁結果條數"/}
11、list 標記
表示列表模板裡的內容列表
文法：
{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 標記
表示分頁頁碼列表
適用範圍：列表模板
文法：
{dede:pagelist listsize="3"/}
listsize 表示 [1][2][3] 這些項的長度 x 2
13、pagebreak 標記
用途：表示文檔的分頁連結清單。
適用範圍：僅文件範本。
文法：{dede:pagebreak /}
14、 fieldlist 標記
用途：獲得附加表的所有欄位資訊。
適用範圍：僅文件範本。
文法：
{dede:fieldlist}
[field:name /] ： [field:value /]
{/dede:fieldlist}
http://www.bkjia.com/PHPjc/318224.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/318224.htmlTechArticle解析引擎概述 模板設計規範 代碼參考 標記參考：arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart)fieldchannelmytagvotefriendlinkmynewsloopchanne...
