解析引擎概述 模板设计规范 代码参考
标记参考:arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart)fieldchannelmytagvotefriendlinkmynewsloopchannelartlistpagelistpagelistpagebreakfieldlist 一、织梦模板解析引擎概述在了解Dedecms的模板代码之前,了解一下织梦模板引擎的知识是非常有意义的。织梦模板引擎是一种使用XML名字空间形式的模板解析器,使用织梦解析器解析模板的最大好处是可以轻松的制定标记的属性,感觉上就像在用HTML一样,使模板代码十分直观灵活,新版的织梦模板引擎不单能实现模板的解析还能分析模板里错误的标记。 1、织梦模板引擎的代码样式有如下几种形式:
{dede:标记名称属性='值'/}
{dede:标记名称属性='值'}{/dede:标记名称}
{dede:标记名称属性='值'}自定义样式模板(InnerText){/dede:标记名称} 提示:
对于{dede:标记名称属性='值'}{/dede:标记名称}这种形式的标记,在2.1版中,表示结束只需要用“{/dede}”,但
V3中需要严格用“{/dede:标记名称}”,否则会报错。 2、织梦模板引擎内置有多个系统标记,这些系统标记在任何场合都是能直接使用的。 (1)global标记,表示获取一个外部变量,除了数据库密码之外,能调用系统的任何配置参数,形式为:
{dede:globalname='变量名称'}{/dede:global}
或
{dede:globalname='变量名称'/} 其中变量名称不能加$符号,如变量$cfg_cmspath,应该写成{dede:globalname='cfg_cmspath'/}。 (2)foreach用来输出一个数组,形式为:
{dede:foreacharray='数组名称'}[field:key/][field:value/]{/dede:foreach} (3)include引入一个文件,形式为:
{dede:includefile='文件名称'/}
对文件的搜索路径为顺序为:绝对路径、include文件夹,CMS安装目录,CMS主模板目录 3、织梦标记允许在任何标记中使用函数对得到的值进行处理,形式为:
{dede:标记名称属性='值'function='youfunction("参数一","参数二","@me")'/}
其中@me用于表示当前标记的值,其它参数由你的函数决定是否存在,例如:
{dede:fieldname='pubdate'function='strftime("%Y-%m-%d%H:%M:%S","@me")'/} 二、Dedecms模板制作规范 Dedecms系统的模板是非固定的,用户可以在新建栏目时可以自行选择栏目模板,官方仅提供最基本的默认模板,即是内置系统模型的各个模板,Dedecms支持自定义频道模型,用户自定义新频道模型后,需要按该模型设计一套新的模板。
一、概念,设计和使用模板,必须要理解下面几个概念:
1、板块(封面)模板:
指网站主页或比较重要的栏目封面使用的模板,一般用“index_识别ID.htm”命名,此外,用户单独定义的单个页面或自定义标记,也可选是否支持板块模板标记,如果支持,系统会用板块模板标记引擎去解析后才输出内容或生成特定的文件。
2、列表模板:
指网站某个栏目的所有文章列表的模板,一般用“list_识别ID.htm”命名。
3、档案模板:
表示文档查看页的模板,一般用“article_识别ID.htm”命名。
4、其它模板:
一般系统常规包含的模板有:主页模板、搜索模板、RSS、JS编译功能模板等,此外用户也可以自定义一个模板创建为任意文件。
二、命名,为了规范起见,织梦官方建议使用统一的方式来命名模板,具体如下:
1、模板保存位置:
模板目录:{cmspath/templets/样式名称(英文,默认为default,其中system为系统底层模板,plus为插件使用的模板)/具体功能模板文件}
一般的模板位置:“/templets/default”
2、模板文件命名规范:
(1)index_识别ID.htm: 表示板块(栏目封面)模板;
(2)list_识别ID.htm: 表示栏目列表模板;
(3)article_识别ID.htm: 表示内容查看页(文档模板,包括专题查看页);
(4)search.htm:搜索结果列表模板;
(5)index.htm:主页模板;
注解:
你的系统各个内容频道的[识别ID]分别为:
例:list_image.htm表示是就是内容类型为图片集的栏目默认列表模板。 三、主要标记参考 1、arclist标记 这个标记是Dedecms最常用的一个标记,其中hotart、coolart、likeart、artlist、imglist、imginfolist、specart这些标记都是由这个标记所定义的不同属性延伸出来的。 作用:获取一个指定的文档列表 适用范围:封面模板、列表模板、文档模板 (1)基本语法: {dede:arclist
typeid=''row=''col=''titlelen=''
infolen=''imgwidth=''imgheight=''listtype=''orderby=''keyword=''} 自定义样式模板(InnerText) {/dede:arclist} 本标记等同于artlist、imglist、imginfolist标记,其中与artlist是完全等同的,与imglist、imginfolist仅是默认的底层模板不同。
(2)属性参考: [1]typeid=''表示栏目ID,在列表模板和档案模板中一般不需要指定,在封面模板中允许用","分开表示多个栏目;
[2]row=''表示返回文档行数,如果和col联合使用,刚结果数等于row*col;
[3]col=''表示分多少列显示(默认为单列);
[4]titlelen=''表示标题长度;
[5]infolen=''表示内容简介长度;
[6]imgwidth=''表示缩略图宽度;
[7]imgheight=''表示缩略图高度;
[8]type=''表示档案类型,其中默认值或type='all'时为普通文档
§type='commend'时,表示推荐文档,等同于
§type='image'时,表示必须含有缩略图片的文档
[9]orderby=''表示排序方式,默认值是senddate按发布时间排列。
§orderby='hot'或orderby='click'表示按点击数排列
§orderby='pubdate'按出版时间排列(即是前台允许更改的时间值)
§orderby='sortrank'按文章的新排序级别排序(如果你想使用置顶文章则使用这个属性)
§orderby='id'按文章ID排序
[10]keyword=''表示含有指定关键字的文档列表,多个关键字用","分开
[11]channelid='数字'表示特定的频道类型,内置的频道:专题(-1)、文章(1)、图集(2)、Flash(4)、软件(3)
[12]limit='起始,结束'表示限定的记录范围,row属性必须等于"结束-起始",MysqL的limit语句是由0起始的,如“limit0,5”表示的是取前五笔记录,“limit5,5”表示由第五笔记录起,取下五笔记录。 (3)底层模板变量 ID(同id),title,iscommend,color,typeid,ismake,description(同info),
pubdate,senddate,arcrank,click,litpic(同picname),typedir,typename,
arcurl(同filename),typeurl,stime(pubdate的"0000-00-00"格式),
textlink,typelink,imglink,image 其中:
textlink=<ahref='arcurl'>title
typelink=<ahref='typeurl'>typename
imglink=<ahref='arcurl'><imgsrc='picname'border='0'width='imgwidth'height='imgheight'>
image=<imgsrc='picname'border='0'width='imgwidth'height='imgheight'> 变量调用方法:[field:varname/] 如:
{dede:arclistinfolen='100'}
[field:textlink/]
[field:info/]
{/dede:arclist} 2、field标记 这个标记用于获取特定栏目或档桉的字段值及常用的环境变量值 适用范围:封面模板、列表模板、文档模板 (1)基本语法 {dede:fieldname=''/} (2)name属性的值: 板块模板:PHPurl,indexurl,indexname,templeturl,memberurl,powerby,webname,specurl 列表模板:position,PHPurl,specurl,栏目表dede_arctype的所有字段
其中position为“栏目一>栏目二”这样形式的链接,title则为这种形式的标题 文档模板:position,id(同ID,aid),档案dede_archives表和附加表的所有字段。
3、channel标记 用于获取栏目列表 适用范围:封面模板、列表模板、文档模板 (1)基本语法
{dede:channelrow=''type=''}
自定义样式模板(InnerText)
{/dede:channel} (2)属性 [1]row='数字'表示获取记录的条数(通用在某级栏目太多的时候使用,默认是8) [2]type=top,sun,self type='top'表示顶级栏目
type='sun'表示下级栏目
type='self'表示同级栏目 其中后两个属性必须在列表模板中使用。 (3)底层模板变量 ID,typelink(这里仅表示栏目的网址) 例:
{dede:channeltype='top'}
<ahref='[field:typelink/]'>[field:typename/]
{/dede:channel} 4、mytag标记 用于获取自定义标记的内容 适用范围:封面模板、列表模板、文档模板 (1)基本语法 {dede:mytagtypeid=''name=''ismake=''/} (2)属性 [1]typeid='数字'表示栏目ID,默认为0,在没有设定的栏目没有定义这个名称的标记,会按如下搜索方式来搜索“先向上查找父栏目->通用标记(typeid=0)的同名标记”。 [2]name=''标记名称。 [3]ismake=yes|no默认为no表示mytag里的内容不包含其它封面模板的标记,yes则表示标记内容含有其它封面模板标记。 5、vote标记 用于获取一组投票表单 适用范围:封面模板 (1)基本语法
{dede:voteid='投票ID'lineheight='22'
tablewidth='100%'titlebgcolor='#EDEDE2'
titlebackground=''tablebgcolor='#FFFFFF'}
{/dede:vote}
6、friendlink标记,等同flink 用于获取友情链接 适用范围:封面模板 (1)基本语法 {dede:flinktype=''row=''col=''titlelen=''tablestyle=''}{/dede:flink}
属性注解:
[1]type:链接类型,值:
a.textall全部用文字显示
b.textimage文字和图得混合排列
c.text仅显示不带logo的链接
d.image仅显示带logo的链接
-------------------------------------
[2]row:显示多少行,默认为4行
[3]col:显示多少列,默认为6列
[4]titlelen:站点文字的长度
[5]tablestyle:表示<table这里的内容> 7、mynews标记 用于获取站内新闻 适用范围:封面模板 (1)基本语法 {dede:mynewsrow='条数'titlelen='标题长度'}Innertext{/dede:mynews} Innertext支持的字段为:[field:title/],[field:writer/],field:senddate/,[field:body/] 8、loop标记 用于调用任意表的数据,一般用于调用论坛贴子之类的操作,请参阅论坛扩展插件。 9、channelartlist标记 用于获取频道的下级栏目的内容列表 适用范围:封面模板 语法: {dede:channelArtlisttypeid=0col=2tablewidth='100%'}
<tablewidth="99%"border="0"cellpadding="3"cellspacing="1"bgcolor="#BFCFA9">
<tr>
<tdbgcolor="#E6F2CC">
{dede:type}
<tableborder="0"cellpadding="0"cellspacing="0"width="98%">
<tr>
<tdwidth='10%'align="center"><imgsrc='[field:globalname='cfg_plus_dir'/]/img/channellist.gif'width='14'height='16'></td>
<tdwidth='60%'>
<ahref="[field:typelink/]">[field:typename/]
</td>
<tdwidth='30%'align='right'>
<ahref="[field:typelink/]">更多...
</td>
</tr>
</table>
{/dede:type}
</td>
</tr>
<tr>
<tdheight="150"valign="top"bgcolor="#FFFFFF">
{dede:arclistrow="8"}
·<ahref="[field:arcurl/]">[field:title/]
{/dede:arclist}
</td>
</tr>
</table>
<divstyle='font-size:2px'>