核心概念:DedeCMS是如何工作的?
在开始修改之前,你必须理解DedeCMS的基本工作原理,这样你才能知道要修改哪里。

(图片来源网络,侵删)
- 模板文件:DedeCMS的页面外观是由HTML模板文件决定的,这些文件存放在
/templets/目录下。 - 模板文件中不是纯HTML,里面穿插着特殊的代码,叫做 Dede标签,这些标签的作用是“调用”数据库里的内容。
{dede:arclist}是调用文章列表的标签。{dede:channel}是调用栏目列表的标签。
- 动态生成:当用户访问你的网站时,DedeCMS会解析这些模板文件,执行标签里的PHP代码,从数据库中取出数据,然后动态生成最终的HTML页面,发送给用户的浏览器。
修改首页,就是修改 /templets/ 目录下的首页模板文件,并理解其中的标签。
第一部分:找到并修改首页模板文件
这是最基础也是最直接的修改。
步骤1:定位首页模板文件
DedeCMS的首页模板文件通常有两个,一个用于PC端,一个用于手机端。
-
PC端首页模板:
(图片来源网络,侵删)- 路径:
/templets/default/index.htm default是默认的模板文件夹,如果你的网站使用了其他模板(比如你下载的模板),路径可能是/templets/你的模板名称/index.htm。
- 路径:
-
手机端首页模板:
- 路径:
/templets/default/wap/index.htm - 同样,如果你的手机端模板不同,路径也会相应改变。
- 路径:
步骤2:如何修改模板文件
-
通过FTP软件:
- 使用 FileZilla 等FTP工具连接到你的服务器。
- 找到上述路径的
index.htm文件。 - 将其下载到本地电脑。
- 使用 VS Code、Sublime Text、Dreamweaver 等代码编辑器(强烈不推荐使用记事本,因为它可能会破坏文件编码)打开并修改。
- 修改完成后,保存文件,再通过FTP上传回服务器,覆盖原文件。
-
通过DedeCMS后台:
- 登录你的DedeCMS后台。
- 进入 【模板】 -> 【模板管理】。
- 在列表中找到 “首页模板”,点击右侧的 “修改” 按钮。
- 在弹出的代码编辑器中直接修改,然后点击 “保存” 按钮。
- 注意:后台编辑器有时对大文件处理较慢,且可能无法完美处理所有代码格式,对于复杂修改,推荐使用FTP+专业编辑器的方式。
第二部分:理解并修改首页中的核心标签
修改模板文件时,你真正需要操作的是这些标签,下面列出首页最常用的几个标签及其修改方法。

