# imgtoc 图片图床插件 — 安装步骤

本文档说明在 Discuz! 论坛中安装、配置与升级 **imgtoc 图片图床** 插件的操作步骤。适用标识符：`imgtoc`，当前插件版本以后台「关于插件」或 `discuz_plugin_imgtoc.xml` 中 `version` 为准。

---

## 一、环境与依赖

| 项目 | 要求 |
|------|------|
| 论坛程序 | Discuz! X 系列（插件包标注支持 X2 / X2.5 / X3.x / **X3.5** 等，请以 `discuz_plugin_imgtoc.xml` 中 `Version` 为准） |
| PHP | 建议 **PHP 5.6～8.x**（与服务器及 Discuz 版本兼容即可） |
| PHP 扩展 | 必须开启 **cURL**（插件在服务端通过 cURL 请求 ImgToC 站点） |
| 数据库 | MySQL，安装脚本会创建数据表（见下文） |
| 图床服务 | 已部署的 **ImgToC** 站点，且包含与插件配套的接口 |

---

## 二、安装前准备

1. **部署 ImgToC 图床**  
   在独立域名或子域部署 ImgToC，确保论坛服务器能 **HTTPS/HTTP 访问** 该站点根地址。

2. **获取 API 密钥**  
   在 ImgToC **用户中心 → API 接入** 中生成或重新生成 **X-API-Key**，安装完成后填入 Discuz 插件设置。  
   发帖上传由论坛 PHP **代理转发**，密钥不会直接输出到访客网页；图床侧通常按**服务器出站 IP** 做白名单校验（一般无需再为浏览器单独配置论坛域名）。

3. **备份**  
   安装或升级前建议备份数据库与 `source/plugin/imgtoc` 目录。

---

## 三、上传插件文件

1. 将本插件整个目录 **`imgtoc`** 上传到论坛目录：  
   `站点根目录/source/plugin/imgtoc/`  
   确保该目录下存在 `discuz_plugin_imgtoc.xml`、`install.php`、`imgtoc.class.php` 等文件。

2. 目录权限按 Discuz 常规要求即可（需保证 Web 服务器可读；若服务器有安全策略，勿误删 `static` 等子目录）。

---

## 四、在后台安装插件

1. 使用 **创始人或具备插件管理权限** 的管理员账号登录 **管理中心**。

2. 进入：**插件**（或「应用」→「插件」，以您使用的 Discuz 菜单为准）。

3. 在插件列表中找到 **imgtoc图片图床**（或名称含 imgtoc），点击 **安装**。  
   - 系统会执行 `install.php`：创建数据表 **`pre_imgtoc_upload_log`**（表前缀 `pre_` 以您 `config` 中 `tablepre` 为准，实际表名形如 `pre_imgtoc_upload_log`）。  
   - 用于记录本地上传日志，供后台统计等功能使用。

4. 安装成功后，点击 **设置**（或进入该插件的配置页），完成下一节参数填写。

---

## 五、插件设置项说明

在 **插件 → imgtoc → 设置** 中建议按顺序配置：

| 设置项 | 说明 |
|--------|------|
| **ImgToC 站点地址** | 图床站点**根地址**，**不要**末尾斜杠，例如 `https://imgtoc.com`。须指向已部署、且含插件所需 API 的 ImgToC；若对端未升级接口，后台列表可能出现「未知的API操作」等提示。 |
| **API 密钥（X-API-Key）** | 填入 ImgToC 用户中心生成的密钥。未正确填写时，前台发帖图床上传不可用（上传页会提示先配置密钥）。 |
| **CURL 是否校验 SSL 证书** | 生产环境建议 **校验**（是）。自签名证书或本机调试若报证书错误，可临时改为不校验；纯 HTTP 图床地址时影响较小。 |
| **图床插件按钮提示文字** | 发帖编辑器上图床按钮的 `title` 提示。 |
| **隐藏论坛发帖子【附件】上传** | 开启后通过脚本隐藏系统自带附件按钮（按需）。 |
| **隐藏论坛发帖子【图片】上传** | 开启后隐藏系统自带图片按钮（按需）。 |
| **可使用图床的用户组** | **必选**：仅被选中的用户组在发帖编辑器左侧会看到图床按钮；未选中的会员无法使用该插件发帖传图。 |

保存设置后，建议 **更新缓存**（Discuz 后台「工具」或「站长」中的更新缓存），避免旧缓存导致配置不生效。

---

## 六、安装后自检

1. 使用 **已授权用户组** 的测试账号登录前台，进入 **发帖/回帖** 编辑器，确认出现 **图床** 按钮（样式为插件自带图标）。  
2. 点击按钮应弹出层：**上传图片** / **图片列表** 两个页签。  
3. 上传一张测试图，确认能插入编辑器并正常发帖显示。  
4. 管理员进入：**插件 → imgtoc** 子菜单（如「关于插件」「文件管理」「报表统计」），确认远程列表与统计按说明工作（依赖站点地址与密钥正确）。

---

## 七、升级插件

1. **备份** 数据库与 `source/plugin/imgtoc`。  
2. 用新版本文件覆盖 `source/plugin/imgtoc`（注意不要删掉您自改的模板 unless 有意替换）。  
3. 在后台 **插件** 中对该插件执行 **升级**（会执行 `upgrade.php`）：  
   - 补建或修正 `imgtoc_upload_log` 表结构（含历史表名迁移逻辑）；  
   - 同步后台菜单顺序等（以 `upgrade.php` 实际逻辑为准）。  
4. 升级完成后再次检查设置与缓存。

---

## 八、卸载说明

在后台 **插件** 中对 imgtoc 执行 **卸载** 时，会执行 `uninstall.php`，**删除数据表** `pre_imgtoc_upload_log`（前缀以站点配置为准）。  
卸载后上传日志与相关统计将不可恢复，请务必先确认是否需要导出数据。

---

## 九、常见问题

- **前台提示先填写 API 密钥**  
  在插件设置中填写正确的 **X-API-Key** 并更新缓存。

- **后台文件列表报错或「未知的API操作」**  
  检查 **ImgToC 站点地址** 是否指向正确环境、图床是否为与插件匹配的版本。

- **部分用户看不到图床按钮**  
  在 **可使用图床的用户组** 中勾选对应用户组。

- **HTTPS 请求失败**  
  检查服务器 cURL、证书链；必要时在插件中调整 **SSL 校验** 选项（仅建议用于调试或自签名场景）。

---

## 十、联系我们

**版权所有:**
 https://www.phpdisk.com  https://imgtoc.com

**邮件联系：**
 admin@phpdisk.com

