DedeCms模板二次开发手册.docVIP

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起始的，如 “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格式),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)底层模板变量这个标记的底层模板变量即是被查询表的所有字段例：获取dz论坛的最新主题贴子：amp;amp;nbsp;     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%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,arc