Discuz! 的模板机制

更新于 2026-10-30

<div class="tbmu bbda mbm"><a href="?ac=document&page=dev_template" class="a">模板风格创建</a><span class="pipe">|</span><a href="?ac=document&page=template_coderule">Discuz!模板解析语法</a><span class="pipe">|</span><a href="?ac=document&page=template_css">模板缓存与CSS缓存</a><span class="pipe">|</span><a href="?ac=document&page=template_sample">内置常用CSS代码分析 </a></div>

## 开启模板开发者模式
开始设计一个新模板，请首先打开 config/config_global.php 文件，在文件结尾添加以下代码开启模板开发者模式。

$_config['plugindeveloper'] = 1;

## 模板套系与风格区别
模板套系：统一的一类模板，集中放置并打包的系列。
模板风格：使用某个模板套系代码，仅改变其中变量设置的一个方案。
（默认一个模板套系下就一个风格方案，通过“复制”功能，可以复制出不同的风格，进行不同的设置，比如改变logo设置）

## 模板创建（基于最新版的教程）

- 首先进入**后台 - 模板 - 设计新模板**

- 填写模板名称(name)，例如设置为“我的模板”

- 填写版权信息(copyright)，根据自己的情况填写版权信息

- 填写惟一标识符(identifier)，惟一标识符用于生成模板目录和后续提交模板到应用中心，不可与现有模板重复，命名规则限制与 PHP 变量命名相同，建议一次性将此配置设置好，否则可能涉及到很多代码方面的变更，增加编码的麻烦。请注意：惟一标识符请不要设置的过短，或使用有可能与其他模板重复的命名。会自动创建模板目录：template/标识符/。

- 初始化模板设置，使用已经存在的模板设置初始化本模板，或创建空白设置的模板

- 其他细节参考下边老教程的说明

## 模板创建（老版本dz的教程）
### 创建模板套系
- 首先进入**后台 - 界面 - 模板管理**，扩展制作模板时需要创建一个专属套系用来后期修改

- 基于“模板套系”可以扩展针对 ./template/default/ 目录中对的模板文件

- 创建套系的原则是不破坏原有模板基础上进行全新的扩展模板设计

#### 实例
- 在站点根目录 ./template/中创建新的目录如" ./template/mytest"
- 在 mytest 目录中创建必要子目录与文件如：
```
	./template/mytest/common/
	./template/mytext/common/extend_common.css
	./template/mytext/common/extend_module.css
```
- 其中common目录为公共模板目录，其内部新建的**extend_common.css**、**extend_module.css**为扩展型CSS文件，它们可以在./template/default/common/common.css的和module.css的基础上进行CSS代码的覆盖性扩展

- 如果需要替换论坛首页模板，可以新建 ./template/mytext/forum/discuz，或复制 ./template/default 中的对应文件放在 mytext 对应目录，以在缓存生成时覆盖原有模板缓存，达到修改模板而不破坏原生模板的目的

### 后台风格管理
- 进入**后台 - 界面 - 风格管理**
- “风格管理”可以对已有风格进行风格变量的编辑，也可以基于前面创建的“模板套系”来全新开辟新的风格

#### 新建风格
- 后台风格管理中，可以通过**新增**和**复制**原有风格进行新建风格的操作
- 新建风格之后，需要编辑它，调整里面的“匹配模板”为上面创建的新套系即可

#### 风格管理编辑页面中重点风格常量介绍
- 匹配模板：对应的模板套系
- 扩展配色：此风格基础上可用于用户切换配色方案的扩展，它对应 ./template/mytest/style/ 目录中的样式文件。全新创建时应在./template/mytest/style/目录中建立如t1/style.css之后方能生效
- 默认配色：指定站点访问时，用户首先看到的配色方案
- 默认表情分类：对应**后台 - 界面 - 表情管理**中所启用的表情
- 界面基础图片目录：可用于更改模板图片目录，在CSS文件中使用**{IMGDIR}**的常量进行输出，**在Discuz! X2版本之后的模板中需要使用`$_G['style']['imgdir']`**
- 扩展图片目录：用来更改扩展图片目录，在CSS文件中使用**{STYLEIMGDIR}**的常量进行输出，**在Discuz! X2版本之后的模板中需要使用`$_G['style']['styleimgdir']`**
- 其他风格常量：以上没有提到风格常量，均可以在后台取得以花括号框选的常量用以在CSS文件中使用（X2以后的模板中均需要`$_G['style']`中对应的数组键值），涉及到CSS样式的动态变更，可以在修改对应设置如：正常字体大小 `{FONTSIZE}:12px/1.5`，则直接修改程序运行中CSS缓存中的值
- 自定义模板变量 - 新增：可以根据扩展需求，针对个性化的CSS进行全局的定义

发现文档有误？去技术社区反馈回到顶部

开发文档

入门

平台介绍

开发

技术文档

文档有疑问？去技术社区提问

开放平台

Discuz! 的模板机制

开发文档