DEDECMS用户手册
合集下载
相关主题
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
指网站主页或比较重要的栏目封面使用的模板，一般用“index_识别 ID.htm”命名，此外，用户单独定义的单个页面或自定义标记，也可选是否支 持板块模板标记，如果支持，系统会用板块模板标记引擎去解析后才输出内容 或生成特定的文件。
2、列表模板： 指网站某个栏目的所有文章列表的模板，一般用 “list_识别
Quote: 频道模型用来自定义数据库里的字段的，当你定义好自己的字段后，在使 用模版语言时就可以用到自己定义的字段。用于栏目参数设置时，它用来指定 整个栏目所发布内容的属性。比如，要建立一个产品库栏目，须要产品名称， 产品类型，产品图片．参数等等，你可以自由增减 采集节点 Quote: 采集指从外部网站截取指定内容，节点可以理解为一个频道／栏目，采集节点 指一个指定采集内容对应内部频道／栏目的名称 系统使用指南 系统目录结构 Quote: setup: 系统安装目录 dede: DedeCms 管理目录(可自行更改) member: 会员目录(可在 include\config_base.php 文件中更改) html: 默认的静态文件发布目录(可在 include\config_base.php 文件中更 改) include: 存放系统公共文件的目录 upimg: 图片浏览器的默认路径(可在 include\config_base.php 文件中更 改) plus: 插件目录，这个目录是用于存放计数器、投票、评论等程序的必要 动态程序(可在 include\config_base.php 文件中更改) special: 专题列表的存放路径(可在 include\config_base.php 文件中更 改) templates: 默认的模版文件存放目录，(可在 include\config_base.php 文件中更改) include\config_base.php: 系统核心配置文件，可以配置数据库信息(数 据库名、用户名、密码)等 采集使用指南 Quote: DedeCMS 本身带采集，使用可看以下 IT 柏拉图 的 手把手教你使用 DedeCms V3 的在线采集 当然你也可以使用第三方开发的采集程序有以下一些 NEATCOLLECT 小蜜蜂采集器 小蜜蜂采集器 DedeCMS V3 正式版导库模版 火车采集器(LocoySpider) 火车 dede v3 正式版登录模块 等等 登录后台 内容模型管理 插件管理 站点管理 发布管理 模版制作使用 Copy code
解析引擎概述 模板设计规范 代码参考 标记参考：
arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart) field channel mytag vote friendlink mynews loop channelartlist page list pagelist pagebreak fieldlist
1、织梦模板引擎的代码样式有如下几种形式： {dede:标记名称 属性='值'/} {dede:标记名称 属性='值'}{/dede:标记名称} {dede:标记名称 属性='值'}自定义样式模板(InnerText){/dede:标记名 称} 提示： 对于{dede:标记名称 属性='值'}{/dede:标记名称}这种形式的标记，在 2.1 版中，表示结束只需要用“{/dede}”，但 V3 中需要严格用“{/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='文件名称' /} 对文件的搜索路径为顺序为：绝对路径、include 文件夹，CMS 安装目录， CMS 主模板目录 3、织梦标记允许在任何标记中使用函数对得到的值进行处理，形式为： {dede:标记名称 属性='值' function='youfunction("参数一","参数二 ","@me")'/} 其中 @me 用于表示当前标记的值，其它参数由你的函数决定是否存在，例 如： {dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")' /} 二、DedeCms 模板制作规范
系统常用术语汇总 全局标记 Quote: 全局标记指的是应用在网站主页、单独页面、频道封面使用的单独的模板 标记，在列表或文章模板中，一般只允许调用 channel、arclist 标记（hotart、 coolart、imglist 等都是这个标记延伸出来的标记），但是环境变量限定为文 章或列表所在的栏目，如果你要测试的标记是在列表或文章中使用，请指定环 境变量（栏目ＩＤ）。 自定义标记 Quote: 自定义标记指的是应用在所属栏目内的模板标记,事先指定显示内容后在 列表或文章模板中显示,可以理解为一个 JS 调用/一个简单的广告管理系统,支 持时间范围显示内容｀过期显示内容｀HTML 代码． 频道模型
ID.htm” 命名。 3、档案模板： 表示文档查看页的模板，一般用 “article_识别 ID.htm” 命名。 4、其它模板： 一般系统常规包含的模板有：主页模板、搜索模板、ＲＳＳ、ＪＳ编
译功能模板等，此外用户也可以自定义一个模板创建为任意文件。 二、 命名，为了规范起见，织梦官方建议使用统一的方式来命名板，具
DedeCms 用户手册 安装、升级和整站迁移 系统需求 Quote: DedeCms 基于 php 语言开发，需要以下环境支持： 服务器平台: Linux、 FreeBSD、Solaris、 Unix、 Win2000、Win2003 Web 服务器运行环境: Apache1.3.XX(2.0.XX) / IIS5(6) + php4.3.X/4.4X/5.x + MySQL3.2X/4.0x+ 补充说明： (1)要正常使用 DedeCms 的各项功能，php 还需要支持 GD 扩展(建议 GD 版本 不低于 2.0) (2)后台管理端目前只支持 Internet Explorer，并且要求版本不低于 6.0， 否则可能会导致未知错误(编辑器不显示等等) 安装示图： 安装
体如下： 1、模板保存位置： 模板目录：｛cmspath/templets/样式名称（英文，默认为 default，
其中 system 为系统底层模板，plus 为插件使用的模板）/具体功能模板文件｝ 一般的模板位置：“/templets/default”
2、 模板文件命名规范： （１）index_识别 ID.htm： 表示板块（栏目封面）模板； （２）list_识别 ID.htm： 表示栏目列表模板； （３）article_识别 ID.htm： 表示内容查看页（文档模板，包括专题查 看页）； （４）search.htm： 搜索结果列表模板； （５）index.htm： 主页模板； 注解： 你的系统各个内容频道的[识别 ID]分别为： 例：list_image.htm 表示是就是内容类型为图片集的栏目默认列表模板。 三、主要标记参考 1、arclist 标记 这个标记是 DedeCms 最常用的一个标记，其中 hotart、coolart、likeart、 artlist、imglist、imginfolist、specart 这些标记都是由这个标记所定义的 不同属性延伸出来的。 作用：获取一个指定的文档列表 适用范围：封面模板、列表模板、文档模板 (1)基本语法： {dede:arclist typeid='' row='' col='' titlelen=''
一、织梦模板解析引擎概述在了解 DedeCms 的模板代码之前，了解一下织 梦模板引擎的知识是非常有意义的。织梦模板引擎是一种使用 XML 名字空间形 式的模板解析器，使用织梦解析器解析模板的最大好处是可以轻松的制定标记 的属性，感觉上就像在用 HTML 一样，使模板代码十分直观灵活，新版的织梦模 板引擎不单能实现模板的解析还能分析模板里错误的标记。
infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword=''}
自定义样式模板(InnerText) {/dede:arclist} 本标记等同于 artlist、imglist、imginfolist 标记，其中与 artlist 是 完全等同的，与 imglist、imginfolist 仅是默认的底层模板不同。 (2)属性参考： [1] typeid='' 表示栏目 ID，在列表模板和档案模板中一般不需要指定， 在封面模板中允许用","分开表示多个栏目； [2] row='' 表示返回文档行数，如果和 col 联合使用，刚结果数等于 row * col； [3] col='' 表示分多少列显示（默认为单列）； [4] titlelen='' 表示标题长度； [5] infolen='' 表示内容简介长度； [6] imgwidth='' 表示缩略图宽度； [7] imgheight='' 表示缩略图高度； [8] type='' 表示档案类型，其中默认值或 type='all'时为普通文档 § type='commend'时，表示推荐文档，等同于 § type='image'时，表示必须含有缩略图片的文档 [9] orderby='' 表示排序方式，默认值是 senddate 按发布时间排列。 § orderby='hot' 或 orderby='click' 表示按点击数排列 § orderby='pubdate' 按出版时间排列（即是前台允许更改的时间值） § orderby='sortrank' 按文章的新排序级别排序（如果你想使用置顶文 章则使用这个属性） § orderby='id' 按文章 ID 排序 [10] keyword='' 表示含有指定关键字的文档列表，多个关键字用","分开 [11] channelid='数字' 表示特定的频道类型，内置的频道：专题(-1)、 文章(1)、图集(2)、Flash(4)、软件(3) [12] limit='起始,结束' 表示限定的记录范围，row 属性必须等于"结束 起始"，mysql 的 limit 语句是由 0 起始的，如 “limit 0,5”表示的是取前五 笔记录，“limit 5,5”表示由第五笔记录起，取下五笔记录。 (3)底层模板变量 ID(同 id),title,iscommend,color,typeid,ismake,description(同 info), pubdate,senddate,arcrank,click,litpic(同 picname),typedir,typename, arcurl(同 filename),typeurl,stime(pubdate 的"0000-00-00"格式), textlink,typelink,imglink,image 其中： textlink = <a href='arcurl'>title</a> typelink = <a href='typeurl'>typename</a> imglink = <a href='arcurl'><img src='picname' border='0' width='imgwidth' height='imgheight'></a>
DedeCms 系统的模板是非固定的，用户可以在新建栏目时可以自行选择 栏目模板，官方仅提供最基本的默认模板，即是内置系统模型的各个模板， DedeCms 支持自定义频道模型，用户自定义新频道模型后，需要按该模型设计一 套新的模板。
一、概念，设计和使用模板，必须要理解下面几个概念： 1、板块（封面）模板：
2、列表模板： 指网站某个栏目的所有文章列表的模板，一般用 “list_识别
Quote: 频道模型用来自定义数据库里的字段的，当你定义好自己的字段后，在使 用模版语言时就可以用到自己定义的字段。用于栏目参数设置时，它用来指定 整个栏目所发布内容的属性。比如，要建立一个产品库栏目，须要产品名称， 产品类型，产品图片．参数等等，你可以自由增减 采集节点 Quote: 采集指从外部网站截取指定内容，节点可以理解为一个频道／栏目，采集节点 指一个指定采集内容对应内部频道／栏目的名称 系统使用指南 系统目录结构 Quote: setup: 系统安装目录 dede: DedeCms 管理目录(可自行更改) member: 会员目录(可在 include\config_base.php 文件中更改) html: 默认的静态文件发布目录(可在 include\config_base.php 文件中更 改) include: 存放系统公共文件的目录 upimg: 图片浏览器的默认路径(可在 include\config_base.php 文件中更 改) plus: 插件目录，这个目录是用于存放计数器、投票、评论等程序的必要 动态程序(可在 include\config_base.php 文件中更改) special: 专题列表的存放路径(可在 include\config_base.php 文件中更 改) templates: 默认的模版文件存放目录，(可在 include\config_base.php 文件中更改) include\config_base.php: 系统核心配置文件，可以配置数据库信息(数 据库名、用户名、密码)等 采集使用指南 Quote: DedeCMS 本身带采集，使用可看以下 IT 柏拉图 的 手把手教你使用 DedeCms V3 的在线采集 当然你也可以使用第三方开发的采集程序有以下一些 NEATCOLLECT 小蜜蜂采集器 小蜜蜂采集器 DedeCMS V3 正式版导库模版 火车采集器(LocoySpider) 火车 dede v3 正式版登录模块 等等 登录后台 内容模型管理 插件管理 站点管理 发布管理 模版制作使用 Copy code
解析引擎概述 模板设计规范 代码参考 标记参考：
arclist(artlist,likeart,hotart,imglist,imginfolist,coolart,specart) field channel mytag vote friendlink mynews loop channelartlist page list pagelist pagebreak fieldlist
1、织梦模板引擎的代码样式有如下几种形式： {dede:标记名称 属性='值'/} {dede:标记名称 属性='值'}{/dede:标记名称} {dede:标记名称 属性='值'}自定义样式模板(InnerText){/dede:标记名 称} 提示： 对于{dede:标记名称 属性='值'}{/dede:标记名称}这种形式的标记，在 2.1 版中，表示结束只需要用“{/dede}”，但 V3 中需要严格用“{/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='文件名称' /} 对文件的搜索路径为顺序为：绝对路径、include 文件夹，CMS 安装目录， CMS 主模板目录 3、织梦标记允许在任何标记中使用函数对得到的值进行处理，形式为： {dede:标记名称 属性='值' function='youfunction("参数一","参数二 ","@me")'/} 其中 @me 用于表示当前标记的值，其它参数由你的函数决定是否存在，例 如： {dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")' /} 二、DedeCms 模板制作规范
系统常用术语汇总 全局标记 Quote: 全局标记指的是应用在网站主页、单独页面、频道封面使用的单独的模板 标记，在列表或文章模板中，一般只允许调用 channel、arclist 标记（hotart、 coolart、imglist 等都是这个标记延伸出来的标记），但是环境变量限定为文 章或列表所在的栏目，如果你要测试的标记是在列表或文章中使用，请指定环 境变量（栏目ＩＤ）。 自定义标记 Quote: 自定义标记指的是应用在所属栏目内的模板标记,事先指定显示内容后在 列表或文章模板中显示,可以理解为一个 JS 调用/一个简单的广告管理系统,支 持时间范围显示内容｀过期显示内容｀HTML 代码． 频道模型
ID.htm” 命名。 3、档案模板： 表示文档查看页的模板，一般用 “article_识别 ID.htm” 命名。 4、其它模板： 一般系统常规包含的模板有：主页模板、搜索模板、ＲＳＳ、ＪＳ编
译功能模板等，此外用户也可以自定义一个模板创建为任意文件。 二、 命名，为了规范起见，织梦官方建议使用统一的方式来命名板，具
DedeCms 用户手册 安装、升级和整站迁移 系统需求 Quote: DedeCms 基于 php 语言开发，需要以下环境支持： 服务器平台: Linux、 FreeBSD、Solaris、 Unix、 Win2000、Win2003 Web 服务器运行环境: Apache1.3.XX(2.0.XX) / IIS5(6) + php4.3.X/4.4X/5.x + MySQL3.2X/4.0x+ 补充说明： (1)要正常使用 DedeCms 的各项功能，php 还需要支持 GD 扩展(建议 GD 版本 不低于 2.0) (2)后台管理端目前只支持 Internet Explorer，并且要求版本不低于 6.0， 否则可能会导致未知错误(编辑器不显示等等) 安装示图： 安装
体如下： 1、模板保存位置： 模板目录：｛cmspath/templets/样式名称（英文，默认为 default，
其中 system 为系统底层模板，plus 为插件使用的模板）/具体功能模板文件｝ 一般的模板位置：“/templets/default”
2、 模板文件命名规范： （１）index_识别 ID.htm： 表示板块（栏目封面）模板； （２）list_识别 ID.htm： 表示栏目列表模板； （３）article_识别 ID.htm： 表示内容查看页（文档模板，包括专题查 看页）； （４）search.htm： 搜索结果列表模板； （５）index.htm： 主页模板； 注解： 你的系统各个内容频道的[识别 ID]分别为： 例：list_image.htm 表示是就是内容类型为图片集的栏目默认列表模板。 三、主要标记参考 1、arclist 标记 这个标记是 DedeCms 最常用的一个标记，其中 hotart、coolart、likeart、 artlist、imglist、imginfolist、specart 这些标记都是由这个标记所定义的 不同属性延伸出来的。 作用：获取一个指定的文档列表 适用范围：封面模板、列表模板、文档模板 (1)基本语法： {dede:arclist typeid='' row='' col='' titlelen=''
一、织梦模板解析引擎概述在了解 DedeCms 的模板代码之前，了解一下织 梦模板引擎的知识是非常有意义的。织梦模板引擎是一种使用 XML 名字空间形 式的模板解析器，使用织梦解析器解析模板的最大好处是可以轻松的制定标记 的属性，感觉上就像在用 HTML 一样，使模板代码十分直观灵活，新版的织梦模 板引擎不单能实现模板的解析还能分析模板里错误的标记。
infolen='' imgwidth='' imgheight='' listtype='' orderby='' keyword=''}
自定义样式模板(InnerText) {/dede:arclist} 本标记等同于 artlist、imglist、imginfolist 标记，其中与 artlist 是 完全等同的，与 imglist、imginfolist 仅是默认的底层模板不同。 (2)属性参考： [1] typeid='' 表示栏目 ID，在列表模板和档案模板中一般不需要指定， 在封面模板中允许用","分开表示多个栏目； [2] row='' 表示返回文档行数，如果和 col 联合使用，刚结果数等于 row * col； [3] col='' 表示分多少列显示（默认为单列）； [4] titlelen='' 表示标题长度； [5] infolen='' 表示内容简介长度； [6] imgwidth='' 表示缩略图宽度； [7] imgheight='' 表示缩略图高度； [8] type='' 表示档案类型，其中默认值或 type='all'时为普通文档 § type='commend'时，表示推荐文档，等同于 § type='image'时，表示必须含有缩略图片的文档 [9] orderby='' 表示排序方式，默认值是 senddate 按发布时间排列。 § orderby='hot' 或 orderby='click' 表示按点击数排列 § orderby='pubdate' 按出版时间排列（即是前台允许更改的时间值） § orderby='sortrank' 按文章的新排序级别排序（如果你想使用置顶文 章则使用这个属性） § orderby='id' 按文章 ID 排序 [10] keyword='' 表示含有指定关键字的文档列表，多个关键字用","分开 [11] channelid='数字' 表示特定的频道类型，内置的频道：专题(-1)、 文章(1)、图集(2)、Flash(4)、软件(3) [12] limit='起始,结束' 表示限定的记录范围，row 属性必须等于"结束 起始"，mysql 的 limit 语句是由 0 起始的，如 “limit 0,5”表示的是取前五 笔记录，“limit 5,5”表示由第五笔记录起，取下五笔记录。 (3)底层模板变量 ID(同 id),title,iscommend,color,typeid,ismake,description(同 info), pubdate,senddate,arcrank,click,litpic(同 picname),typedir,typename, arcurl(同 filename),typeurl,stime(pubdate 的"0000-00-00"格式), textlink,typelink,imglink,image 其中： textlink = <a href='arcurl'>title</a> typelink = <a href='typeurl'>typename</a> imglink = <a href='arcurl'><img src='picname' border='0' width='imgwidth' height='imgheight'></a>
DedeCms 系统的模板是非固定的，用户可以在新建栏目时可以自行选择 栏目模板，官方仅提供最基本的默认模板，即是内置系统模型的各个模板， DedeCms 支持自定义频道模型，用户自定义新频道模型后，需要按该模型设计一 套新的模板。
一、概念，设计和使用模板，必须要理解下面几个概念： 1、板块（封面）模板：