(转)模板引擎类dedetemplate.class.php使用说明

时间:2022-04-02 13:07:39

1.概述

织梦的模板标签类似于XML格式,所有的模板都含有定界符,默认情况下是{dede:*}和{/dede:*},“*”代表模板标记名称。

一般情况下{dede:*}和{/dede:*}是成对出现的。

每个模板都会生成一个模板缓存文件,默认是在站点根目录data/tplcache目录。在模板调试的时候可以查看缓存中编译后的模板文件。

如果需要在开发中使用,则需要引用dedetemplate.class.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(物理绝对路径的文件名);

模板中具体标签的使用可以查看本章节相关内容。

2.变量输出

在程序开发中,我们在程序处理中可以给变量赋值,但如何将其显示到模板中呢?这里我们来说明下:

   
1.普通变量

例如我们这里有一个变量

$myvar =
'DedeCMS';
  $this->SetVar('myvar', $myvar);

我们可以在模板中使用:

{dede:var.myvar/}

{dede:var
name='myvar'/}

解析后的代码是<?php
echo $GLOBALS['_vars']['myvar']; ?>,同时我们可以在模板中看到输出效果。

以上是一个普通变量的输出,当然我们可以将数组传递到模板中去

   
2.数组

我们可以通过SetVar()将数组在模板中解析,比如我们现在有一个数组:

$myarr =
array('name'=>'DedeCMS','company'=>'DesDev INC.');

$this->SetVar('myarr', $myarr);

我们可以在模板中使用:

Name:{dede:var.myarr.name/}
Company:{dede:var.myarr.company/}
或者通过:Company:{dede:var name='myarr.company'/}来调用。不过我们推荐使用前者形式并   
且需要整个程序模板标签写法保持统一。

上面的代码解析后是:

Name:<?php echo
$GLOBALS['_vars']['myarr']['name']; ?>
Company:<?php echo
$GLOBALS['_vars']['myarr']['company']; ?>

需要注意的是,一些模板引擎中喜欢使用Assign这种形式来给模板标签变量赋值,DedeCMS也可以使用,用法和SetVar是一样的。

例如:$this->Assign('myvar',
$myvar);

3.函数使用

一般标签有时候是很难完成开发制作需要的,织梦的模板引擎提供了一种处理标签的特殊方法:自定义函数。

通过自定义函数的处理,可以对解析后的标签赋予新的处理,但需要满足函数本身能够返回值。

标签格式为:

{dede:标记名称function='youfunction("参数一","参数二","@me")'/}

其中 @me 用于表示当前标记的值,其它参数由你的函数决定是否存在,例如:
{dede:field.pubdate
function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}

比如说我们这里有一个变量,调用的是时间,我们通常保存在数据库中的时间都是10位的整数,但现实的时候需要将其解析为文本,这时候我们就需要通过特定的函数来处理,这里我们的这个标签是:{dede:field.time/},在模板中输出内容是“1252458332”。

我们来查看一个函数:

//返回格林威治标准时间
function
MyDate($format='Y-m-d H:i:s',$timest=0)
...{
global
$cfg_cli_time;
$addtime = $cfg_cli_time *
3600;
if(empty($format))
...{
$format = 'Y-m-d H:i:s';
}
return
gmdate ($format,$timest+$addtime);
}

这个函数将时间按照格式输出,默认格式是"Y-m-d H:i:s"。

我们将我们的标签进行处理。{dede:field.time function="MyDate('m-d',@me)"/}

我们可以看到输出结果:09-09

4. 系统变量

除了普通的一些变量之外,在系统开发中,模板常常还需要调用一些系统变量以及一些特殊的变量输出,本篇介绍如何在Dede模板中使用标签来调用这些系统变量。

1.配置变量config

配置变量可以在载入模板后通过
$tpl->GetConfig($name) 获得,仅作为配置,不在模板中显示。此变量直接提交到 this->tpCfgs
中,并会生成与模板对应的缓存文件 ***_config.php 文件(可以在tplcache中找到)。

