Плагин Crypoverse - Crypto Payment Gateway 3.1.2

# Crypoverse - Криптовалютный платежный шлюз - Список изменений

## Версия 3.1.2 (15.12.2025) - ПРОИЗВОДСТВЕННЫЙ РЕЛИЗ: Полное структурное исправление

### **ОКОНЧАТЕЛЬНОЕ ИСПРАВЛЕНИЕ: Проблема "Пересборка" против "Обновления" - КОРЕННАЯ ПРИЧИНА УСТРАНЕНА!**

**Проблема #10: XenForo отображает неправильную версию после установки** - **ИСПРАВЛЕНО **
- **Коренная причина**: Конфликтующие источники версий и неправильная структура дополнения
- **Анализ**: Исследованы лучшие практики и современные стандарты для дополнений XenForo 2.x
- **Обнаружение**: XenForo корректно работает ТОЛЬКО с addon.json для контроля версий
**Проблема #6: Платежный провайдер не создается при новых установках (НОВЫЕ УСТАНОВКИ)**
- **Исправлено** - Платежный провайдер теперь работает корректно регистрирует данные при новых установках
- **Исправлено** - Улучшена функция installStep2() с комплексной обработкой ошибок и механизмами резервного копирования
- **Исправлено** - Добавлена функция upgrade3000800Step1() для воссоздания отсутствующего поставщика платежей для существующих установок
- **Причина** - Функция installStep2() некорректно обрабатывала крайние случаи и отсутствовало логирование ошибок
- **Влияние** - Новые установки версии 3.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 (28.11.2025) - ИСПРАВЛЕНИЕ КРИТИЧЕСКОЙ СТРУКТУРЫ ZIP-АРХИВА + ВСЕ ПРЕДЫДУЩИЕ ИСПРАВЛЕНИЯ

ПРИМЕЧАНИЕ: Для обновления дополнения замените файлы с помощью FTP или просто перезапишите дополнение через панель управления!

### ВАЖНЫЕ ИСПРАВЛЕНИЯ

**Проблема № 5: Некорректная структура архива XenForo (НОВОЕ)**
- **Исправлено** - Исправлена структура ZIP-архива, теперь он начинается с папки `CryptoPayment/` в корневом каталоге
- **Причина** - Предыдущие ZIP-архивы имели некорректную структуру: `upload/src/addons/Crypoverseaddon/CryptoPayment/`
- **Влияние** - Теперь ZIP-архив загружается успешно, больше нет ошибки «Файл, по-видимому, не является допустимым архивом дополнения»
- **Критически важно** - Без этого исправления XenForo полностью отклоняет ZIP-файл

**Проблема № 4: Дополнение не обновляется (отображается «Перестроить» вместо «Обновить»)**
- **Исправлено** - Обновлена версия в `_data/addon_info.xml` и исправлен порядок атрибутов XML
- **Причина** - XenForo использует addon_info.xml (а не только addon.json) для определения версии во время обновления
- **Влияние** - Теперь дополнение корректно обновляется с 2.5.1/3.0.4 до 3.0.7 без необходимости использования опции "Перезаписать файлы"
- **Критически важно** - Без этого исправления пользователи оставались на старых версиях даже после "обновления"
- **Подробности** - Уверено, что атрибут version_id находится перед version_string в XML

**Проблема №1: Отсутствует ошибка проверки работоспособности файла hashes.json**
- **Исправлено** - Файл hashes.json скопирован из папки `_data/` в корневую папку дополнения
- **Причина** - XenForo ожидает файл hashes.json в корневой папке дополнения, а не в подпапке _data
- **Влияние** - Проверка работоспособности файла теперь корректно работает в панели администратора XenForo

**Проблема №2: Ошибка MySQL с символами эмодзи в phrases.xml**
- **Исправлено** - Удалены все символы эмодзи из phrases.xml, вызывавшие ошибки MySQL utf8mb4
- **Ошибка** - `Некорректное строковое значение: '\xF0\x9F\x93\x9A <...' для столбца 'phrase_text'`
- **Влияние** - Установка/обновление дополнения теперь завершается без ошибок MySQL
- **Измененные фразы**:
- `option_group_cryptoPayment_explain` - Удалены эмодзи , ,
- `enter_api_key_from_crypto_platform` - Удалены эмодзи , ,

**Проблема #3: Неопределенная константа CallbackState:AYMENT_CANCELLED**
- **Исправлено** - Удалено использование Несуществующие константы XenForo
- **Ошибка** - `Неопределенная константа XF\Payment\CallbackState:AYMENT_CANCELLED`
- **Основная причина** - В XenForo 2 всего 3 константы: PAYMENT_RECEIVED, PAYMENT_REINSTATED, PAYMENT_REVERSED
- **Влияние** - Обратные вызовы веб-хуков теперь обрабатываются корректно без фатальных ошибок
- **Измененные файлы**:
- `Payment/CryptoProvider.php` (строки 634, 641, 837, 868, 875, 887)
- `Controller/CryptoPayment.php` (строки 135-138)
- `Controller/PaymentReturn.php` (строки 70-100)