DEDECMS教程之静态模板类类文件_dedecms_CMS教程

使用织梦解析器解析模板的最大好处是可以轻松的制定标记的属性,感觉上就像在用HTML一样,使模板代码十分直观灵活,新版的织梦模板引擎不单能实现模板的解析还能分析模板里错误的标记。lZy迪尔课堂自学网-|第二课堂|--(官网)
lZy迪尔课堂自学网-|第二课堂|--(官网)
include/dedetag.class.php这个文件是dedecms V5.3及之前版本使用的主要的模板类,它是解析式模板类,并非编译式的(区别是前者通过获得标签位置进行内容替换,后者是直接解析式PHP代码,二次执行) lZy迪尔课堂自学网-|第二课堂|--(官网)
一、模板语法 lZy迪尔课堂自学网-|第二课堂|--(官网)
1、织梦模板引擎的代码样式有如下几种形式: lZy迪尔课堂自学网-|第二课堂|--(官网)
{dede:标记名称 属性='值'/} lZy迪尔课堂自学网-|第二课堂|--(官网)
{dede:标记名称 属性='值'}{/dede:标记名称} lZy迪尔课堂自学网-|第二课堂|--(官网)
{dede:标记名称 属性='值'}自定义样式模板(InnerText){/dede:标记名称} lZy迪尔课堂自学网-|第二课堂|--(官网)
提示: lZy迪尔课堂自学网-|第二课堂|--(官网)
如果使用带底层模板的标记,必须严格用{dede:标记名称 属性='值'}{/dede:标记名称} 这种格式,否则会报错。 lZy迪尔课堂自学网-|第二课堂|--(官网)
2、织梦模板引擎内置有多个系统标记,这些系统标记在任何场合都是能直接使用的。 lZy迪尔课堂自学网-|第二课堂|--(官网)
(1) global 标记,表示获取一个外部变量,除了数据库密码之外,能调用系统的任何配置参数,形式为: lZy迪尔课堂自学网-|第二课堂|--(官网)
{dede:global name='变量名称'}{/dede:global} lZy迪尔课堂自学网-|第二课堂|--(官网)
lZy迪尔课堂自学网-|第二课堂|--(官网)
{dede:global name='变量名称'/} lZy迪尔课堂自学网-|第二课堂|--(官网)
其中变量名称不能加 $ 符号,如变量 $cfg_cmspath ,应该写成 {dede:global name='cfg_cmspath'/} 。 lZy迪尔课堂自学网-|第二课堂|--(官网)
(2) foreach 用来输出一个数组,形式为: lZy迪尔课堂自学网-|第二课堂|--(官网)
{dede:foreach array='数组名称'}[field:key/] [field:value/]{/dede:foreach} lZy迪尔课堂自学网-|第二课堂|--(官网)
(3) include 引入一个文件,形式为: lZy迪尔课堂自学网-|第二课堂|--(官网)
{dede:include file='文件名称' ismake='是否为dede板块模板(yes/no)'/} lZy迪尔课堂自学网-|第二课堂|--(官网)
对文件的搜索路径为顺序为:绝对路径、include文件夹,CMS安装目录,CMS主模板目录 lZy迪尔课堂自学网-|第二课堂|--(官网)
3、织梦标记允许在任何标记中使用函数对得到的值进行处理,形式为: lZy迪尔课堂自学网-|第二课堂|--(官网)
{dede:标记名称 属性='值' function='youfunction("参数一","参数二","@me")'/} lZy迪尔课堂自学网-|第二课堂|--(官网)
其中 @me 用于表示当前标记的值,其它参数由你的函数决定是否存在,例如: lZy迪尔课堂自学网-|第二课堂|--(官网)
{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/} lZy迪尔课堂自学网-|第二课堂|--(官网)
4、织梦标记允许有限的编程扩展。 lZy迪尔课堂自学网-|第二课堂|--(官网)
格式为: lZy迪尔课堂自学网-|第二课堂|--(官网)

