Объединение товаров в вариации

# Инструкция по использованию модуля ms_combining_options

Установка

1. Убедитесь, что установлен модуль Product Variations
2. Установите модуль через раздел Модули → Скачанные модули
3. Активируйте модуль Объединение товаров в вариации
4. При установке модуль автоматически выполнит миграции базы данных

Настройка

Выбор характеристики бренда

1. Перейдите в Модули → Скачанные модули → Объединение товаров в вариации
2. Выберите Характеристика бренд из списка расширенных характеристик
3. Сохраните настройки

Важно: После выбора характеристики бренда в настройках вариантов этой характеристики появится поле "Формат объединения товаров".

Настройка форматов объединения для брендов

1. Перейдите в Товары → Характеристики → Редактирование
2. Найдите выбранную характеристику бренда
3. Для каждого варианта бренда настройте Формат объединения товаров:

• Не объединять - товары этого бренда не будут объединяться
• Последние два символа - товары объединяются по последним двум символам артикула
• Символы после последнего дефиса - товары объединяются по символам после последнего дефиса в артикуле
• 0000.00.0.XXX.000.0 - товары объединяются по специальному формату

1. Сохраните настройки

Настройка cron-ссылки

1. Перейдите в настройки модуля
2. Заполните поле Ключ безопасности (по умолчанию: ms_combining_options)
3. Сохраните настройки
4. После сохранения в настройках модуля отобразится Cron ссылка для запуска алгоритма объединения

Использование

Запуск объединения товаров

1. Через cron-ссылку:

• Скопируйте cron-ссылку из настроек модуля
• Откройте ссылку в браузере или добавьте в cron:

`

0 3 * * * curl "https://your-site.com/index.php?dispatch=ms_combining_options.combine&secret_key=YOUR_SECRET_KEY"

`

1. Результат выполнения:

• Модуль обработает все товары с настроенными форматами объединения
• Товары будут сгруппированы в вариации согласно выбранным форматам
• Отобразится сообщение о количестве объединённых товаров

Проверка результатов

1. Перейдите в Товары → Товары
2. Найдите товары, которые должны были быть объединены
3. Проверьте, что товары объединены в вариации:

• Товары с одинаковым значением формата должны быть в одной вариации
• Вариация должна содержать все товары с одинаковым форматом

Импорт/Экспорт

Модуль не поддерживает импорт/экспорт данных. Настройки форматов объединения хранятся в базе данных CS-Cart.

Тестирование

1. Настройте модуль:

• Выберите характеристику бренда
• Настройте форматы объединения для нескольких брендов
• Заполните ключ безопасности

1. Подготовьте тестовые товары:

• Создайте несколько товаров с разными артикулами
• Назначьте им разные бренды с настроенными форматами

1. Запустите алгоритм объединения:

• Откройте cron-ссылку или выполните через cron
• Проверьте сообщение о результате выполнения

1. Проверьте результаты:

• Убедитесь, что товары объединены в вариации
• Проверьте корректность группировки по форматам

Обслуживание

Обновление модуля

1. Обновление модуля выполняется стандартным способом через раздел Модули → Скачанные модули
2. При обновлении модуль может выполнить дополнительные миграции базы данных
3. Проверьте, что настройки модуля не изменились после обновления

Удаление модуля

При удалении модуля:

• Все настройки модуля удаляются
• Настройки форматов объединения в вариантах характеристик остаются (не удаляются автоматически)
• Объединённые товары остаются в вариациях
• Cron-ссылка перестаёт работать

Ключевые файлы

• func.php - основные функции модуля (установка, миграции, получение вариантов характеристик)
• controllers/common/ms_combining_options.php - контроллер для запуска алгоритма объединения
• schemas/ms_combining_options/article_formats.php - схема форматов объединения
• upgrades/migrations/ - файлы миграций базы данных
• design/backend/templates/addons/ms_combining_options/settings/cron_link.tpl - шаблон настроек cron
• addon.xml - конфигурация модуля
• var/langs/ru/addons/ms_combining_options.po - языковые файлы