織夢dedecms中存在二種模板引擎,一個(gè)是靜態(tài)模板引擎,也就是站長經(jīng)常提到的模板用的就是這個(gè)引擎,我們在織夢dedecms模板里經(jīng)??吹降臉?biāo)簽,例如{dede:arclist}{/dede:arclist}等,就是使用的這個(gè)引擎;另一個(gè)是動(dòng)態(tài)的模板引擎,這個(gè)模板引擎一般用在“非核心模塊的動(dòng)態(tài)頁面或列表頁的模板解析”,從這名稱就可以看出,動(dòng)態(tài)模板引擎,用在動(dòng)態(tài)頁面,至于二者區(qū)別我們這里不多說,請查一下織夢手冊,里面有詳細(xì)進(jìn)解。
今天我們說的就是靜態(tài)模板引擎,這個(gè)引擎就是我們經(jīng)常用的,只是我們沒有注意,我們通過在模板里寫的標(biāo)簽,就是這個(gè)來引擎來解析的,這也不是今天的討論的范圍,這個(gè)靜態(tài)模板引擎的核心文件是:include/dedetag.class.php,今天的教程,就是學(xué)習(xí)一下這個(gè)引擎里面的功能的使用。
如果不做二次開發(fā)的話,這個(gè)教程完全可以不用看,這些教程專為二次開發(fā)人員寫的,也是自己在二次開發(fā)過程中的一點(diǎn)總結(jié)。
剛登錄織夢后臺(tái)后,左邊的菜單就是就是通過循環(huán)標(biāo)記,加上js來調(diào)用出來的,js今天我們不討論,只看一下菜單是如何實(shí)現(xiàn)的。在“織夢下載標(biāo)簽分析”這個(gè)教程里面介紹過了,這里再做一個(gè)概括:
標(biāo)簽字符串的存在分二種情況,一種是存在于數(shù)據(jù)庫表中,例如,下載標(biāo)簽softlinks,圖片集標(biāo)簽imgurls,這些字段對(duì)應(yīng)的字符串值,必須查詢出來,然后,通過模板引擎遍歷出我們想要的內(nèi)容。在這一種情況里面,又分二種,一種是存在在表字段fieldset里面的,這里面保存的都是附加表字段;另一種是存在于附加表里面的字段值,例如軟件模型附加表里面的softlinks。
插件模型表#@_plus里面字段menustring 對(duì)應(yīng)的值,這個(gè)插件模型與頻道模型是平級(jí),這一點(diǎn)要注意。
另一個(gè)就是不在數(shù)據(jù)庫表中,而是在文件里面,這些文件后綴可以是htm,html,txt等,一般的后綴文件都可以。今天我們進(jìn)的就是第二種,我們自己定義的,應(yīng)用這種非常靈活,最大好處就是不用操作數(shù)據(jù)庫表。
不管哪一種,它們的通用代碼是:
1.引入模板引擎:dedetag.class.php,這是必須的,沒有這個(gè),一切空談。
2.實(shí)例化對(duì)象:$dtp = new DedeTagParse(),這個(gè)也是必須的,要不也是空談。
3.設(shè)置名字空間:$dtp->SetNameSpace('field','<','>')這個(gè)是也必須設(shè)置的,要不模板引擎也不知道你要做什么。這個(gè)函數(shù)里面的field就是叫“標(biāo)記的名字空間”,這個(gè)是可以改成自己的需要的,例如,織夢標(biāo)簽的標(biāo)記的名字空
間是“dede”即$dtp->SetNameSpace("dede","{","}"),如果我們要自己定義一個(gè)命子空間,例如,$dtp->SetNameSpace('m','<','>')、SetNameSpace('menu','<','>')等都是可以的。
4.加載模板:$dtp->LoadTemplet('dedebase.html'),實(shí)際上所謂加載模板就是把存放標(biāo)簽的文件加載進(jìn)來,以便后面的通過foreach把里面的內(nèi)容遍歷出來。模板文件dedebase.html里面的內(nèi)容,如下所示。
<menu:item link="http://www.dedebase.com" title="織夢基地" />
<menu:item link="http://www.dedebase.com" title="織夢模板" />
<menu:item link="http://www.dedebase.com" title="織夢二次開發(fā)" />
這里面任何的內(nèi)容都可以隨便寫,但是必須名字空間對(duì)應(yīng),例如,名字空間是field,而你在模板寫的是menu,這樣就錯(cuò)了,模板中必須是field或,名字空間必須是menu,還有標(biāo)記的開始與結(jié)束符號(hào),必須一樣,否則也會(huì)出錯(cuò)。
在織夢有些文件里面,你會(huì)看到$dtp->LoadString(字符串),這完全正確,注意,這個(gè)函數(shù)里面的必須是字符串。我們?nèi)edetag.class.php搜索檢查看一下,你會(huì)發(fā)現(xiàn),這個(gè)函數(shù)又調(diào)用了“載入模板字符串”函數(shù)LoadSource($str)
其中參數(shù)$str是字符串,然后,把這些字符串(也是就是標(biāo)簽)以這個(gè)字符串,作為文件名,緩存到文件data/tplcache/.md5($str).inc文件里面,然后,再把這個(gè)文件作為模板,通過函數(shù)LoadTemplet()載入,從中可以看出,最終還是通過加載了這個(gè)函數(shù)。
還可能通過LoadSource($ctag->InnerText)來加載,最終也是加載了模板,這里面的參數(shù)$ctag->InnerText是標(biāo)記之間的文本,要注意的是這個(gè)標(biāo)記之間的文件也可能是一個(gè)標(biāo)簽,即標(biāo)記中嵌套著標(biāo)記。例如,下面的代碼:
$menusMain = "
<m:top mapitem='6' item='7' name='輔助插件' display='block'>
<m:item name='插件管理器' link='plus_main.php' rank='10' target='main' />
$plusset
</m:top>"
$dtp = new DedeTagparse();
$dtp->SetNameSpace('m','<','>');
$dtp->LoadString($menusMain);
foreach($dtp->CTags as $ctag)
{
$dtp2 = new DedeTagParse();
$dtp2->SetNameSpace('m', '<', '>');
$dtp2->LoadSource($ctag->InnerText);
foreach($dtp2->CTags as $j=>$ctag2)
{
$mapstring .= "<li><a href='".$ctag2->GetAtt('link')."' target='".$ctag2->GetAtt('target')."'>".$ctag2->GetAtt('name')."</a></li>\r\n";
}
$mapstring .= "</ul>\r\n</dd>\r\n</dl>\r\n";
}
代碼已經(jīng)簡化了,請查文件dede/inc/inc_menu_map.php,最下面。
5.循環(huán)遍歷標(biāo)記: foreach($dtp->CTags as $ctag){},根據(jù)需要遍歷出自己想要的內(nèi)容。
以上就是循環(huán)標(biāo)記的原理,現(xiàn)在我們看一個(gè)例子。
我想實(shí)現(xiàn)如下圖所示的效果。
正常情況我們可以通過標(biāo)簽{dede:arclist}{/dede:arclist}就可以了,但是如果我想點(diǎn)每個(gè)標(biāo)題,進(jìn)入到不同的網(wǎng)站并且,不準(zhǔn)查詢數(shù)據(jù)庫,用這個(gè)標(biāo)簽就完全實(shí)現(xiàn)不了了。
我們這樣做就可以實(shí)現(xiàn),建立一個(gè)文件dedebase.html這個(gè)文件名隨便起,然后,在這里面寫上如下代碼。
<menu:item link="http://www.dedebase.com" title="織夢基地" />
<menu:item link="http://www.baidu.com" title="織夢模板" />
<menu:item link="http://www.g.com" title="織夢二次開發(fā)" />
<menu:item link="http://www.abc.com" title="織夢教程" />
<menu:item link="http://www.sina.com" title= 織夢dedecms內(nèi)容管理系統(tǒng)" />
然后,建立一個(gè)php文件test.php,在文件里寫上,下面的代碼。
<?php
header("Content-type:text/html;charset=utf-8");
require_once(dirname(__FILE__)."/include/common.inc.php");
/*require_once(DEDEINC."/typeunit.class.admin.php");
require_once(DEDEADMIN."/inc/inc_archives_functions.php");
*/
require_once(DEDEINC.'/dedetag.class.php');
$dtp = new DedeTagparse();
$dtp->SetNameSpace('menu','<','>');
$dtp->LoadTemplet('dedebase.html');
if(is_array($dtp->CTags))
{
foreach($dtp->CTags as $ctag)
{
$title = $ctag->GetAtt('title');
$link = $ctag->GetAtt('link');
echo "<li><a href='{$link}' target='main'>{$title}</a></li>\r\n";
}
}
?>
看看是不是已經(jīng)實(shí)現(xiàn)了,搞定!