Joe 风格安装教程（Discuz! 7.2 GBK）

# Joe 风格安装教程（Discuz! 7.2 GBK）

本教程教你把 Joe 风格安装到自己的 Discuz! 7.2 论坛，与论坛原有风格**完全隔离**：安装期间原风格照常运行，随时可一键切回。

- 适用版本：Discuz! 7.2（GBK 编码，BIG5/UTF-8 站请勿用）
- 套系目录：`templates/dz7joe`
- 需要权限：后台管理员（风格导入、模板编辑、数据库升级）
- 预计时间：30 分钟（主要是逐份粘贴模板）

安装前请先在后台备份数据库一次，有备无患。

---

## 第一步：导入风格 XML

1. 下载附件 `discuz_style_dz7joe.xml`（文件为 GBK 编码，**不要用记事本转存成 UTF-8**，也不要改文件名）。

discuz_style_joe风格.rar (356 Bytes)
2. 后台 → 界面 → 风格管理 → **导入风格**，选择该 XML 上传，提交。
3. 成功后风格列表出现「Joe风格」，模板管理里出现 **dz7joe** 套系。

此时它只是一个**空壳**，网站外观没有任何变化，**先不要启用**。

> 若提示目录创建失败（极少数主机禁了建目录权限），停止安装并联系发布者，不要手动改 XML 里的目录名硬闯。

## 第二步：创建聊天室数据表（需要聊天室才做，不需要可跳过）

后台 → 工具/数据库 → 升级（或 phpMyAdmin），执行以下 SQL。**注意把 `cdb_` 换成你自己的表前缀**，其余原样，CHARSET=utf8 不要改：

