Импорт товаров в Market PRO из CSV и Excel в Cotonti
Профессиональное руководство по плагину marketproductsimport
Данная статья представляет собой подробный обзор и руководство по использованию плагина marketproductsimport, предназначенного для импорта товарных позиций в модуль Market PRO CMS Cotonti. Материал ориентирован на администраторов сайтов, владельцев маркетплейсов и технических специалистов, которые используют Cotonti в качестве платформы для коммерческих проектов и нуждаются в массовом управлении товарными данными.
Статья описывает назначение плагина, его архитектурную логику, реализованные возможности, ограничения и принципы работы. Все выводы основаны исключительно на анализе фактической реализации плагина. В тексте отсутствуют предположения, нереализованные функции и гипотетические сценарии.
Общая концепция плагина
Плагин marketproductsimport решает практическую задачу массового импорта товаров в Market PRO без ручного создания позиций через административный интерфейс. Он предназначен для ситуаций, когда каталог товаров уже существует в виде таблицы Excel или CSV-файла и требуется перенести эти данные в систему Cotonti с сохранением структуры, категорий, цен и текстовых описаний.
Плагин работает строго в административной части CMS и не оказывает влияния на публичную часть сайта. Его использование предполагает наличие прав администратора или пользователя с разрешением на запись в плагины.
Поддерживаемые форматы и источники данных
Импорт осуществляется из файлов двух типов:
Формат файла определяется по расширению. Поддержка других форматов отсутствует. Проверка формата является обязательным этапом перед любой обработкой данных. Файл с неподдерживаемым расширением не будет принят системой.
Общий сценарий работы
Работа с плагином строится по пошаговой модели, исключающей случайный или неконтролируемый импорт данных. Пользователь последовательно проходит несколько логических этапов:
- Загрузка файла с данными
- Анализ структуры файла
- Сопоставление колонок файла с полями базы данных
- Запуск процесса импорта
- Завершение и очистка временных данных
Каждый этап строго отделён от предыдущего, что снижает риск ошибок и даёт администратору полный контроль над процессом.
Административный интерфейс
Плагин интегрируется в стандартный административный раздел Cotonti и доступен через раздел инструментов. Интерфейс плагина не перегружен дополнительными элементами и выполняет только одну задачу — управление процессом импорта.
В зависимости от текущего состояния сессии администратору отображается либо форма загрузки файла, либо форма сопоставления полей. Одновременное отображение обоих этапов исключено.
Загрузка файла
На первом этапе администратор загружает файл с локального компьютера. После загрузки файл сохраняется во внутреннем каталоге плагина. Имя файла принудительно уникализируется, что исключает конфликты при повторных загрузках и параллельной работе.
Файл не импортируется сразу после загрузки. Сначала система анализирует его структуру и извлекает заголовки колонок. Это позволяет плагину корректно подготовить следующий этап — маппинг.
Если файл повреждён, имеет неподдерживаемый формат или не может быть прочитан, процесс останавливается, а файл удаляется.
Анализ структуры файла
После успешной загрузки система считывает первую строку файла и интерпретирует её как список заголовков столбцов. Эти заголовки используются исключительно как идентификаторы колонок для сопоставления с полями базы данных Market PRO.
Если в файле отсутствуют заголовки или отдельные ячейки первой строки пусты, такие колонки помечаются как недоступные для маппинга.
Сопоставление полей (маппинг)
Ключевая особенность плагина — гибкий маппинг. Администратор самостоятельно определяет, какие колонки файла соответствуют каким полям таблицы Market PRO.
Для каждого поля базы данных доступен выбор:
- назначить конкретную колонку из файла;
- исключить поле из импорта.
Это позволяет использовать файлы с любой структурой и любым порядком колонок, не требуя строгого соответствия формату Market PRO.
Импорт не может быть запущен, если не выбрано ни одного соответствия. Это исключает пустые или ошибочные операции.
Используемые поля Market PRO
Плагин работает только с теми полями, которые реально существуют в таблице market в текущей базе данных. Перед импортом система анализирует структуру таблицы и автоматически исключает несуществующие поля из обработки.
Таким образом, плагин корректно работает с кастомизированными или изменёнными версиями Market PRO, не вызывая ошибок базы данных.
Принципы обработки данных
Во время импорта каждая строка файла обрабатывается независимо от других. Ошибка в одной строке не останавливает процесс целиком.
Для всех записей используются значения по умолчанию, если конкретное поле не было сопоставлено или отсутствует в файле. Эти значения задаются на уровне логики плагина и применяются только к существующим полям таблицы.
Работа с датами
Все поля, которые интерпретируются как даты, приводятся к единому формату времени Unix. Плагин корректно обрабатывает как числовые значения дат Excel, так и строковые представления дат.
Если дата не распознана, используется текущее системное время.
Работа с ценами
Ценовые поля обрабатываются с приведением к числовому формату. Десятичные разделители нормализуются. В итоговой записи сохраняется значение с фиксированным количеством знаков после запятой.
Плагин не выполняет валютных конверсий и не интерпретирует валюту — он работает только с числовыми значениями.
Обработка текстовых данных
Для текстовых полей реализована дополнительная очистка содержимого. При включённой настройке плагин автоматически удаляет:
- HTML-ссылки
- JavaScript-код
- прямые URL
- потенциально небезопасные атрибуты
Очистка применяется только к тем полям, которые явно относятся к текстовому контенту.
Обязательные условия импорта
Строка данных не будет импортирована, если отсутствуют обязательные значения:
- категория товара
- заголовок товара
Это правило действует независимо от настроек и защищает базу данных от некорректных или неполных записей.
Автоматическое заполнение описаний
Если текстовое описание товара отсутствует, но заголовок указан, плагин автоматически использует заголовок в качестве текстового содержимого. Это позволяет избежать пустых описаний в каталоге.
Ограничение количества строк
Плагин поддерживает ограничение количества импортируемых строк за одну операцию. Это позволяет безопасно тестировать импорт на небольших выборках и предотвращает перегрузку сервера при работе с большими файлами.
Контроль прогресса
Во время импорта плагин отслеживает количество обработанных строк и общее количество строк, подлежащих импорту. Эти данные хранятся в сессии и могут использоваться для отображения прогресса.
Логирование
Плагин поддерживает детальное логирование всех ключевых этапов:
- загрузка файла
- чтение заголовков
- параметры маппинга
- обработка каждой строки
- ошибки и исключения
- итоговый результат
Логирование включается и отключается через конфигурацию и предназначено для диагностики и аудита.
Завершение импорта
После завершения импорта:
- временный файл удаляется;
- данные сессии очищаются;
- администратор получает итоговое сообщение с количеством успешно добавленных записей.
Повторный импорт возможен только после новой загрузки файла.
Ограничения плагина
Плагин сознательно не реализует следующие функции:
- обновление существующих товаров;
- поиск дубликатов;
- откат импорта;
- фоновую обработку;
- автоматическую привязку категорий.
Это не недостатки, а осознанные архитектурные решения, обеспечивающие предсказуемость и безопасность работы.
Итоговая оценка
Плагин marketproductsimport — это инструмент контролируемого, прозрачного и безопасного импорта товаров в Market PRO. Он не пытается быть универсальным комбайном и решает строго одну задачу: корректно перенести данные из табличного файла в структуру Cotonti с минимальным риском ошибок.
Он подходит для профессионального использования в административной среде и хорошо вписывается в философию Cotonti как модульной и управляемой CMS.
