首发于星辰营销

织梦建站基础入门教程

DedeCms 系统的模板是非固定的，用户可以在新建栏目时可以自行选择栏目模板，官方仅提供最基本的默认模板，即是内置系统模型的各个模板，由于 DedeCms 支持自定义频道模型，用户自定义新频道模型后，还需要按该模型的字段设计一套新的模板，此外， DedeCms 也支持使用风格的形式使用模板，默认风格是 default ，它表示系统默认使用 cmspath/templets/default 这个文件夹的模板，如果你下载了一套新的模板，你可以不必要删除 default 原有的文件，把下载的模板文件夹命名你想要的风格名称，如 style2 等，然后在后台修改了默认的模板风格名称为 style2 ，那系统将使用 templets/style2 这文件当作默认模板，但是若你手工指定了栏目模板的位置，则后台参数风格的定义无效。

一、概念，设计和使用模板，必须要理解下面几个概念

1 、板块（封面）模板：
　　指网站主页或比较重要的栏目封面频道使用的模板，一般用 “index_ 识别 ID.htm ”命名，此外，用户单独定义的单个页面或自定义标记，也可选是否支持板块模板标记，如果支持，系统会用板块模板标记引擎去解析后才输出内容或生成特定的文件。
2 、列表模板：
　　指网站某个栏目的所有文章列表的模板，一般用 “list_ 识别 ID.htm ” 命名。
3 、档案模板：
　　表示文档查看页的模板，如文章模板，一般用 “article_ 识别 ID.htm ” 命名。
4 、其它模板：
　　一般系统常规包含的模板有：主页模板、搜索模板、ＲＳＳ、ＪＳ编译功能模板等，此外用户也可以自定义一个模板创建为任意文件。

二、命名， DedeCms 模板默认命名规则如下

1 、模板保存位置：
　　模板目录： cmspath/templets/ 样式名称（英文，默认为 default ，其中 system 为系统底层模板， plus 为插件使用的模板） / 具体功能模板文件｝
2 、模板文件命名规范：
（１） index_ 识别 ID .htm ：　表示板块（栏目封面）模板；
（２） list_ 识别 ID .htm ：　表示栏目列表模板；

（３） article_ 识别 ID .htm ：　表示内容查看页（文档模板，包括专题查看页）；
（４） search.htm ：搜索结果列表模板；
（５） index.htm ：主页模板；

注解： [ 识别 ID] 可以在 “ 频道模型管理 ” 的地方获得，当然，你也可以在 “ 频道模型管理 ” 的地方确定某个频道的模板命名。

例： list_image.htm 表示是就是内容类型为图片集的栏目默认列表模板。
article_article.htm 表示的是文章查看页模板。

三、其它模板说明

1 、默认底层模板
位置： cmspath/templets/system
功能：在没有指定标记的默认底层模板的时候，系统将自动调用这个文件夹的相应文件作为底层模板。
2 、插件目录模板
位置： cmspath/templets/plus
功能：评论、友情链接、 RSS 地图等模板。
3 、会员后台模板
位置： cmspath/member/templets
功能：会员后台的模板。

四、二次开发

织梦内容管理系统
DedeCms 主要的模板解析类是 include/inc_arcpart_view.php 、 include/inc_arclist_view.php 、 include/inc_archives_view.php ，这些类是与 pub_dedetag.php 一起工作的，如果你想为文档模板、列表模板、板块模板增加一些功能，可以直接修改这几个类的 ParseTemplet() 或 ParseTempletsFirst() 这类的方法，把标记名称，属性对应试相应该的功能函数即时。

在了解 DedeCms 的模板代码之前，了解一下织梦模板引擎的知识是非常有意义的。织梦模板引擎是一种使用 XML 名字空间形式的模板解析器，使用织梦解析器解析模板的最大好处是可以轻松的制定标记的属性，感觉上就像在用 HTML 一样，使模板代码十分直观灵活，新版的织梦模板引擎不单能实现模板的解析还能分析模板里错误的标记。

1 、织梦模板引擎的代码样式有如下几种形式：
{dede: 标记名称属性 =' 值 '/}
{dede: 标记名称属性 =' 值 '}{/dede: 标记名称 }
{dede: 标记名称属性 =' 值 '} 自定义样式模板 (InnerText){/dede: 标记名称 }

提示：
如果使用带底层模板的标记，必须严格用 {dede: 标记名称属性 =' 值 '}{/dede: 标记名称 } 这种格式，否则会报错。

2 、织梦模板引擎内置有多个系统标记，这些系统标记在任何场合都是能直接使用的。

