dede模板说明

1、dede模板说明DedeCms【模板说明】+【标记标签说明】=菜鸟教程织梦DedeCms模板标记简介（也就是DEDECMS模板代码）】1：织梦模板引擎的代码样式有如下几种形式：dede:标记名称属性=值/dede:标记名称属性=值/dede:标记名称dede:标记名称属性=值自定义样式模板(InnerText)/dede:标记名称提示：如果使用带底层模板的标记，必须严格用dede:标记名称属性=值/dede:标记名称 这种格式，否则会报错2：模板内置系统标记如下(1) global标记，表示获取一个外部变量，除了数据库密码之外，能调用系统的任何配置数，形式为：dede:global name=

2、变量名称/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=文件名称 ismake=是否为dede板块模板(yes/no)/对文件的搜索路径为顺序为：绝对路径、include文件夹，CMS安装目录，CMS

3、主模板目录3：织梦标记允许在任何标记中使用函数对得到的值进行处理，形式为：dede:标记名称属性=值 function=youfunction(参数一,参数二,me)/其中me 用于表示当前标记的值，其它参数由你的函数决定是否存在，例如：dede:field name=pubdatefunction=strftime(%Y-%m-%d %H:%M:%S,me)/4：织梦标记允许有限的编程扩展。格式为：dede:tagname runphp=yes$aaa = me;me = 123456;/dede:tagnameme 表示这个标记本身的值，因此标记内编程是不能使用echo之类的语句的，只能把

4、所有返回值传递给me。此外由于程序代码占用了底层模板InnerText的内容，因此需编程的标记只能使用默认的InnerText。【织梦DedeCms模板标签代码参考】【Arclist 标记】=获取指定的文档列表这个标记是DedeCms最常用的一个标记，也叫自由列表标记，其中hotart、coolart、likeart、artlist、imglist、imginfolist、specart、autolist 这些标记都是由这个标记所定义的不同属性延伸出来的别名标记。适用范围：封面模板、列表模板、文档模板基本语法：dede:arclist typeid= row= col= titlelen= i

5、nfolen=imgwidth= imgheight= listtype= orderby= keyword=底层模板(InnerText)/dede:arclist属性说明：1 typeid= 表示栏目ID，在列表模板和档案模板中一般不需要指定，在封面模板中允许用,分开表示多个栏目；2 row= 表示返回文档列表总数；3 col= 表示分多少列显示（默认为单列）；4 titlelen= 表示标题长度；5 infolen= 表示内容简介长度；6 imgwidth= 表示缩略图宽度；7 imgheight= 表示缩略图高度；8 type= 表示档案类型，其中空值、不使用这个属性或type=all

6、时为普通文档 type=commend时，表示推荐文档，等同于dede:coolart/dede:coolart type=image时，表示必须含有缩略图片的文档，等同于dede:imglist/dede:imglist、dede:imginfolist/dede:imginfolist type=spec时，表示专题，等同于标记dede:specart/dede:specart以上属性值可以联合使用，如：type=commend image 表示推荐的图片文档9 orderby= 表示排序方式，默认值是senddate 按发布时间排列。 orderby=hot 或orderby=click

7、 表示按点击数排列 orderby=pubdate 按出版时间排列（即是前台允许更改的时间值） orderby=sortrank 按文章的新排序级别排序（如果你想使用置顶文章则使用这个属性） orderby=id 按文章ID排序 orderby=postnum 按文章评论次数排序 orderby=rand 随机获得指定条件的文档列表10 orderway= 值为desc 或asc ，指定排序方式是降序还是顺向排序，默认为降序。11 keyword= 表示含有指定关键字的文档列表，多个关键字用,分开12 channelid= 表示特定的频道模型ID，内置的频道：专题(-1)、文章(1)、图集(2

8、)、Flash(4)、软件(3)13 limit=起始,结束 表示限定的记录范围，row属性必须等于结束- 起始，mysql的limit语句是由0起始的，如“limit 0,5”表示的是取前五笔记录，“limit 5,5”表示由第五笔记录起，取下五笔记录，使用了本属性后，row属性将无效。14 att=数值 表示自定义属性值15 subday=天数 表示在多少天以内的文档，通常用于获取指定天数的热门文档、推荐文档、热门评论文档等16 partsort=排列位数表示自动获得父栏目的所有子数中排列在第几位的栏目ID，标记为dede:autolist/dede:autolist 时，使用本属性才有效

