dede模板index.htm改名后如何生效？

这是一个非常常见的需求，尤其是在进行二次开发或者模板定制时，修改模板文件名需要遵循一定的规则,否则网站将无法正确加载首页。

核心原则：文件名与模板标识符的对应关系

在 DedeCMS 中，模板文件名不仅仅是一个文件名，它与数据库中的 模板标识符 是一一对应的，当你通过后台修改首页时，系统实际上是在数据库的 dede_templets (或 dede_arctype，取决于版本和设置) 表中，将某个栏目的 templet 字段值更新为你选择的模板文件名。

修改 index.htm 的关键在于 同步修改数据库中的对应记录。

安全稳妥的方法（推荐）

这是最安全、最推荐的方法，它利用了 DedeCMS 自带的模板管理功能,可以确保所有相关设置都正确更新。

步骤如下：

1. 重命名模板文件

   • 通过 FTP 或你的主机控制面板文件管理器,登录到你的网站服务器。
   • 进入 DedeCMS 的模板目录，通常是 /templets/ 目录。
   • 找到 index.htm 文件,将其重命名为你想要的新名称。
   • 重要提示：新文件名必须以 .htm 或 .html 例如，你可以将其命名为 myhome.htm、new_index.htm 或 v5_index.htm。

2. 在后台重新指定模板

   • 登录你的 DedeCMS 管理后台。
   • 在左侧菜单中找到 【系统】 -> 【系统基本参数设置】。
   • 在打开的页面中，切换到 【核心设置】 选项卡。
   • 找到 “首页默认模板” 这一项，它的值当前应该是 index.htm。
   • 将这里的值修改为你刚刚在 FTP 中设置的新文件名，myhome.htm。
   • 点击 【保存】 按钮。

3. 更新栏目模板（如果适用）

   • 如果你的首页是绑定在某个顶级栏目下的（首页”栏目）,你还需要去该栏目的模板设置中进行修改。
   • 在后台菜单中进入 【栏目管理】。
   • 点击“首页”栏目的 【修改】 按钮。
   • 在栏目修改页面，找到 “列表模板选项” 或 “首页模板” 字段（具体名称可能因版本略有不同）,确保这里的值也和你设置的新文件名一致。
   • 保存修改。

完成！ 现在清空一下浏览器缓存和 DedeCMS 的缓存（后台【系统】->【一键更新缓存】），然后访问你的网站首页,它就会加载你重命名后的新模板了。

直接修改数据库（高风险，不推荐新手使用）

如果你无法通过后台修改（例如后台出现故障），或者你非常熟悉数据库操作，可以采用此方法。操作前务必备份数据库！

1. 备份数据库

   • 这是最重要的一步！在你的主机控制面板中找到数据库管理工具（如 phpMyAdmin），导出整个 dede_ 开头的数据库作为备份。

2. 重命名模板文件

   • 同方法一，通过 FTP 将 index.htm 重命名为你想要的文件名，myhome.htm。

3. 修改数据库记录

   • 使用 phpMyAdmin 等工具登录你的数据库。
   • 找到 DedeCMS 的核心数据表，通常是 dede_homepageset 或 dede_sysconfig。
   • 情况 A：dede_homepageset 表
     • 在该表中查找 templet 字段。
     • 将 templet 字段的值从 index.htm 修改为你的新文件名 myhome.htm。
   • 情况 B：dede_sysconfig 表
     • 在该表中，查找 varname 为 'cfg_templet' 或 'index' 的记录。
     • 修改该记录对应的 value 字段，将其值改为 myhome.htm。
   • 情况 C：dede_arctype 表（如果首页是栏目）
     • 如果你的首页是作为一个顶级栏目存在的，还需要检查 dede_arctype 表。
     • 找到 topid 为 0 的栏目记录（通常是“首页”）。
     • 修改其 templet 字段，将值改为 myhome.htm。

4. 验证

   修改完成后，访问网站首页,看是否加载正常。

常见问题与注意事项

• Q: 修改后网站首页显示空白或模板错误？

  • A: 最常见的原因是数据库中的模板标识符没有更新，请仔细检查方法一中的步骤2或方法三中的步骤3，确保数据库中的文件名和服务器上的文件名完全一致（包括大小写）,请检查新模板文件中是否有语法错误。

• Q: 修改后网站无法访问，出现500错误？

  • A: 这通常是由于直接修改数据库时出现了错误，导致系统配置表损坏,请立即恢复你之前备份的数据库。

• Q: 新文件名有什么限制？

  • A:
    1. 必须以 .htm 或 .html
    2. 建议使用英文字母、数字和下划线，避免使用中文、空格或特殊符号,以防编码问题。
    3. 不要使用 DedeCMS 已有的核心模板文件名，如 article_list.htm、article_article.htm 等,以免混淆。

• Q: 我只想换个名字，不想改功能，可以吗？

  • A: 完全可以，这只是一个重命名操作，只要按照上述方法正确同步了数据库,网站功能不会受到任何影响。