Инструкция к модулю Объединение товаров в вариации

Модуль группирует отдельные товары в штатные группы вариаций CS-Cart по общей части артикула. Правило обработки артикула задаётся отдельно для каждого варианта выбранной характеристики бренда. Группировку можно запустить вручную из настроек модуля или автоматически по cron.

Что делает модуль

При запуске модуль находит товары, которым назначен вариант выбранной характеристики бренда с заполненным форматом объединения. Для каждого артикула он рассчитывает ключ группировки по заданному правилу. Если одинаковый ключ получили не менее двух товаров, модуль создаёт для них группу вариаций через штатный механизм «Вариации товаров».

Если среди совпавших товаров уже есть товар из группы вариаций, модуль добавляет найденные товары в существующую группу. Товары с пустым артикулом, без выбранного формата или с форматом «Не объединять» пропускаются.

Где находится модуль

• Модули → Скачанные модули → Объединение товаров в вариации → Настройки — выбор характеристики бренда, ключ безопасности, кнопка ручного запуска и команда для cron.
• Товары → Характеристики → выбранная характеристика бренда → Варианты — поле Формат объединения товаров у каждого варианта характеристики.
• Товары → Товары — карточки обработанных товаров и созданные штатные группы вариаций.

Перед первым запуском

Модуль использует штатную функциональность «Вариации товаров». Подготовьте товары как отдельные позиции, заполните их артикулы и назначьте каждому товару вариант характеристики бренда. Убедитесь, что выбранные товары можно объединить штатными средствами «Вариаций товаров»: модуль передаёт им создание и расширение групп и не отменяет их ограничения.

Настройка модуля

1. Выберите характеристику бренда

1. Откройте настройки модуля.
2. В поле Характеристика бренд выберите активную расширенную характеристику, варианты которой назначены товарам как бренды.
3. Сохраните настройки.

В списке доступны только активные расширенные характеристики; в селекте отображаются их внутренние названия. Поле Формат объединения товаров показывается только у вариантов характеристики, которая выбрана в настройках модуля. Если позднее выбранную характеристику отключить или удалить, запуск завершится сообщением о недоступном бренде.

Кнопка Запустить группировку товаров появляется в настройках после выбора характеристики. Сформированная команда в блоке Cron ссылка отображается после заполнения ключа безопасности.

2. Задайте формат для каждого варианта бренда

1. Перейдите в раздел Товары → Характеристики.
2. Откройте характеристику, выбранную в настройках модуля.
3. Для каждого нужного варианта бренда выберите значение в поле Формат объединения товаров.
4. Сохраните характеристику.

Формат определяет, какую часть артикула модуль считает изменяемой. После её исключения оставшаяся часть становится ключом группировки.

Названия форматов задаются у вариантов бренда, но итоговая группа определяется рассчитанным ключом артикула. Если у товаров разных брендов получится одинаковый ключ, они могут попасть в одну группу. Используйте схемы артикулов, которые не дают таких пересечений.

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

3. Настройте ключ безопасности

1. В настройках модуля заполните поле Ключ безопасности. Вместо значения по умолчанию рекомендуется использовать собственную длинную случайную строку.
2. Сохраните настройки.
3. После сохранения скопируйте сформированную команду из блока Cron ссылка.

В cron передаётся не сам ключ, а его хеш в параметре --hash. Не публикуйте сформированную команду: она разрешает запуск группировки. Если команда стала доступна посторонним или ключ был изменён, сохраните новое значение ключа и заново скопируйте команду.

Ручной запуск группировки

1. Убедитесь, что выбрана характеристика бренда и для нужных её вариантов заданы форматы.
2. В настройках модуля нажмите Запустить группировку товаров.
3. Дождитесь уведомления CS-Cart. При успешной обработке в нём будет указано количество объединённых товаров.

Один запуск обрабатывает все товары каталога, у которых есть непустой артикул и вариант выбранной характеристики с заданным форматом. Отдельного фильтра по категории, статусу товара, продавцу или витрине модуль не предоставляет. В Multi-Vendor и Ultimate заранее учитывайте этот охват всего каталога. Группа создаётся только для ключа, по которому найдено не менее двух товаров.

Автоматический запуск по cron

1. Скопируйте всю команду из блока Cron ссылка в настройках модуля.
2. Добавьте её в планировщик cron на сервере магазина.
3. При необходимости измените только расписание в начале строки, сохранив PHP-команду, путь, параметр --dispatch=ms_combining_options.combine и сформированный --hash.

Команда, которую показывает модуль, запускается ежедневно в 04:00 по времени сервера: она начинается с 0 4 * * *. В ней уже указаны версия PHP CLI, путь к корню магазина и имя клиентского скрипта. Используйте именно сформированную для текущего магазина команду.

Как проверить работу

1. Выберите один вариант характеристики бренда и назначьте ему формат Последние два символа.
2. Подготовьте два тестовых товара с этим вариантом характеристики и артикулами MODEL-01 и MODEL-02.
3. Запустите группировку вручную.
4. Проверьте уведомление об успешной обработке.
5. Откройте один из тестовых товаров в разделе Товары → Товары и убедитесь, что оба товара входят в одну штатную группу вариаций.
6. Добавьте контрольный товар с другим ключом или с форматом Не объединять и убедитесь, что он не попал в эту группу.

Что важно учитывать при повторных запусках

• Модуль создаёт новые группы и добавляет товары в существующие, но не разделяет и не удаляет уже созданные группы.
• Изменение формата у варианта бренда не отменяет результат предыдущей обработки. Ошибочно созданную группу нужно скорректировать штатными средствами «Вариаций товаров».
• Для объединения нужны как минимум два товара с одинаковым рассчитанным ключом.
• Пустой артикул, отсутствующий дефис для соответствующего правила или артикул неправильной точечной структуры приводят к пропуску товара.
• Проверяйте уникальность ключей между брендами: значение самого бренда отдельно в ключ группировки не добавляется.

Типовые сообщения и проверка настроек

• Не задана «Характеристика бренд». Выберите характеристику в настройках модуля и сохраните изменения.
• Бренд не найден или находится не во включённом состоянии. Проверьте, что выбранная характеристика существует и активна, либо выберите другую активную расширенную характеристику.
• Не найдено ни одного товара с допустимым вариантом формата. Назначьте форматы вариантам выбранной характеристики и проверьте, что эти варианты назначены товарам.
• Не найдено необходимое количество товаров. Проверьте артикулы: после применения правила не менее двух товаров должны получить полностью одинаковый ключ.
• Товары не были объединены. Проверьте структуру артикулов, существующие группы и возможность объединить эти товары штатными средствами «Вариаций товаров».
• Команда cron перестала запускать обработку. Если ключ безопасности менялся, скопируйте новую команду; также проверьте доступность указанной версии PHP CLI и права пользователя cron на запуск клиентского скрипта магазина.