> ## Documentation Index
> Fetch the complete documentation index at: https://discuz.p.cafe/llms.txt
> Use this file to discover all available pages before exploring further.

# 模板风格创建

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

## **开启模板开发者模式**

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

```
$_config['plugindeveloper'] = 1;
```

## **模板套系与风格区别**

**模板套系：** 统一的一类模板，集中放置并打包的系列。

**模板风格：** 使用某个模板套系代码，仅改变其中变量设置的一个方案。

默认一个模板套系下就一个风格方案，通过"复制"功能，可以复制出不同的风格，进行不同的设置，比如改变logo设置。

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

1. 首先进入**后台 - 模板 - 设计新模板**
2. 填写模板名称(name)，例如设置为"我的模板"
3. 填写版权信息(copyright)，根据自己的情况填写版权信息
4. 填写惟一标识符(identifier)，惟一标识符用于生成模板目录和后续提交模板到应用中心，不可与现有模板重复，命名规则限制与 PHP 变量命名相同
5. 初始化模板设置，使用已经存在的模板设置初始化本模板，或创建空白设置的模板

## **模板创建（老版本dz的教程）**

### **创建模板套系**

1. 首先进入**后台 - 界面 - 模板管理**，扩展制作模板时需要创建一个专属套系用来后期修改
2. 基于"模板套系"可以扩展针对 ./template/default/ 目录中对的模板文件
3. 创建套系的原则是不破坏原有模板基础上进行全新的扩展模板设计

#### **实例**

在站点根目录 ./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/ 目录中的样式文件 |
| 默认配色     | 指定站点访问时，用户首先看到的配色方案                                        |
| 默认表情分类   | 对应**后台 - 界面 - 表情管理**中所启用的表情                                |
| 界面基础图片目录 | 可用于更改模板图片目录，在CSS文件中使用\*\*IMGDIR\*\*的常量进行输出                 |
| 扩展图片目录   | 用来更改扩展图片目录，在CSS文件中使用\*\*STYLEIMGDIR\*\*的常量进行输出             |
| 自定义模板变量  | 可以根据扩展需求，针对个性化的CSS进行全局的定义                                  |