复制代码
代码如下:
lZy迪尔课堂自学网-|第二课堂|--(官网)
{dede:tagname runphp='yes'} lZy迪尔课堂自学网-|第二课堂|--(官网)
$aaa = @me; lZy迪尔课堂自学网-|第二课堂|--(官网)
@me = "123456"; lZy迪尔课堂自学网-|第二课堂|--(官网)
{/dede:tagname} lZy迪尔课堂自学网-|第二课堂|--(官网)
lZy迪尔课堂自学网-|第二课堂|--(官网)
@me 表示这个标记本身的值,因此标记内编程是不能使用echo之类的语句的,只能把所有返回值传递给@me。 lZy迪尔课堂自学网-|第二课堂|--(官网)
此外由于程序代码占用了底层模板InnerText的内容,因此需编程的标记只能使用默认的InnerText。 lZy迪尔课堂自学网-|第二课堂|--(官网)
二、解析方式 lZy迪尔课堂自学网-|第二课堂|--(官网)
在 dedetag.class.php 里面有四个类 lZy迪尔课堂自学网-|第二课堂|--(官网)
class DedeAttribute 属性结构表述 lZy迪尔课堂自学网-|第二课堂|--(官网)
class DedeAttributeParse 属性解析器 lZy迪尔课堂自学网-|第二课堂|--(官网)
class DedeTag 标签结构表述 lZy迪尔课堂自学网-|第二课堂|--(官网)
class DedeTagParse 标签解析器 lZy迪尔课堂自学网-|第二课堂|--(官网)
使用解析类解析模板时一般经过下面的步骤 lZy迪尔课堂自学网-|第二课堂|--(官网)
1、初始化: lZy迪尔课堂自学网-|第二课堂|--(官网)
$dtp = new DedeTagParse(); lZy迪尔课堂自学网-|第二课堂|--(官网)
2、载入模板/模板字符串: lZy迪尔课堂自学网-|第二课堂|--(官网)
$dtp->LoadTemplate(模板文件(绝对路径)); //会生成缓存,第二次不需解析模板 lZy迪尔课堂自学网-|第二课堂|--(官网)
lZy迪尔课堂自学网-|第二课堂|--(官网)
$dtp->LoadSource(字符串); lZy迪尔课堂自学网-|第二课堂|--(官网)
3、给标签赋值 lZy迪尔课堂自学网-|第二课堂|--(官网)
foreach($dtp->CTags as $tid=>$ctag) { lZy迪尔课堂自学网-|第二课堂|--(官网)
//判断ctag的名称和属性,并给赋不同的值,通常用函数处理 lZy迪尔课堂自学网-|第二课堂|--(官网)
if($ctag->GetName=='mytag') $dtp->Assign($tid, mytagvalue($ctag) ); lZy迪尔课堂自学网-|第二课堂|--(官网)
} lZy迪尔课堂自学网-|第二课堂|--(官网)
在上面例子中,直接把名称为 mytag的标签转交给 mytagvalue 函数处理,mytagvalue 里判断$ctag的各个属性,返回不同内容即可。 lZy迪尔课堂自学网-|第二课堂|--(官网)
在 V5.3版本中,通常除了field、list等专用标签之外,凡arc.*开头的类解析的文件,标签都是对应该 include/taglib 的源码的,这个由系统进行了自动的映射。 lZy迪尔课堂自学网-|第二课堂|--(官网)
4、显示或保存为HTML lZy迪尔课堂自学网-|第二课堂|--(官网)
$dtp->display(); lZy迪尔课堂自学网-|第二课堂|--(官网)
lZy迪尔课堂自学网-|第二课堂|--(官网)
$dtp->SaveTo(静态文件名); lZy迪尔课堂自学网-|第二课堂|--(官网)
对于二次开发人员而言,不大需要知道dedecms模板具体解析方式,不过应该十分清楚CTag这个类的结构,从而判断标签不同属性进行处理。 lZy迪尔课堂自学网-|第二课堂|--(官网)

