核心概念:模板在 DedeCMS 中的位置
在开始之前,你需要明白 DedeCMS 的模板文件存放在哪里,默认情况下,所有模板文件都位于你的网站根目录下的 /templets/ 文件夹中。

你的网站根目录/
├── dede/ (后台管理目录)
├── include/ (核心函数库)
├── special/ (专题目录)
└── templets/ (模板主目录)
├── default/ (默认模板文件夹)
│ ├── index.htm (首页模板)
│ ├── list_article.htm (文章列表页模板)
│ ├── article_article.htm (文章内容页模板)
│ └── ... (其他默认模板)
├── mytheme/ (你自己的自定义模板文件夹)
│ ├── index.htm
│ └── ...
└── ... (其他模板文件夹)
你所有的修改都是编辑这些 .htm 文件,然后在后台指定使用哪个文件夹下的哪个文件。
如何设置首页模板
这是最常见的需求,比如你想给网站换一个全新的首页。
操作路径: 登录 DedeCMS 后台 -> 系统 -> 系统基本参数 -> 核心设置
详细步骤:

-
登录后台:使用你的管理员账号登录 DedeCMS 后台。
-
进入核心设置:在左侧菜单栏中找到并点击 “系统”,然后在下拉菜单中选择 “系统基本参数”。
-
找到首页模板选项:在打开的“系统基本参数”页面中,切换到 “核心设置” 这个选项卡。
-
修改模板路径:找到 “站点默认主页模板” 这一栏。
(图片来源网络,侵删)- 默认值 通常是
default/index.htm,表示使用/templets/default/文件夹下的index.htm作为首页。 - 修改:如果你想使用自己创建的模板,
mytheme文件夹下的首页,就把它修改为mytheme/index.htm。
- 默认值 通常是
-
保存并生效:修改完成后,务必点击页面底部的 “保存” 按钮。
重要提示:
- 模板文件必须存在:你填写的路径必须真实存在于你的
/templets/目录下,否则网站首页会无法显示(通常显示为空白或系统错误页面)。 - 清除缓存:设置完成后,建议去后台的 “系统” -> “一键更新网站” -> “更新主页HTML”,或者直接删除
/data/cache/目录下的index.html文件,让新模板立即生效。
如何设置栏目列表页和内容页模板
不同栏目可能需要不同的样式,这时就需要为特定栏目设置模板。
操作路径: 登录 DedeCMS 后台 -> 核心 -> 栏目管理
详细步骤:
-
进入栏目管理:在左侧菜单栏中点击 “核心”,然后选择 “栏目管理”。
-
选择目标栏目:在栏目列表中,找到你想要修改模板的那个栏目,点击其名称或后面的 “[更改]” 按钮。
-
设置模板:进入栏目编辑页面后,向下滚动,找到 “栏目选项” 部分,这里有几个关键的模板设置项:
- 列表模板:指定该栏目下的文章列表页使用哪个模板文件。
mytheme/list_article.htm。 - 文档模板:指定该栏目下文章的详情页使用哪个模板文件。
mytheme/article_article.htm。 - 封面模板:如果该栏目是外部链接或单页栏目,这里可以设置封面页模板。
- 列表模板:指定该栏目下的文章列表页使用哪个模板文件。
-
保存:填写完毕后,点击页面底部的 “确定” 按钮保存。
效果:
- 设置完成后,访问该栏目的列表页(如
yourdomain.com/plus/list.php?tid=1),就会使用你指定的“列表模板”。 - 点击列表页中的任意一篇文章,进入文章详情页,就会使用你为该栏目指定的“文档模板”。
高级应用:使用不同模板风格
很多网站希望拥有多个风格,并让用户可以切换,这可以通过 DedeCMS 的“风格”功能实现。
操作路径: 登录 DedeCMS 后台 -> 系统 -> 系统基本参数 -> 默认模板风格
详细步骤:
- 准备多套模板:你在
/templets/目录下至少要有两套完整的模板文件夹,default和blue。 - 进入风格设置:后台 -> 系统 -> 系统基本参数 -> 默认模板风格。
- 选择默认风格:在 “站点默认主页模板” 中,你可以选择
default/index.htm。 - 切换风格:你可以通过修改这个值来切换整个网站的风格,改成
blue/index.htm,网站首页就会立即变成blue风格。 - 实现用户切换:DedeCMS 默认不提供前台的风格切换功能,但你可以通过二次开发实现,一个简单的思路是在首页放置一个链接,链接指向一个你自己编写的 PHP 脚本,这个脚本的作用是修改
dede_sysconfig表中templet字段的值,从而达到切换风格的目的。
常见问题与解决方法
问题1:后台修改了模板路径,但网站没变化。
- 原因:模板缓存未更新。
- 解决:
- 去 “系统” -> “一键更新网站”,点击“更新主页HTML”。
- 或者,通过 FTP 或文件管理器,删除
/data/cache/目录下的index.html文件。 - 确保
/templets/目录下有你指定的模板文件。
问题2:指定的模板文件不存在,导致网站报错。
- 原因:路径写错或模板文件未上传。
- 解决:
- 检查后台设置的模板路径是否正确,
mytheme/index.htm对应的文件是/templets/mytheme/index.htm。 - 确认该文件已经通过 FTP 上传到服务器上。
- 检查后台设置的模板路径是否正确,
问题3:只想修改某个页面的局部,比如页脚。
- 原因:没有使用模板继承或公共文件。
- 解决:
- 推荐方法(公共文件):在模板文件中,将需要重复使用的部分(如页头、页脚、导航栏)单独做成
.htm文件(如header.htm,footer.htm),然后在其他模板文件中使用{dede:include filename='header.htm'/}这样的标签来引入。 - 这样修改
footer.htm,所有引入了它的页面都会自动更新,非常方便。
- 推荐方法(公共文件):在模板文件中,将需要重复使用的部分(如页头、页脚、导航栏)单独做成
| 设置目标 | 后台路径 | 关键设置项 | 说明 |
|---|---|---|---|
| 网站首页 | 系统 -> 系统基本参数 -> 核心设置 | 站点默认主页模板 | 影响整个网站的首页显示 |
| 栏目列表页 | 核心 -> 栏目管理 -> 选择栏目 -> 栏目选项 | 列表模板 | 只影响该栏目的文章列表页 |
| 页 | 核心 -> 栏目管理 -> 选择栏目 -> 栏目选项 | 文档模板 | 只影响该栏目下文章的详情页 |
| 切换整体风格 | 系统 -> 系统基本参数 -> 默认模板风格 | 站点默认主页模板 | 快速切换多套完整模板 |
希望这份详细的指南能帮助你熟练掌握 DedeCMS 后台的模板选择和设置!
