织梦 CMS 教程：织梦内容管理系统 (dede) 模板标签代码讲解

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 。

copyright