dede织梦cms模板标签说明,模版制作解析引擎概述模板设计规范代码参考标记参考:arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart ) field channel mytag vote friendlink mynews loop channelartlist page list pagelist pagebreak fieldlist一、织梦模板解析引擎概述在了解DedeCms的模板代码之前,了解一下织梦模板引擎的知识是非常有意义的。
织梦模板引擎是一种使用XML名字空间形式的模板解析器,使用织梦解析器解析模板的最大好处是可以轻松的制定标记的属性,感觉上就像在用HTML一样,使模板代码十分直观灵活,新版的织梦模板引擎不单能实现模板的解析还能分析模板里错误的标记。
1、织梦模板引擎的代码样式有如下几种形式:{dede:标记名称属性='值'/}{dede:标记名称属性='值'}{/dede:标记名称}{dede:标记名称属性='值'}自定义样式模板(InnerText){/dede:标记名称}提示:对于{dede:标记名称属性='值'}{/dede:标记名称}这种形式的标记,在2.1版中,表示结束只需要用“{/dede}”,但V3中需要严格用“{/dede:标记名称}”,否则会报错。
2、织梦模板引擎内置有多个系统标记,这些系统标记在任何场合都是能直接使用的。
(1) global 标记,表示获取一个外部变量,除了数据库密码之外,能调用系统的任何配置参数,形式为:{dede:global name='变量名称'}{/dede:global}或{dede:global name='变量名称' /}其中变量名称不能加$ 符号,如变量$cfg_cmspath ,应该写成{dede:global name='cfg_cmspath' /} 。
(2) foreach 用来输出一个数组,形式为:{dede:foreach array='数组名称'}[field:key/][field:value/]{/dede:foreach}(3) include 引入一个文件,形式为:{dede:include file='文件名称' /}对文件的搜索路径为顺序为:绝对路径、include文件夹,CMS安装目录,CMS主模板目录3、织梦标记允许在任何标记中使用函数对得到的值进行处理,形式为:{dede:标记名称属性='值' function='youfunction("参数一","参数二","@me")'/}其中@me 用于表示当前标记的值,其它参数由你的函数决定是否存在,例如:{dede:field name='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:arclisttypeid='' 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起始的,如“limit 0,5”表示的是取前五笔记录,“limit 5,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 = <a href='arcurl'>title</a>typelink = <a href='typeurl'>typename</a>imglink = <a href='arcurl'><img src='picname' border='0' width='imgwidth' height='imgheight'></a>image = <img src='picname' border='0' width='imgwidth'height='imgheight'>变量调用方法:[field:varname /]如:{dede:arclist infolen='100'}[field:textlink /]<br>[field:info /]<br>{/dede:arclist}2、field 标记这个标记用于获取特定栏目或档桉的字段值及常用的环境变量值适用范围:封面模板、列表模板、文档模板(1)基本语法{dede:field name=''/}(2) name 属性的值:板块模板:phpurl,indexurl,indexname,templeturl,memberurl,powerby, webname,specurl列表模板:position,title,phpurl,templeturl,memberurl,powerby,indexurl ,indexname,specurl,栏目表dede_arctype的所有字段其中position 为“栏目一> 栏目二” 这样形式的链接,title 则为这种形式的标题文档模板:position,phpurl,templeturl,memberurl,powerby,indexurl,ind exname,specurl,id(同ID,aid),档案dede_archives表和附加表的所有字段。