本文将完整梳理DedeCms（织梦）所有常用模板标签，按功能分类拆解，明确每个标签的功能说明、适用范围、基本语法、属性及底层模板变量，兼顾新手入门与实操参考，覆盖基础标签、扩展标签及2007版专属标签，确保信息完整无遗漏。
一、核心基础标签（通用高频）
1. arclist 标记（自由列表标记）
这是织梦最常用的模板标记，又称自由列表标记，hotart、coolart、likeart、imglist、imginfolist、specart、autolist等标记，均是其不同属性延伸出的别名标记。
功能说明：获取指定条件的文档列表
适用范围：封面模板、列表模板、文档模板
基本语法：
html |
核心属性说明：
• typeid=''：栏目ID，列表/文档模板一般无需指定，封面模板可用“,”分隔多个栏目；
• row=''：返回文档列表总数；
• col=''：分栏显示数量，默认单列；
• titlelen=''：标题字符长度；
• infolen=''：内容简介字符长度；
• imgwidth/ imgheight=''：缩略图宽/高；
• type=''：档案类型（空值/all=普通文档；commend=推荐文档，等同coolart；image=含缩略图文档，等同imglist/imginfolist；spec=专题，等同specart），可联合使用（如type='commend image'）；
• orderby=''：排序方式（默认senddate=发布时间；hot/click=点击数；pubdate=出版时间；sortrank=排序级别/置顶；id=文章ID；postnum=评论次数；rand=随机）；
• orderway=''：排序方向（desc=降序，asc=升序，默认降序）；
• keyword=''：关键字筛选，多个关键字用“,”分隔；
• channelid=''：频道模型ID（专题-1、文章1、图集2、软件3、Flash4）；
• limit='起始,结束'：限定记录范围，row属性失效（mysql语法，0起始，如limit 0,5=前5条）；
• att='数值'：自定义属性值；
• subday='天数'：指定天数内的文档（用于热门/推荐文档筛选）；
• partsort='排列位数'：仅autolist标记生效，获取父栏目子栏目中指定排序位置的栏目ID。
底层模板字段：ID(id)、title、iscommend、color、typeid、ismake、description(info)、writer、shorttitle、memberid、pubdate、senddate、arcrank、click、litpic(picname)、typedir、typename、arcurl(filename)、typeurl、stime、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/]
补充说明：底层模板支持PHP语法和Function扩展，例：给当天发布内容添加“(new)”标志
html |
2. Field 标记
功能说明：获取特定栏目、文档的字段值及常用环境变量值
适用范围：封面模板、列表模板、文档模板
基本语法：{dede:field name='字段名'/}
系统分配字段：
• 板块模板：phpurl、indexurl、indexname、templeturl、memberurl、powerby、webname、specurl；
• 列表模板：position（栏目路径链接，如“栏目一 > 栏目二”）、title（栏目路径标题）、phpurl、templeturl、memberurl、powerby、indexurl、indexname、specurl，及栏目表dede_arctype所有字段；
• 文档模板：position、phpurl、templeturl、memberurl、powerby、indexurl、indexname、specurl、id(aid)。
文档所有内容字段：档案表dede_archives和附加表的所有字段。
3. Channel 标记
功能说明：获取栏目列表
适用范围：封面模板、列表模板、文档模板
基本语法：
html |
核心属性：
• row='数字'：获取栏目条数，默认8条；
• type='top/son/sun/self'：top=顶级栏目；son/sun=下级栏目；self=同级栏目（后两者仅列表模板可用）。
底层模板变量：ID、typename、typedir、typelink（栏目网址）
示例：
html |
补充说明：未指定typeid时，type属性与模板环境关联（如模板生成到栏目一，type='son'即栏目一的子栏目）。
4. Type 标记（别名：onetype）
功能说明：获取指定单个栏目的链接
适用范围：封面模板、列表模板、文档模板
基本语法：{dede:type typeid=''}{/dede:type}
核心属性：typeid='栏目ID'（指定单个栏目）
底层模板变量：typename、typelink（栏目网址）
5. Autochannel 标记
功能说明：获取指定排序位置的单个栏目的链接
适用范围：封面模板、列表模板、文档模板
基本语法：{dede:autochannel partsort=''}{/dede:autochannel}
核心属性：partsort='栏目排序位置'（指定父栏目子栏目中的排序位次）
底层模板变量：typename、typelink（栏目网址）
二、功能扩展标签（按需调用）
1. Mytag 标记
功能说明：获取自定义宏标记的内容
适用范围：封面模板、列表模板、文档模板
基本语法：{dede:mytag typeid='' name='' ismake=''/}
核心属性：
• typeid='数字'：栏目ID，默认0，无匹配时按“父栏目→通用标记（typeid=0）”搜索；
• name=''：自定义宏标记名称；
• ismake='yes/no'：默认no（标记内容不含其他封面模板标记），yes则允许包含其他模板标记。
2. Vote 标记
功能说明：获取一组投票表单
适用范围：仅封面模板
基本语法：
html |
补充说明：直接生成投票HTML表单，建议在后台“投票管理”中复制生成的HTML代码修改样式，更便捷。
3. Flink 标记（别名：friendlink）
功能说明：获取友情链接
适用范围：仅封面模板
基本语法：{dede:flink type='' row='' col='' titlelen='' tablestyle=''}{/dede:flink}
核心属性：
• type：链接类型（textall=全部文字显示；textimage=文字+图片混合；text=仅无Logo链接；image=仅带Logo链接）；
• row：显示行数，默认4行；
• col：显示列数，默认6列；
• titlelen：站点名称字符长度；
• tablestyle：<table>标签内的样式内容。
4. Mynews 标记
功能说明：获取站内新闻
适用范围：仅封面模板
基本语法：{dede:mynews row='条数' titlelen='标题长度'}Innertext{/dede:mynews}
核心属性：row=新闻条数；titlelen=标题字符长度
底层模板变量：[field:title/]、[field:writer/]、[field:senddate function="strftime('%y-%m-%d %H:%M',@me)"/]（时间）、[field:body/]
5. LOOP 标记
功能说明：调用任意数据表的数据（如论坛帖子、自定义表数据）
适用范围：所有模板
基本语法：
html |
核心属性：
• table：需查询的数据表名称；
• sort：排序字段；
• row：返回结果条数；
• if：查询条件（SQL语句中的where条件）。
底层模板变量：查询数据表的所有字段
示例：获取Phpwind论坛最新主题帖子
html |
6. Channelartlist 标记
功能说明：获取当前频道下级栏目的内容列表，是唯一可直接嵌套其他标记的宏标记（仅支持嵌套type和arclist标记）
适用范围：仅封面模板
基本语法：
html |
核心属性：
• typeid=0：频道ID，默认获取当前频道下级栏目，可用“,”分隔多个ID；
• col=2：分栏显示数量；
• tablewidth='100%'：外围表格宽度。
三、列表/文档专属标签（定向使用）
1. List 标记
功能说明：列表模板中的分页内容列表
适用范围：仅列表模板（list_*.htm）
基本语法：
html |
核心属性：
• col：内容列数；
• titlelen：标题长度；
• infolen：内容摘要长度；
• imgwidth/ imgheight：缩略图宽/高；
• orderby：排序方式（senddate、pubdate、id、click、lastpost、postnum，默认sortrank）；
• pagesize：分页大小（每页显示条数）。
底层模板变量：与arclist标记基本一致，额外支持附加表字段（可在模型管理中查看）。
2. Page 标记（已过期）
功能说明：分页页面的附加参数（指定每页条数）
适用范围：仅列表模板
语法：{dede:page pagesize="每页结果条数"/}
补充说明：DedeCms3.1及以上版本已过期，直接在list标记中添加pagesize属性即可。
3. Pagelist 标记
功能说明：生成分页页码列表（如首页、上一页、页码、下一页、末页）
适用范围：仅列表模板
基本语法：{dede:pagelist listsize='3' listitem=''/}
核心属性：
• listsize：页码显示长度（如listsize=3，显示[1][2][3]，长度为3×2）；
• listitem：页码样式（可叠加，index=首页、pre=上一页、pageno=页码、next=下一页、end=末页、option=下拉跳转框）。
示例：{dede:pagelist listsize='3' listitem='index pre pageno next end option'/}
4. Pagebreak 标记
功能说明：显示文档的分页链接列表（如“第1页 第2页 ...”）
适用范围：仅文档模板
语法：{dede:pagebreak/}
5. Prenext 标记
功能说明：获取文档“上一篇/下一篇”链接
适用范围：仅文档模板
基本语法：{dede:prenext/}
核心属性：get=''（2007版专属，get=''=横排上下页；get='pre'=仅上一篇；get='next'=仅下一篇）
补充说明：默认横排，需竖排可使用：{dede:prenext function="str_replace(' 下一篇：','<br/>下一篇：',@me)"/}
6. Pagetitle 标记
功能说明：获取文档的分页标题（如“标题 - 第1页”）
适用范围：仅文档模板
基本语法：{dede:pagetitle style='select'/}
核心属性：style=展示样式（select=下拉框；link=文字直接链接）
7. Fieldlist 标记
功能说明：获取文档附加表的所有字段信息
适用范围：仅文档模板
基本语法：
html |
8. Myad 标记
功能说明：获取广告代码
适用范围：所有模板
补充说明：建议在后台“广告管理”模块中直接获取广告代码，无需手动编写标记。
四、DedeCms2007版专属标签（仅旧版可用）
1. Ask 标记
功能说明：获取最新问答主题
适用范围：非扩展模块所有模板
基本语法：{dede:ask row='' qtype=''}底层模板{/dede:ask}
核心属性：
• row：返回记录条数；
• qtype：问答类型（默认=新回复问题；commend=推荐问题；ok=已解决问题；high=高分问题）。
底层模板变量：[field:typeurl/]（栏目网址）、[field:tidname/]（栏目名称）、[field:url/]（问题网址）、[field:title/]（问题标题）、[field:id/]（问题ID）
示例：
html |
2. Sql 标记
功能说明：通过SQL查询语句获取数据并展示
适用范围：非扩展模块所有模板
基本语法：{dede:sql sql="SQL查询语句"}底层模板{/dede:sql}
核心属性：sql=完整的SQL查询语句（需符合MySQL语法）
底层模板变量：SQL查询结果中的所有字段，用[field:字段名/]调用。
3. Group 标记
功能说明：获取特定条件的圈子列表
适用范围：非扩展模块所有模板
基本语法：{dede:group row="个数" orderby='排序条件' }底层模板{/dede:group}
核心属性：
• row：返回圈子个数；
• orderby：排序条件（默认threads=发帖量；members=会员数；hits=浏览量；stime=创建时间）。
底层模板变量：[field:url/]（圈子网址）、[field:groupname/]（圈子名称）、[field:icon/]（圈子图标）、[field:groupid/]（圈子ID）
4. Groupthread 标记
功能说明：获取圈子最新发表的主题
适用范围：非扩展模块所有模板
基本语法：{dede:groupthread gid='' row='' orderby='' orderway=''}底层模板{/dede:groupthread}
核心属性：
• gid=''：圈子分类ID，空值/0=所有分类；
• row=''：返回主题条数；
• orderby=''：排序字段，默认dateline（发布时间）；
• orderway=''：排序方向（desc=降序，asc=升序）。
底层模板变量：[field:url/]、[field:groupname/]、[field:icon/]、[field:groupid/]
5. booklist 标记
功能说明：获取最新连载图书列表
适用范围：仅连载书库模板
基本语法：
html |
核心属性：
• row=''：返回图书条数；
• booktype=''：图书类型（1=漫画；0=小说；-1/默认=全部）；
• titlelen=''：图书标题长度；
• orderby=''：排序方式；
• catid=''：栏目ID；
• author=''：作者筛选；
• imgwidth/ imgheight：图书封面宽/高。
底层模板变量：contenttitle、contentid、contenturl、dmbookurl、bookurl、catalogurl、cataloglink、booklink、contentlink、imglink、ischeck、booktypename
6. catalog 标记
功能说明：获取书库栏目列表
适用范围：仅连载书库模板
基本语法：{dede:catalog type=''}底层模板{/dede:catalog}
核心属性：type=栏目类型（默认=顶级栏目；son=当前栏目子栏目；指定栏目ID=特定栏目）
底层模板变量：支持in嵌套，可调用[field:url/]、[field:classname/]等字段
示例（列出所有分类）：
html |
7. chapter 标记
功能说明：获取图书的章节列表
适用范围：仅连载书库的book_book.htm模板
基本语法：{dede:chapter}底层模板{/dede:chapter}
底层模板变量：url（章节网址）、ch（章节号）、title（章节标题）
8. contentlist 标记
功能说明：获取最新图书章节列表（按最新章节排序）
适用范围：仅连载书库模板
基本语法：{dede:contentlist row='' booktype='' titlelen='' catid=''}底层模板{/dede:contentlist}
核心属性：row=章节条数；booktype=图书类型；titlelen=章节标题长度；catid=栏目ID
底层模板变量：与booklist标记一致，区别在于按最新章节排序。
五、总结
本文已完整覆盖DedeCms所有模板标签，按“核心基础→功能扩展→列表/文档专属→2007版专属”分类，每个标签均明确功能、语法、属性及使用场景，可直接作为实操手册参考。其中arclist、Channel、Field是高频通用标签，需重点掌握；列表/文档专属标签需注意适用模板限制；2007版专属标签仅适用于旧版系统，新版需谨慎使用。所有标签的底层模板变量均可直接调用，支持PHP语法扩展，可根据需求灵活定制样式。
