织梦内容管理系统模板标签代码参考.doc

织梦内容管理系统模板标签代码参考_ 【Arclist 标记】 这个标记是DedeCms最常用的一个标记，也叫自由列表标记，其中 hotart、coolart、likeart、artlist、imglist、imginfolist、specart、autolist 这些标记都是由这个标记所定义的不同属性延伸出来的别名标记。功能说明：获取指定的文档列表 适用范围：封面模板、列表模板、文档模板基本语法：dede:arclist typeid= row= col= titlelen= infolen= 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时为普通文档 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 表示按点击数排列 orderby=pubdate 按出版时间排列（即是前台允许更改的时间值） orderby=sortrank 按文章的新排序级别排序（如果你想使用置顶文章则使用这个属性） orderby=id 按文章ID排序 orderby=postnum 按文章评论次数排序 orderby=rand 随机获得指定条件的文档列表10 orderway= 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序。11 keyword= 表示含有指定关键字的文档列表，多个关键字用,分开12 channelid= 表示特定的频道模型ID，内置的频道：专题(-1)、文章(1)、图集(2)、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 时，使用本属性才有效。底层模板字段：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 = 字段调用方法：field:varname/如：dede:arclist infolen=100field:textlink/field:info/dede:arclist 注：底层模板里的Field实现也是织梦标记的一种形式，因此支持使用PHP语法，Function扩展等功能如： 给当天发布的内容加上 (new) 标志field:senddate runphp=yes $ntime = time();$oneday = 3600 * 24;if($ntime-me)$oneday)me=(new);else me = ;/field:senddate 【Field 标记】功能说明：用于获取特定栏目或档桉的字段值及常用的环境变量值适用范围：封面模板、列表模板、文档模板(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,memberurl,powerby,indexurl,indexname,specurl,id(同 ID,aid)(3) 文档所有内容字段档案dede_archives表 和 附加表的所有字段。 【Channel 标记】 功能说明：用于获取栏目列表 适用范围：封面模板、列表模板、文档模板 (1)基本语法dede:channel row= type=自定义样式模板(InnerText)/dede:channel (2)属性 1 row=数字 表示获取记录的条数（通用在某级栏目太多的时候使用，默认是 8） 2 type = top,sun/son,self type=top 表示顶级栏目type=son 或 sun 表示下级栏目type=self 表示同级栏目 其中后两个属性必须在列表模板中使用。 (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)底层模板变量 typename,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，在没有设定的栏目没有定义这个名称的标记，会按如下搜索方式来搜索“先向上查找父栏目 - 通用标记（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 注：本标记直接生成投票的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列4titlelen：站点文字的长度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) 基本语法dede:loop table= sort= row= if= 底层模板/dede:loop (2) 属性1 table 表示查询的数据表2 sort 用于排序的字段3 row 返回结果的条数4 if 查询条件(3)底层模板变量这个标记的底层模板变量即是被查询表的所有字段例：获取Phpwind论坛的最新主题贴子 dede:loop table=pw_threads sort=tid row=8 if= field:subject function=cn_substr(me,30)/ (field:lastpost function=date(m-d H:M,me)/) /dede:loop 【Channelartlist 标记】 功能说明：用于获取当前频道的下级栏目的内容列表 适用范围：封面模板 (1)基本语法dede:channelArtlist typeid=0 col=2 tablewidth=100%dede:typefield:typename /更多./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 标记】 功能说明：表示列表模板里的分页内容列表 适用范围：仅列表模板 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 ，默认为 sortrank 7pagesize 分页大小(3)底层模板变量 ID(同 id),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 标记】 功能说明：表示分页页面的附加参数 适用范围：列表模板 语法： dede:page pagesize=每页结果条数/ 注：此标记在dedecms3.1中已经过期，dedecms3.1中直接把 pagesize属性加在 list 标记中，表示记录分页大小。 【Pagelist 标记】 功能说明：表示分页页码列表 适用范围：列表模板 (1)语法dede:pagelist listsize=3 listitem=/ (2)属性 1 listsize 表示 123 这些项的长度 x 2 2 listitem 表示页码样式，可以把下面的值叠加index首页pre 上一页pageno 页码next 下一页end 末页option 下拉跳转框例： 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:prenext function=str_replace( 下一篇：,下一篇：,me)/ 表示 【Pagetitle 标记】功能说明：表示获取文档的分页标题适用范围：仅文档模板。 (1)语法：dede:pagetitle style=select/(2)属性：style 表示分页标题的展示样式select 表示下拉框、link 表示文字直接链接 【Fieldlist 标记】功能说明：获得附加表的所有字段信息。适用范围：仅文档模板。 语法：dede:fieldlistfield:name/ ： field:value/ /dede:fieldlist 【Myad 标记】功能说明：获取广告代码适用范围：所有模板。 建议在广告管理模块中获取，在此不作描述 # 以下仅适用于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查询获得其返回内容。适用范围：非扩展模块所有模板。 (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)底层模板：field: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:groupname/圈子名称 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 imgwidth= 8 imgheight=(3)底层模板：contenttitle,contentid,contenturl,dmbookurl,bookurl,catalogurl,cataloglink,booklink,contentlink,imglink,ischeck,booktypename 【catalog 标记】功能说明：用于获取书库的栏目。适用范围：连载书库。 (1)语法：dede:catalog type=底层模板/dede:catalog (2)属性：1 type 类型 默认为顶级栏目，type=son 表示当前栏目的子栏目，指定特定的栏目id则为所指定的栏目。 (3)底层模板：本标记支持in嵌套，里面的in标记还可以再使用一重样式dede:catalogin:field name=classname/in:field/dede:catalog列出所有分类：dede:catalogin:field name=classname/in:field：in:sonlist field:classname/in:sonlist /dede:catalog 【chapter 标记】功能说明：用于获取图书的章节列表，适用于book_book.htm。适用范围：连载书库。 (1)语法：dede:chapter底层模板/dede:chapter (2)属性：(3)底层模板：url 网址 ch 章节 title 标题 【contentlist 标记】功能说明：用于获取最新图书章节。适用范围：连载书库。 (1)语法：dede:contentlist row= booktype= titlelen= catid=底层模板/dede:contentlist (2)属性：1 row 条数 2 booktype 图书类型 1 漫画，0 小说， -1 或默认 全部 3 titlelen4 catid 栏目ID(3)底层模板：contenttitle,contentid,contenturl,dmbookurl,bookurl,catalogurl,cataloglink,booklink,contentlink,imglink,ischeck,booktypename本标记实际是由booklist引申的，不同之处是按book的最新发表章节排序 Power by D 版权所有sql标签可以称得上是个万能标签了，查询数据库将其输出，这里介绍一些关于这个标签的用法：1.用来输出统计内容，这个是不错的，举个例子，我们来统计下总共发了多少的文章，思路就是输出dede_addonarticle这个文章附加表内容总数就可以了。dede:sql sql=SELECT COUNT(*) AS nums FROM dede_addonarticlefield:name = nums/dede:sql2.使用field来进行特殊的查询，比如之前论坛上面很多会员需要做一个输出当前发布文章会员的相关内容，之前用sql或者arclist标签是没办法实现的，因为每篇内容是不同的，这里我们来用5.5的sql语句来做个示范。我们首先在文章模板中相应的位置加上下面的标签dede:sql sql=SELECT * FROM dede_archives WHERE writer=writerfield:id/,/dede:sql这个放到article_article.htm页面，将会检索出当前会员发布的相关文章，这里的 writer会根据当前内容的环境变量进行替换后再执行查询。这里出现在SQL语句中条件查询的 writer，也就是$refObj-Fields$value这个里面的相关内容模板中使用PHP许多人希望织梦的模板标签能够更加灵活，加入可以运行PHP的功能，这里在DedeCMS V5.5中就加入了一个可以执行php的特殊标签dede:php/dede:php，这个标签可以执行PHP语句了。我这里举几个常用的例子：1.最简单的输出内容：dede:php$numA = 1;$numB = 2;echo $numA + $numB;/dede:php这个输出的内容是计算结果：32.结合SQL查询输出单条内容dede:php$row = $dsql-GetOne(select id,typename from dede_arctype where id=2);print_r($row);/dede:php这个输出的内容是Array(id = 2typename = 问答)3.获取当前页面的变量比如我们这里进入系统后台的模板-全局标记测试，我们在代码中填入下面的内容：dede:phpprint_r($refObj-Fields);/dede:php如果环境变量保持默认，即“不使用环境ID”，我们会看到以下的结果：Array(typeid = 0phpurl = /plusindexurl = /templeturl = /templetsmemberurl = /memberspecurl = /specialindexname = 主页templetdef = /templets/default)那我们再换个环境变量测试看看，这里以我本地的栏目为测试了：Array(id = 3reid = 0topid = 0sortrank = 1typename = 产品typedir = cmspath/product indexname = 主页templetdef = /templets/defaultposition = 主页 产品 title = 产品)这样一来就检索出当前页面的局部变量了，接下来我们可以来结合前面的SQL语句来实现根据不同环境ID调用内容不同栏目内容。例如：dede:php$thisid = $refObj-Fieldsid;$row = $dsql-GetOne(select id,typename from dede_arctype where id=.$thisid);print_r($row);/dede:php这样是来调用当前栏目的标题，这个标签功能类似于dede:field.typename/写自己的标签，让别人说去吧DedeCMS从V5.3开始就支持自己扩展标签，不过许多新人很少用那个东西，今天我就来简单的介绍下如何编写自己的调用标签。我们需要知道下扩展标签的存放目录及文件名构成，首先，扩展的标签都是存放在/include/taglib这个目录，名称都是以“标签名.lib.php”格式，例如dede:channel/标签对应的是channel.lib.php文件。我们可以看一个示例标签：demotag.lib.php if(!defined(DEDEINC)exit(Request Error!);function lib_demotag(&$ctag,&$refObj)global $dsql,$envs;/属性处理$attlist=row|12,titlelen|24;FillAttsDefault($ctag-CAttribute-Items,$attlist);extract($ctag-CAttribute-Items, EXTR_SKIP);$revalue = ;/你需编写的代码，不能用echo之类语法，把最终返回值传给$revalue/-$revalue = Hello Word!;/-return $revalue;?我们登录系统后台的模板-全局标签测试中运行dede:demotag/,显示如下的结果： 这里我们知道，其实标签生成的内容其实是这个函数的一个返回值，这里返回的内容都是字符串，也就是函数return $revalue;中的$revalue需要是经过处理后生成的字符串。$attlist=row|12,titlelen|24;这个是属性列表，这个经过函数处理后会直接生成变量并复制，我们可以测试下，做如下的修改：$revalue = Hello Word!;$revalue .=Row:.$row.;TitleLen:.$titlelen; 这样我们可以看到，这个属性已经被创建变量并且赋值了。接下来我们可以再进一步去修改这个标签。比如说我们需要写一个标签专门来查询文章内容页的那个相关文章，功能类似于上面sql标签中的那个sql，只是这里我们将其分装为一个标签。我们可以新建一个标签，例如叫writerarc，那我们就需要创建一个writerarc.lib.php，然后模仿demotag编写函数，注意需要修改为function lib_writerarc(&$ctag,&$refObj)接下来我们就可以编写查询语句及对底层模板处理的相关函数了$revalue = ;$innertext = $ctag-GetInnerText();$ctp = new DedeTagParse();$ctp-SetNameSpace(field, , );$sql = SELECT * FROM dede_archives WHERE writer=$refObj-Fieldswriter limit 0, $row;$innertext这个是用来获取标签的底层模板的，$ctp创建用于处理底层模板中的变量，并处理进行替换。我们根据获取的属性编写我们的sql语句，这里我们使用limit 0, $row，这样就可以根据$row来确定查询的内容数目。当然我们可以获取更多的属性以便我们这个标签更强大，例如我们可以增加类似于arclist中的相关属性，并在函数中进行处理，不过这个需要有一定的PHP基础。接下来我们通过执行查询对sql及输出变量进行处理：$dsql-Execute(me,$sql);while($rs = $dsql-GetArray(me)/根据属性处理查询变量$rstitle = cn_substr($rstitle, $titlelen);/获取底层模板$ctp-LoadSource($innertext);foreach($ctp-CTags as $tagid=$ctag) if(!empty($rsstrtolower($ctag-GetName() $ctp-Assign($tagid,$rs$ctag-GetName();/根据底层模板及查询变量得到处理结果$revalue .= $ctp-GetResult();这样我们就将查询出来的结果同底层模板中出现的相关变量进行替换，然后生成输出字符串，将所有的字符串信息存储到$revalue中。最后返回这个值return $revalue;整个文件内容如下： if(!defined(DEDEINC)exit(Request Error!);function lib_writerarc(&$ctag,&$refObj)global $dsql,$envs;/属性处理$attlist=row|12,titlelen|24;FillAttsDefault($ctag-CAttribute-Items,$attlist);extract($ctag-CAttribute-Items, EXTR_SKIP);$revalue = ;$innertext = $ctag-GetInnerText();$ctp = new DedeTagParse();$ctp-SetNameSpace(field, , );$sql = SELECT * FROM dede_archives WHERE writer=$refObj-Fieldswriter limit 0, $row;$dsql-Execute(me,$sql);while($rs = $dsql-GetArray(me)/根据属性处理查询变量$rstitle = cn_substr($rstitle, $titlelen);/获取底层模板$ctp-LoadSource($innertext);foreach($ctp-CTags as $tagid=$ctag) if(!empty($rsstrtolower($ctag-GetName() $ctp-Assign($tagid,$rs$ctag-GetName();/根据底层模板及查询变量得到处理结果$revalue .= $ctp-GetResult();return $revalue;?接下来我们来测试我们这个标签，我们修改article_article.htm模板，在里面加入以下的标签代码：dede:writerarc row=10 titlelen=6field:title/ /dede:writerarc通过动态浏览页面进行查看调试/plus/view.php?aid=3，我们会发现标签起作用了，输出了我们的内容。 至此我们完成了标签的编写，这里面主要涉及到PHP、MySQL的很多知识，需要有一定相关方面的基础才能够编写标签了，当然这里只是一个简单的标签开发例子，还有许多的东西可以去开发。1. field:pubdate function=GetDateTimeMK(me)/标签获得当前时间的：yyyy-mm-dd HH:MM:ss的格式，主要用的方法是GetDateTimeMK(me)2. field:senddate function=strftime(%y-%m-%d %H:%M,me)/ 获得制定格式的时间。strftime是用来指定时间格式的方法3. dede:field name=title/ 用来获得栏目的主标题和子标题4. field:description function=cn_substr(me,60,10