CREATE TABLE `cdb_chatroom` (
`pid` mediumint(8) unsigned NOT NULL AUTO_INCREMENT,
`uid` int(10) unsigned NOT NULL DEFAULT '0',
`username` varchar(15) NOT NULL DEFAULT '',
`message` text NOT NULL,
`dateline` int(10) unsigned NOT NULL DEFAULT '0',
PRIMARY KEY (`pid`),
KEY `dateline` (`dateline`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;

复制

## 第三步：逐份粘贴套系模板（核心步骤）

后台 → 界面 → 模板管理（模板编辑）→ 选择 **dz7joe** 套系 → 新建模板，名字填下表"模板名"（**不带 .htm 后缀**），内容粘贴发布者提供的对应文件全文，提交。

**必须按下表顺序操作**：大括号 `{subtemplate}` 引用的子模板要先保存，父模板后保存，顺序反了会编译报错。每批保存完再做下一批。

### 第 1 批：基础库和公共片段（6 个）

| 模板名 | 作用 |
|---|---|
| css_append | 全部样式（内容最长，粘贴后确认 textarea 完整再提交） |
| joe_auth_css | 登录/注册页样式 |
| jquery_331 | jQuery 库 |
| swiper | 轮播库（header 直接以 script src 引用） |
| clipboard | 复制库（备用库，当前页面未加载，需要复制功能时在 header 加一行 script 引用即可） |
| joe_global_js | 全站公共 JS |

### 第 2 批：自定义页面与边栏（4 个）

| 模板名 | 作用 |
|---|---|
| about | 关于页（?icode=about） |
| page_forumdisplay | 板块导航页（?icode=forumdisplay） |
| page_darkroom | 小黑屋页（?icode=darkroom） |
| side | 全站边栏 |

### 第 3 批：头尾框架（2 个）

| 模板名 | 作用 |
|---|---|
| header | 页头 |
| footer | 页脚 |

### 第 4 批：业务页面（23 个）

| 模板名 | 作用 |
|---|---|
| discuz | 首页（务必在 header 之后保存） |
| joe_index_js | 首页 JS（discuz 引用，紧跟 discuz） |
| forumdisplay | 板块帖子列表页 |
| viewthread | 帖子详情页 |
| joe_post_js | 帖子页 JS |
| post | 发帖/回帖页 |
| login / register | 登录 / 注册 |
| nopermission / showmessage | 无权限提示 / 消息提示页 |
| my | 个人中心 |
| my_threads / my_buddylist / my_favorites | 我的主题 / 好友 / 收藏 |
| pm / pm_node / pm_send | 私信列表 / 消息节点 / 发私信浮窗 |
| memcp_profile | 个人资料（含头像上传与签名适配） |
| notice | 通知页 |
| search / search_threads | 搜索页 / 结果 |
| viewpro_classic | 个人资料卡 |
| discuzcode | 帖子内容与表情渲染 |

没有列出的模板不用建，Discuz 会自动使用默认模板。

## 第四步：安装 default 默认包文件（聊天室功能，4 项）

这几个文件属于**默认模板包**（所有风格共用），不在 dz7joe 套系里。后台模板编辑切到 **default（默认模板）** 分类操作：

1. 新建模板 **joe_chatroom_api**，粘贴对应文件全文；
2. 新建模板 **joe_chatroom**，粘贴对应文件全文；
3. 编辑 **faq** 模板：在文件**第一行**加上下面这一行后保存（如果你以前改过 faq，只加这一行即可，其他内容不动）：

{subtemplate joe_chatroom_api}

复制

4. 编辑默认模板的 **header**，在 `</head>` 之前加一行：

<script type="text/javascript" src="templates/default/joe_chatroom.htm"></script>

复制

不需要聊天室的论坛可跳过本步整节。

## 第五步：配置"其他头部信息"

后台 → 全局/界面设置 → 站点信息里的「其他头部信息」（seohead）框，填入一行：

<script src="templates/dz7joe/jquery_331.htm?joe=20260930q" type="text/javascript"></script>

复制

如果该框里已有你自己的统计代码等内容，另起一行追加即可，不要删除原有内容。

## 第六步：启用并更新缓存

1. 后台 → 风格管理 → 「Joe风格」点**启用**，并设为**默认风格**；
2. 后台 → 工具 → 更新缓存（全部缓存）；
3. 浏览器 Ctrl+F5 强刷首页，安装完成。

---

## Sclub 等免费托管平台特别说明

- 本风格已内置官方顶部条（含 logo、繁简切换、广告、检举的那一行）的**美化样式**，启用后自动变成与主题一致的配色，官方元素和统计计数全部保留。
- **严禁**用 `margin-top:-18px`、display:none 等任何方式遮挡或删除官方顶部条，否则会被封站。本风格没有此类代码，你也不要自行添加。
- 平台不支持上传模板图片文件属正常现象：本风格图标全部内联，无图片文件依赖。

## 可选配置（后台"第三方统计代码"框，每行一个）

| 配置 | 作用 | 示例 |
|---|---|---|
| JOELOGO | 自定义站标图片 URL | `JOELOGO:https://你的图床/logo.png` |
| JOEHOT | 指定首页 4 个热帖（不足自动按回复数补齐） | `JOEHOT:12,15,30,42` |
| JOEBANNER | 指定首页轮播帖子，数量不限，显示原图 | `JOEBANNER:1859,1860,1861,1862` |
| JOENOTICE | 指定首页公告标题（红色，可点击） | `JOENOTICE:1859` |

不写某行即使用默认规则；修改后更新缓存生效。

## 常见问题

| 现象 | 原因与处理 |
|---|---|
| 启用后整页白屏 | 某份模板粘贴不完整或保存顺序不对。回风格管理切回原风格立即恢复，再重新编辑对应模板核对内容 |
| 页面无样式/排版全乱 | css_append 没粘或没更新缓存；重做第 1 批第一项 + 更新缓存 |
| 轮播/复制等功能不生效，JS 报 404 | 第 1 批的 JS 模板漏粘；若你改了套系名（非 dz7joe），需把模板内路径同步替换 |
| 中文乱码 | XML 被存成了 UTF-8：用记事本打开另存为，编码选 **ANSI** 后重新导入 |
| 聊天室打不开 | 第二步建表、第四步 4 个文件、第五步——逐项核对，缺一不可 |
| 头像上传异常 | 确认 memcp_profile 已粘到 dz7joe 套系（第 4 批） |

## 如何卸载/回退

风格管理里把默认风格切回你原来的风格，前台立即恢复。dz7joe 套系和 XML 可保留不占资源；确认不要了再在后台删除该风格，`templates/dz7joe` 目录与 cdb_chatroom 表需自行到服务器/数据库清理。

dz7joe.rar (338.43 KB)

屏幕截图 2026-10-04 221132.png (620.81 KB)

屏幕截图 2026-10-04 221132.png

评论一下？