例如我们在模板中设置:{dede:config.pagesize value='20'/},这个是设置分页标签的分页数量为20。

我们将这个配置标签放到模板文件的最顶部,解析后发现模板中的列表显示就是每页显示20条内容。这个是因为在datalist类中对这个配置进行了解析处理。

if(isset($this->tpl->tpCfgs['pagesize']))
...{
$this->pageSize
= $this->tpl->tpCfgs['pagesize'];
}

 2.全局变量global

在系统中经常会调用全局变量,我们可以在模板中使用{dede:global
name='varname'/}来调用,这个变量同时也能够调用系统的一些配置变量。

比如我们调用系统配置中的模板路径,可以使用{dede:global.cfg_templeturl/}来调用。

当然你也可以赋值一些全局变量通过global标签来调用:

$GLOBALS['myglobal'] =
array('name'=>'DedeCMS','company'=>'DesDev INC.');

模板中使用:

{dede:global.myglobal.name/}进行调用。

我们可以通过print_r($GLOBALS);来查看全局变量并使用这个标签进行调用。同时这个变量也支持自定义函数

3.系统配置变量cfg

在上面的内容中就介绍了通过global标签输出系统配置,这里其实有专门的系统配置标签可以输出,我们可以在模板中使用{dede:cfg.name/}来输出相应的配置,这个解析后的内容等同于:<?php
echo $cfg_name; ?>。

考虑到大多数情况下都会在函数或类中调用模板,因此 $_vars、$fields 数组必须声明为 global
数组,否则模板引擎无法获得它的值从而导致产生错误。

4.对象object

在模板中可以使用{dede:object.name->att/}来调用对象的属性。解析后为:<?php echo
$GLOBALS['name']->att; ?>

 5.固定块

这个标签是一个比较特殊的块处理标签,一般需要配合类进行使用。

1.datalist

从绑定类成员函数GetArcList中获取数组并输出
{dede:datalist}
循环代码
{/dede:datalist}
遍历一个二维数组,数据源是固定的,只适用用类调用。
等同于

{tag:blockname bind='GetArcList' bindtype='class'
rstype='array'}
循环代码
{/tag:blockname}

2.label
从绑定函数中获取字符串值并输出
等同于
{tag:blockname bind='func' bindtype='sub' rstype='string'/}

3.pagelist

从绑定类成员函数GetPageList中获取字符串值并输出
等同于 {tag:blockname
bind='GetPageList' bindtype='class' rstype='string'/}

(转)模板引擎类dedetemplate.class.php使用说明的更多相关文章

  1. PHP模板引擎正则替换函数 preg&lowbar;replace 与 preg&lowbar;replace&lowbar;callback 使用总结

    在编写PHP模板引擎工具类时,以前常用的一个正则替换函数为 preg_replace(),加上正则修饰符 /e,就能够执行强大的回调函数,实现模板引擎编译(其实就是字符串替换). 详情介绍参考博文:P ...

  2. Django基础,Day10 - template 模板引擎与路径设置

    作为一个Web框架,Django需要一个方便的方式来生成动态的HTML.最常见的方法依赖于模板.模板包含所需的HTML输出的静态部分以及一些特殊的语法描述如何插入动态内容. Django框架后端默认支 ...

  3. smarty模板引擎原理解析

    //php 控制器文件 <?php//引入模板引擎文件include("20130304.php");$smarty =newTinySmarty();$qq_numbers ...

  4. (转)浅谈dedecms模板引擎工作原理及自定义标签

    理解织梦模板引擎有什么意义?一方面可以更好地自定义标签.更多在于了解织梦系统,理解模板引擎是理解织梦工作原理的第一步.理解织梦会使我们写php代码时更顺手,同时能学习一些php代码的组织方式. 这似乎 ...

  5. 前端学PHP之自定义模板引擎

    前面的话 在大多数的项目组中,开发一个Web程序都会出现这样的流程:计划文档提交之后,前端工程师制作了网站的外观模型,然后把它交给后端工程师,它们使用后端代码实现程序逻辑,同时使用外观模型做成基本架构 ...

  6. 浅谈dedecms模板引擎工作原理及其自定义标签

    浅谈dedecms模板引擎工作原理: 理解织梦模板引擎有什么意思? 可以更好地自定义标签.更多在于了解织梦系统,理解模板引擎是理解织梦工作原理的第一步. 理解织梦会使我们写PHP代码是更顺手,同时能学 ...

  7. PHP的自定义模板引擎

    前面的话 在大多数的项目组中,开发一个Web程序都会出现这样的流程:计划文档提交之后,前端工程师制作了网站的外观模型,然后把它交给后端工程师,它们使用后端代码实现程序逻辑,同时使用外观模型做成基本架构 ...

  8. Flask 框架下 Jinja2 模板引擎高层 API 类——Environment

    Environment 类版本: 本文所描述的 Environment 类对应于 Jinja2-2.7 版本.   Environment 类功能: Environment 是 Jinja2 中的一个 ...

  9. day94&colon;flask&colon;Jinjia2模板引擎&amp&semi;flask中的CSRF攻击&amp&semi;Flask-SQLAlchemy的创建模型类和基本的增删改查

    目录 1.Jinjia2模板引擎 1.Jinjia2加载模板并传递数据到模板中 2.Jinjia2的模板语句 3.模板中特有的变量和函数 4.模板中内置的过滤器 5.自定义过滤器 6.模板继承 2.在 ...

