织梦标签使用手册

《织梦标签使用手册》由会员分享，可在线阅读，更多相关《织梦标签使用手册（21页珍藏版）》请在金锄头文库上搜索。

1、DedeCms 模板安装模板安装/制作概述：制作概述： DedeCms 系统的模板是非固定的，用户可以在新建栏目时可以自行选择栏目模板，官方仅提供最基本 的默认模板，即是内置系统模型的各个模板，由于 DedeCms 支持自定义频道模型，用户自定义新频道模型 后，还需要按该模型的字段设计一套新的模板，此外，DedeCms 也支持使用风格的形式使用模板，默认风 格是 default，它表示系统默认使用 cmspath/templets/default 这个文件夹的模板，如果你下载了一套新的模 板，你可以不必要删除 default 原有的文件，把下载的模板文件夹命名你想要的风格名称，如 style2

2、 等， 然后在后台修改了默认的模板风格名称为 style2 ，那系统将使用 templets/style2 这文件当作默认模板，但 是若你手工指定了栏目模板的位置，则后台参数风格的定义无效。 一、概念，设计和使用模板，必须要理解下面几个概念一、概念，设计和使用模板，必须要理解下面几个概念 1、板块（封面）模板：、板块（封面）模板： 指网站主页或比较重要的栏目封面频道使用的模板，一般用“index_识别 ID.htm”命名，此外，用户单 独定义的单个页面或自定义标记，也可选是否支持板块模板标记，如果支持，系统会用板块模板标记引擎 去解析后才输出内容或生成特定的文件。 2、列表模板：、列表模板：

3、指网站某个栏目的所有文章列表的模板，一般用 “list_识别 ID.htm” 命名。 3、档案模板：、档案模板： 表示文档查看页的模板，如文章模板，一般用 “article_识别 ID.htm” 命名。 4、其它模板：、其它模板： 一般系统常规包含的模板有：主页模板、搜索模板、编译功能模板等，此外用户也可以 自定义一个模板创建为任意文件。 二、二、 命名，命名，DedeCms 模板默认命名规则如下模板默认命名规则如下 1、模板保存位置：、模板保存位置： 模板目录：cmspath/templets/样式名称（英文，默认为 default，其中 system 为系统底层模板，plus 为插 件使用

4、的模板）/具体功能模板文件 2、 模板文件命名规范：模板文件命名规范： （）index_识别 ID.htm：表示板块（栏目封面）模板； （）list_识别 ID.htm：表示栏目列表模板； （）article_识别 ID.htm：表示内容查看页（文档模板，包括专题查看页）； （）search.htm： 搜索结果列表模板； （）index.htm： 主页模板； 注解：注解：识别 ID可以在“频道模型管理”的地方获得，当然，你也可以在“频道模型管理”的地方确定某个频 道的模板命名。 例：list_image.htm 表示是就是内容类型为图片集的栏目默认列表模板。 article_article.h

5、tm 表示的是文章查看页模板。 三、其它模板说明三、其它模板说明 1、默认底层模板、默认底层模板 位置： cmspath/templets/system 功能：在没有指定标记的默认底层模板的时候，系统将自动调用这个文件夹的相应文件作为底层模板。 2、插件目录模板、插件目录模板 位置： cmspath/templets/plus 功能：评论、友情链接、RSS 地图等模板。 3、会员后台模板、会员后台模板 位置： cmspath/member/templets 功能：会员后台的模板。 四、二次开发四、二次开发 DedeCms 主要的模板解析类是 include/inc_arcpart_view.p

6、hp、include/inc_arclist_view.php、 include/inc_archives_view.php，这些类是与 pub_dedetag.php 一起工作的，如果你想为文档模板、列表模板、 板块模板增加一些功能，可以直接修改这几个类的 ParseTemplet()或 ParseTempletsFirst()这类的方法，把标 记名称，属性对应试相应该的功能函数即时。 织梦模板标记简介： 在了解 DedeCms 的模板代码之前，了解一下织梦模板引擎的知识是非常有意义的。织梦模板引擎是一种使 用 XML 名字空间形式的模板解析器，使用织梦解析器解析模板的最大好处是可以轻松的制

7、定标记的属性， 感觉上就像在用 HTML 一样，使模板代码十分直观灵活，新版的织梦模板引擎不单能实现模板的解析还能 分析模板里错误的标记。 1、织梦模板引擎的代码样式有如下几种形式： dede:标记名称 属性=值/ dede:标记名称 属性=值/dede:标记名称 dede:标记名称 属性=值自定义样式模板(InnerText)/dede:标记名称 提示： 如果使用带底层模板的标记，必须严格用dede:标记名称 属性=值/dede:标记名称 这种格式，否则会报 错。 2、织梦模板引擎内置有多个系统标记，这些系统标记在任何场合都是能直接使用的。 (1) global 标记，表示获取一个外部变量，

8、除了数据库密码之外，能调用系统的任何配置参数，形式为： 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=是否为

9、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 run

10、php=yes $aaa = me; me = “123456“; /dede:tagname me 表示这个标记本身的值，因此标记内编程是不能使用 echo 之类的语句的，只能把所有返回值传递给 me。 此外由于程序代码占用了底层模板 InnerText 的内容，因此需编程的标记只能使用默认的 InnerText。 织梦内容管理系统模板标签代码参考 【Arclist 标记】 这个标记是 DedeCms 最常用的一个标记，也叫自由列表标记，其中 hotart、coolart、likeart、artlist、 imglist、imginfolist、specart、autolist 这些标记都是

11、由这个标记所定义的不同属性延伸出来的别名标记。 功能说明：获取指定的文档列表 适用范围：封面模板、列表模板、文档模板 基本语法： dede:arclist typeid= row= col= titlelen= infolen= imgwidth= imgheight= listtype= orderby= keyword= 底层模板(InnerText) /dede:arclist 属性说明： 1 typeid= 表示栏目 ID，在列表模板和档案模板中一般不需要指定，在封面模板中允许用“,“分开表示多 个栏目； 2 row= 表示返回文档列表总数； 3 col= 表示分多少列显示（默认为单列

12、）； 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:sp

13、ecart/dede:specart 以上属性值可以联合使用，如： type=commend image 表示推荐的图片文档 9 orderby= 表示排序方式，默认值是 senddate 按发布时间排列。 orderby=hot 或 orderby=click 表示按点击数排列 orderby=pubdate 按出版时间排列（即是前台允许更改的时间值） orderby=sortrank 按文章的新排序级别排序（如果你想使用置顶文章则使用这个属性） orderby=id 按文章 ID 排序 orderby=postnum 按文章评论次数排序 orderby=rand 随机获得指定条件的文档列表

14、 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 属性将无效。

15、 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/