dedecms 制作模板中使用的全局标记介绍
解析引擎概述? 模板設計規范? 代碼參考
標記參考:?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?模板制作規范
1、DedeCms?的主要模板放在?“DedeCms安裝目錄/templets”?目錄,其中system為底層模板,一般可以在“自定義樣式模板(InnerText)”中改變,default?文件夾就是DedeCms官方提供的默認模板。因為DedeCms最小系統都包含圖集、文章、Flash、下載4個大模板,加上專題、搜索?和?主頁模板,一共有十六個基本的模板文件,你可以按自己的情況更改有需要的模板。
2、DedeCms的模板標記按功能分為:封面模板標記(頻道封面、主頁)、列表模板標記、文檔模板標記和特殊用途標記。
三、主要標記參考
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=''?表示返回文檔條數;
[3]?col=''?表示分多少列顯示(默認為單列);
[4]?titlelen=''?表示標題長度;
[5]?infolen=''?表示內容簡介長度;
[6]?imgwidth=''?表示縮略圖寬度;
[7]?imgheight=''?表示縮略圖高度;
[8]?type=''?表示檔案類型,其中默認值或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='數字',特定的頻道類型,1?文章,2?圖片集,3?軟件,4?Flash,其它數字則是用戶自定義頻道的id?,即是?dede_channeltype.ID?的值。
[9]?orderby=''?表示排序方式,默認值是?senddate?按發布時間排列。?同名屬性:?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=''?表示含有指定關鍵字的文檔列表,多個關鍵字用","分開。
(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?row=''?col=''?titlelen=''?tablestyle=''}{/dede:flink}
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}
[field:typename?/]
更多...
{/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?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?標記
表示分頁頁碼列表
適用范圍:列表模板
語法:
{dede:pagelist?listsize="3"/}
listsize?表示?[1][2][3]?這些項的長度?x?2?
13、pagebreak?標記
用途:表示文檔的分頁鏈接列表。
適用范圍:僅文檔模板。?
語法:{dede:pagebreak?/}?
14、?fieldlist?標記
用途:獲得附加表的所有字段信息。
適用范圍:僅文檔模板。?
語法:
{dede:fieldlist}
[field:name?/]?:?[field:value?/]?
{/dede:fieldlist}
轉載于:https://www.cnblogs.com/xrhui/p/4450571.html
總結
以上是生活随笔為你收集整理的dedecms 制作模板中使用的全局标记介绍的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: (011)XHTML文档之列表
- 下一篇: linux下iptables讲解