9、。底层模板字段：ID(同id),title,iscommend,color,typeid,ismake,description(同info),writer,shorttitle,memberidpubdate,senddate,arcrank,click,litpic(同picname),typedir,typename,arcurl(同filename),typeurl,stime(pubdate 的0000-00-00格式),textlink,typelink,imglink,image其中：textlink = titletypelink = typenameimglink =image

10、 = 字段调用方法：field:varname/如：dede:arclist infolen=100field:textlink/dede:arclist注：底层模板里的Field实现也是织梦标记的一种形式，因此支持使用PHP语法，Function扩展等功能如：给当天发布的内容加上(new)标志field:senddate runphp=yes$ntime = time();$oneday = 3600 * 24;if($ntime - me)else me = ;/field:senddate【Field 标记】：用于获取特定栏目或档桉的字段值及常用的环境变量值适用范围：封面模板、列表模板、

11、文档模板(1)基本语法dede:field name=字段名/(2) 系统分配的field板块模板：phpurl,indexurl,indexname,templeturl,memberurl,powerby,webname,specurl 列表模板：position,title,phpurl,templeturl,memberurl,powerby,indexurl,indexname,specurl ,栏目表dede_arctype的所有字段其中position 为“栏目一 栏目二” 这样形式的链接，title则为这种形式的标题文档模板：position,phpurl,templeturl

12、,memberurl,powerby,indexurl,indexname,specurl,id(同ID,aid)(3) 文档所有内容字段档案dede_archives表和附加表的所有字段。【Channel 标记】：用于获取栏目列表适用范围：封面模板、列表模板、文档模板dede:channel row= type=自定义样式模板(InnerText)/dede:channel(2)属性1 row=数字 表示获取记录的条数（通用在某级栏目太多的时候使用，默认是8）2 type = top,sun/son,selftype=top 表示顶级栏目type=son 或sun 表示下级栏目type=se

13、lf 表示同级栏目其中后两个属性必须在列表模板中使用。(3)底层模板变量ID,typename,typedir,typelink(仅表示栏目的网址)例：dede:channel type=topfield:typename/dede:channel注：在没有指定typeid的情况下，type标记与模板的环境有关，如，模板生成到栏目一，那么type=son就表示栏目一的所有子类【Type 标记】别名onetype ：表示指定的单个栏目的链接适用范围：封面模板、列表模板、文档模板(1)语法dede:type typeid=/dede:type(2)属性typeid=栏目ID(3)底层模板变量typ

14、ename,typelink(仅表示栏目的网址)【Autochannel 标记】：表示指定排序位置的单个栏目的链接适用范围：封面模板、列表模板、文档模板(1)语法dede:autochannel partsort=/dede:autochannel(2)属性partsort=栏目所在的排序位置(3)底层模板变量typename,typelink(仅表示栏目的网址)【Mytag 标记】：用于获取自定义宏标记的内容适用范围：封面模板、列表模板、文档模板(1)基本语法dede:mytag typeid= name= ismake=/(2)属性1 typeid = 数字 表示栏目ID，默认为0，在没有

15、设定的栏目没有定义这个名称的标记，会按如下搜索方式来搜索“先向上查找父栏目- 通用标记（typeid=0）的同名标记”。2 name = 标记名称。3 ismake = yes|no 默认为no 表示mytag里的内容不包含其它封面模板的标记，yes则表示标记内容含有其它封面模板标记。【Vote 标记】：用于获取一组投票表单适用范围：封面模板(1) 基本语法dede:vote id=投票ID lineheight=22tablewidth=100% titlebgcolor=#EDEDE2titlebackground= tablebgcolor=#FFFFFF/dede:vote注：本标记直

16、接生成投票的HTML表单，为了让你更方便修改其样式，建议在后台-投票管理的地方直接复制生成的HTML代码来使用。【Flink 标记】，等同friendlink ：用于获取友情链接适用范围：封面模板(1)基本语法dede:flink type= row= col= titlelen= tablestyle=/dede:flink(2)属性1type：链接类型，值：a. textall 全部用文字显示b. textimage 文字和图得混合排列c. text 仅显示不带Logo的链接d. image 仅显示带Logo的链接-2row：显示多少行，默认为4行3col：显示多少列，默认为6列4titl

