第一步:理解 DedeCMS 的模板结构
在开始之前,你需要了解 DedeCMS 模板的基本存放位置,默认情况下,模板文件都位于你的网站根目录下的 /templets/ 文件夹中。

(图片来源网络,侵删)
/templets/:总模板目录/default/:默认模板系统所在的文件夹,你所有的自定义模板文件,最好都放在这里,方便管理。/style/:存放 CSS 样式文件的地方。/images/:存放图片资源的地方。/js/:存放 JavaScript 文件的地方。
我们的目标就是:创建一个主页模板文件,然后告诉 DedeCMS 使用这个文件来显示首页。
第二步:创建或上传你的主页模板文件
你有两种方式来获得模板文件:
使用现成的模板(推荐新手)
- 下载模板:从 DedeCMS 官方模板站、模板论坛或第三方模板网站下载你喜欢的模板,通常下载下来的是一个压缩包(如
.zip)。 - 解压并上传:
- 将压缩包解压,你会看到一个名为
default或其他名称的文件夹。 - 通过 FTP 工具(如 FileZilla),将这个
default文件夹完整地上传到你网站的/templets/目录下。 - 注意:如果上传的文件夹也叫
default,那么它会覆盖你原有的默认模板,如果不想覆盖,可以重命名它,myhome。
- 将压缩包解压,你会看到一个名为
自己动手创建模板(适合有一定基础的用户)
- 创建文件:在你的电脑上,使用任意代码编辑器(如 VS Code, Sublime Text, Notepad++),新建一个文件。
- 命名文件:将文件命名为
index.htm。注意:DedeCMS 默认的首页模板文件名就是index.htm,如果你希望你的模板文件名不同(home.htm),也是可以的,但后面在后台指定时需要填写完整的文件名。 - 编写代码:
index.htm文件的内容通常由以下几部分构成:- 头部:包含网站标题、关键词、描述、CSS 和 JS 引入等。
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>{dede:global.cfg_webname/}</title> <meta name="keywords" content="{dede:global.cfg_keywords/}" /> <meta name="description" content="{dede:global.cfg_description/}" /> <link rel="stylesheet" type="text/css" href="/templets/default/style.css" /> </head> - :使用 DedeCMS 的 模板标签 来调用数据库中的内容,这是模板的核心。
- 调用网站名称:
{dede:global.cfg_webname/} - 调用栏目:
{dede:channel type='top' row='8'}...{/dede:channel} - 调用文章列表:
{dede:arclist row='10' titlelen='30'}...{/dede:arclist} - 调用友情链接:
{dede:flink row='24'/} - 调用页脚信息:
{dede:global.cfg_powerby/}
- 调用网站名称:
- 底部:闭合
html标签。<body> <!-- 这里是你的网站布局,header, main, footer --> <header> <h1><a href="/">{dede:global.cfg_webname/}</a></h1> </header> <nav> {dede:channel type='top'} <a href="[field:typelink/]">[field:typename/]</a> {/dede:channel} </nav> <main> {dede:arclist row='5' titlelen='20'} <h2><a href="[field:arcurl/]">[field:title/]</a></h2> <p>[field:description function='cn_substr(@me,100)'/]...</p> {/dede:arclist} </main> <footer> {dede:global.cfg_powerby/} </footer> </body> </html>
- 头部:包含网站标题、关键词、描述、CSS 和 JS 引入等。
- 上传文件:将你创建好的
index.htm文件,通过 FTP 上传到/templets/default/目录下。
第三步:在 DedeCMS 后台指定主页模板
这是最关键的一步,无论你是下载的模板还是自己做的,都需要在这里进行设置。
-
登录后台:打开你的浏览器,输入
你的域名/dede,然后输入用户名和密码登录 DedeCMS 后台管理系统。
(图片来源网络,侵删) -
找到模板设置入口:
- 在后台左侧菜单栏中,找到 “系统” 选项。
- 将鼠标移动到 “系统” 上,在展开的子菜单中点击 “系统基本参数”。
-
进入核心设置:
- 在打开的“系统基本参数”页面中,点击顶部的 “核心设置” 选项卡。
-
修改主页模板:
- 在这个页面中,你会看到一个很长的列表,向下滚动,找到 “主页模板 (S)” 这一栏。
- 在右侧的输入框中,填写你的模板文件名。
- 如果你使用的是默认的
index.htm,并且文件就在/templets/default/目录下,那么直接填写index.htm即可。 - 如果你使用的是自定义文件名或路径,比如你把模板放在了
/templets/myhome/目录下,并且文件名为home.htm,那么你需要填写完整路径:myhome/home.htm。
- 如果你使用的是默认的
- 重要提示:路径是相对于
/templets/目录的,所以不要写成/templets/myhome/home.htm。
-
保存设置:
(图片来源网络,侵删)- 填写完毕后,页面最下方有一个 “保存” 按钮,点击它来保存你的修改。
-
生成首页:
- 这一步至关重要! 仅仅保存模板设置是不够的,你必须让 DedeCMS 根据这个新模板重新生成首页文件。
- 在后台左侧菜单栏中,找到 “生成” 选项。
- 点击 “HTML更新” 或 “一键更新网站”。
- 在打开的页面中,勾选 “主页HTML”。
- 点击 “开始生成” 按钮,系统会自动处理,稍等片刻即可完成。
第四步:预览效果
完成以上所有步骤后,清除你的浏览器缓存,然后访问你的网站主页(你的域名/),现在你应该能看到你新设置的主页模板效果了。
常见问题与解决方法 (FAQ)
-
问题1:为什么我改了模板,网站首页没变化?
- 原因:忘记 “生成首页” 了,DedeCMS 是静态生成,后台修改模板只是“设计稿”,必须点击“生成”才能变成真正的网页。
- 解决:按照第三步第6步的操作,重新生成首页。
-
问题2:生成首页时提示“模板文件不存在”或路径错误?
- 原因:在“核心设置”里填写的模板文件名或路径不正确。
- 解决:
- 通过 FTP 确认你的模板文件是否真的在
/templets/目录下。 - 确认文件名和路径是否拼写正确,注意大小写。
- 确保文件名后缀是
.htm。
- 通过 FTP 确认你的模板文件是否真的在
-
问题3:网站显示错乱,样式丢失?
- 原因:CSS 文件路径错误,你的模板文件里引入 CSS 的路径可能不对。
- 解决:检查你的
index.htm文件中<head>部分的<link>标签,确保href属性指向了正确的 CSS 文件位置,如果模板和 CSS 在同一个文件夹,直接写style.css即可。
希望这份详细的指南能帮助你成功设置 DedeCMS 的主页模板!