复制代码
代码如下:
lZy迪尔课堂自学网-|第二课堂|--(官网)
class DedeTag lZy迪尔课堂自学网-|第二课堂|--(官网)
{ lZy迪尔课堂自学网-|第二课堂|--(官网)
var $IsReplace=FALSE; //标记是否已被替代,供解析器使用 lZy迪尔课堂自学网-|第二课堂|--(官网)
var $TagName=""; //标记名称 lZy迪尔课堂自学网-|第二课堂|--(官网)
var $InnerText=""; //标记之间的文本 lZy迪尔课堂自学网-|第二课堂|--(官网)
var $StartPos=0; //标记起始位置 lZy迪尔课堂自学网-|第二课堂|--(官网)
var $EndPos=0; //标记结束位置 lZy迪尔课堂自学网-|第二课堂|--(官网)
var $CAttribute=""; //标记属性描述,即是class DedeAttribute lZy迪尔课堂自学网-|第二课堂|--(官网)
var $TagValue=""; //标记的值 lZy迪尔课堂自学网-|第二课堂|--(官网)
var $TagID = 0; lZy迪尔课堂自学网-|第二课堂|--(官网)
//获取标记的名称和值 lZy迪尔课堂自学网-|第二课堂|--(官网)
function GetName() lZy迪尔课堂自学网-|第二课堂|--(官网)
{ lZy迪尔课堂自学网-|第二课堂|--(官网)
return strtolower($this->TagName); lZy迪尔课堂自学网-|第二课堂|--(官网)
} lZy迪尔课堂自学网-|第二课堂|--(官网)
function GetValue() lZy迪尔课堂自学网-|第二课堂|--(官网)
{ lZy迪尔课堂自学网-|第二课堂|--(官网)
return $this->TagValue; lZy迪尔课堂自学网-|第二课堂|--(官网)
} lZy迪尔课堂自学网-|第二课堂|--(官网)
//下面两个成员函数仅是为了兼容旧版 lZy迪尔课堂自学网-|第二课堂|--(官网)
function GetTagName() lZy迪尔课堂自学网-|第二课堂|--(官网)
{ lZy迪尔课堂自学网-|第二课堂|--(官网)
return strtolower($this->TagName); lZy迪尔课堂自学网-|第二课堂|--(官网)
} lZy迪尔课堂自学网-|第二课堂|--(官网)
function GetTagValue() lZy迪尔课堂自学网-|第二课堂|--(官网)
{ lZy迪尔课堂自学网-|第二课堂|--(官网)
return $this->TagValue; lZy迪尔课堂自学网-|第二课堂|--(官网)
} lZy迪尔课堂自学网-|第二课堂|--(官网)
//获取标记的指定属性 lZy迪尔课堂自学网-|第二课堂|--(官网)
function IsAttribute($str) lZy迪尔课堂自学网-|第二课堂|--(官网)
{ lZy迪尔课堂自学网-|第二课堂|--(官网)
return $this->CAttribute->IsAttribute($str); lZy迪尔课堂自学网-|第二课堂|--(官网)
} lZy迪尔课堂自学网-|第二课堂|--(官网)
function GetAttribute($str) lZy迪尔课堂自学网-|第二课堂|--(官网)
{ lZy迪尔课堂自学网-|第二课堂|--(官网)
return $this->CAttribute->GetAtt($str); lZy迪尔课堂自学网-|第二课堂|--(官网)
} lZy迪尔课堂自学网-|第二课堂|--(官网)
function GetAtt($str) lZy迪尔课堂自学网-|第二课堂|--(官网)
{ lZy迪尔课堂自学网-|第二课堂|--(官网)
return $this->CAttribute->GetAtt($str); lZy迪尔课堂自学网-|第二课堂|--(官网)
} lZy迪尔课堂自学网-|第二课堂|--(官网)
function GetInnerText() lZy迪尔课堂自学网-|第二课堂|--(官网)
{ lZy迪尔课堂自学网-|第二课堂|--(官网)
return $this->InnerText; lZy迪尔课堂自学网-|第二课堂|--(官网)
} lZy迪尔课堂自学网-|第二课堂|--(官网)
} lZy迪尔课堂自学网-|第二课堂|--(官网)

扫一扫手机访问