DedeCms二次开发手册

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)

[13]limit='起始,结束'表示限定的记录范围，row属性必须等于"结束-起始"，MySQL的limit语句是由0起始的，如“limit0,5”表示的是取前五笔记录，“limit5,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=title

typelink=typename

imglink= image=

字段调用方法：[field:varname/]

如：{dede:arclist infolen='100'}

[field: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='top'}

[field: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='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：表示

【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论坛的最新主题贴子：

amp;amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;{de de:loop&amp;nbsp;table='pw_threads'&amp;nbsp;sort='tid'&amp;nbsp;row='8'&amp; nbsp;if=''}&amp;lt;br&amp;gt;

&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&am p;nbsp;&amp;lt;a&amp;nbsp;href="/bbs/read.PHP?tid=[field:tid/]"&amp;gt;&a mp;amp;nbsp;·[field:subject&amp;nbsp;function="cn_substr('@me',30)"/]& amp;nbsp;

&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&am p;nbsp;([field:lastpost&amp;nbsp;function="date('m-d&amp;nbsp;H:M','@me')"/])& amp;amp;lt;/a&amp;gt;&amp;nbsp;&amp;lt;br/&amp;gt;

&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&amp;nbsp;&am p;nbsp;{dede:loop}

【Channelartlist标记】

功能说明：用于获取当前频道的下级栏目的内容列表

适用范围：封面模板

(1)基本语法

{dede:channelArtlist typeid=0col=2tablewidth='100%'}

{dede:type} [field:typename/] 更多... {/dede:type}

{dede:arclist row="8"} [field:title/] {/dede:arclist}

 

{/dede:channelArtlist}

除了宏标记外，channelArtlist是唯一一个可以直接嵌套其它标记的标记，不过仅限于嵌套

{dede:type}{/dede:type}和{dede:arclist}{/dede:arclist}两个标记。

(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

[7]pagesize分页大小

(3)底层模板变量

ID(同id),title,iscommend,color,typeid,ismake,description(同info),postnum,lastpost,shorttitle

pubdate,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表示[1][2][3]这些项的长度x2

[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/]
{/dede:fieldlist}