DedeCms(織夢)模版制作教程及標(biāo)記語法詳解

一、織夢(Dedecms)簡介:
織夢內(nèi)容管理系統(tǒng)(DedeCms) 以簡單、實用、開源而聞名,是國內(nèi)最知名的PHP開源網(wǎng)站管理系統(tǒng),也是使用用戶最多的PHP類CMS系統(tǒng),在經(jīng)歷了二年多的發(fā)展,目前的版本無論在功能,還是是易用性方面,都有了長足的發(fā)展,DedeCms免費版的主要目標(biāo)用戶鎖定在個人站長,功能更專注于個人網(wǎng)站或中小型門戶的構(gòu)建,當(dāng)然也不乏有企業(yè)用戶和學(xué)校等在使用本系統(tǒng)??棄魞?nèi)容管理系統(tǒng)(DedeCms)基于PHP+MySQL的技術(shù)架構(gòu),完全開源加上強大穩(wěn)定的技術(shù)架構(gòu),使你無論是目前打算做個小型網(wǎng)站,還是想讓網(wǎng)站在不斷壯大后系仍能得到隨意擴充都有充分的保證。
二、織夢(Dedecms)模板解析引擎概述:
織夢模板引擎是一種使用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)記名稱}
小提示:對于{dede:標(biāo)記名稱 屬性='值'}{/dede:標(biāo)記名稱}這種形式的標(biāo)記,在2.1版中,表示結(jié)束只需要用“{/dede}”,但V3中需要嚴格用“{/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ù),形式為:
a、{dede:global name='變量名稱'}{/dede:global}
b、{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='文件名稱' /}
對文件的搜索路徑為順序為:絕對路徑、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")' /}
三、DedeCms 模板制作規(guī)范:
DedeCms系統(tǒng)的模板是非固定的,用戶可以在新建欄目時可以自行選擇欄目模板,官方僅提供最基本的默認模板,即是內(nèi)置系統(tǒng)模型的各個模板,DedeCms支持自定義頻道模型,用戶自定義新頻道模型后,需要按該模型設(shè)計一套新的模板。
1、概念,設(shè)計和使用模板,必須要理解下面幾個概念:
1)板塊(封面)模板:指網(wǎng)站主頁或比較重要的欄目封面使用的模板,一般用“index_識別ID.htm”命名,此外,用戶單獨定義的單個頁面或自定義標(biāo)記,也可選是否支持板塊模板標(biāo)記,如果支持,系統(tǒng)會用板塊模板標(biāo)記引擎去解析后才輸出內(nèi)容或生成特定的文件。
2)列表模板:指網(wǎng)站某個欄目的所有文章列表的模板,一般用 “list_識別ID.htm” 命名。
3)檔案模板:表示文檔查看頁的模板,一般用 “article_識別ID.htm” 命名。
4)其它模板:一般系統(tǒng)常規(guī)包含的模板有:主頁模板、搜索模板、RSS、JS編譯功能模板等,此外用戶也可以自定義一個模板創(chuàng)建為任意文件。
2、 命名,為了規(guī)范起見,織夢官方建議使用統(tǒng)一的方式來命名模板,具體如下:
1、模板保存位置:
模板目錄:{cmspath/templets/樣式名稱(英文,默認為default,其中system為系統(tǒng)底層模板,plus為插件使用的模板)/具體功能模板文件}
一般的模板位置:“/templets/default”
2、 模板文件命名規(guī)范:
1)index_識別ID.htm: 表示板塊(欄目封面)模板;
2)list_識別ID.htm: 表示欄目列表模板;
3)article_識別ID.htm: 表示內(nèi)容查看頁(文檔模板,包括專題查看頁);
4)search.htm: 搜索結(jié)果列表模板;
5)index.htm: 主頁模板;
注解:
你的系統(tǒng)各個內(nèi)容頻道的[識別ID]分別為:
例:list_image.htm 表示是就是內(nèi)容類型為圖片集的欄目默認列表模板。
3、主要標(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僅是默認的底層模板不同。
(2)屬性參考:
[1] typeid='' 表示欄目ID,在列表模板和檔案模板中一般不需要指定,在封面模板中允許用","分開表示多個欄目;
[2] row='' 表示返回文檔行數(shù),如果和col聯(lián)合使用,剛結(jié)果數(shù)等于row * col;
[3] col='' 表示分多少列顯示(默認為單列);
[4] titlelen='' 表示標(biāo)題長度;
[5] infolen='' 表示內(nèi)容簡介長度;
[6] imgwidth='' 表示縮略圖寬度;
[7] imgheight='' 表示縮略圖高度;
[8] type='' 表示檔案類型,其中默認值或type='all'時為普通文檔
type='commend'時,表示推薦文檔,等同于
type='image'時,表示必須含有縮略圖片的文檔
[9] orderby='' 表示排序方式,默認值是 senddate 按發(fā)布時間排列。
orderby='hot' 或 orderby='click' 表示按點擊數(shù)排列
orderby='pubdate' 按出版時間排列(即是前臺允許更改的時間值)
orderby='sortrank' 按文章的新排序級別排序(如果你想使用置頂文章則使用這個屬性)
orderby='id' 按文章ID排序
[10] keyword='' 表示含有指定關(guān)鍵字的文檔列表,多個關(guān)鍵字用","分開
[11] channelid='數(shù)字' 表示特定的頻道類型,內(nèi)置的頻道:專題(-1)、文章(1)、圖集(2)、Flash(4)、軟件(3)
[12] limit='起始,結(jié)束' 表示限定的記錄范圍,row屬性必須等于"結(jié)束 - 起始",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 = <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)記
這個標(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ù)(通用在某級欄目太多的時候使用,默認是 8)
[2] type = top,sun,self
type='top' 表示頂級欄目
type='sun' 表示下級欄目
type='self' 表示同級欄目
其中后兩個屬性必須在列表模板中使用。
(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)容
適用范圍:封面模板、列表模板、文檔模板
基本語法
{dede:mytag typeid='' name='' ismake='' /}
屬性
[1] typeid = '數(shù)字' 表示欄目ID,默認為 0,在沒有設(shè)定的欄目沒有定義這個名稱的標(biāo)記,會按如下搜索方式來搜索“先向上查找父欄目 -> 通用標(biāo)記(typeid=0)的同名標(biāo)記”。
[2] name = '' 標(biāo)記名稱。
[3] ismake = yes|no 默認為 no 表示mytag里的內(nèi)容不包含其它封面模板的標(biāo)記,yes則表示標(biāo)記內(nèi)容含有其它封面模板標(biāo)記。
5、vote 標(biāo)記
用于獲取一組投票表單
適用范圍:封面模板
基本語法
{dede:vote id='投票ID' lineheight='22'
tablewidth='100%' titlebgcolor='#EDEDE2'
titlebackground='' tablebgcolor='#FFFFFF'}
{/dede:vote}
6、friendlink 標(biāo)記,等同 flink
用于獲取友情鏈接
適用范圍:封面模板
基本語法
{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: 表示 <table 這里的內(nèi)容>
7、mynews 標(biāo)記
用于獲取站內(nèi)新聞
適用范圍:封面模板
基本語法
{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%'}
<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 _fcksavedurl=""[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 是唯一一個可以直接嵌套其它標(biāo)記的標(biāo)記,不過僅限于嵌套
{dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist}
標(biāo)記。
(1) 屬性
typeid=0 頻道ID,默認的情況下,嵌套的標(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 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] 這些項的長度 x 2
13、pagebreak 標(biāo)記
用途:表示文檔的分頁鏈接列表。
適用范圍:僅文檔模板。
語法:{dede:pagebreak /}
14、fieldlist 標(biāo)記
用途:獲得附加表的所有字段信息。
適用范圍:僅文檔模板。
語法:
{dede:fieldlist}
[field:name /] : [field:value /] <br>
{/dede:fieldlist}
以上就為大家介紹了dedecms模板制作教程的基礎(chǔ)知識,由于知識比較雜且多特別是標(biāo)記語法講解那段,所以需要大家多多用心學(xué)習(xí)下,只要用心了,我相信大家都會成為織夢(dedecms)高手的。
相關(guān)文章
WebStorm如何調(diào)試Vue項目? webstorm配置vue開發(fā)環(huán)境指南
WebStorm 支持多種調(diào)試工具,包括瀏覽器的開發(fā)者工具,但本文主要講解的是使用 WebStorm 自帶的調(diào)試功能2025-04-15VSCode和webstorm怎么設(shè)置綠色護眼背景? 綠豆沙背景色的設(shè)置方法
護眼色一定程度能保護眼睛,緩解疲勞,VSCode和webstorm這兩款常用的軟件怎么設(shè)置護眼色呢?詳細請看下文介紹2025-04-15- WebStorm本身已經(jīng)足夠強大,但一些優(yōu)秀的插件能錦上添花,顯著提升開發(fā)效率,詳細請看下文介紹2025-04-15
如何安裝配置WebStorm? WebStorm安裝與使用全方位指南
WebStorm軟件在前端和后端開發(fā)領(lǐng)域都備受青睞,很多朋友不知道該怎么下載安裝,下面我們就來看看詳細的安裝配置教程2025-04-15Webstorm怎么配置? Webstorm入門之軟件配置教程
WebStorm是一款功能強大的集成開發(fā)環(huán)境(IDE),支持各種前端開發(fā)技術(shù),今天我們就來看看Webstorm的配置教程2025-04-15Webstorm怎么設(shè)置字體大小/背景顏色/背景圖片?
WebStorm 允許您自定義界面顏色,以創(chuàng)建更個性化和美觀的工作空間,今天我們就來看看Webstorm改變字體大小、背景顏色、設(shè)置背景圖片的方法2025-04-15- VScode上安裝PlatformIO插件能成功安裝,嘗試卸載VScode并刪除插件,這些錯誤仍然存在,下面我們就來看看這個問題的解決辦法2025-04-03
提升代碼搜索效率! VSCode里DeepSeek插件安裝與配置指南
今天我們將向大家介紹如何在Visual Studio Code中安裝并配置 DeepSeek 插件,幫助你更高效地進行代碼搜索2025-04-07- VSCode是一款免費且開源的代碼編輯器,因其強大的功能和良好的用戶體驗而廣受歡迎,本文將詳細介紹 VSCode 的基本使用方法,并通過插圖幫助你更好地理解2025-04-03
- 今天我們來聊聊如何安裝和配置VS Code,讓它成為你編程路上的得力助手,這個過程其實很簡單,只要跟著我的步驟走,你絕對能搞定2025-04-03