(1) global 标记，表示获取一个外部变量，除了数据库密码之外，能调用系统的任何配置参数，形式为：
{dede:global name=' 变量名称 '}{/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 、织梦标记允许在任何标记中使用函数对得到的值进行处理，形式为：
{dede: 标记名称属性 =' 值 ' function='youfunction(" 参数一 "," 参数二 ","@me")'/}
其中 @me 用于表示当前标记的值，其它参数由你的函数决定是否存在，例如：
{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}

4 、织梦标记允许有限的编程扩展。
格式为：
{dede:tagname runphp='yes'}
$aaa = @me;
@me = "123456";
{/dede:tagname}
@me 表示这个标记本身的值，因此标记内编程是不能使用 echo 之类的语句的，只能把所有返回值传递给 @me 。
此外由于程序代码占用了底层模板 InnerText 的内容，因此需编程的标记只能使用默认的 InnerText 。

【 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='rank' 随机获得指定条件的文档列表[10] orderway ='' 值为 desc 或 asc ，指定排序方式是降序还是顺向排序，默认为降序。[11] keyword ='' 表示含有指定关键字的文档列表，多个关键字用 "," 分开[12] channelid= '' 表示特定的频道模型 ID ，内置的频道：专题 (-1) 、文章 (1) 、图集 (2) 、 Flash(4) 、软件 (3) copyright dedecms[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,memberidpubdate,senddate,arcrank,click,litpic( 同 picname),typedir,typename,arcurl( 同 filename),typeurl,stime(pubdate 的 "0000-00-00" 格式 ), dedecms.comtextlink,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 实现也是织梦标记的一种形式，因此支持使用 PHP 语法， Function 扩展等功能如：给当天发布的内容加上 (new) 标志[field:senddate runphp='yes'] $ntime = time();$oneday = 3600 * 24;if(($ntime - @me)<$oneday) @me = "<font color='red'>(new)</font>"; dedecms.comelse @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( 仅表示栏目的网址 ) http://dedecms.com例：{dede:channel type='top'}<a href='[field:typelink /]'>[field:typename/]</a> {/dede:channel} 注：在没有指定 typeid 的情况下， type 标记与模板的环境有关，如，模板生成到栏目一，那么 type='son' 就表示栏目一的所有子类【 Type 标记】别名 onetype 功能说明：表示指定的单个栏目的链接适用范围：封面模板、列表模板、文档模板(1) 语法 {dede:type typeid=''}{/dede:type}(2) 属性 typeid=' 栏目 ID'(3) 底层模板变量 typename,typelink( 仅表示栏目的网址 )【 Autochannel 标记】功能说明：表示指定排序位置的单个栏目的链接 http://dedecms.com 适用范围：封面模板、列表模板、文档模板(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='22'tablewidth='100%' titlebgcolor='#EDEDE2'titlebackground='' tablebgcolor='#FFFFFF'}{/dede: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 的链接-------------------------------------[2] row ：显示多少行，默认为 4 行[3] col ：显示多少列，默认为 6 列[4] titlelen ：站点文字的长度[5] tablestyle ：表示 <table 这里的内容 > 【 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) 底层模板变量这个标记的底层模板变量即是被查询表的所有字段例：获取 DZ 论坛的最新主题贴子      {dede:loop table='pw_threads' sort='tid' row='8' if=''}<br>       <a href="/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} 两个标记。内容来自 dedecms(2) 属性[1] typeid =0 频道 ID, 默认的情况下，嵌套的标记使用的是这个栏目 ID 的下级栏目，如果你想用特定的栏目，可以用 "," 分开多个 ID 。 [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 copyright dedecms[7]pagesize 分页大小(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 标记】 copyright dedecms 功能说明：表示分页页码列表适用范围：列表模板 (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 标记】功能说明：表示获取文档 “ 上一篇／下一篇 ” 的链接列表。适用范围：仅文档模板。语法： {dede:prenext/} 注：此标记默认为横向排列，如果你想用竖向排列，可以用{dede:prenext function="str_replace(' 下一篇： ','<'.'br'.' /> 下一篇： ',@me)"/} 表示【 Pagetitle 标记】功能说明：表示获取文档的分页标题适用范围：仅文档模板。 (1) 语法： {dede:pagetitle style='select'/}(2) 属性： style 表示分页标题的展示样式 select 表示下拉框、 link 表示文字直接链接【 Fieldlist 标记】功能说明：获得附加表的所有字段信息。适用范围：仅文档模板。语法：{dede:fieldlist}[field:name/] ： [field:value/] <br>{/dede:fieldlist} 【 Myad 标记】功能说明：获取广告代码适用范围：所有模板。建议在广告管理模块中获取，在此不作描述