欢迎来到素材无忧网,按 + 收藏我们
登录 注册 退出 找回密码

DedeCms 常用函数参考:动态模板下载类

时间: 2019-05-22 08:42 阅读: 作者:素材无忧网

DedeCms V5.3 常用函数参考:动态模板类   核心类文件  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/} 外部变量 等同于 <?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 数组,否则模板引擎无法获得它的值从而导致产生错误。   (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=""} 
<tr> 
<td class='col1'> 
<div>?<a href='{tag:field.arcurl/}'>{tag:field.title/}</a></div> 
<!--div class='descriptions'>&nbsp;&nbsp;&nbsp;&nbsp;{tag:field.description function="CnSubstr(@me,150)"/}...</div--> 
</td> 
<td class='col2'>{tag:field.formattime/}</td> 
</tr> 
{/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'>&nbsp;&nbsp;&nbsp;&nbsp;<?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'} 
<dd>[{tag:field.typename/}]<a href="{tag:field.arcurl/}">{tag:field.title function="CnSubstr(@me,24)"/}</a></dd> 
{/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 
} 
} 
?>

下一篇:

版权声明: 本站资源均来自互联网或会员发布,如果侵犯了您的权益请与我们联系,我们将在24小时内删除!谢谢!

转载请注明: DedeCms 常用函数参考:动态模板下载类

标签:  
相关文章
模板推荐