随机推荐

  1. python&lowbar;操作oracle数据库

    1. cx_Oracle Python 连接Oracle 数据库,需要使用cx_Oracle 包. 该包的下载地址:http://cx-Oracle.sourceforge.net/ 下载的时候,注意 ...

  2. 使用Dataset

    string sqlStr="Select * from Tb_news"; SqlDataAdapter myDa=new SqlDataAdapter(SqlStr,myCon ...

  3. C&plus;&plus;数据结构之map----第一篇

    摘要: 1 对于非标准类型的map,map 只需要重载小于号就可以了 2map结构初始化 map<string,double> g_lr=map<string,double>( ...

  4. Java之集合初探(一)

    一.集合概述.区别 集合是一种容器,数组也是一种容器 在Java编程中,装各种各样的对象(引用类型)的叫做容器. 为什么出现集合类? 面向对象语言对事物的体现都是以对象的形式,所以为了方便对多个对象的 ...

  5. Log4&period;Net 在Winfrom、MVC、ashx程序里的使用,ashx程序里使用异步

    最近做一个双11活动的,是一套相关的H5页面.本来以为难度不大,但是做下来几天还是遇到些问题.就总结一下吧,还是有收获的. 1.在H5页面中,有一个遮罩层,还是挺有意思的.直接用div+css控制遮罩 ...

  6. subprocess&period;Popen 运行windows命令出现&OpenCurlyDoubleQuote;句柄无效”报错的解决方法

    在框架开发中遇到 subprocess执行多了,就会好句柄无效的问题,终于找到解决方案:如下,修改subprocess中的一点代码就好,也不知道这是不是Python 的bug因为,Python27时没 ...

  7. presto架构和原理

    Presto 是 Facebook 推出的一个基于Java开发的大数据分布式 SQL 查询引擎,可对从数 G 到数 P 的大数据进行交互式的查询,查询的速度达到商业数据仓库的级别,据称该引擎的性能是 ...

  8. 微服务架构之spring cloud eureka

    Spring Cloud Eureka是spring cloud的核心组件,负责服务治理功能,起到中心枢纽作用,其它组件都依赖eureka来获取服务,然后再根据项目需求实现自己的业务,eureka在整 ...

  9. JavaScript 正则表达式——基本语法(2)

    来源:http://www.cnblogs.com/dolphinX/p/3486214.html 定义 JavaScript种正则表达式有两种定义方式,定义一个匹配类似 <%XXX%>  ...

  10. Python 安装 pip package

    Python的 package 站点提供的msi安装越来越少了,如今大多是.whl或.tar.gz格式.对某些用windows的小白(比如,我)来说,对.tar.gz闻所未闻,也纠结了很长时间.whl ...