|
|
解析引擎概述 模板設(shè)計規(guī)范 代碼參考
標(biāo)記參考： arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart) field channel mytag vote friendlink mynews loop channelartlist page list pagelist pagebreak fieldlist
--------------------------------------------------------------------------------
一、織夢模板解析引擎概述
在了解DedeCms的模板代碼之前，了解一下織夢模板引擎的知識是非常有意義的。織夢模板引擎是一種使用XML名字空間形式的模板解析器，使用織夢解析器解析模板的最大好處是可以輕松的制定標(biāo)記的屬性，感覺上就像在用HTML一樣，使模板代碼十分直觀靈活，新版的織夢模板引擎不單能實(shí)現(xiàn)模板的解析還能分析模板里錯誤的標(biāo)記。
1、織夢模板引擎的代碼樣式有如下幾種形式：
{dede:標(biāo)記名稱 屬性='值'/}
{dede:標(biāo)記名稱 屬性='值'}{/dede:標(biāo)記名稱}
{dede:標(biāo)記名稱 屬性='值'}自定義樣式模板(InnerText){/dede:標(biāo)記名稱}
提示：
對于{dede:標(biāo)記名稱 屬性='值'}{/dede:標(biāo)記名稱}這種形式的標(biāo)記，在2.1版中，表示結(jié)束只需要用“{/dede}”，但
V3中需要嚴(yán)格用“{/dede:標(biāo)記名稱}”，否則會報錯。
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}
(3) include 引入一個文件，形式為：
{dede:include file='文件名稱' /}
對文件的搜索路徑為順序?yàn)椋航^對路徑、include文件夾，CMS安裝目錄，CMS主模板目錄
3、織夢標(biāo)記允許在任何標(biāo)記中使用函數(shù)對得到的值進(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ī)范
1、DedeCms 的主要模板放在 “DedeCms安裝目錄/templets” 目錄，其中system為底層模板，一般可以在“自定義樣式模板(InnerText)”中改變，default 文件夾就是DedeCms官方提供的默認(rèn)模板。因?yàn)镈edeCms最小系統(tǒng)都包含圖集、文章、Flash、下載4個大模板，加上專題、搜索 和 主頁模板，一共有十六個基本的模板文件，你可以按自己的情況更改有需要的模板。
2、DedeCms的模板標(biāo)記按功能分為：封面模板標(biāo)記（頻道封面、主頁）、列表模板標(biāo)記、文檔模板標(biāo)記和特殊用途標(biāo)記。
三、主要標(biāo)記參考
1、arclist 標(biāo)記
這個標(biāo)記是DedeCms最常用的一個標(biāo)記，其中 hotart、coolart、likeart、artlist、imglist、imginfolist、specart 這些標(biāo)記都是由這個標(biāo)記所定義的不同屬性延伸出來的。
作用：獲取一個指定的文檔列表
適用范圍：封面模板、列表模板、文檔模板
(1)基本語法：
{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，在列表模板和檔案模板中一般不需要指定，在封面模板中允許用","分開表示多個欄目；
[2] row='' 表示返回文檔條數(shù)；
[3] col='' 表示分多少列顯示（默認(rèn)為單列）；
[4] titlelen='' 表示標(biāo)題長度；
[5] infolen='' 表示內(nèi)容簡介長度；
[6] imgwidth='' 表示縮略圖寬度；
[7] imgheight='' 表示縮略圖高度；
[8] type='' 表示檔案類型，其中默認(rèn)值或type='all'時為普通文檔
§ type='spec'時，表示專題文檔，等同于
{dede:specart typeid='' row='' col='' titlelen='' infolen=''
imgwidth='' imgheight='' listtype='' keyword=''}{/dede:specart}
§ type='commend'時，表示推薦文檔，等同于
{dede:coolart typeid='' row='' col='' titlelen='' infolen=''
imgwidth='' imgheight='' listtype='' keyword=''}{/dede:coolart}
§ type='image'時，表示必須含有縮略圖片的文檔
§ type='數(shù)字'，特定的頻道類型，1 文章，2 圖片集,3 軟件,4 Flash，其它數(shù)字則是用戶自定義頻道的id ，即是 dede_channeltype.ID 的值。
[9] orderby='' 表示排序方式，默認(rèn)值是 senddate 按發(fā)布時間排列。 同名屬性： sort
§ orderby='hot' 或 orderby='click' 表示按順序排列，使用本屬性后等同于
{dede:hotart typeid='' row='' col='' titlelen='' infolen=''
imgwidth='' imgheight='' listtype='' keyword=''}{/dede:hotart}
§ orderby='pubdate' 按出版時間排列（即是前臺允許更改的時間值）
§ orderby='sortrank' 按文章的新排序級別排序（如果你想使用置頂文章則使用這個屬性）
§ orderby='id' 按文章ID排序
[10] keyword='' 表示含有指定關(guān)鍵字的文檔列表，多個關(guān)鍵字用","分開。
(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 =
變量調(diào)用方法：[field:varname /]
如：
{dede:arclist infolen='100'}
[field:textlink /]
[field:info /]
{/dede:arclist}
2、field 標(biāo)記
這個標(biāo)記用于獲取特定欄目或檔桉的字段值及常用的環(huán)境變量值
適用范圍：封面模板、列表模板、文檔模板
(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則為這種形式的標(biāo)題
文檔模板：position,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl,id(同 ID,aid),檔案dede_archives表和附加表的所有字段。
3、channel 標(biāo)記
用于獲取欄目列表
適用范圍：封面模板、列表模板、文檔模板
(1)基本語法
{dede:channel row='' type=''}
自定義樣式模板(InnerText)
{/dede:channel}
(2)屬性
[1] row='數(shù)字' 表示獲取記錄的條數(shù)（通用在某級欄目太多的時候使用，默認(rèn)是 8）
[2] type = top,sun,self
type='top' 表示頂級欄目
type='sun' 表示下級欄目
type='self' 表示同級欄目
其中后兩個屬性必須在列表模板中使用。
(3)底層模板變量
ID,typename,typedir,typelink(這里僅表示欄目的網(wǎng)址)
例：
{dede:channel type='top'}
[field:typename/]
{/dede:channel}
4、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] 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) 基本語法
{dede:vote id='投票ID' lineheight='22'
tablewidth='100%' titlebgcolor='#EDEDE2'
titlebackground='' tablebgcolor='#FFFFFF'}
{/dede:vote}
6、friendlink 標(biāo)記，等同 flink
用于獲取友情鏈接
適用范圍：封面模板
(1)基本語法
{dede:flink row='' col='' titlelen='' tablestyle=''}{/dede:flink}
7、mynews 標(biāo)記
用于獲取站內(nèi)新聞
適用范圍：封面模板
(1) 基本語法
{dede:mynews row='條數(shù)' titlelen='標(biāo)題長度'}Innertext{/dede:mynews}
Innertext支持的字段為：[field:title /],[field:writer /],[field:senddate /](時間),[field:body /]
8、loop 標(biāo)記
用于調(diào)用任意表的數(shù)據(jù)，一般用于調(diào)用論壇貼子之類的操作。
9、channelartlist 標(biāo)記
用于獲取頻道的下級欄目的內(nèi)容列表
適用范圍：封面模板
語法：
{dede:channelArtlist typeid=0 col=2 tablewidth='100%'}
{dede:type}
[field:typename /]
更多...
{/dede:type}
{dede:arclist row="8"}
?[field:title /]
{/dede:arclist}
{/dede:channelArtlist}
channelArtlist 是唯一一個可以直接嵌套其它標(biāo)記的標(biāo)記，不過僅限于嵌套
{dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist}
標(biāo)記。
(1) 屬性
typeid=0 頻道ID,默認(rèn)的情況下，嵌套的標(biāo)記使用的是這個欄目ID的下級欄目，如果你想用特定的欄目，可以用","分開多個ID。
col=2 分多列顯示
tablewidth='100%' 外圍表格的大小
10、page 標(biāo)記
表示分頁頁面的附加參數(shù)
適用范圍：列表模板
語法：
{dede:page pagesize="每頁結(jié)果條數(shù)"/}
11、list 標(biāo)記
表示列表模板里的內(nèi)容列表
語法：
{dede:list row='' 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)記
表示分頁頁碼列表
適用范圍：列表模板
語法：
{dede:pagelist listsize="3"/}
listsize 表示 [1][2][3] 這些項(xiàng)的長度 x 2
13、pagebreak 標(biāo)記
用途：表示文檔的分頁鏈接列表。
適用范圍：僅文檔模板。
語法：{dede:pagebreak /}
14、 fieldlist 標(biāo)記
用途：獲得附加表的所有字段信息。
適用范圍：僅文檔模板。
語法：
{dede:fieldlist}
[field:name /] ： [field:value /]
{/dede:fieldlist}
轉(zhuǎn)載于：http://hi.baidu.com/us%5fhosting
php技術(shù)：dedecms 制作模板中使用的全局標(biāo)記圖文教程，轉(zhuǎn)載需保留來源！
鄭重聲明：本文版權(quán)歸原作者所有，轉(zhuǎn)載文章僅為傳播更多信息之目的，如作者信息標(biāo)記有誤，請第一時間聯(lián)系我們修改或刪除，多謝。
