資源描述:
《DedeCMS二次開(kāi)發(fā)手冊(cè)簿》由會(huì)員上傳分享,免費(fèi)在線閱讀,更多相關(guān)內(nèi)容在工程資料-天天文庫(kù)。
1、文檔DedeCMSV5.3二次開(kāi)發(fā)手冊(cè)一、模板篇1.1、主要模板文件與功能說(shuō)明DedeCMS系統(tǒng)的模板是非固定的,用戶可以在新建欄目時(shí)可以自行選擇欄目模板,官方僅提供最基本的默認(rèn)模板,即是內(nèi)置系統(tǒng)模型的各個(gè)模板,由于DedeCMS支持自定義頻道模型,用戶自定義新頻道模型后,還需要按該模型的字段設(shè)計(jì)一套新的模板,此外,DedeCMS也支持使用風(fēng)格的形式使用模板,默認(rèn)風(fēng)格是default,它表示系統(tǒng)默認(rèn)使用{cmspath}/templets/default這個(gè)文件夾的模板,如果你下載了一套新的模板,你可以不必要?jiǎng)h除default原有的文件,把下載的模板文件夾命名你想要的風(fēng)格名稱,
2、如style2等,然后在后臺(tái)修改了默認(rèn)的模板風(fēng)格名稱為style2,那系統(tǒng)將使用{cmspath}/templets/style2這文件當(dāng)作默認(rèn)模板,但是若你手工指定了欄目模板的位置,則后臺(tái)參數(shù)風(fēng)格的定義無(wú)效。一、概念,設(shè)計(jì)和使用模板,必須要理解下面幾個(gè)概念1、板塊(封面)模板:指網(wǎng)站主頁(yè)或比較重要的欄目封面頻道使用的模板,一般用“index_識(shí)別ID.htm”命名,此外,用戶單獨(dú)定義的單個(gè)頁(yè)面或自定義標(biāo)記,也可選是否支持板塊模板標(biāo)記,如果支持,系統(tǒng)會(huì)用板塊模板標(biāo)記引擎去解析后才輸出內(nèi)容或生成特定的文件。2、列表模板:指網(wǎng)站某個(gè)欄目的所有文章列表的模板,一般用“l(fā)ist_識(shí)別I
3、D.htm”命名。3、檔案模板:表示文檔查看頁(yè)的模板,如文章模板,一般用“article_識(shí)別ID.htm”命名。4、其它模板:一般系統(tǒng)常規(guī)包含的模板有:主頁(yè)模板、搜索模板、RSS、JS編譯功能模板等,此外用戶也可以自定義一個(gè)模板創(chuàng)建為任意文件。二、命名,DedeCMS模板默認(rèn)命名規(guī)則如下1、模板保存位置:模板目錄:{cmspath}/templets/樣式名稱(英文,默認(rèn)為default,其中system為系統(tǒng)底層模板,plus為插件使用的模板)/具體功能模板文件}2、模板文件命名規(guī)范:(1)index_識(shí)別ID.htm: 表示板塊(欄目封面)模板;(2)list_識(shí)別ID.
4、htm: 表示欄目列表模板;(3)article_識(shí)別ID.htm: 表示內(nèi)容查看頁(yè)(文檔模板,包括專題查看頁(yè));(4)search.htm:搜索結(jié)果列表模板;(5)index.htm:主頁(yè)模板;注解:[識(shí)別ID]可以在“頻道模型管理”的地方獲得,當(dāng)然,你也可以在“頻道模型管理”的地方確定某個(gè)頻道的模板命名。例:list_image.htm表示是就是內(nèi)容類型為圖片集的欄目默認(rèn)列表模板。article_article.htm表示的是文章查看頁(yè)模板。文檔三、其它模板說(shuō)明1、默認(rèn)底層模板位置:{cmspath}/templets/system功能:在沒(méi)有指定標(biāo)記的默認(rèn)底層模板的時(shí)候,
5、系統(tǒng)將自動(dòng)調(diào)用這個(gè)文件夾的相應(yīng)文件作為底層模板。2、插件目錄模板位置:{cmspath}/templets/plus功能:評(píng)論、友情鏈接、RSS地圖等模板。3、會(huì)員后臺(tái)模板位置:{cmspath}/member/templets功能:會(huì)員后臺(tái)的模板。四、二次開(kāi)發(fā)在V5.3中已經(jīng)將標(biāo)簽開(kāi)發(fā)分離出來(lái),您可以通過(guò)后臺(tái)[模板]-[標(biāo)簽代碼管理],點(diǎn)擊“新增加一個(gè)新的標(biāo)簽”來(lái)創(chuàng)建一個(gè)自己的標(biāo)簽,標(biāo)簽文件名為:標(biāo)簽名.lib.php接口函數(shù)定義為:functionlib_標(biāo)簽名(&$ctag,&$refObj),返回值是結(jié)果字符串修改標(biāo)簽時(shí)為了防止出錯(cuò),您也可以修改它的名稱(同時(shí)修改文件名
6、和函數(shù)名),這樣等同繼承了原來(lái)標(biāo)簽的代碼建立一個(gè)新的標(biāo)簽。1.2、模板標(biāo)簽語(yǔ)法簡(jiǎn)介織夢(mèng)的模板標(biāo)簽類似于XML格式,所有的模板都含有定界符,默認(rèn)情況下是{dede:*}和{/dede:*},“*”代表模板標(biāo)記名稱。一般情況下{dede:*}和{/dede:*}是成對(duì)出現(xiàn)的,例如:例1-1:1{dede:arclistflag='h'limit='0,1'}
2
[field:title/]
3
[field:description/]...7、>[查看全文]
4{/dede:arclist}上面的{dede:arclist}和{/dede:arclist}成對(duì)出現(xiàn)在模板文件中,并且在兩個(gè)標(biāo)簽當(dāng)中包含了底層模板(innertext)。底層模板(Innertext),底層模板實(shí)際上就是對(duì)于有多條記錄的模板輸出,用戶手工去指定單個(gè)記錄的樣式。標(biāo)簽還有一類出現(xiàn)形式是{dede:*/},通常以這種形式出現(xiàn)都是輸出變量、或者不含底層模板的內(nèi)容。例如:1-2{dede:global.cfg_webname/}{dede: