Crypoverse - Cryptocurrency Payment Gateway [BTC， LTC， ETH] - 更新

3.1.2

昨天 03:59

# Crypoverse - 加密支付网关 - 更新日志

## 版本 3.1.2（2025-12-15）- 生产发布：完整结构修复

### 最终修复：“重建”与“升级”问题——根本原因已解决！

问题#10：XenForo 安装后显示错误版本 - *已修复 *

根本原因：版本源冲突和插件结构错误

分析：研究 XenForo 2.x 插件的最佳实践和现代标准

Discovery：XenForo 仅在版本控制 addon.json 下正常工作

问题#6：新安装时未创建支付提供商

固定 - 支付提供商在新安装时正确注册

已修复 - 改进的 installStep2（），具备全面的错误处理和后退机制

Fixed - 添加 upgrade3000800Step1（）以重建现有安装中缺失的支付提供商

原因 - installStep2（）未能正确处理边缘情况和缺失错误日志

影响 - 新安装的 v3.0.5+未在支付提供商下拉菜单中创建“Crypoverse”选项

关键 - 没有此修复，插件看似成功安装，但完全无法使用。

### 出了什么问题：
1. 有 build.json（不必要的文件导致冲突）
2. 有_data/addon_info.xml（XenForo 2.x 不需要）
3. 有两个 hashes.json 文件（循环参考问题）
4. 使用的 MD5 哈希（已过时）
5. 哈希路径相对于附加文件夹（错误）
6. 循环引用导致无限哈希变化

### 修复（v3.1.2）：
1. 已删除：build.json（版本来源冲突）
2. 已删除：_data/addon_info.xml（XenForo 2 不需要）
3. 删除：_data/hashes.json（循环引用问题）
4. 更新：hashes.json 使用 SHA-256 代替 MD5
5. 更新：哈希路径将与 ZIP 相关：'src/addons/Crypoverseaddon/CryptoPayment/...'
6. 已验证：addon.json 现在是版本信息的唯一来源
7. 清理：移除 Setup.php 中的所有调试代码
8. 修正：选项短语现在正确显示（使用点代替下划线）

### 为什么这能解决一切：

XenForo 仅读取 addon.json 版本（按设计）

无冲突版本来源以造成混淆

SHA-256 提供更好的文件完整性验证

ZIP 相对于路径与 XenForo 内部结构相匹配

无循环引用 = 无无限哈希变化

遵循 XenForo 2.x 现代插件结构标准

3.0.7

2025年12月09日

## 版本 3.0.7（2025-11-28）- 关键压缩结构修复 + 所有之前修复

注意：升级插件时，请用 FTP 替换文件，或者直接覆盖 ACP 插件！

### 关键修复

问题#5：无效的 XenForo 档案结构（新）

已修正 - 修正 ZIP 归档结构，根目录始于“CryptoPayment/”文件夹

原因 - 之前的 ZIP 结构错误：“上传/src/addons/Crypoverseaddon/CryptoPayment/”

Impact - ZIP 现在已成功上传，不再出现“文件似乎不是有效的附加档案”错误

关键 - 如果没有此修复，XenForo 会完全拒绝 ZIP 文件

问题#4：插件未升级（显示“重建”而非“升级”）

已修复 - 更新版本，按“_data/addon_info.xml”进行并修正了 XML 属性顺序

Cause - XenForo 在升级时使用 addon_info.xml（不仅仅是 addon.json）来检测版本

影响 - 插件现在可以正确从 2.5.1/3.0.4 升级到 3.0.7，无需“覆盖文件”选项

关键 - 没有此修复，用户即使“升级”后仍停留在旧版本

细节 - 确保 version_id 属性置于 XML 中的 version_string 之前

问题#1：缺少 hashes.json 文件健康检查错误

已修复 - 将“_data/”文件夹中的 hashes.json 复制到插件根文件夹

原因 - XenForo 期望在插件根中获得 hashes.json，而不是_data 子文件夹

Impact - 文件健康检查现在在 XenForo 管理 CP 中正常工作

问题#2：MySQL 错误，表情符号出现在 phrases.xml

已修复 - 移除所有导致 MySQL utf8mb4 错误的表情符号字符 phrases.xml

错误 - “字符串值错误：”\xF0\x9F\x93\x9A <...”对于“phrase_text”列

影响 - 插件安装/升级现在完成且不出现 MySQL 错误

变换短语：

“option_group_cryptoPayment_explain” - 已移除，表情符号

“enter_api_key_from_crypto_platform” - 已移除，表情符号

问题#3：未定义的持续回调状态： AYMENT_CANCELLED

修复 - 移除不存在的 XenForo 常量

错误 - '未定义常数 XF\Payment\CallbackState： AYMENT_CANCELLED'

根因 - XenForo 2 只有三个常数：PAYMENT_RECEIVED、PAYMENT_REINSTATED、PAYMENT_REVERSED

Impact - Webhook 回调现在能正常处理，不会导致致命错误

修改文件：

“付款/CryptoProvider.php”（第 634、641、837、868、875、887 行）

“控制员/CryptoPayment.php”（第 135-138 行）

“Controller/PaymentReturn.php”（第 70-100 行）