织梦官方织梦CMS模板制作手册

织梦织梦CMS模板制作手册版本：20230312编写：天际上海卓卓网络科技Copyright2023-2023DesDevINC.Allrightsreserved.2Copyright2023-2023DesDevINC.Allrightsreserved.名目267777手册Web78999101111111212131414141414153Copyright2023-2023DesDevINC.Allrightsreserved.1516161619191920全局标签20arclist20arclistsg23arclistarclist24autochannel25cattree26channel26channelartlist29feedback32field34flink35flinktype36global37hotwords37jsonJSON38loop41memberlist42myad44mynews46mytag48phpphp49softmsg504Copyright2023-2023DesDevINC.Allrightsreserved.sonchannel52sqlSQL53tagTAG55type56vote5757list57list59内容标签60likearticle60break61title63prenext65fieldlist6668bookcontentlist68booklist69group70groupthread7172infoguide72infolink7375757575767778cn_substr785Copyright2023-2023DesDevINC.Allrightsreserved.Html2Text79Text2Html79MyDate80GetDateTimeMk81FloorTime82HtmlReplace82RemoveXSS836Copyright2023-2023DesDevINC.Allrightsreserved.版权申明公布本资料须遵守开放出版许可协议1.0或者更版本；未经版权全部者明确授权，制止发行本文档及其被实质上修改的版本；未经版权全部者事先授权，制止将此作品及其衍生作品以标准〔纸质〕书籍形式发行；联系版权全部。对DedeCMSbbs.dedecms公布相关争论。并在此感谢全部参与到DedeCMS工程中的朋友。有关DedeCMS工程及本文档的最资料，请准时访问官方主站“://dedecms/“。本散布，将导致相应的法律责任。7Copyright2023-2023DesDevINC.Allrightsreserved.前言简介本手册是织梦官方推出，用于介绍织梦内容治理系统〔以下简称：DedeCMS〕模板的制作，为织梦模会大大提高模板设计师的制作效率。DedeCMS的模板引擎承受了官方自行研发的DedeXML构造的标签简洁易懂，便于在网页编辑器中进展编辑。同时标签齐全，应用广泛，这为基于DedeCMS建设开发的站点供给了一个良好的根底，只需要懂HTMLDedeCMS风行的一个重要因素。主题手册将会从以下几个局部进展重点的说明：织梦模板设计师要求模板制作流程模板文件及名目构造模板引擎介绍模板标签模板扩展发行方法手册包含在线阅读、PDF、CHM几种发行方式，您可以登录织梦帮助中心来猎取最版本。手册Web站点您可以通过手册Web站点同官方取得沟通，以及共享您在制作过程中的心得。8Copyright2023-2023DesDevINC.Allrightsreserved.帮助中心：help.dedecms织梦技术论坛：bbs.dedecms最终的朋友参DedeCMS精神支持以及急躁表示感谢。9Copyright2023-2023DesDevINC.Allrightsreserved.第一章织梦模板设计师要求适合自身进展的从业人员及对员工进展定位、培训。设计师定义能够设计、制作DedeCMS程序模板的人员。设计师级别划分及要求这里依据建站需求，我们将织梦模板设计师进展一个大致的划分：初级：能够对模板进展修改，例如：元素布局、调用内容等。需要把握根本的HTML，图形图像处理技术，同时需要对织梦的常用标签有大致的了解。中级：能够依据设计稿输出页面、嵌套标签，并能够灵敏调用DedeCMS内容。需要娴熟把握Div+CSS、Javascript，DedeCMS的模板标签用法，同时需要有一些根本的PHP、MySQL尝试。写自己需要的标签以到达站点所需效果。需要娴熟把握图形图像网页设计相关技术、 PHP、JavascitptjQuer板引擎。10Copyright2023-2023DesDevINC.Allrightsreserved.其次章模板制作流程织梦模板制作需要经过以下几个流程：①设计页面效果图，一般为PSD或者PNG格式的原图；②将页面效果图输出为HTML.ht③依据页面内容调用需求生成或者编写标签所需代码；④嵌套标签代码到输出页面对应位置；⑤测试调试模板文件，保证调用和设计效果全都；⑥将模板标签、文件上传到模板名目；⑦在系统设定模板名目，重生成全站；11Copyright2023-2023DesDevINC.Allrightsreserved.第三章模板文件及名目构造模板名目系统的模板名目在系统根名目下的templets内，下面是模板名目的文件名目构造。templets├─default 默认模板名目│├─images 模板图片名目││├─mood││└─photo│├─js 模板JS脚本名目│└─style 模板CSS样式名目├─lurd LURD系统模板├─plus 插件模板名目├─system 系统底层模板名目└─wap WAP模块模板名目模板文件与功能说明DedeCMS系统的模板是非固定的，用户可以在建栏目时可以自行选择栏目模板，官方仅供给最基本的默认模板，即是内置系统模型的各个模板，由于DedeCMS支持自定义频道模型，用户自定义频道模型后，还需要按该模型的字段设计一套的模板。此外，DedeCMS也支持使用风格的形式使用模板，默认风格是default，它表示系统默认使用{cmspath}templetsdefaultdefault原有的文件，把下载的模板文件夹命名你想要的风格名称，如style2等，然后在后台修改了默认的模板风格名称为style2，那系统将使用{cmspath}templetsstyle2这文件当作默认模板，但是假设你手工指定了栏目模板的位置，则后台参数风格的定义无效。12Copyright2023-2023DesDevINC.Allrightsreserved.概念，设计和使用模板板块〔封面〕模板指网站主页或比较重要的栏目封面频道使用的模板，一般用“index_识别ID.htm”命名，此外，用户单模板标记引擎去解析后才输出内容或生成特定的文件。列表模板指网站某个栏目的全部文章列表的模板，一般用“list_ID.htm”命名。档案模板：表示文档查看页的模板，如文章模板，一般用“article_ID.htm”命名。其它模板：RSS、JS编译功能模板等，此外用户也可以自定义一个模板创立为任意文件。命名规章模板保存位置模板名目：{cmspath}templets样式名称〔default，其中system为系统底层模板，plus为插件使用的模板〕具体功能模板文件｝模板文件命名标准index_ID.htm：表示板块〔栏目封面〕模板；list_ID.htm：表示栏目列表模板；article识别ID.ht：表示内容查看页〔文档模板，包括专题查看页；search.htm：搜寻结果列表模板；index.htm：主页模板；注：[识别ID]可以在“频道模型治理”的地方获得，固然，你也可以在“频道模型治理”的地方确定某个频道13Copyright2023-2023DesDevINC.Allrightsreserved.的模板命名。例：list_image.htm表示是就是内容类型为图片集的栏目默认列表模板。article_article.htm表示的是文章查看页模板。其它模板说明默认底层模板位置：{cmspath}templetssystem底层模板。插件名目模板位置：{cmspath}templetsplus功能：评论、友情链接、RSS地图等模板。会员后台模板位置：{cmspath}membertemplets功能：会员后台的模板。系统后台模板位置：{cmspath}dedetemplets功能：系统后台治理的模板14Copyright2023-2023DesDevINC.Allrightsreserved.第四章模板引擎介绍DedeCMS从V5开头承受了解析式引擎与编译式引擎并存的模式，由于在生成HTML时，解析式引擎拥有巨大的优势，但对于动态扫瞄的互动性质的页面，编译式引擎更有用高效，织梦CMS承受双引擎并存的模式，在保持标签风格全都性的同时，也保证将来开发更多互动模块时有更好的性能。静态模板引擎核心文件includededetag.class.php功能描述DedeCMSV5.3及之前版本使用的主要的模板类，它是解析式模板类，并非编译式的。注：编译式是通过获得标签位置进展内容替换，编译式是直接解析为PHP代码，二次执行。模板语法织梦模板引擎是一种使用XML大好处是可以轻松的制定标记的属性，感觉上就像在用HTML一样，使模板代码格外直观灵敏，版的织梦模板引擎不单能实现模板的解析还能分析模板里错误的标记。织梦模板引擎的代码样式{dede标记名称属性=”值”}{dede标记名称属性=”值”}{dede标记名称}{dede标记名称属性=”值”}自定义样式模板(InnerText){dede标记名称}注：假设使用带底层模板的标记，必需严格用{dede标记名称属性=”值”}{dede标记名称}这种格式，否则会报错。内置系统标记①global形式为：{dedeglobalname=”变量名称”}{dedeglobal}15Copyright2023-2023DesDevINC.Allrightsreserved.或{dedeglobalname=”变量名称”}其中变量名称不能加$$cfg_cmspath，应当写成{dedeglobalname=”cfg_cmspath”}。②foreach用来输出一个数组，形式为：{dedeforeacharray=”数组名称”}[fieldkey][fieldvalue]{dedeforeach}③include引入一个文件，形式为：{dedeincludefile=”文件名称”ismake=”dede板块模板(yesno)”}对文件的搜寻路径为挨次为：确定路径、include文件夹，CMS安装名目，CMS主模板名目自定义函数使用{dede标记名称属性=”值”function=”youfunction(参数一,参数二,@me)”}其中@me用于表示当前标记的值，其它参数由你的函数打算是否存在，例如：{dedefieldname=”pubdate”function=”strftime(%Y-%m-%d%H%M%S,@me)”}织梦标记允许有限的编程扩展格式为：{dedetagnamerunphp=”yes”}$aaa=@me;@me=123456;{dedetagname}@me表示这个标记本身的值，因此标记内编程是不能使用echo之类的语句的，只能把全部返回值传递给@me。此外由于程序代码占用了底层模板InnerText的内容，因此需编程的标记只能使用默认的InnerText。动态模板引擎核心文件includededetemplate.class.php功能描述用于非核心模块的动态页面或列表页的模板解析，如：membercontent_list.php，通常是在16Copyright2023-2023DesDevINC.Allrightsreserved.datalistcp.class.phpPHP的，因此性能上会优级于旧的解析类，这个方法将在将来版本中作为通用的方式。使用方法$tpl=newDedeTemplate(模板对象实例名称，通常是”tpl”,[模板存放名目〔生成缓存时会存放在这个名目〕,include语法默认引用名目]);通常状况下参数二和参数三是不必要的，如：$tpl=newDedeTemplate(”tpl”);假设在类文件中调用，应当加上设置：$this-tpl-SetObject($this);在一些块调用中默认将使用当前类的成员函数。$tpl-LoadTemplate(模板的物理路径);假设模板中带有{dedeconfigname=””value=””}可以在载入模板后，通过$tpl-GetConfig($name)获得这些变量的值。显示页面或保存页面为文件$tpl-Display;$tpl-SaveTo(物理确定路径的文件名);标记语法标记通用特性①短标记{}等同于{dedetagnamename=””}②块标记17Copyright2023-2023DesDevINC.Allrightsreserved.{dedetagname}循环代码{dedetagname}标记的具体语法及对应的PHP代码①配置变量{dedeconfigname=””value=””}配置变量可以在载入模板后通过$tpl-GetConfig($name)②短标记{}外部变量等同于phpecho$name;{}var数组等同于phpecho$_vars[”name”];{}field数组等同于phpecho$fields[”name”];{}系统配置变量等同于phpecho$cfg_name;考虑到大多数状况下都会在函数或类中调用模板$_vars$fields数组必需声明为global数组，否则模板引擎无法获得它的值从而导致产生错误。③自由调用块标记{tagblocknamebind=”GetArcList”bindtype=”class”}循环代码{tagblockname}必要属性：bind数据源来源函数bindtype函数类型，默认是class可选为subrstype返回结果类型，默认是array，可选项为string自定义函数格式必需为function(array$atts,object$refObj,array$fields);在没有指定bindMakePublicTag($atts,$tpl-refObj,$fields)统一治理。④固定块标记1.datalist从绑定类成员函数GetArcList中猎取数组并输出{dededatalist}循环代码{dededatalist}18Copyright2023-2023DesDevINC.Allrightsreserved.遍历一个二给维数组，数据源是固定的，只适用用类调用。等同于{tagblocknamebind=”GetArcList”bindtype=”class”rstype=”arrayu”}循环代码{tagblockname}2.label从绑定函数中猎取字符串值并输出等同于{tagblocknamebind=”func”bindtype=”sub”rstype=”string”}3.list从绑定类成员函数GetList中猎取字符串值并输出等同于{tagblocknamebind=”GetList”bindtype=”class”rstype=”string”}4.include{dedeincludefile=””}{dedeincludefilename=””}5.php{dedephpphp代码}或{dedephp}php代码{dedephp}6.If仅支持if，else，else直接用{else}表示,但不支持{elseif}这样的语法，一般建议模板中不要使用太简洁的条件语法，假设确实有需要，可以直接使用php语法。{dedeif条件}a-block{else}b-block{dedeif}条件中允许使用、、、表示相应的变量。如：{dedeiffield.id10}{dedeif}19Copyright2023-2023DesDevINC.Allrightsreserved.7.遍历一个array数组{}{dedekey}={dedevalue}{dedearray}各种语法的具体编译后的代码，可查看dedetemplate.class.php 的functionCompilerOneTag(&$cTag)。模板标签标签介绍样的划分。我们在系统涉及到内容治理及生成HTML的地方大多承受了解析式的模板标签，一些互动局部的功能，如中，我们大多接触的是解析式的模板标签，也是本章标签介绍的重点。解析式标签所在的名目为系统根名目下includetaglib名目下includetpllib中，这局部的扩展内容会在随后的章节中具体介绍。标签的分类容几个部过程中主要根据模板的作用域来对模板进展如下划分：全局标签可以在前台文档任意页面使用的模板标记，例如：arclist、channel、sql、loop等。列表标签仅在模板_list.htm中可以使用的标签，例如：list、list。内容标签仅在模板_.article.htm中可以使用的模板标记，例如：likearticle、break等。模块标签仅在特定的模块、插件中使用的模板标记20Copyright2023-2023DesDevINC.Allrightsreserved.第六章标签参考6.1全局标签arclist文档列表〔DedeCMS3.0，DedeCMS4，DedeCMS5〕名称：arclist功能：用于猎取系统主从表模型〔如：文章、软件、图集、商品等〕的一列文档，也称自由列表块标记，其中imglist、imginfolist、specart、coolart、autolist都是由该标记所定义的不同属性延长出来的别名标记。语法：{dedearclistflag=”h”typeid=””row=””col=””titlelen=””infolen=””imgwidth=””imgheight=””listtype=””orderby=””keyword=””limit=”0,1”}ahref=”[fieldarcurl]”[fieldtitle]a{dedearclist}文件：includetaglibarclist.lib.phpfunctionlib_arclist(&$ctag,&$refObj)默认底层模板：imglist：part_imglist.htmimginfolist：part_imginfolist.htmarclist：part_arclist.htm参数：col=””分多少列显示〔默认为单列，5.3col=”1”要多列显示的可用div+css实现以下为通过div+css实现多列的范例：styletype=textcssdiv{width400px;floatleft;}style{dedearclistrow=”10”titlelen=”24”orderby=”pubdate”idlist=””col=”2”}21Copyright2023-2023DesDevINC.Allrightsreserved.[fieldtextlink]([fieldpubdatefunction=MyDate(”m-d”,@me)])br{dedearclist}col1将使用原来的table多列方式显示row=”10”返回文档列表总数typeid=””ID,,分开表示多个栏目；getall=”1”在没有指定这属性的状况下,在栏目页、文章页模板,不会猎取以,分开的多个栏目的下级子类titlelen=”30”标题长度等同于titlelengthinfolen=”160”infolength〔infosdescription的内容〕imgwidth=”120”缩略图宽度imgheight=”90”缩略图高度listtype=”all”image含有缩略图commend推举orderby=”sortrank”文档排序方式orderby=”hot”orderby=”click”表示按点击数排列orderby=”sortrank”orderby=”pubdate”按出版时间排列orderby=”near”orderby==”lastpost”按最终评论时间orderby==”scores”按得分排序orderby=”id”ID排序orderby=”rand”随机获得指定条件的文档列表keyword=””含有指定关键字的文档列表，多个关键字用,分innertext=””单条记录样式aid=””指定文档IDidlist=””提取特定文档〔文档ID〕channelidIDlimit=”ID,记录数”〔ID0开头〕表示限定的记录范围〔如：limit=”1,2”表示从ID1的记2条记录〕flag=”h”自定义属性值：头条[h]推举[c]图片[p]幻灯[f]滚动[s]跳转[j]图文[a]加粗[b]noflag=””flag，但这里是表示不包含这些属性orderway=”desc”descasc，指定排序方式是降序还是顺向排序，默认为降序subday=”天数”表示在多少天以内的文档22Copyright2023-2023DesDevINC.Allrightsreserved.底层字段：ID(同id),typeid,sortrank,flag,ismake,channel,arcrank,click,money,title,shorttitle,color,writer,source,litpic(同picname),pubdate,senddate,mid,lastpost,scores,goodpost,badpost,notpost,description( 同 infos),filename, image, imglink, fulltitle,textlink,typelink,plusurl,memberurl,templeturl,stime(pubdate0000-00-00格式)其中：textlink=ahref=”arcurl”titleatypelink=ahref=”typeurl”typenameaimglink=ahref=”arcurl”imgsrc=”picname”border=”0”width=”imgwidth”height=”imgheight”aimage=imgsrc=”picname”border=”0”width=”imgwidth”height=”imgheight”alt=’titile’注：字段调用方法[fieldvarname]，同样适用于其他标签如：{dedearclistinfolen=”100”}[fieldtextlink]br[fieldinfos]br{dedearclist}底层模板里的Field实现也是织梦标记的一种形式，因此支持使用PHP语法，Function扩展等功能。如：给当天公布的内容加上(new)标志[fieldsenddaterunphp=”yes”]$ntime=time;$oneday=360024;if(($ntime-@me)$oneday)@me=fontcolor=”red”(new)font;else@me=;[fieldsenddate]23Copyright2023-2023DesDevINC.Allrightsreserved.arclistsg独立单表模型文档列表〔DedeCMS5.3〕名称：arclistsg功能：类似arclist标签，猎取指定单表模型〔例如：分类信息现样式的一列文档语法：{dedearclistsgflag=”h”typeid=””row=””col=””titlelen=””orderway=””keyword=””limit=”0,1”}ahref=”[fieldarcurl]”[fieldtitle]a{dedearclistsg}文件：includetaglibarclistsg.lib.phpfunctionlib_arclistsg(&$ctag,&$refObj)默认底层模板：part_arclistsg.htm参数：col=””分多少列显示〔默认为单列，5.3版中本属性无效，要多列显示的可用div+cssrow=”10”返回文档列表总数typeid=””ID,,分开表示多个栏目；titlelen=”30”标题长度等同于titlelengthorderwey=”desc”或”asc”排序方向keyword=含有指定关键字的文档列表，多个关键字用,分innertext=[fieldtitle]单条记录样式(innertext是放在标签之间的代码)arcid=””指定文档IDidlist=””提取特定文档〔文档ID〕channelid=””IDlimit=””起始,完毕表示限定的记录范围〔如：limit=”1,2”〕flag=”h”自定义属性值：头条[h]推举[c]图片[p]幻灯[f]滚动[s]跳转[j]图文[a]加粗[b]subday=”天数”表示在多少天以内的文档底层字段：24Copyright2023-2023DesDevINC.Allrightsreserved.ID(id),typeid,channel,arcrank,mid,click,title,senddate,flag,litpic(picname),userip,lastpost,scores,goodpost,badpost,textlink范例：这个标签用于调用单表模型的内容，在V5.3系统中参与了单表模型的概念，脱离了以前的主从表的数据表关联构造，一般我们在添加内容模型的时候会选择是否为单表模型还是主从表模型。我们可以进入系统后台[核心]-[内容模型治理]，查看系统现有的内容模型，在系统默认环境下，只有分类信息是单表模型，一般添加单表模型，模型的id号都小于-1，即分类信息模型id号为-8。arclist类信息的内容：{dedearclistsgchannelid=”-8”limit=”0,2”}ahref=”[fieldarcurl]”[fieldtitle]abr{dedearclistsg}id02[全局标签测试]中显示以下的内容：arclistarclist列表分页〔DedeCMS5.6〕名称：arclist功能：通过制定arclistsizetagid属性，协作arclist标签进展内容当前分页中显示，DedeCMS5.8中将取消这个标签的使用25Copyright2023-2023DesDevINC.Allrightsreserved.语法：ulclass=c1ico2{dedearclistflag=”c”titlelen=42row=”16”tagid=”dedecms”size=”8”}liclass=”dotline”ahref=[fieldarcurl][fieldtitle]ali{dedearclist}uldivclass=c_{dedearclisttagid=”dedecms”}div文件：includetaglibarclist.lib.phplib_arclist(&$ctag,&$refObj)默认底层模板：无参数：tagid=””arclist的标签名称底层字段：无autochannel指定栏目〔DedeCMS4，DedeCMS5〕名称：autochannel功能：指定排序位置的单个栏目的链接语法：{dedeautochannelpartsort=”2”typeid=1}ahref=”[fieldtypelink]”[fieldtypename]a{dedeautochannel}文件：includetaglibautochannel.lib.phpfunctionlib_autochannel(&$ctag,&$refObj)默认底册模板：part_autochannel.htm26Copyright2023-2023DesDevINC.Allrightsreserved.参数：partsort=”0”栏目所在的排序位置typeid=”0”猎取单个栏目的顶级栏目底层字段：id,typelink,typedir,isdefault,defaultname,ispart,namerule2,typename,moresite,siteurl,sitepath,listmancattree树形类目〔DedeCMS5.3〕名称：cattree功能：树形类目标签语法：{dedecattreetypeid=””catid=””showall=””}文件：includetaglibcattree.lib.phplib_cattree(&$ctag,&$refObj)默认底层模板：无参数：typeid=””顶级树idcatid=0上级栏目idshowall=””在空或不存在时，强制用产品模型id；假设是yes刚显示整个语言区栏目树；为其它数字则是这个数字的模型的id底层字段：无channel猎取栏目列表标签〔DedeCMS3，DedeCMS4，DedeCMS5〕名称：channel信息语法：27Copyright2023-2023DesDevINC.Allrightsreserved.{dedechanneltype=”top”row=”8”currentstyle=liahref=”~typelink~”class=”thisclass”~typename~ali}liahref=”[fieldtypelink]”[fieldtypename]ali{dedechannel}文件：includetaglibchannel.lib.phpfunctionlib_channel(&$ctag,&$refObj)默认底层模板：channel_list.htm参数：typeid=”0”栏目IDreid=”0”上级栏目IDrow=”100”调用栏目数col=”1”分多少列显示〔默认为单列〕type=”sonsun”son表示下级栏目,self表示同级栏目,top顶级栏目currentstyle=””应用样式底层字段：ID(id),typeid,typelink,typename,typeurl,typedir(仅表示栏目的网址)例：{dedechanneltype=”top”}ahref=”[fieldtypelink]”[fieldtypename]a{dedechannel}currentstyle中支持~rel~、~id~、~typelink~、~typename~注：在没有指定typeid的状况下，type标记与模板的环境有关，如，模板生成到栏目一，type=”son”就表示栏目一的全部子类范例：这个标签是全局常用标记，主要用于显示页面的栏目分类，我们可以查看默认模板templetsdefaulthead.htm中的相关代码：{dedechanneltype=”top”currentstyle=liclass=”thisclass”ahref=”~typelink~”~typename~ali}liahref=”[fieldtypeurl]”[fieldtypename]ali{dedechannel}台[核心]-[栏目治理]中进展栏目设置：28Copyright2023-2023DesDevINC.Allrightsreserved.设置完成我们可以在首页顶部看到相关的效果固然这里涉及到一个顶级栏目和子级栏目显示的问题调用，我们来看一个封面的页面内容：29Copyright2023-2023DesDevINC.Allrightsreserved.我们查看这个文章封面templetsdefaultindex_article.htm的模板标签ul{dedechanneltype=”son”currentstyle=liclass=”thisclass”ahref=”~typelink~”span~typename~spanali}liahref=”[fieldtypeurl]”span[fieldtypename]spanali{dedechannel}ul这里就使用了type=”son”这个属性用来显示子栏目，currentstyle则代表当前选中项的呈现样式。很多用户期望顶部导航连接便于SEindex.htm对标签进展一个修改：{dedechanneltype=”top”}liahref=”[fieldtypeurlfunction=”str_replace(index.html,,@me)”]”[fieldtypename]ali{dedechannel}channelartlist当前频道的下级栏目的内容列表〔DedeCMS，DedeCMS4，DedeCMS5〕名称：channelartlist功能：猎取当前频道的下级栏目的内容列表标签语法：{dedechannelartlistrow=6}dl30Copyright2023-2023DesDevINC.Allrightsreserved.dtahref=”{dedefieldname=”typeurl”}”{dedefieldname=”typename”}adtdd{dedearclisttitlelen=”42”row=”10”}ulclass=”autod”liahref=[fieldarcurl][fieldtitle]alili([fieldpubdatefunction=MyDate(”m-d”,@me)])liul{dedearclist}dl{dedechannelartlist}文件：includetaglibchannelartlist.lib.phpfunctionlib_channelartlist(&$ctag,&$refObj)默认底层模板：part_channelartlist.htm参数：typeid=”0”频道ID,多个请用,分开，假设调用1个栏目可以使用typeid=”5,0”来调用。分隔row=”20”获channelArtlist是唯一一个可以直接嵌套其它标记的标记，不过仅限于嵌套{dedetype}{dedetype}和{dedearclist}{dedearclist}两个标记。底层字段：包含{dedetype}{dedetype}及{dedearclist}{dedearclist}下面全部底层模板变量。范例：这个标签是系统中不多的一个支持嵌套的标签，这个标签通常使用在首页〔含封面首页用于输出一组栏目内容列表，我们可以看到默认模板首页：31Copyright2023-2023DesDevINC.Allrightsreserved.templetsdefaultindex.htm{dedechannelartlist}dlclass=tboxdtstrongahref={dedefieldname=”typeurl”}{dedefieldname=”typename”}astrongspanclass=moreahref={dedefieldname=”typeurl”}更多...aspandtddulclass=d1ico3{dedearclisttitlelen=”60”row=”8”}lispanclass=date[fieldpubdatefunction=MyDate(”m-d”,@me)]spanahref=[fieldarcurl][fieldtitle]ali{dedearclist}uldddl{dedechannelartlist}feedback评论内容〔DedeCMS4，DedeCMS5〕32Copyright2023-2023DesDevINC.Allrightsreserved.名称：feedback功能：用于调用最评论语法：{dedefeedback}ulliclass=”fbtitle”[fieldusernamefunction=(@me==”guest””游客” @me)]对[fieldtitle]的评论：liliclass=”fbmsg”ahref=plusfeedback.phpaid=[fieldaid]class=”fbmsg”[fieldmsg]aliul{dedefeedback}文件：文件includetaglibfeedback.lib.phpfunctionlib_feedback(&$ctag,&$refObj)默认底层模板：tag_feedback.htm参数：row=”12”调用评论条数titlelen=”24”标题长度infolen=”100”评论长度底层字段：id,aid,typeid,username,arctitle,ip,ischeck,dtime,mid,bad,good,ftype,face,msg,title范例：这个标签主要调用系统的会员评论信息，我们在默认模板首页可以查看到相关的内容：33Copyright2023-2023DesDevINC.Allrightsreserved.我们可以查看首页的模板templetsdefaultindex.htm有如下代码：{dedefeedbackrow=”5”titlelen=”24”infolen=”80”}lismallahref=#class=username[fieldusernamefunction=(@me==”guest” ”游客” @me)]a评论ahref=[fieldglobal.cfg_phpurl]feedback.phpaid=[fieldaid]class=title[fieldtitle]asmallp[fieldmsg]pli{dedefeedback}[核心]-[评论治理]中对现有的评论进展审核和编辑：34Copyright2023-2023DesDevINC.Allrightsreserved.在[系统]-[系统根本参数]的”互动设置“中也有评论的相关设置选项，可以把握会员评论。field内容变量名称：field功能：用于猎取特定栏目或者档案的字段值及常用的环境变量值语法：{dedefieldname=”字段名”}或者{dedefield.字段名}文件：全部视图类中默认底层模板：无参数：板块模板：phpurl,indexurl,indexname,templeturl,memberurl,specurlposition,title,phpurl,templeturl,memberurl,indexurl,indexname,specurl,dede_arctype的全部字段其中position为“栏目一栏目二”这样形式的链接，title则为这种形式的标题文档模板：position,phpurl,templeturl,memberurl,indexurl,indexname,specurl,id(同ID,aid)文档全部内容字段：档案#@ archives表和附加表的全部字段。35Copyright2023-2023DesDevINC.Allrightsreserved.flink友情链接〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：flink功能：用于猎取友情链接，在DedeCMS系统中已经默认集成友情链接插件，所以无需其他安装即可使用该标签。语法：{dedeflinkrow=”24”}文件：includetaglibflink.lib.phpfunctionlib_flink(&$ctag,&$refObj)默认底层模板：li[fieldlink]li参数：type=”textall”链接类型row=24链接数量titlelen=24站点标题文字的长度linktype=1链接位置内页typeid=0[模块]-[友情链接]中的“网站类型治理”中查看。底层字段：36Copyright2023-2023DesDevINC.Allrightsreserved.url,webname,logo,linkflinktype友情链接类型〔=DedeCMS5.7〕名称：flinktype功能：用于猎取友情链接类型语法：{dedeflinktypetype=dedecms}ahref=#_for=flink_[fieldid][fieldtypename]a{dedeflinktype}文件：includetaglibflinktype.lib.phpfunctionlib_flinktype(&$ctag,&$refObj)默认底层模板：li[fieldtypename]li参数：row=24链接类型数量titlelen=24链接文字的长度底层字段：id,typename范例：{dedeflinktypetype=dedecms}ahref=#_for=flink_[fieldid][fieldtypename]a{dedeflinktype}同时flinktype可以同flink标签进展嵌套使用，用于循环生成分类标签，类似channelarclist标签。{dedeflinktypetype=dedecms}ddid=flink_[fieldid]ulclass=f5{dedeflink}37Copyright2023-2023DesDevINC.Allrightsreserved.uldd{dedeflinktype}global全局配置变量标签〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：global功能：猎取系统全局配置变量内容语法：{dedeglobal.cfg_webname}[fieldglobal.cfg_webname]用于底层模板中文件：系统模板引擎默认底层模板：无参数：无底层字段：无hotwords搜寻关键词〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：hotwords功能：猎取网站搜寻的热门关键字语法：{dedehotwordsnum=6subday=365maxlength=16}文件：includetaglibhotwords.lib.phpfunctionlib_hotwords(&$ctag,&$refObj)38Copyright2023-2023DesDevINC.Allrightsreserved.默认底层模板：无参数：num=6关键词数目subday=365调用天数以内的关键词maxlength=16关键词最大长度底层字段：无jsonJSON数据调用〔=DedeCMS5.7〕名称：json功能：调用某个远程连接的json接口，便利同远程站点之间进展通信来调取内容语法：{dedejsonurl=”yoursitejson.php”cache=300}[fieldid]-[fieldtitle]br{dedejson}文件：includetaglibjson.lib.phpfunctionlib_json(&$ctag,&$refObj)默认底层模板：无参数：url=””json接口地址注：所传递的数据需要是UTF-8编码格式，否则可能会消灭乱码。cache=300缓存时间，0为不缓存底层字段：json传递数组字段范例：39Copyright2023-2023DesDevINC.Allrightsreserved.我们首先编写一个简洁的效劳器端APIapiGB2312编码，所以UTF-8即可。php$cfg_NotPrintHead=false;header(Content-Typetexthtml;charset=utf-8);include_once(dirname( FILE )...includecommon.inc.php);error_reporting(E_ALL~E_NOTICE);require_once(DEDEINC.”json.class.php”);$reval=array;$dsql-SetQuery(SELECTid,titleFROM`#@ archives`ORDERBYidDESCLIMIT0,10);$dsql-Execute(”me”);while($row=$dsql-GetArray(”me”)){$row[”title”]=gb2utf8($row[”title”]);$reval[]=$row;}$json=newServices_JSON(SERVICES_JSON_SUPPRESS_ERRORS);echo$json-encode($reval);通过地址“://dedeapiarcticle.php/“dedeapiarcticle.php我们可以访问到刚刚编写的效劳端文件。40Copyright2023-2023DesDevINC.Allrightsreserved.下面我们就可以通过标签来进展访问。{dedejsonurl=”dedeapiarcticle.php”cache=0}[fieldid]-[fieldtitle]br{dedejson}测试标记结果如下：41Copyright2023-2023DesDevINC.Allrightsreserved.假设您是想猎取单条记录，可以构造如下的数组：$row[]=$dsql-GetOne(“SELECTFROM#@ archivesWHEREid=88”);然后将这个数组通过JSON格式化进展处理。loop万能调用标签〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：loop功能：调用任意表的数据标签语法：{dedelooptable=”dede_archives”sort=””row=”4”if=””}ahref=”[fieldarcurl]”[fieldtitle]a{dedeloop}文件：includetaglibloop.lib.phpfunctionlib_loop(&$ctag,&$refObj)默认底层模板：无参数：table=””数据表名称tablename=””同tablerow=8调用数据的行数sort=””用于排序的字段if=””查询的条件ifcase=””iforderway=”desc”排序方式，desc降序、asc升序底层字段：这个标记的底层模板变量即是被查询表的全部字段范例：我们来查询用户id1的用户公布的文档，可以用下面的标签来表示：42Copyright2023-2023DesDevINC.Allrightsreserved.{dedelooptable=”#@ archives”sort=”mid”row=”4”if=”mid=1”}ahref=”[fieldarcurl]”[fieldtitle]a([fieldmid])br{dedeloop}查询结果如下：loop标签同时可以查询跟DedeCMS序安装在同一数据库，也可以使用loop标签进展调用。memberlist会员列表〔=DedeCMS4，DedeCMS5〕名称：memberlist功能：调用会员列表语法：{dedememberlistorderby=”scores”row=”20”}ahref=..memberindex.phpuid={dedefield.userid}{dedefield.userid}aspan{dedefield.scores}span{dedememberlist}文件：includetaglibmemberlist.lib.phpfunctionlib_memberlist(&$ctag,&$refObj)默认底层模板：43Copyright2023-2023DesDevINC.Allrightsreserved.memberlist.htm参数：row=”6”调用数目iscommend=”0”是否为推举会员orderby=”logintime”按登陆时间排序money按金钱排序scores按积分排序signlen=50签名长度底层字段：#@ member全部字段及spacename(空间名称)、sign(用户签名)范例：用于调用会员相关的列表信息，我们可以在默认模板中查看templetsdefaultindex.htmdivclass=latestloginstrong最近登陆的会员strongulclass=e7{dedememberlistrow=6signlen=30}lia href=[fieldspaceurl] target=_blankimg src=[fieldface] alt=”[fieldspacename]” width=52height=52[fielduname]ali{dedememberlist}uldiv!--latestlogin--我们可以查看网站首页局部：44Copyright2023-2023DesDevINC.Allrightsreserved.固然这里也可以通过指定orderby的属性来调用不同形式排序的内容。myad广告〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：myad功能：调用广告内容语法：{dedemyadtypeid=””name=””}文件：includetaglibmyad.lib.phpfunctionlib_myad(&$ctag,&$refObj)默认底层模板：无参数：name=””2、3是可选属性ismake=”no”no表示设定的纯HTML代码，yes表示含板块标记的代码typeid=0表示所属栏目的ID，默认为0，表示全部栏目通用的显示内容，在列表和文档模板中，typeid默认是这个列表或文档本身的栏目ＩＤ45Copyright2023-2023DesDevINC.Allrightsreserved.底层字段：无范例：在系统后台可以添加一个广告广告位标识就是广告标签的id，那么可以使用：divclass=banner{dedemyadname=”innerTopBanner1”}div来调用出对应的广告位内容。可以直接在广告治理页面，点击“代码”选项来猎取对应的代码。46Copyright2023-2023DesDevINC.Allrightsreserved.mynews站内闻〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：mynews功能：站内闻语法：{dedemynewsrow=””titlelen=””}b[fieldtitle]b公布人：[fieldwriter]时间：[fieldsenddatefunction=”MyDate(Y-m-dHis,@me)”]p[fieldbody]p{dedemynews}文件：includetaglibmynews.lib.phpfunctionlib_mynews(&$ctag,&$refObj)默认底层模板：mynews.htm参数：47Copyright2023-2023DesDevINC.Allrightsreserved.row=1调用站内闻数titlelen=24闻标题长度底层字段：aid,typeid,title,writer,senddate,body范例：[模块]-[站内闻]选项卡中来添加站内闻。我们使用下面的标签：{dedemynewsrow=”2”titlelen=””}b[fieldtitle]b公布人：[fieldwriter]时间：[fieldsenddatefunction=”MyDate(Y-m-dHis,@me)”]br{dedemynews}测试后标签调用信息内容如下：48Copyright2023-2023DesDevINC.Allrightsreserved.mytag自定义宏标签〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：mytag功能：自定义宏标记调用标签语法：{dedemytagtypeid=”0”name=””}文件：includetaglibmytag.lib.phpfunctionlib_mytag(&$ctag,&$refObj)默认底层模板：无参数：name=””2、3是可选属性ismake=”no”no表示设定的纯HTML代码，yes表示含板块标记的代码typeid=0表示所属栏目的ID，默认为0，表示全部栏目通用的显示内容，在列表和文档模板中，typeid默认是这个列表或文档本身的栏目ＩＤ底层字段：无范例：可以在系统后台[模板]-[自定义宏标记]中增加一个内容，这个内容可以是一段一般的HTML，也可以是织梦的某个标签块。49Copyright2023-2023DesDevINC.Allrightsreserved.这样我们可以直接使用标签：{dedemytagname=”auto_1”ismake=”yes”}来调用上面的内容。phpphp标签〔=DedeCMS5.2〕名称：php功能：执行PHP代码50Copyright2023-2023DesDevINC.Allrightsreserved.语法：{dedephp}$a=dede;echo$a;{dedephp}文件：includetaglibphp.lib.phpfunctionlib_php(&$ctag,&$refObj)默认底层模板：无参数：无底层字段：无范例：注：PHP标签由于承受直接执行php代码，在使用的时候需要留意其安全性。softmsg软件下载提示信息〔=DedeCMS5.3〕51Copyright2023-2023DesDevINC.Allrightsreserved.名称：softmsg功能：调用下载说明语法：{dedesoftmsg}文件：includetaglibsoftmsg.lib.phpfunctionlib_softmsg(&$ctag,&$refObj)默认底层模板：无参数：无底层字段：无范例：在系统后台[系统]-[软件频道设置]中配置下载说明：使用标签就可以调用这里的信息。52Copyright2023-2023DesDevINC.Allrightsreserved.sonchannel子栏目调用〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：sonchannel功能：子栏目调用标签语法：{dedesonchannel}ahref=”[fieldtypeurl]”[fieldtypename]a{dedesonchannel}文件：includetaglibsonchannel.lib.phpfunctionlib_sonchannel(&$ctag,&$refObj)默认底层模板：无参数：row=100返回数目col=1默认单列显示nosonmsg=””ID子栏目显示的信息内容底层字段：53Copyright2023-2023DesDevINC.Allrightsreserved.id,typename,typedir,isdefault,ispart,defaultname,namerule2,moresite,siteurl,sitepath,listman范例：这个标签使用的时候需要留意要在某个特定栏目下才能够正常被调用。sqlSQL查询标签〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：sql功能：用于猎取MySQL数据库内容的标签语法：{dedesqlsql=””appname=”default”}[fieldtitle]{dede}文件：54Copyright2023-2023DesDevINC.Allrightsreserved.includetaglibsql.lib.phpfunctionlib_sql(&$ctag,&$refObj)默认底层模板：无参数：sql=””需要查询的sql语句appname=”default”这个参数在DedeCMS5.7息，默认为default，即当前系统所运行的数据库，可在datatagsql.inc.php中扩展，在DedeCMS5.8中用户可以通过后台[模板]-[SQL标签应用治理]来配置应用。底层字段：SQL语句查询出来的字段范例：我们通过以下标签来调用phpwind论坛的会员信息。{dedesqlsql=”SELECTuid,username,email,memberidFROM`phpwind87`.pw_membersORDERBYuiddesc”appname=”phpwind”}[fielduid]-[fieldusername]br{dedesql}标签调试结果内容如下：55Copyright2023-2023DesDevINC.Allrightsreserved.注：在DedeCMS5.8中可以直接使用标签生成器来生成SQL标签。tagTAG调用标签〔=DedeCMS4，DedeCMS5〕名称：tag功能：TAG调用语法：{dedetagsort=”new”getall=”0”}ahref=”[fieldlink]”[fieldtag]a{dedetag}文件：includetaglibtag.lib.phpfunctionlib_tag(&$ctag,&$refObj)默认底层模板：tag_one.htm参数：row=30调用条数sort=”new”month，rand，week，hot，total底层字段：keyword,tag,link,highlight,56Copyright2023-2023DesDevINC.Allrightsreserved.type指定栏目调用标签〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：type功能：猎取指定栏目链接语法：{dedetype}ahref=[fieldtypelink][fieldtypename]a{dedetype}文件：includetaglibtype.lib.phpfunctionlib_type(&$ctag,&$refObj)默认底层模板：part_type_list.htm参数：typeid=0指定栏目ID，假设没有指定则猎取当前页面下的环境变量底层字段：id,typelink,typename,typedir,isdefault,ispart,defaultname,namerule2,moresite,siteurl,sitepath,listman范例：57Copyright2023-2023DesDevINC.Allrightsreserved.vote投票标签〔=DedeCMS3，DedeCMS4，DedeCMS5〕名称：vote功能：用于猎取一组投票表单，系统默认安装了投票插件，可在[模块]-[关心插件]-[投票模块]中来添加或者猎取投票标签语法：{dedevoteid=””lineheight=”22”tablewidth=”100%”titlebgcolor=”#EDEDE2”titlebackground=””tablebgcolor=”#FFFFFF”}{dede}文件：includetaglibvote.lib.phpfunctionlib_vote(&$ctag,&$refObj)默认底层模板：无参数：id=0数字，当前投票IDlineheight=24表格高度tablewidth=”100%”表格宽度titlebgcolor=”#EDEDE2”投票标题背风光titlebackgroup=””标题背景图tablebg=”#FFFFFF”投票表格背风光底层字段：无列表标签list列表数据标签〔=DedeCMS3，DedeCMS4，DedeCMS5〕58Copyright2023-2023DesDevINC.Allrightsreserved.名称：list功能：猎取列表模板中的列表内容语法：{dedelistcol=””titlelen=””infolen=””imgwidth=””imgheight=””orderby=””size=””}{dedelist}文件：includearc.listview.class.phpincludearc.sglistview.class.phpfunctionGetArcList($limitstart=0,$row=10,$col=1,$titlelen=30,$infolen=250,$imgwidth=120,$imgheight=90,$listtype=all,$orderby=default,$innertext=,$tablewidth=100,$ismake=1,$orderWay=”desc”)默认底层模板：list_fulllist.htm参数：col=1内容列数titlelen=30标题长度infolen=250内容摘要长度imgwidth=120缩略图宽imgheight=90缩略图高orderby=”default”senddatepubdateidclicklastpostpostnum，默认为sortranksize=20分页大小orderway=”desc”排序方式底层字段：ID(同id),title,iscommend,color,typeid,ismake,description(同info),postnum,lastpost,shorttitlepubdate,senddate,arcrank,click,litpic(picname),typedir,typename,arcurl(filename),typeurl,stime(pubdate0000-00-00格式),textlink,typelink,imglink,image范例：{dedelistsize=”10”}59Copyright2023-2023DesDevINC.Allrightsreserved.li [fieldarray runphp=”yes”]@me = (empty(@me[”litpic”]) a href=”{@me[”arcurl”]}”class=”preview”imgsrc=”{@me[”litpic”]}”a);[fieldarray][b[fieldtypelink]b]ahref=[fieldarcurl]class=title[fieldtitle]aspanclass=infosmall日期：small[fieldpubdatefunction=GetDateTimeMK(@me)]small点击：small[fieldclick]small好评：small[fieldscores]spanpclass=intro[fielddescription]...pli{dedelist}list标签同时也适用单表模型文档列表。注：list标记除了支持档案表的根本模板变量外，还支