Копирование/восстановление настроек
Начиная с текущей версии модуля, добавлена возможность экспорта и импорта настроек.
Функция позволяет быстро переносить конфигурацию между магазинами, делать резервные копии перед экспериментами и восстанавливать рабочее состояние после изменений.
![]() |
|---|
| Вкладка резервного копирования настроек |
Где находится
Функция доступна во вкладке:
Настройки → Конфигурация
Интерфейс разделен на два блока:
- Экспорт настроек
- Восстановление настроек
Экспорт (сохранение) настроек
Экспорт создает JSON-файл со всеми текущими настройками модуля.
Как выполнить экспорт:
- Откройте вкладку Резервное копирование.
- Нажмите кнопку Сохранить настройки.
- Браузер автоматически скачает файл настроек.
Имя файла формируется автоматически и содержит временную метку, например:
attributipro_settings_2026-02-06T09-41-22.json
Для сохранения используется стандартный механизм загрузки файла браузером.
Файл попадает в папку загрузок, настроенную в вашей системе.
Что содержится в файле резервной копии
Файл резервной копии имеет формат JSON и содержит:
- все настройки модуля
- служебные метаданные
- версию модуля
- версию OpenCart
- дату создания копии
Пример структуры:
{
"meta": {
"module": "attributipro",
"version": "x.x.x",
"created_at": "YYYY-MM-DD HH:MM:SS",
"opencart_version": "x.x.x.x"
},
"settings": {
"...": "..."
}
}
Метаданные используются для проверки совместимости при восстановлении.
Восстановление настроек
Восстановление загружает настройки из ранее сохраненного JSON-файла и перезаписывает текущую конфигурацию модуля.
![]() |
|---|
| Выбор файла и восстановление настроек |
Как выполнить восстановление:
- Нажмите кнопку выбора файла.
- Выберите JSON-файл резервной копии.
- Нажмите Восстановить настройки.
- Подтвердите операцию.
- После успешного восстановления страница будет автоматически перезагружена.
Восстановление перезаписывает текущие настройки модуля.
Рекомендуется предварительно сделать резервную копию.
Выбор файла
Для выбора файла используется стандартный системный диалог выбора файла:
- в Windows — Проводник Windows
- в Linux — файловый менеджер окружения
- в macOS — Finder
Поддерживаются только файлы формата:
*.json
Если файл не выбран или имеет неверный формат — восстановление не будет выполнено.
Проверки совместимости при восстановлении
При импорте выполняются автоматические проверки:
- соответствие имени модуля
- корректность JSON
- непустой набор настроек
- поддержка старого формата (обратная совместимость)
Если файл создан другим модулем — восстановление будет отклонено.
Обратная совместимость
Поддерживаются два формата резервных копий:
- ✅ новый формат — с блоком
meta - ✅ старый формат — только настройки без метаданных
Это позволяет восстанавливать архивы, созданные предыдущими версиями модуля.
Особенности хранения данных
Некоторые внутренние поля настроек хранятся в сериализованном виде.
При экспорте они автоматически преобразуются в JSON-структуры, а при восстановлении — корректно сериализуются обратно. Это обеспечивает:
- читаемый файл резервной копии
- корректное восстановление сложных структур
- переносимость между версиями
Рекомендуемые сценарии использования
Рекомендуется использовать резервное копирование:
- перед обновлением модуля
- перед массовым изменением настроек
- при переносе магазина
- при настройке нескольких магазинов с одинаковой конфигурацией
- для тестовых стендов