17、elen：站点文字的长度5tablestyle：表示【Mynews 标记】：用于获取站内新闻适用范围：封面模板(1) 基本语法dede:mynews row=条数 titlelen=标题长度Innertext/dede:mynews(2)属性1 row新闻条数2 titlelen标题长度(3)底层模板变量field:title/、field:writer/、field:senddate function=strftime(%y-%m-%d %H:%M,me)/(时间)、field:body/【LOOP 标记】：用于调用任意表的数据，一般用于调用论坛贴子之类的操作适用范围：所有模板(1) 基本语

18、法dede:loop table= sort= row= if=底层模板/dede:loop(2) 属性1 table 表示查询的数据表2 sort用于排序的字段3 row返回结果的条数4 if查询条件(3)底层模板变量这个标记的底层模板变量即是被查询表的所有字段例：获取Phpwind论坛的最新主题贴子<FONT size=3> dede:looptable=pw_threads sort=tid row=8if=<br>&lt

19、;ahref="/bbs/read.php?tid=field:tid/&amp ;amp;quot;> field:subjectfunction="cn_substr(me,30)&qu ot;/(field:lastpost function="date(m-d H:M,me)"/)</a&a

20、mp;am p;amp;gt; <br/>/dede:loop</FONT> 【Channelartlist 标记】：用于获取当前频道的下级栏目的内容列表适用范围：封面模板(1)基本语法dede:channelArtlist typeid=0 col=2 tablewidth=100%bgcolor=#BFCFA9dede:typename=cfg_plus_dir/img/channellist.gif width=14 height=16field:typ

21、ename /更多./dede:typedede:arclist row=8field:title /dede:arclist/dede:channelArtlist除了宏标记外，channelArtlist 是唯一一个可以直接嵌套其它标记的标记，不过仅限于嵌套dede:type/dede:type和dede:arclist/dede:arclist两个标记。(2) 属性1typeid=0 频道ID,默认的情况下，嵌套的标记使用的是这个栏目ID的下级栏目，如果你想用特定的栏目，可以用,分开多个ID。2col=2 分多列显示3tablewidth=100% 外围表格的大小【List 标记】：表示

22、列表模板里的分页内容列表适用范围：仅列表模板list_*.htm(1)基本语法dede:list col= titlelen=infolen= imgwidth= imgheight= orderby= pagesize=/dede:list(2)属性1col 内容列数2titlelen 标题长度3infolen 内容摘要长度4imgwidth 缩略图宽5imgheight 缩略图高6orderby 排序方式，有效的排序方式有senddate、pubdate、id、click、lastpost、postnum ，默认为sortrank7pagesize 分页大小(3)底层模板变量ID(同id)

23、,title,iscommend,color,typeid,ismake,description(同info),postnum,lastpost,shorttitlepubdate,senddate,arcrank,click,litpic(同picname),typedir,typename,arcurl(同filename),typeurl,stime(pubdate 的0000-00-00格式),textlink,typelink,imglink,image注：list标记除了支持档案表的基本模板变量外，还支持附加表的字段，你可以在模型管理中知道附加表支持列表使用的字段有哪些。【Page

24、 标记】：表示分页页面的附加参数适用范围：列表模板语法：dede:page pagesize=每页结果条数/注：此标记在dedecms3.1中已经过期，dedecms3.1中直接把pagesize属性加在list 标记中，表示记录分页大小。【Pagelist 标记】：表示分页页码列表适用范围：列表模板(1)语法dede:pagelist listsize=3 listitem=/(2)属性1 listsize 表示123 这些项的长度x 22 listitem 表示页码样式，可以把下面的值叠加index首页pre 上一页pageno 页码next 下一页end 末页option 下拉跳转框例：

