Appearance
DedeCMS静态模板引擎
核心文件
/include/dedetag.class.php
功能描述
DedeCMS V5.7 及之前版本使用的主要的模板类,它是解析式模板类,并非编译式的。
注:
编译式是通过获得标签位置进行内容替换,编译式是直接解析为PHP代码,二次执行。
模板语法
织梦模板引擎是一种使用XML名字空间形式的模板解析器,使用织梦解析器解析模板的最大好处是可以轻松的制定标记的属性,感觉上就像在用HTML一样,使模板代码十分直观灵活,新版的织梦模板引擎不单能实现模板的解析还能分析模板里错误的标记。
代码样式
html
{dede:标记名称 属性='值'/}
html
{dede:标记名称 属性='值'}{/dede:标记名称}
html
{dede:标记名称 属性='值'}自定义样式模板(InnerText){/dede:标记名称}
注:
如果使用带底层模板的标记,必须严格用{dede:标记名称 属性='值'}{/dede:标记名称} 这种格式,否则会报错。
内置系统标记
global
表示获取一个外部变量,除了数据库密码之外,能调用系统的任何配置参数,形式为:
html
{dede:global name='变量名称'}{/dede:global}
或
html
{dede:global name='变量名称'/}
其中变量名称不能加 $
符号,如变量 $cfg_cmspath
,应该写成
html
{dede:global name='cfg_cmspath'/}
foreach
用来输出一个数组,形式为:
html
{dede:foreach array='数组名称'}
[field:key/] [field:value/]
{/dede:foreach}
include
引入一个文件,形式为:
html
{dede:include file='文件名称' ismake='是否为dede板块模板(yes/no)'/}
文件路径优先顺序
绝对路径 > include文件夹 > CMS安装目录 > CMS主模板目录
自定义函数
html
{dede:标记名称 属性='值' function='youfunction("参数一","参数二","@me")'/}
其中 @me
用于表示当前标记的值,其它参数由你的函数决定是否存在,例如:
html
{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}
DedeCMS允许有限的编程扩展,格式为:
html
{dede:tagname runphp='yes'}
$aaa = @me;
@me = "123456";
{/dede:tagname}
注:
@me
表示这个标记本身的值,因此标记内编程是不能使用 echo
之类的语句的,只能把所有返回值传递给 @me
。
此外由于程序代码占用了底层模板 InnerText
的内容,因此需编程的标记只能使用默认的 InnerText
。