dedecms二次開發:dedetemplate.class.php 動態模板類
dedecms二次開發目錄點這個:dedecms二次開發教程目錄
核心類文件
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(物理絕對路徑的文件名);
二、模板標記語法
1、標記通用特性
(1) 短標記
{dede:tagname.name/}
等同於
{dede:tagname name=‘‘ /}
(2) 塊標記
{dede:tagname}
循環代碼
{/dede:tagname}
2、標記的具體語法及對應的PHP代碼
(1) 配置變量
{dede:config name=‘‘ value=‘‘/}
配置變量可以在載入模板後通過 $tpl->GetConfig($name) 獲得,僅作為配置,不在模板中顯示。
(2) 短標記
{dede:global.name/} 外部變量 等同於
{dede:var.name/} var數組 等同於
{dede:field.name/} field數組 等同於
{dede:cfg.name/} 系統配置變量 等同於
考慮到大多數情況下都會在函數或類中調用模板,因此 $_vars、$fields 數組必須聲明為 global 數組,否則模板引擎無法獲得它的值從而導致產生錯誤。
(3) 自由調用塊標記
{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) 統一管理,這個函數存放在 cls_dede_tplinc.php 。
(4) 固定塊標記
[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‘/}
(5) include 語法
{dede:include file=‘‘/}
{dede:include filename=‘‘/}
(6) php 代碼塊
{dede:php
php 代碼
/}
或
{dede:php}
php代碼
{/dede:php}
(7) 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}
(8) 遍歷一個 array 數組
{dede:array.name}
{dede:key/} = {dede:value/}
{/dede:array}
各種語法的具體編譯後的代碼,可查看 dede-template-class.php 的 function CompilerOneTag(&$cTag)。
塊調用示例代碼:
1、示例一
{tag:datalist timeformat=""}<br /> <tr><br /> <td class=‘col1‘><br /> <div>?<a href=‘{tag:field.arcurl/}‘>{tag:field.title/}</a></div><br /> <!--div class=‘descriptions‘> {tag:field.description function="CnSubstr(@me,150)"/}...</div--><br /> </td><br /> <td class=‘col2‘>{tag:field.formattime/}</td><br /> </tr><br /> {/tag:datalist}
編譯後的代碼
<?php $atts = array(); $atts[‘tagname‘] = ‘datalist‘; $atts[‘timeformat‘] = ‘‘; $blockValue = $this->refObj->GetArcList($atts,$this->refObj,$fields); foreach( $blockValue as $key=>$fields ) { ?> <tr> <td class=‘col1‘> <div>?<a href=‘<?php echo $fields[‘arcurl‘]; ?>‘><?php echo $fields[‘title‘]; ?></a></div> <!--div class=‘descriptions‘> <?php echo CnSubstr($fields[‘description‘],150); ?>...</div--> </td> <td class=‘col2‘><?php echo $fields[‘formattime‘]; ?></td> </tr> <?php } ?>
2、示例二
{tag:article sort=‘new‘ titlelen=‘36‘ row=‘10‘}<br /> <dd>[{tag:field.typename/}]<a href="{tag:field.arcurl/}">{tag:field.title function="CnSubstr(@me,24)"/}</a></dd><br /> {/tag:article}
編譯後的代碼
<?php $atts = array(); $atts[‘tagname‘] = ‘article‘; $atts[‘sort‘] = ‘new‘; $atts[‘titlelen‘] = ‘36‘; $atts[‘row‘] = ‘10‘; $blockValue = MakePublicTag($atts,$this->refObj,$fields); if(is_array($blockValue) && count($blockValue) > 0){ foreach( $blockValue as $key=>$fields ) { ?> <dd>[<?php echo $fields[‘typename‘]; ?>]<a href="<?php echo $fields[‘arcurl‘]; ?>"><?php echo CnSubstr($fields[‘title‘],24); ?></a></dd> <?php } } ?>
dedecms二次開發:dedetemplate.class.php 動態模板類