25、dede:pagelist listsize=3 listitem=index pre pageno next end option/【Pagebreak 标记】：表示文档的分页链接列表。适用范围：仅文档模板。语法：dede:pagebreak/【Prenext 标记】功能说明：表示获取文档“上一篇下一篇”的链接列表。适用范围：仅文档模板。(1)语法：dede:prenext/(2)属性：1 get 获取连接类型（仅2007版），get= 同V4显示横排的上下页连接，get=pre 上一篇的连接get=next 下一篇连接注：此标记默认为横向排列，如果你想用竖向排列，可以用dede:prene

26、xt function=str_replace( 下一篇：,【Pagetitle 标记】：表示获取文档的分页标题适用范围：仅文档模板。(1)语法：dede:pagetitle style=select/(2)属性：style表示分页标题的展示样式select 表示下拉框、link 表示文字直接链接【Fieldlist 标记】功能说明：获得附加表的所有字段信息。适用范围：仅文档模板。语法：dede:fieldlistfield:name/ ：field:value/dede:fieldlist【Myad 标记】功能说明：获取广告代码适用范围：所有模板。建议在广告管理模块中获取，在此不作描述# #

27、 以下仅适用于DedeCms2007版# 【Ask 标记】：用于获取最新的问答的主题。适用范围：非扩展模块所有模板。(1)语法：dede:ask row= qtype=底层模板/dede:ask(2)属性：1 row 记录条数。2 qtype 类型默认为新回复问题，commend推荐问题ok已解决问题high高分问题(3)底层模板：field:tidname/field:title/field:typeurl/ 栏目网址field:tidname/ 栏目名称field:url/ 问题网址field:title/ 问题标题field:id/ 问题id【Sql 标记】：用于从模板中用一个SQL查询

28、获得其返回内容。适用范围：非扩展模块所有模板。(1)语法：dede:sql sql=底层模板/dede:sql(2)属性：1 sql 完整的SQL查询语句。(3)底层模板：SQL语句中查出的所有字段都可以用field:字段名/来调用。【Group 标记】：获取特定条件的圈子。适用范围：非扩展模块所有模板。(1)语法：dede:group row=个数 orderby=排序条件 底层模板/dede:group(2)属性：1 row 返回结果个数。2 orderby 排序条件，一般为：默认threads 发贴量，members 会员数，hits 浏览量，stime 创建时间。(3)底层模板：fie

29、ld:url/圈子网址field:groupname/圈子名称field:icon/圈子图标field:groupid/ 圈子ID【Groupthread 标记】：获取圈子最新发表的主题。适用范围：非扩展模块所有模板。(1)语法：dede:groupthread gid= row= orderby= orderway=底层模板/dede:groupthread(2)属性：1 gid= 圈子分类，为空或0刚表示所有分类2 row= 条数3 orderby= 排序条件默认dateline4 orderway= 排序方向desc 或asc(3)底层模板：field:url/圈子网址field:gro

30、upname/圈子名称field:icon/圈子图标field:groupid/ 圈子ID【booklist 标记】功能说明：用于获取最新连载图书。适用范围：连载书库。(1)语法：dede:booklist row= booktype= titlelen= orderby= catid= author= imgwidth= imgheight=底层模板/dede:booklist(2)属性：1 row= 行数2 booktype= 图书类型1 漫画，0 小说，-1 或默认全部3 titlelen= 标题长度4 orderby= 排序5 catid= 栏目ID6 author= 作者7 imgw

31、idth=8 imgheight=(3)底层模板：contenttitle,contentid,contenturl,dmbookurl,bookurl,catalogurl,cataloglink,book link,contentlink,imglink,ischeck,booktypename【catalog 标记】功能说明：用于获取书库的栏目。适用范围：连载书库。(1)语法：dede:catalog type=底层模板/dede:catalog(2)属性：1 type 类型默认为顶级栏目，type=son 表示当前栏目的子栏目，指定特定的栏目id则为所指定的栏目。(3)底层模板：本标记支持in嵌套，里面的in标记还可以再使用一重样式dede:catalogin:fieldname=classname/in:field/dede:catalog列出所有分类：dede:catalogin:fieldname=classname/in:field：in:sonlist field:classname/in:sonlist/dede:catalog【chapter 标记】功能说明：用于获取图书的章节列表，适用于book_book.htm。适用范围：连载书库。(1)语法：dede:chapter底层模板/dede:chapter(2)属性：(3)底层模板：url 网