Перейти к основному содержимому
Версия: 3.0.7

Копирование/восстановление настроек

Начиная с текущей версии модуля, добавлена возможность экспорта и импорта настроек.
Функция позволяет быстро переносить конфигурацию между магазинами, делать резервные копии перед экспериментами и восстанавливать рабочее состояние после изменений.

Settings Backup Tab
Вкладка резервного копирования настроек

Где находится

Функция доступна во вкладке:

Настройки → Конфигурация

Интерфейс разделен на два блока:

  • Экспорт настроек
  • Восстановление настроек

Экспорт (сохранение) настроек

Экспорт создает JSON-файл со всеми текущими настройками модуля.

Как выполнить экспорт:

  1. Откройте вкладку Резервное копирование.
  2. Нажмите кнопку Сохранить настройки.
  3. Браузер автоматически скачает файл настроек.

Имя файла формируется автоматически и содержит временную метку, например:

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-файла и перезаписывает текущую конфигурацию модуля.

Settings Restore
Выбор файла и восстановление настроек

Как выполнить восстановление:

  1. Нажмите кнопку выбора файла.
  2. Выберите JSON-файл резервной копии.
  3. Нажмите Восстановить настройки.
  4. Подтвердите операцию.
  5. После успешного восстановления страница будет автоматически перезагружена.
внимание

Восстановление перезаписывает текущие настройки модуля.
Рекомендуется предварительно сделать резервную копию.


Выбор файла

Для выбора файла используется стандартный системный диалог выбора файла:

  • в Windows — Проводник Windows
  • в Linux — файловый менеджер окружения
  • в macOS — Finder

Поддерживаются только файлы формата:

*.json

Если файл не выбран или имеет неверный формат — восстановление не будет выполнено.


Проверки совместимости при восстановлении

При импорте выполняются автоматические проверки:

  • соответствие имени модуля
  • корректность JSON
  • непустой набор настроек
  • поддержка старого формата (обратная совместимость)

Если файл создан другим модулем — восстановление будет отклонено.


Обратная совместимость

Поддерживаются два формата резервных копий:

  • ✅ новый формат — с блоком meta
  • ✅ старый формат — только настройки без метаданных

Это позволяет восстанавливать архивы, созданные предыдущими версиями модуля.


Особенности хранения данных

Некоторые внутренние поля настроек хранятся в сериализованном виде.
При экспорте они автоматически преобразуются в JSON-структуры, а при восстановлении — корректно сериализуются обратно. Это обеспечивает:

  • читаемый файл резервной копии
  • корректное восстановление сложных структур
  • переносимость между версиями

Рекомендуемые сценарии использования

Рекомендуется использовать резервное копирование:

  • перед обновлением модуля
  • перед массовым изменением настроек
  • при переносе магазина
  • при настройке нескольких магазинов с одинаковой конфигурацией
  • для тестовых стендов