网盘资源管理插件

—

# 📂 网盘资源管理插件 v4.7.4

**网盘资源管理插件** 是一款专为 WordPress + Zibll 主题打造的高级网盘资源管理插件。它不仅支持主流网盘链接的智能解析与自动提取码识别，更深度对接了 Zibll 的用户系统（VIP、SVIP、等级系统）和支付系统，实现了精细化、严格隔离的权限控制体系。

—

## 🌟 核心功能特性 (Features)

### 1. 深度对接 Zibll 生态
* **等级系统支持**：完美识别 Zibll 的用户等级（LV1 – LV10），支持读取主题设置的自定义等级名称（如“铁粉”、“元老”等）。
* **VIP 会员体系**：直接调用主题的 VIP/SVIP 权限判断，支持自定义 VIP 名称显示。
* **原生支付集成**：通过 Zibll 的收银台接口实现资源单独付费解锁，无需额外部署支付系统。

### 2. 🛡️ 严格的权限隔离机制 (v4.7.4 新特性)
拒绝权限混淆！插件实现了严格的单一权限逻辑：
* **付费资源**：仅限购买后下载，VIP 无法直接免费下载（除非您设置为 VIP 权限）。
* **等级/VIP 资源**：仅限达到指定等级或会员身份下载，付费无法解锁。
* **评论资源**：必须评论后才能下载，强制互动。
* **登录资源**：游客必须登录。
* **管理员/作者特权**：网站管理员和文章作者拥有最高权限，可直接下载所有资源。

### 3. ⚡ 智能解析与操作
* **批量解析**：支持粘贴多行混合文本，插件自动提取 `链接` 和 `提取码`。
* **支持网盘**：预设百度、阿里、夸克、迅雷、123盘、蓝奏云等主流网盘规则，并支持后台自定义正则扩展。
* **一键提取码**：前端点击提取码自动复制，体验丝滑。

### 4. 🎨 现代化 UI 与交互
* **侧边栏监听**：在文章编辑器（古腾堡/经典）侧边栏实时显示资源状态，点击即可弹窗管理。
* **一键配色**：内置 20+ 种按钮渐变色风格（仿 Zibll 风格），可针对不同文章设置不同颜色。
* **响应式设计**：完美适配移动端和桌面端，暗黑模式（Dark Mode）自动适配。

—

## 📖 使用说明 (User Guide)

### 1. 安装与启用
1. 将插件文件夹上传至 `/wp-content/plugins/` 目录。
2. 在 WordPress 后台“插件”菜单中启用 **“网盘资源管理 (Zibll侧边栏强力监听版)”**。

### 2. 添加资源 (文章编辑页)
1. 进入文章编辑页面，在右侧侧边栏找到 **“网盘资源”** 面板。
2. 点击 **“管理资源链接”** 按钮，打开悬浮管理窗口。
3. **智能添加**：
* 在上方文本框粘贴分享链接（如：`链接：https://pan.baidu.com/s/xxx 提取码：1234`）。
* 点击 **“智能解析并添加”**，系统自动识别并填入列表。
4. **手动调整**：
* **资源名称**：默认为网盘名称，可自定义。
* **权限设置**：下拉选择权限（公开/登录/评论/指定权限/付费）。
* **提取码**：如有提取码会自动填入。

### 3. 权限详解 (Permission Settings)

| 权限模式 | 前端表现 | 解锁条件 | 适用场景 |
| :— | :— | :— | :— |
| **全公开** | 显示“立即下载” | 无需任何条件 | 免费分享资源 |
| **登录可见** | 显示“登录后下载” | 用户登录账号 | 引导游客注册 |
| **评论可见** | 显示“评论后下载” | 用户发布评论并通过审核 | 增加文章热度/互动 |
| **指定用户组** | 显示“需 [VIP名称] 权限” | 用户达到指定 VIP 等级或 LV 等级 | 会员专享资源 |
| **付费下载** | 显示“立即解锁”/价格 | 调用 Zibll 支付接口付款 | 售卖高价值资源 |

> **注意**：选择“指定用户组”后，右侧会出现二级下拉框，请务必选择具体的等级（如 VIP1, SVIP, LV3 等）。

### 4. 全局设置 (后台)
进入 **设置 -> 网盘资源设置**：
* **网盘规则配置**：可以添加新的网盘识别正则，修改图标 URL。
* **常用预设**：点击顶部预设按钮可快速恢复默认规则。

—

## 🛠️ 常见问题 (FAQ)

**Q: 为什么我设置了 VIP 下载，前端还是显示“指定权限”？**
A: 请确保您安装的是 **v4.7.3+** 版本。新版本已修复此问题，会自动读取 Zibll 主题设置中真实的 VIP 名称（如“黄金会员”）。如果未选择具体等级，系统会自动默认为 VIP1。

**Q: 付费资源可以设置 VIP 免费吗？**
A: 在本插件的逻辑中，权限是**严格隔离**的。
* 如果您希望 VIP 免费，请选择“指定用户组 -> VIP1”，这样 VIP 可以直接下载。
* 如果您希望必须付费（即使是 VIP 也要买），请选择“付费”，这样所有人（包括 VIP）都需要单独购买。

**Q: 如何修改按钮颜色？**
A: 在文章编辑页的弹窗底部，有一个“设置按钮颜色风格”区域，点击选择即时生效。

—

## 📝 更新日志 (Changelog)

**v4.7.4**
* **重构**：全量重构权限判断核心逻辑 (`check_permission`)，确保逻辑严密。
* **修复**：修复前端选择“指定用户组”时若未更改二级选项可能导致参数无法保存的 Bug。
* **优化**：未登录状态下，针对 VIP/等级资源统一引导登录。
* **优化**：管理员和作者拥有最高权限，无视所有锁定状态。

**v4.7.3**
* **修复**：修复按钮文字显示为“需 指定权限 权限”的问题，现在精准显示为“需 SVIP 权限”或“需 LV3 权限”。
* **优化**：增强数据保存时的清洗逻辑，防止空值写入。

—

**版权所有 © ReelGo | 适配 Zibll 主题**