[DeDe] - 织梦内容管理系统模板标签代码参考

来源：http://www.dedecms.com/archives/templethelp/help/taghelp.htm

◆织梦内容管理系统模板标签代码参考
【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(同 id),title,iscommend,color,typeid,ismake,description(同 info),writer,shorttitle,memberid 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} [/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' 表示同级栏目其中后两个属性必须在列表模板中使用。注：在没有指定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=''/} 【Vote 标记】注：本标记直接生成投票的HTML表单，为了让你更方便修改其样式，建议在后台->投票管理的地方直接复制生成的HTML代码来使用。【Flink 标记】，等同 friendlink 功能说明：用于获取友情链接适用范围：封面模板 (1)基本语法 {dede:flink type='' row='' col='' titlelen='' tablestyle=''}{/dede:flink} (2)属性 [1]type：链接类型，值： a. textall 全部用文字显示 b. textimage 文字和图得混合排列 c. text 仅显示不带Logo的链接 d. image 仅显示带Logo的链接这里的内容> 【Mynews 标记】【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=''}<br> <a href="/bbs/read.php?tid=[field:tid/]" _mce_href="http://www.cnblogs.com/bbs/read.php?tid=[field:tid/]"> ·[field:subject function="cn_substr('@me',30)"/] ([field:lastpost function="date('m-d H:M','@me')"/])</a> <br/> {/dede:loop} 【Channelartlist 标记】功能说明：用于获取当前频道的下级栏目的内容列表适用范围：封面模板 (1)基本语法 {dede:channelArtlist typeid=0 col=2 tablewidth='100%'} <table width="99%" border="0" cellpadding="3" cellspacing="1" bgcolor="#BFCFA9"> <tr> <td bgcolor="#E6F2CC"> {dede:type} <table border="0" cellpadding="0" cellspacing="0" width="98%"> <tr> <td width='10%' align="center"><img src='[field:global name='cfg_plus_dir'/]/img/channellist.gif' width='14' height='16'></td> <td width='60%'> <a href="[field:typelink /]">[field:typename /]</a> </td> <td width='30%' align='right'> <a href="[field:typelink /]">更多...</a> </td> </tr> </table> {/dede:type} </td> </tr> <tr> <td height="150" valign="top" bgcolor="#FFFFFF"> {dede:arclist row="8"} ·<a href="[field:arcurl /]">[field:title /]</a><br> {/dede:arclist} </td> </tr> </table> <div style='font-size:2px'> </div> {/dede:channelArtlist} 除了宏标记外，channelArtlist 是唯一一个可以直接嵌套其它标记的标记，不过仅限于嵌套 {dede:type}{/dede:type} 和 {dede:arclist}{/dede:arclist} 两个标记。 [2]col=2 分多列显示 [3]tablewidth='100%' 外围表格的大小【List 标记】功能说明：表示列表模板里的分页内容列表适用范围：仅列表模板 list_.htm (1)基本语法* {dede:list col='' titlelen='' infolen='' imgwidth='' imgheight='' orderby='' pagesize=''}{/dede:list} (2)属性 [1]col 内容列数 [2]titlelen 标题长度 [3]infolen 内容摘要长度 [4]imgwidth 缩略图宽 [5]imgheight 缩略图高 [6]orderby 排序方式，有效的排序方式有 senddate、pubdate、id、click、lastpost、postnum ，默认为 sortrank [7]pagesize 分页大小 textlink,typelink,imglink,image 注：list标记除了支持档案表的基本模板变量外，还支持附加表的字段，你可以在模型管理中知道附加表支持列表使用的字段有哪些。【Page 标记】注：此标记在dedecms3.1中已经过期，dedecms3.1中直接把 pagesize属性加在 list 标记中，表示记录分页大小。【Pagelist 标记】功能说明：表示分页页码列表适用范围：列表模板 (1)语法 {dede:pagelist listsize='3' listitem=''/} (2)属性 [1] listsize 表示 [1][2][3] 这些项的长度 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 标记】表示【Pagetitle 标记】功能说明：表示获取文档的分页标题适用范围：仅文档模板。 (1)语法：{dede:pagetitle style='select'/} (2)属性：style 表示分页标题的展示样式 select 表示下拉框、link 表示文字直接链接【Fieldlist 标记】功能说明：获得附加表的所有字段信息。适用范围：仅文档模板。语法： {dede:fieldlist} [field:name/] ： [field:value/] <br> {/dede:fieldlist} 【Myad 标记】功能说明：获取广告代码适用范围：所有模板。建议在广告管理模块中获取，在此不作描述 ############################################################## ## 以下仅适用于DedeCms2007版 ############################################################## 【Ask 标记】 </dd> [field:typeurl/] 栏目网址 [field:tidname/] 栏目名称 [field:url/] 问题网址 [field:title/] 问题标题 [field:id/] 问题id 【Sql 标记】 (2)属性： [1] sql 完整的SQL查询语句。 (3)底层模板： SQL语句中查出的所有字段都可以用[field:字段名/]来调用。【Group 标记】 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='' 排序条件默认 dateline [4] 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='' 栏目ID [6] author='' 作者 [7] imgwidth='' [8] imgheight='' (3)底层模板： contenttitle,contentid,contenturl,dmbookurl,bookurl,catalogurl,cataloglink,booklink,contentlink,imglink,ischeck,booktypename 【catalog 标记】 {/dede:catalog} 【chapter 标记】功能说明：用于获取图书的章节列表，适用于book_book.htm。适用范围：连载书库。 (1)语法：{dede:chapter}底层模板{/dede:chapter} (2)属性： (3)底层模板： url 网址 ch 章节 title 标题【contentlist 标记】本标记实际是由booklist引申的，不同之处是按book的最新发表章节排序