- 准备模板文件
- 通过FTP上传模板到服务器
- 在DedeCMS后台安装并启用模板
下面是详细的图文步骤说明。

(图片来源网络,侵删)
第一步:准备模板文件
在开始之前,你需要准备好你的网站模板,一个完整的DedeCMS模板包含以下文件和目录结构:
my_templete/ <-- 你的模板文件夹名称,可以自定义
├── index.htm <-- 首页模板
├── list_*.htm <-- 列表页模板 (list_article.htm)
├── article_*.htm <-- 文章内容页模板 (article_article.htm)
├── search.htm <-- 搜索页模板
├── head.htm <-- 公共头部文件
├── foot.htm <-- 公共底部文件
├── images/ <-- 模块所用到的图片目录
└── style/ <-- CSS样式文件目录
└── css.css <-- 主样式表
重要提示:
- 模板命名规则:DedeCMS对模板文件有特定的命名规则,系统会自动识别。
- 首页:必须命名为
index.htm。 - 列表页:通常命名为
list_栏目ID.htm,list_1.htm,或者使用通用名list_*.htm。 - 文章页:通常命名为
article_栏目ID.htm,article_1.htm,或者使用通用名article_*.htm。 - 其他页面:如搜索页
search.htm、用户页member.htm等,有固定的命名。
- 首页:必须命名为
- 模板标签:你的模板文件(
.htm)中必须包含DedeCMS的模板标签,否则无法调用数据。{dede:include filename="head.htm"/}:包含头部文件。{dede:arclist titlelen='30' row='10'}:调用文章列表。{dede:field.title/}:调用文章标题。{dede:field.body/}:调用文章正文。{dede:pagelist listitem='index,pre,next,end,pageno' listsize='5'/}:调用分页。
第二步:通过FTP上传模板到服务器
DedeCMS的模板默认存放在服务器的 /templets/ 目录下,你需要使用FTP工具(如 FileZilla)将准备好的模板文件夹上传到这里。
-
连接FTP:使用你的FTP软件,输入服务器地址、用户名、密码连接到你的网站空间。
(图片来源网络,侵删) -
找到模板目录:登录后,进入网站的根目录(通常是
public_html,www或htdocs),然后找到并进入templets文件夹。 -
上传模板:
- 在你的本地电脑上,找到你第一步准备好的模板文件夹(
my_templete)。 - 将整个
my_templete文件夹拖拽到FTP客户端的右侧(服务器端)templets目录中。 - 等待上传完成。
- 在你的本地电脑上,找到你第一步准备好的模板文件夹(
注意:如果你的模板文件很多,或者网站开启了 “使用绝对地址” 选项,你需要确保模板中引用的图片、CSS、JS等资源的路径是正确的,通常推荐使用相对路径(如 images/logo.png)。
第三步:在DedeCMS后台安装并启用模板
文件上传成功后,你还需要在DedeCMS后台告诉系统这个新模板的存在,并将其设置为默认模板。

(图片来源网络,侵删)
-
登录DedeCMS后台:打开你的网站,在域名后加上
/dede/进入后台管理系统(www.yourdomain.com/dede/),并登录。 -
进入模板管理:
- 在左侧菜单栏中,找到 “系统” -> “系统基本参数”。
- 在打开的页面中,点击左侧的 “核心设置”。
-
设置默认模板:
- 在“核心设置”页面中,找到以下几项设置:
cfg_templets_dir:这个值默认就是templets,无需修改。cfg_df_style:这是 “默认模板风格”,在这里填入你刚刚上传的模板文件夹的名称(my_templete)。cfg_arcdir:文章保存目录,默认是a。cfg_med_dir:媒体文件目录,默认是uploads。
- 修改
cfg_df_style的值为你自己的模板文件夹名,然后点击页面底部的 “保存基本参数” 按钮。
- 在“核心设置”页面中,找到以下几项设置:
-
(可选)验证模板是否生效:
- 方法一(推荐):直接访问你的网站首页,如果一切正常,你应该能看到你新模板的样式和内容了。
- 方法二:在后台左侧菜单栏找到 “模板” -> “默认模板管理”。
- 你可以看到系统识别到的所有模板文件,检查你的新模板文件是否都列在这里,并且路径正确(
templets/my_templete/index.htm)。
常见问题与解决方法
-
问题:上传后网站样式乱了,或者图片不显示。
- 原因:通常是模板文件中的资源路径(图片、CSS、JS)不正确。
- 解决:检查你的模板文件,确保所有资源的路径都是相对于模板文件本身的,CSS文件在
style/目录下,那么引用路径就应该是style/css.css。
-
问题:后台提示“模板文件不存在”或无法保存模板。
- 原因:
- FTP上传时,文件权限设置不正确。
templets目录及其内部文件需要有写入权限(通常是 755 或 777,但 777 有安全风险,755 是推荐值)。 - 上传的文件路径错误,没有放在
/templets/目录下。 - 文件名不符合DedeCMS的命名规则。
- FTP上传时,文件权限设置不正确。
- 解决:
- 通过FTP工具,右键点击
templets文件夹,选择“文件权限”,将其设置为 755,同样,检查模板文件本身的权限。 - 确认文件上传路径和文件名都正确。
- 通过FTP工具,右键点击
- 原因:
-
问题:模板已经设置好,但内容还是旧的。
- 原因:DedeCMS有缓存机制。
- 解决:
- 在后台点击 “系统” -> “一键更新网站” -> “更新HTML”,然后选择“更新所有”或“更新首页”。
- 或者,直接删除
/data/tplcache/目录下的所有缓存文件(这个目录可能会自动生成,删除后系统会重新生成)。
上传DedeCMS模板的流程可以概括为:
准备文件 -> FTP上传 -> 后台设置
记住最关键的两点:
- 模板文件夹 和 文件命名 要符合规范。
- 后台的“默认模板风格” 一定要设置成你的模板文件夹名称。
按照以上步骤操作,你就可以成功地将自己的网页模板应用到DedeCMS网站中了。
