DedeCMS二次开发手册.docVIP

DedeCMS V5.3二次开发手册 一、模板篇 1.1、主要模板文件与功能说明 DedeCMS系统的模板是非固定的，用户可以在新建栏目时可以自行选择栏目模板，官方仅提供最基本的默认模板，即是内置系统模型的各个模板，由于DedeCMS支持自定义频道模型，用户自定义新频道模型后，还需要按该模型的字段设计一套新的模板，此外，DedeCMS也支持使用风格的形式使用模板，默认风格是 default，它表示系统默认使用 {cmspath}/templets/default 这个文件夹的模板，如果你下载了一套新的模板，你可以不必要删除 default 原有的文件，把下载的模板文件夹命名你想要的风格名称，如 style2 等，然后在后台修改了默认的模板风格名称为 style2 ，那系统将使用{cmspath}/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功能：会员后台的模板。四、二次开发在V5.3中已经将标签开发分离出来，您可以通过后台[模板]-[标签代码管理]，点击“新增加一个新的标签”来创建一个自己的标签，标签文件名为：标签名.lib.php接口函数定义为：function lib_标签名($ctag,$refObj)，返回值是结果字符串修改标签时为了防止出错，您也可以修改它的名称(同时修改文件名和函数名)，这样等同继承了原来标签的代码建立一个新的标签。 模板标签语法简介 织梦的模板标签类似于XML格式，所有的模板都含有定界符，默认情况下是{dede:*}和{/dede:*}，“*”代表模板标记名称。一般情况下{dede:*}和{/dede:*}是成对出现的，例如：例1-1： {dede:arclist flag=h limit=0,1}br / h2a href=[field:arcurl/][field:title/]/a/h2br / p[field:description/]...a href=[field:arcurl/][查看全文]/a/pbr / {/dede:arclist} 上面的{dede:arclist}和{/dede:arclist}成对出现在模板文件中，并且在两个标签当中包含了底层模板(innertext)。底层模板（Innertext），底层模板实际上就是对于有多条记录的模板输出，用户手工去指定单个记录的样式。标签还有一类出现形式是{dede:*/}，通常以这种形式出现都是输出变量、或