MS: Cross товары

Описание

Модуль ms_cross реализует функциональность подбора аналогов (cross-товаров) для товаров. Модуль позволяет находить и отображать аналогичные товары от разных продавцов на основе различных критериев (бренд, артикул производителя, cross-артикул и т.д.).

Основные возможности

• Подбор аналогов: Автоматический подбор аналогов товаров на основе различных критериев
• Вкладка на странице товара: Добавляет вкладку "Cross товары" на странице товара с отображением аналогов
• Генерация связей: Возможность автоматической генерации cross-связей между товарами через cron
• Фильтрация по бренду: Фильтрация аналогов по бренду товара
• Работа с мультивендор: Поддержка отображения аналогов от разных продавцов
• Работа с master products: Корректная работа с товарами-вариантами (vendor products)

Как работает модуль

Модуль использует следующие механизмы:

1. База данных (func.php): При установке модуль создает таблицу ms_cross_product_links для хранения связей между товарами.

1. Генерация связей (func.php):

• fn_ms_cross_get_cross_product_ids_by_product_id() - получает список связанных товаров для товара
• fn_ms_cross_get_product_cross_id() - проверяет наличие cross-связи для товара
• fn_ms_cross_delete_product_from_cross() - удаляет товар из cross-связи

1. Отображение аналогов (controllers/frontend/products.post.php):

• На странице товара модуль определяет связанные товары
• Отображает их во вкладке "Cross товары" с пагинацией
• Поддерживает фильтрацию по бренду и другим параметрам

1. Поиск товаров (hooks.func.php):

• fn_ms_cross_get_products() - модифицирует запрос поиска товаров для учета cross-связей
• Поддерживает фильтрацию по бренду, артикулу производителя, cross-артикулу
• Работает с мультивендор, исключая ограничения по продавцам при поиске аналогов

1. Генерация через cron (controllers/common/ms_cross.php): Модуль предоставляет контроллер для автоматической генерации cross-связей через cron-задачу с использованием security hash.

1. Настройки модуля:

• items_per_page - количество товаров на странице во вкладке Cross товары
• image_size - размер изображений товаров
• brand_feature_id - ID характеристики бренда для фильтрации
• company_city_field - поле профиля продавца для отображения города
• security_hash - хэш безопасности для доступа к cron-контроллерам

Где находится функциональность

• Административная панель:
• Настройки модуля (количество товаров, размер изображений, характеристика бренда, поле города продавца, security hash)
• Страница товара с возможностью управления cross-связями
• Кнопки генерации cross-связей
• Cron-ссылка для автоматической генерации
• Витрина:
• Вкладка "Cross товары" на странице товара
• Отображение аналогов с информацией о продавцах

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

• Количество элементов (items_per_page): Количество товаров, отображаемых на странице во вкладке "Cross товары"
• Высота/ширина изображения (image_size): Размер изображений товаров во вкладке Cross товары
• Характеристика бренд (brand_feature_id): ID характеристики товара, содержащей бренд (для фильтрации аналогов)
• Город продавца (company_city_field): Поле профиля продавца, содержащее город (для отображения на витрине)
• Хэш безопасности (security_hash): Хэш для доступа к контроллерам по cron-ссылке

Технические детали

• Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
• При установке выполняет миграции для создания таблицы ms_cross_product_links
• Поддерживает работу с master products и vendor products
• Интегрируется с системой поиска товаров CS-Cart
• Использует AJAX для динамической загрузки аналогов
• Поддерживает пагинацию для больших списков аналогов
• Работает с различными типами артикулов (артикул производителя, cross-артикул, артикул маркетплейса, артикул продавца)