(图片来源网络,侵删)
和Logo
-
:通常在
<title>标签里。- 代码:
<title>{dede:global.cfg_webname/}</title> {dede:global.cfg_webname/}是调用后台“系统参数”中设置的网站名称。- 修改:你可以直接修改
{dede:global.cfg_webname/}为你的网站名,或者保留这个标签,去后台 【系统】 -> 【系统基本参数】 -> 【站点信息】 修改“站点名称”。
- 代码:
-
网站Logo:
- 代码:
<a href='/{dede:global.cfg_indexurl/}'><img src='{dede:global.cfg_cmspath/}/images/logo.gif' /></a> src属性里的路径就是Logo图片的地址。- 修改:
- 准备好你的新Logo图片(建议尺寸和原Logo接近)。
- 通过FTP上传到
/templets/default/images/目录下。 - 修改代码中的
src路径,指向你的新Logo图片,src='/templets/default/images/your_new_logo.png'。
- 代码:
调用文章/资讯列表
这是首页最重要的部分,用于显示最新的文章、新闻、产品等。
-
基本代码:
{dede:arclist typeid='' row='10' titlelen='24'} <li> <a href="[field:arcurl/]">[field:title/]</a> <span>[field:pubdate function="MyDate('Y-m-d', @me)"/]</span> </li> {/dede:arclist} -
常用属性说明:
typeid='':指定调用哪个栏目的文章,留空表示调用所有栏目,如果想调用指定栏目,填入栏目ID,typeid='5'。row='10':调用文章的数量。10表示调用10条。titlelen='24'显示的字数长度。24表示最多显示24个汉字。orderby='pubdate':排序方式。pubdate按发布时间排序,click按点击量排序。type='image':只包含有图片的文章。
-
字段说明(用[field:xxx/]来调用):
[field:title/]。[field:arcurl/]:文章链接。[field:pubdate function="MyDate('Y-m-d', @me)"/]:文章发布时间,MyDate函数用于格式化日期。[field:description/]:[field:litpic/]:文章缩略图。
-
如何修改:
- 改变调用数量:修改
row='10'中的数字。 - 只调用某个栏目:在
typeid中填入你想要显示的栏目ID,如何找到栏目ID?去后台 【栏目】 -> 【栏目管理】**,鼠标移到栏目名称上,浏览器状态栏会显示ID。 - 修改列表样式:修改
<li>标签及其内部的HTML结构,可以给标题加粗、添加图片等。{dede:arclist row='5' typeid='5'} <div class="news-item"> <img src="[field:litpic/]" alt="[field:title/]"> <h3><a href="[field:arcurl/]">[field:title/]</a></h3> <p>[field:description function="cn_substr(@me, 100)"/]...</p> </div> {/dede:arclist}
- 改变调用数量:修改
调用栏目导航
-
基本代码:
{dede:channel type='top' row='8'} <li><a href="[field:typelink/]">[field:typename/]</a></li> {/dede:channel} -
常用属性说明:
type='top':只调用顶级栏目,如果想调用所有栏目,可以去掉这个属性或改为type='son'。row='8':调用栏目的数量。
-
如何修改:
- 修改
row='8'可以改变显示的栏目数量。 - 修改
<li>标签的样式可以改变导航菜单的外观。
- 修改
调用单页内容(如“关于我们”、“联系我们”)
如果首页需要显示“关于我们”这类固定内容,可以使用单页内容标签。
- 步骤:
- 在后台 【栏目】 -> 【添加栏目】,创建一个“关于我们”栏目,栏目类型选择“单页文档**”。
- 在这个栏目中添加内容并保存。
- 在首页模板中,使用以下标签调用:
{dede:field name='body'/}
- 这个标签会自动调用当前栏目(首页)的内容,如果你要调用指定ID的单页内容,可以使用:
{dede:sql sql='Select body from dede_arctype where id=5'} [field:body/] {/dede:sql}(
id=5是你创建的“关于我们”栏目的ID)
第三部分:修改后网站不生效怎么办?
这是新手最常遇到的问题。
-
清除缓存!清除缓存!清除缓存!
- 这是最最常见的原因,DedeCMS为了提高速度,会生成静态缓存文件。
- 解决方法:
- 方法一(推荐):登录后台,点击右上角的 “更新缓存” 按钮。
- 方法二:通过FTP删除
/data/cache/目录下的所有文件(除了index.html)。 - 方法三:在后台 【系统】 -> 【SQL命令行工具】**,执行
Delete from dede_arccache;来清空文章缓存。
-
检查标签语法错误
- 确保所有标签都正确闭合,
{dede:arclist}必须有对应的{/dede:arclist}。 - 检查标签属性是否正确,不要有多余的空格或错误的字符。
- 确保所有标签都正确闭合,
-
文件权限问题
- 确保你的模板文件(如
index.htm)和/data/目录有正确的读写权限(通常是755或644)。
- 确保你的模板文件(如
-
使用“一键生成首页”
- 在后台 【生成】 -> 【主页更新】**,点击“一键生成首页”,可以强制重新生成首页文件。
总结与建议
- 新手入门:从修改
/templets/default/index.htm文件开始,重点修改Logo、网站标题和文章列表的typeid和row属性。 - 进阶修改:深入学习
arclist、channel、sql等标签,实现更复杂的内容调用和布局。 - 最佳实践:
- 修改前备份:每次修改模板文件前,务必先备份原文件。
- 使用FTP+专业编辑器:这是最稳定、最高效的修改方式。
- 善用官方文档:DedeCMS官网有详细的标签手册,遇到不理解的标签可以去查阅。
希望这份详细的指南能帮助你成功修改DedeCMS首页!如果在操作中遇到具体问题,可以随时提出。
