主頁 > 網(wǎng)站建設(shè) > 建站知識(shí) > dedecms 制作模板中使用的全局標(biāo)記圖文教程

dedecms 制作模板中使用的全局標(biāo)記圖文教程

POST TIME:2021-05-20 00:15

  如果這個(gè)官方的模板解釋看的太抽象的,可以參考一下:

解析引擎概述 模板設(shè)計(jì)規(guī)范 代碼參考
標(biāo)記參考:arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart)fieldchannelmytagvotefriendlinkmynewsloopchannelartlistpagelistpagelistpagebreakfieldlist
--------------------------------------------------------------------------------
一、織夢(mèng)模板解析引擎概述
在了解DedeCms的模板代碼之前,了解一下織夢(mèng)模板引擎的知識(shí)是非常有意義的??棄?mèng)模板引擎是一種使用XML名字空間形式的模板解析器,使用織夢(mèng)解析器解析模板的最大好處是可以輕松的制定標(biāo)記的屬性,感覺上就像在用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ù)庫密碼之外,能調(diào)用系統(tǒng)的任何配置參數(shù),形式為:
{dede:globalname='變量名稱'}{/dede:global}

{dede:globalname='變量名稱'/}
其中變量名稱不能加$符號(hào),如變量$cfg_cmspath,應(yīng)該寫成{dede:globalname='cfg_cmspath'/}。
(2)foreach用來輸出一個(gè)數(shù)組,形式為:
{dede:foreacharray='數(shù)組名稱'}[field:key/][field:value/]{/dede:foreach}
(3)include引入一個(gè)文件,形式為:
{dede:includefile='文件名稱'/}
對(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:fieldname='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個(gè)大模板,加上專題、搜索和主頁模板,一共有十六個(gè)基本的模板文件,你可以按自己的情況更改有需要的模板。
2、DedeCms的模板標(biāo)記按功能分為:封面模板標(biāo)記(頻道封面、主頁)、列表模板標(biāo)記、文檔模板標(biāo)記和特殊用途標(biāo)記。
三、主要標(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)記所定義的不同屬性延伸出來的。
作用:獲取一個(gè)指定的文檔列表
適用范圍:封面模板、列表模板、文檔模板
(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,在列表模板和檔案模板中一般不需要指定,在封面模板中允許用","分開表示多個(gè)欄目;
[2]row=''表示返回文檔條數(shù);
[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='spec'時(shí),表示專題文檔,等同于
{dede:specarttypeid=''row=''col=''titlelen=''infolen=''
imgwidth=''imgheight=''listtype=''keyword=''}{/dede:specart}
§type='commend'時(shí),表示推薦文檔,等同于
{dede:coolarttypeid=''row=''col=''titlelen=''infolen=''
imgwidth=''imgheight=''listtype=''keyword=''}{/dede:coolart}
§type='image'時(shí),表示必須含有縮略圖片的文檔
§type='數(shù)字',特定的頻道類型,1文章,2圖片集,3軟件,4Flash,其它數(shù)字則是用戶自定義頻道的id,即是dede_channeltype.ID的值。
[9]orderby=''表示排序方式,默認(rèn)值是senddate按發(fā)布時(shí)間排列。同名屬性:sort
§orderby='hot'或orderby='click'表示按順序排列,使用本屬性后等同于
{dede:hotarttypeid=''row=''col=''titlelen=''infolen=''
imgwidth=''imgheight=''listtype=''keyword=''}{/dede:hotart}
§orderby='pubdate'按出版時(shí)間排列(即是前臺(tái)允許更改的時(shí)間值)
§orderby='sortrank'按文章的新排序級(jí)別排序(如果你想使用置頂文章則使用這個(gè)屬性)
§orderby='id'按文章ID排序
[10]keyword=''表示含有指定關(guān)鍵字的文檔列表,多個(gè)關(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:arclistinfolen='100'}
[field:textlink/]
[field:info/]
{/dede:arclist}
2、field標(biāo)記
這個(gè)標(biāo)記用于獲取特定欄目或檔桉的字段值及常用的環(huán)境變量值
適用范圍:封面模板、列表模板、文檔模板
(1)基本語法
{dede:fieldname=''/}
(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:channelrow=''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:channeltype='top'}
[field:typename/]
{/dede:channel}
4、mytag標(biāo)記
用于獲取自定義標(biāo)記的內(nèi)容
適用范圍:封面模板、列表模板、文檔模板
(1)基本語法
{dede:mytagtypeid=''name=''ismake=''/}
(2)屬性
[1]typeid='數(shù)字'表示欄目ID,默認(rèn)為0,在沒有設(shè)定的欄目沒有定義這個(gè)名稱的標(biāo)記,會(huì)按如下搜索方式來搜索“先向上查找父欄目->通用標(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:voteid='投票ID'lineheight='22'
tablewidth='100%'titlebgcolor='#EDEDE2'
titlebackground=''tablebgcolor='#FFFFFF'}
{/dede:vote}
6、friendlink標(biāo)記,等同flink
用于獲取友情鏈接
適用范圍:封面模板
(1)基本語法
{dede:flinkrow=''col=''titlelen=''tablestyle=''}{/dede:flink}
7、mynews標(biāo)記
用于獲取站內(nèi)新聞
適用范圍:封面模板
(1)基本語法
{dede:mynewsrow='條數(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)用論壇貼子之類的操作。
9、channelartlist標(biāo)記
用于獲取頻道的下級(jí)欄目的內(nèi)容列表
適用范圍:封面模板
語法:
{dede:channelArtlisttypeid=0col=2tablewidth='100%'}
{dede:type}
[field:typename/]
更多...
{/dede:type}
{dede:arclistrow="8"}
·[field:title/]
{/dede:arclist}

{/dede:channelArtlist}
channelArtlist是唯一一個(gè)可以直接嵌套其它標(biāo)記的標(biāo)記,不過僅限于嵌套
{dede:type}{/dede:type}和{dede:arclist}{/dede:arclist}
標(biāo)記。
(1)屬性
typeid=0頻道ID,默認(rèn)的情況下,嵌套的標(biāo)記使用的是這個(gè)欄目ID的下級(jí)欄目,如果你想用特定的欄目,可以用","分開多個(gè)ID。
col=2分多列顯示
tablewidth='100%'外圍表格的大小
10、page標(biāo)記
表示分頁頁面的附加參數(shù)
適用范圍:列表模板
語法:
{dede:pagepagesize="每頁結(jié)果條數(shù)"/}
11、list標(biāo)記
表示列表模板里的內(nèi)容列表
語法:
{dede:listrow=''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:pagelistlistsize="3"/}
listsize表示[1][2][3]這些項(xiàng)的長(zhǎng)度x2
13、pagebreak標(biāo)記
用途:表示文檔的分頁鏈接列表。
適用范圍:僅文檔模板。
語法:{dede:pagebreak/}
14、fieldlist標(biāo)記
用途:獲得附加表的所有字段信息。
適用范圍:僅文檔模板。
語法:
{dede:fieldlist}
[field:name/]:[field:value/]
{/dede:fieldlist}


轉(zhuǎn)載于:%5fhosting



收縮
  • 微信客服
  • 微信二維碼
  • 電話咨詢

  • 400-1100-266