DEDECMS教程之靜態(tài)模板類類文件

字號(hào):


    靜態(tài)模板類類文件織夢(mèng)模板引擎是一種使用XML名字空間形式的模板解析器
    使用織夢(mèng)解析器解析模板的最大好處是可以輕松的制定標(biāo)記的屬性,感覺(jué)上就像在用HTML一樣,使模板代碼十分直觀靈活,新版的織夢(mèng)模板引擎不單能實(shí)現(xiàn)模板的解析還能分析模板里錯(cuò)誤的標(biāo)記。
    include/dedetag.class.php這個(gè)文件是dedecms V5.3及之前版本使用的主要的模板類,它是解析式模板類,并非編譯式的(區(qū)別是前者通過(guò)獲得標(biāo)簽位置進(jìn)行內(nèi)容替換,后者是直接解析式PHP代碼,二次執(zhí)行)
    一、模板語(yǔ)法
    1、織夢(mèng)模板引擎的代碼樣式有如下幾種形式:
    {dede:標(biāo)記名稱 屬性='值'/}
    {dede:標(biāo)記名稱 屬性='值'}{/dede:標(biāo)記名稱}
    {dede:標(biāo)記名稱 屬性='值'}自定義樣式模板(InnerText){/dede:標(biāo)記名稱}
    提示:
    如果使用帶底層模板的標(biāo)記,必須嚴(yán)格用{dede:標(biāo)記名稱 屬性='值'}{/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ù)庫(kù)密碼之外,能調(diào)用系統(tǒng)的任何配置參數(shù),形式為:
    {dede:global name='變量名稱'}{/dede:global}
    或
    {dede:global name='變量名稱'/}
    其中變量名稱不能加 $ 符號(hào),如變量 $cfg_cmspath ,應(yīng)該寫成 {dede:global name='cfg_cmspath'/} 。
    (2) foreach 用來(lái)輸出一個(gè)數(shù)組,形式為:
    {dede:foreach array='數(shù)組名稱'}[field:key/] [field:value/]{/dede:foreach}
    (3) include 引入一個(gè)文件,形式為:
    {dede:include file='文件名稱' ismake='是否為dede板塊模板(yes/no)'/}
    對(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:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}
    4、織夢(mèng)標(biāo)記允許有限的編程擴(kuò)展。
    格式為:
    代碼如下:
    {dede:tagname runphp='yes'}
    $aaa = @me;
    @me = "123456";
    {/dede:tagname}
    @me 表示這個(gè)標(biāo)記本身的值,因此標(biāo)記內(nèi)編程是不能使用echo之類的語(yǔ)句的,只能把所有返回值傳遞給@me。
    此外由于程序代碼占用了底層模板InnerText的內(nèi)容,因此需編程的標(biāo)記只能使用默認(rèn)的InnerText。
    二、解析方式
    在 dedetag.class.php 里面有四個(gè)類
    class DedeAttribute 屬性結(jié)構(gòu)表述
    class DedeAttributeParse 屬性解析器
    class DedeTag 標(biāo)簽結(jié)構(gòu)表述
    class DedeTagParse 標(biāo)簽解析器
    使用解析類解析模板時(shí)一般經(jīng)過(guò)下面的步驟
    1、初始化:
    $dtp = new DedeTagParse();
    2、載入模板/模板字符串:
    $dtp->LoadTemplate(模板文件(絕對(duì)路徑)); //會(huì)生成緩存,第二次不需解析模板
    或
    $dtp->LoadSource(字符串);
    3、給標(biāo)簽賦值
    foreach($dtp->CTags as $tid=>$ctag) {
    //判斷ctag的名稱和屬性,并給賦不同的值,通常用函數(shù)處理
    if($ctag->GetName=='mytag') $dtp->Assign($tid, mytagvalue($ctag) );
    }
    在上面例子中,直接把名稱為 mytag的標(biāo)簽轉(zhuǎn)交給 mytagvalue 函數(shù)處理,mytagvalue 里判斷$ctag的各個(gè)屬性,返回不同內(nèi)容即可。
    在 V5.3版本中,通常除了field、list等專用標(biāo)簽之外,凡arc.*開(kāi)頭的類解析的文件,標(biāo)簽都是對(duì)應(yīng)該 include/taglib 的源碼的,這個(gè)由系統(tǒng)進(jìn)行了自動(dòng)的映射。
    4、顯示或保存為HTML
    $dtp->display();
    或
    $dtp->SaveTo(靜態(tài)文件名);
    對(duì)于二次開(kāi)發(fā)人員而言,不大需要知道dedecms模板具體解析方式,不過(guò)應(yīng)該十分清楚CTag這個(gè)類的結(jié)構(gòu),從而判斷標(biāo)簽不同屬性進(jìn)行處理。
    代碼如下:
    class DedeTag
    {
    var $IsReplace=FALSE; //標(biāo)記是否已被替代,供解析器使用
    var $TagName=""; //標(biāo)記名稱
    var $InnerText=""; //標(biāo)記之間的文本
    var $StartPos=0; //標(biāo)記起始位置
    var $EndPos=0; //標(biāo)記結(jié)束位置
    var $CAttribute=""; //標(biāo)記屬性描述,即是class DedeAttribute
    var $TagValue=""; //標(biāo)記的值
    var $TagID = 0;
    //獲取標(biāo)記的名稱和值
    function GetName()
    {
    return strtolower($this->TagName);
    }
    function GetValue()
    {
    return $this->TagValue;
    }
    //下面兩個(gè)成員函數(shù)僅是為了兼容舊版
    function GetTagName()
    {
    return strtolower($this->TagName);
    }
    function GetTagValue()
    {
    return $this->TagValue;
    }
    //獲取標(biāo)記的指定屬性
    function IsAttribute($str)
    {
    return $this->CAttribute->IsAttribute($str);
    }
    function GetAttribute($str)
    {
    return $this->CAttribute->GetAtt($str);
    }
    function GetAtt($str)
    {
    return $this->CAttribute->GetAtt($str);
    }
    function GetInnerText()
    {
    return $this->InnerText;
    }
    }