模板路径的作用
织梦CMS的模板路径决定了系统去哪里读取 HTML 模板文件。默认路径是 /templets/default/,存放首页、列表页、内容页等模板。当需要切换模板风格、上线新模板或做多套模板共存时,就需要修改模板路径。
原因分析
1. 上线新模板
新模板开发完成后,需要把默认路径切换到新模板目录。
2. 多模板共存
站点需要根据节日、季节切换不同主题模板。
3. 安全考虑
把模板目录改名,避免黑客直接访问默认路径探测站点结构。
4. 模板分离部署
把模板放到独立目录或 CDN,方便多人协作与版本管理。
修改方法
方法一:后台修改(推荐)
- 登录织梦后台,进入「系统 → 系统基本参数 → 站点设置」。
- 找到「模板默认风格」字段,默认值是
default。 - 改为新模板目录名,例如
mytheme。 - 保存后,进入「生成 → 更新主页HTML」,重新生成全站。
方法二:修改配置文件
打开 data/config.cache.inc.php,找到:
$cfg_df_style='default';
改为:
$cfg_df_style='mytheme';
方法三:修改首页模板路径
首页模板路径单独配置,在「系统基本参数」中找到「主页模板」字段:
$cfg_df_templets='default/index.htm';
改为:
$cfg_df_templets='mytheme/index.htm';
方法四:栏目级模板
每个栏目可以独立指定模板,在「核心 → 栏目管理 → 修改栏目」中设置:
- 列表模板:
{style}/list_article.htm - 文章模板:
{style}/article_article.htm - 封面模板:
{style}/index_article.htm
{style} 会被自动替换为当前默认模板目录名。
配置示例
完整的模板相关配置(data/config.cache.inc.php):
// 默认模板风格
$cfg_df_style='mytheme';
// 主页模板文件
$cfg_df_templets='mytheme/index.htm';
// 模板文件扩展名
$cfg_df_templetdir='../templets';
// 模板缓存目录
$cfg_tplcache_dir='../data/tplcache';
多模板切换示例
实现春节主题模板切换:
- 新建目录
templets/spring/,把春节主题模板放进去。 - 修改
data/config.cache.inc.php:$cfg_df_style='spring'; - 清空
data/tplcache/缓存。 - 重新生成全站 HTML。
- 节后改回
default,再次生成。
注意事项
- 新模板目录必须存在于
templets/下,否则后台报错。 - 修改模板路径后必须清空
data/tplcache/,否则仍读旧缓存。 - 静态站点必须重新生成所有页面,否则前端不生效。
- 模板目录名不要使用中文,避免编码问题。
- 模板文件命名要遵循织梦规范:index.htm、list_*.htm、article_*.htm。
- 修改前务必备份
config.cache.inc.php,避免误改导致全站崩溃。
建议把模板目录放到版本控制(Git)中,方便多人协作与回滚。
建议与行动
模板路径管理是站点换肤与升级的基础,建议建立规范的模板命名与目录结构,例如 templets/站点名_v版本号/,方便追溯。同时把模板文件纳入版本控制,每次改版都有 commit 记录,出问题能快速回滚。对于多主题站点,可以写个切换脚本,一键修改配置并重新生成,省去手动操作。今天就先看看当前模板路径配置,把模板目录纳入备份策略,下次改版就能从容应对。