dedecms模板引擎介紹

  • 作者: admin
  • 發布日期: 2013-08-16 02:03:02
  • 點擊:

DedeCMS從V5開始采用了解析式引擎與編譯式引擎并存的模式,由于在生成HTML時,解析式引擎擁有巨大的優勢,但對于動態瀏覽的互動性質的頁面,編譯式引擎更實用高效,織夢CMS采用雙引擎并存的模式,在保持標簽風格一致性的同時,也保證將來開發更多互動模塊時有更好的性能。

靜態模板引擎

核心文件

include/dedetag.class.php

功能描述

DedeCMS V5.3及之前版本使用的主要的模板類,它是解析式模板類,并非編譯式的。

注:編譯式是通過獲得標簽位置進行內容替換,編譯式是直接解析為PHP代碼,二次執行。

模板語法

織夢模板引擎是一種使用XML名字空間形式的模板解析器,使用織夢解析器解析模板的最大好處是可以輕松的制定標記的屬性,感覺上就像在用HTML一樣,使模板代碼十分直觀靈活,新版的織夢模板引擎不單能實現模板的解析還能分析模板里錯誤的標記。

織夢模板引擎的代碼樣式

{dede:標記名稱 屬性='值'/}
{dede:標記名稱 屬性='值'}{/dede:標記名稱}
{dede:標記名稱 屬性='值'}自定義樣式模板(InnerText){/dede:標記名稱}

注:如果使用帶底層模板的標記,必須嚴格用{dede:標記名稱 屬性='值'}{/dede:標記名稱} 這種格式,否則會報錯。

內置系統標記

① global標記,表示獲取一個外部變量,除了數據庫密碼之外,能調用系統的任何配置參數,形式為:
{dede:global name='變量名稱'}{/dede:global}

{dede:global name='變量名稱'/}

其中變量名稱不能加$符號,如變量$cfg_cmspath,應該寫成{dede:global name='cfg_cmspath'/}。

②foreach用來輸出一個數組,形式為:
 {dede:foreach array='數組名稱'}[field:key/] [field:value/]{/dede:foreach}

③include引入一個文件,形式為:
 {dede:include file='文件名稱' ismake='是否為dede板塊模板(yes/no)'/}
 對文件的搜索路徑為順序為:絕對路徑、include文件夾,CMS安裝目錄,CMS主模板目錄

自定義函數使用

{dede:標記名稱 屬性='值' function='youfunction("參數一","參數二","@me")'/}

其中@me 用于表示當前標記的值,其它參數由你的函數決定是否存在,例如:

{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}

織夢標記允許有限的編程擴展

格式為:
{dede:tagname runphp='yes'}
       $aaa = @me;
       @me = "123456";
{/dede:tagname}
@me 表示這個標記本身的值,因此標記內編程是不能使用echo之類的語句的,只能把所有返回值傳遞給@me。
此外由于程序代碼占用了底層模板InnerText的內容,因此需編程的標記只能使用默認的InnerText。


動態模板引擎

核心文件

include/dedetemplate.class.php

功能描述

用于非核心模塊的動態頁面或列表頁的模板解析,如:member/content_list.php ,通常是在datalistcp.class.php 中使用,這個類在動態運行的情況下,由于本身是把模板編譯成PHP的,因此性能上會優級于舊的解析類,這個方法將在未來版本中作為通用的方式。

使用方法
 

$tpl = new DedeTemplate(
模板對象實例名稱,通常是'tpl',
[模板存放目錄(生成緩存時會存放在這個目錄),

include語法默認引用目錄]

);
通常情況下參數二和參數三是不必要的,如:
$tpl = new DedeTemplate('tpl');
如果在類文件中調用,應該加上設置:
$this->tpl->SetObject($this);
在一些塊調用中默認將使用當前類的成員函數。
$tpl->LoadTemplate(模板的物理路徑);
如果模板中帶有{dede:config name='' value=''/}
可以在載入模板后,通過$tpl->GetConfig($name) 獲得這些變量的值。

顯示頁面或保存頁面為文件
$tpl->Display();
$tpl->SaveTo(物理絕對路徑的文件名);


標記語法


標記通用特性

① 短標記
{dede:tagname.name/}
等同于
{dede:tagname name='' /}
② 塊標記
{dede:tagname}
循環代碼
{/dede:tagname}

標記的具體語法及對應的PHP代碼

① 配置變量
{dede:config name='' value=''/}
配置變量可以在載入模板后通過$tpl->GetConfig($name) 獲得,僅作為配置,不在模板中顯示。
② 短標記

{dede:global.name/}   外部變量      等同于<?php echo $name; ?>
{dede:var.name/}      var數組       等同于<?php echo $_vars['name']; ?>
{dede:field.name/}    field數組     等同于<?php echo $fields['name']; ?>
{dede:cfg.name/}      系統配置變量  等同于<?php echo $cfg_name; ?>
考慮到大多數情況下都會在函數或類中調用模板,因此$_vars、$fields 數組必須聲明為global 數組,否則模板引擎無法獲得它的值從而導致產生錯誤。

③ 自由調用塊標記

{tag:blockname bind='GetArcList' bindtype='class'}
循環代碼
{/tag:blockname}
必要屬性:
bind       數據源來源函數
bindtype   函數類型,默認是class 可選為sub
rstype     返回結果類型,默認是array ,可選項為string
自定義函數格式必須為function(array $atts,object $refObj, array $fields);
在沒有指定bind 綁定的函數的情況下,默認指向MakePublicTag($atts,$tpl->refObj,$fields) 統一管理。

④ 固定塊標記

1.datalist
從綁定類成員函數GetArcList中獲取數組并輸出
{dede:datalist}
循環代碼
{/dede:datalist}
遍歷一個二給維數組,數據源是固定的,只適用用類調用。
等同于
{tag:blockname bind='GetArcList' bindtype='class' rstype='arrayu'}
循環代碼
{/tag:blockname}

2.label

從綁定函數中獲取字符串值并輸出
等同于{tag:blockname bind='func' bindtype='sub' rstype='string'/}

3.pagelist

從綁定類成員函數GetPageList中獲取字符串值并輸出
等同于{tag:blockname bind='GetPageList' bindtype='class' rstype='string'/}

4.include
{dede:include file=''/}
{dede:include filename=''/}

5.php

{dede:php
php 代碼
/}

{dede:php}
php代碼
{/dede:php}

6.If

僅支持if ,else ,else 直接用{else}表示,但不支持{else if}這樣的語法,一般建議模板中不要使用太復雜的條件語法,如果確實有需要,可以直接使用php 語法。
{dede:if 條件} a-block  {else} b-block {/dede:if}
條件中允許使用var.name 、global.name 、field.name、cfg.name 表示相應的變量。
如:
{dede:if field.id>10 }
{/dede:if}

7.遍歷一個array 數組

{dede:array.name}
  {dede:key/} = {dede:value/}
{/dede:array}
各種語法的具體編譯后的代碼,可查看dedetemplate.class.php的function CompilerOneTag(&$cTag)。

 

網站備案所需要提供的資料清單

目前,國內每個網站都必須具有信息產業部批準的備案號才能正常開通,否則只有選擇國外的服務器。
欧美性XXXX极品高清HD,永久免费A片在线观看全网站,免费观看成人A片免费不卡在线,美女黄18以下禁止观看免费的