1.模板后缀应为“
htm”
2.系统的模板目录在系统根目录下的
templets内,下面是模板目录的文件目录结构。
/templets·········································································
├─default······································································默认模板目录
│├─
images································································ 模板图片目录
││├─mood····························································
││└─photo····························································
│├─
js······································································ 模板JS脚本目录
│└─
style···································································模板CSS样式目录
├─lurd········································································· LURD系统模板
├─plus·········································································插件模板目录
├─system······································································系统底层模板目录
└─wap·········································································WAP模块模板目录
3.,默认风格是default,它表示系统默认使用
{cmspath}/templets/default 这个文件夹的模板,如果你下载了一套新的模板,你可以不必要删除default 原
有的文件,把下载的模板文件夹命名你想要的风格名称,如style2 等,然后在
后台修改默认的模板风格
名称为style2,那系统将使用{cmspath}/templets/style2 这文件当作默认模板,但是若你手工指定了栏目模
板的位置,则后台参数风格的定义无效。
4.
板块(封面)模板
指网站主页或比较重要的栏目封面频道使用的模板,一般用“index_识别ID.htm”命名,此外,用户单
独定义的单个页面或自定义标记,也可选是否
支持板块模板标记,如果支持,系统会用板块模板标记引擎
去解析后才输出内容或生成特定的文件。
列表模板
指网站某个栏目的所有
文章列表的模板,一般用“list_识别ID.htm” 命名。
档案模板:
表示文档查看页的模板,如
文章模板,一般用“article_识别ID.htm” 命名。
其它模板:
一般系统常规包含的模板有:
主页模板、搜索模板、RSS、JS编译功能模板等,此外用户也可以自定
义一个模板创建为任意文件。
5.
模板文件命名规范
1 index_识别ID.htm:表示板块(栏目封面)模板;
2 list_识别ID.htm:表示栏目列表模板;
3 article_识别ID.htm:表示内容查看页(文档模板,包括专题查看页);
4 search.htm:搜索结果列表模板;
5 index.htm:主页模板;
6.织梦模板引擎的
代码样式
{dede:标记名称属性='值'/}
{dede:标记名称属性='值'}{/dede:标记名称}
{dede:标记名称属性='值'}自定义样式模板(InnerText){/dede:标记名称}
7.注:如果使用带底层模板的标记,必须严格用{dede:标记名称属性='值'}{/dede:标记名称} 这种格式,否
则会报错。
内置系统标记
①global 标记,表示
获取一个外部变量,除了数据库密码之外,能调用系统的任何配置参数,形式为:
{dede:globalname='变量名称'}{/dede:global}或{dede:globalname='变量名称'/}
其中变量名称不能加$符号,如变量$cfg_cmspath,应该写成{dede:globalname='cfg_cmspath'/}。
②foreach 用来
输出一个数组,形式为:
{dede:foreacharray='数组名称'}[field:key/] [field:value/]{/dede:foreach}
③include
引入一个文件,形式为:
{dede:includefile='文件名称' ismake='是否为dede板块模板(yes/no)'/}
对文件的搜索路径为顺序为:绝对路径、include 文件夹,CMS安装目录,CMS主模板目录
自定义函数使用{dede:标记名称属性='值' function='youfunction("参数一","参数二","@me")'/}
其中
@me用于表示当前标记的值,其它参数由你的函数决定是否存在,例如:
{dede:fieldname='pubdate'function='strftime("%Y-%m-%d%H:%M:%S","@me")'/}
织梦标记允许有限的编程扩展
格式为:
{dede:tagnamerunphp='yes'}
$aaa=@me;
@me="123456";
{/dede:tagname}
@me表示这个标记本身的值,因此
标记内编程是不能使用echo之类的语句的,只能把所有返回值传递给
@me。
此外由于程序代码占用了底层模板InnerText的内容,因此需编程的标记只能使用默认的InnerText
8.
动态模板引擎
用于非核心模块的动态页面或列表页的模板解析,如:member/content_list.php,通常是
在datalistcp.class.php中使用,这个类在动态运行的情况下,由于本身是把模板编译成PHP的,因此性能上
会优级于旧的解析类,这个方法将在未来版本中作为通用的方式。
标记通用特性
①短标记
{dede:tagname.name/}
等同于
{dede:tagnamename=''/}
②块标记
{dede:tagname}
循环代码
{/dede:tagname}
标记的具体语法及对应的PHP代码
①配置变量
{dede:configname=''value=''/}
配置变量可以在载入模板后通过$tpl->GetConfig($name) 获得,仅作为配置,不在模板中显示。
②短标记
{dede:global.name/} 外部变量 等同于<?phpecho$name;?>
{dede:var.name/} var数组 等同于<?phpecho$_vars['name'];?>
{dede:field.name/} field数组 等同于<?phpecho$fields['name'];?>
{dede:cfg.name/} 系统配置变量等同于<?phpecho$cfg_name;?>
考虑到大多数情况下都会在函数或类中调用模板,因此$_vars、$fields 数组必须声明为global 数组,否
则模板引擎无法获得它的值从而导致产生错误。
③自由调用块标记
{tag:blocknamebind='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)统一管理。
④固定块标记
1.datalist
从绑定类成员函数GetArcList中获取数组并输出
{dede:datalist}
循环代码
{/dede:datalist}
遍历一个二给维数组,数据源是固定的,只适用用类调用。
等同于
{tag:blocknamebind='GetArcList'bindtype='class'rstype='arrayu'}
循环代码
{/tag:blockname}
2.label
从绑定函数中获取字符串值并输出
等同于{tag:blocknamebind='func'bindtype='sub'rstype='string'/}
3.pagelist
从绑定类成员函数GetPageList中获取字符串值并输出
等同于{tag:blocknamebind='GetPageList'bindtype='class'rstype='string'/}
4.include
{dede:includefile=''/}
{dede:includefilename=''/}
5.php
{dede:php
php代码
/}
或
{dede:php}
php代码
{/dede:php}
6.If
仅支持if ,else ,else 直接用{else}表示,但不支持{elseif}这样的语法,一般建议模板中不要使用太复杂
的条件语法,如果确实有需要,可以直接使用php语法。
{dede:if 条件}a-block {else}b-block{/dede:if}
条件中允许使用var.name、global.name 、field.name、cfg.name表示相应的变量。
如:
{dede:iffield.id>10}
{/dede:if}
7.遍历一个array 数组
{dede:array.name}
{dede:key/}={dede:value/}
{/dede:array}
各种语法的具体编译后的代码,可查看dedetemplate.class.php的functionCompilerOneTag(&$cTag)。
9.
标签的分类
每个标签都会有他的作用域,上文中我们可以了解系统文档页面可以分为:封面、列表、内容几个部
分,每个页面的模板则会涉及到不同的标签,所以标签也有了他的作用域,我们在模板制作过程中主要根
据模板的作用域来对模板进行如下划分:
全局标签
可以在前台文档任意页面使用的模板标记,例如:arclist、channel、sql、loop 等。
列表标签
仅在模板*_list.htm中可以使用的标签,例如:list、pagelist。
内容标签
仅在模板*_.article.htm中可以使用的模板标记,例如:likearticle、pagebreak等。
模块标签
仅在特定的模块、插件中使用的模板标记