Імпорт / Експорт товарів XLSX і CSV для OpenCart 3

Модуль Product Import/Export додає до OpenCart комплексний набір інструментів для пакетного імпорту та експорту каталогу у форматах XLSX і CSV.

Розширення працює не лише з основними полями товарів, а й з мультимовним контентом, характеристиками, фільтрами, стандартними опціями OpenCart, зображеннями, категоріями, виробниками, SEO URL та метаданими.

Окремі майстри імпорту, зіставлення стовпців, попередня перевірка довідникових значень, пакетна обробка, історія файлів і профілі експорту дають змогу безпечніше працювати як із невеликими таблицями, так і з великими каталогами.

Як працює модуль

1. Адміністратор завантажує файл XLSX або CSV
2. Для XLSX вибирає потрібний аркуш
3. Вибирає режим імпорту, ідентифікатор товару та додаткові параметри
4. Зіставляє стовпці файла з полями OpenCart
5. Перевіряє невідомі характеристики, фільтри, опції та їх значення
6. Запускає пакетну обробку та бачить прогрес виконання
7. За потреби повторно відкриває файл з історії, змінює параметри й запускає імпорт ще раз

Що вміє модуль

• Імпортувати та експортувати дані у форматах XLSX і CSV
• Створювати нові товари та оновлювати наявні
• Працювати за product_id, model, sku, upc, ean, jan, isbn або mpn
• Імпортувати основні, мультимовні та SEO-поля товару
• Імпортувати характеристики, контент, фільтри й стандартні опції OpenCart окремими майстрами
• Автоматично створювати або вручну зіставляти відсутні характеристики, фільтри, опції та значення
• Пакетно імпортувати основні й додаткові зображення
• Генерувати ідентифікатори, SEO URL і метадані за налаштованими масками
• Фільтрувати товари перед експортом
• Зберігати й повторно використовувати профілі експорту
• Експортувати довідники OpenCart з ID та мультимовними назвами
• Завантажувати готові XLSX-шаблони для кожного типу імпорту
• Зберігати історію завантажених файлів і параметри імпорту
• Обробляти великі файли пакетами через послідовні AJAX-запити
• Працювати з додатковими полями бази даних та полями ocStore
• Окремо налаштовувати видимість полів імпорту та експорту

Імпорт товарів

Майстер імпорту товарів підтримує три режими: створення та оновлення, лише створення або лише оновлення. Для кожного стовпця можна вибрати відповідне поле OpenCart або залишити його без імпорту.

Доступні основні поля каталогу: ідентифікатори, модель, SKU, коди товару, розташування, кількість, статус відсутності, виробник, ціна, бали, податковий клас, дата надходження, вага, габарити, мінімальна кількість, віднімання зі складу, статус, порядок сортування, категорії, магазини, зображення та інші стандартні дані OpenCart.

Поля назва, опис, теги, Meta Title, Meta Description, Meta Keywords, Meta H1 і SEO URL зіставляються окремо для кожної мови магазину.

Товар можна шукати за product_id, model, sku, upc, ean, jan, isbn або mpn. Якщо вибраний ідентифікатор відсутній у нового товару, модуль може створити його за маскою, наприклад K-{number:6}.

Категорії, виробники та магазини

• Пошук виробника за ID або назвою
• Пошук категорій за ID або повним шляхом
• Декілька категорій в одній комірці через налаштований роздільник
• Заміна категорій товару або додавання до наявних
• Автоматичне додавання батьківських категорій
• Категорія та виробник за замовчуванням із пріоритетом над даними файла
• Прив’язка товару до одного або декількох магазинів
• Підтримка main_category для сумісних збірок ocStore

Імпорт характеристик

Характеристики імпортуються окремим майстром. ID характеристики зазначається у квадратних дужках у заголовку стовпця, наприклад: ОЗУ[12] UA.

• Підтримка одного або декількох мовних стовпців
• Послідовне розміщення мов для кожної характеристики
• Режими заміни, додавання відсутніх і оновлення з файла
• Автоматичне зіставлення за ID та назвою
• Можливість ігнорувати невідому характеристику, створити нову або зіставити з наявною

Імпорт контенту

Окремий майстер призначений для мультимовного оновлення назв, описів, тегів і метаданих без зміни інших даних товару.

HTML-розмітка, апострофи, лапки та переноси рядків зберігаються як вміст комірки. Доступні режими повної заміни, заповнення лише порожніх полів та оновлення непорожніми значеннями з файла.

Імпорт фільтрів

Фільтри прив’язуються до товарів окремими рядками. Групу та значення фільтра можна передавати за ID або назвою.

• Заміна всіх фільтрів товару
• Синхронізація лише груп, присутніх у файлі
• Додавання без видалення наявних зв’язків
• Ігнорування, створення або ручне зіставлення невідомих фільтрів

Імпорт стандартних опцій OpenCart

Модуль імпортує стандартні опції та значення опцій OpenCart: тип, обов’язковість, кількість, віднімання зі складу, ціну, бали, вагу, префікси коригування та значення для текстових і календарних типів.

• Заміна всіх опцій товару
• Синхронізація лише опцій, присутніх у файлі
• Додавання та оновлення без видалення інших опцій
• Створення або ручне зіставлення відсутніх опцій і значень

Модуль працює зі штатною моделлю опцій OpenCart і не створює залежні комбінації між декількома опціями.

Імпорт зображень

Зображення завантажуються групою. Ідентифікатор товару та порядок зображень визначаються з назви файла за налаштованим роздільником.

• Окремий вибір поля пошуку: model, sku, upc, ean, jan, isbn або mpn
• Налаштування правила визначення головного зображення
• Ігнорування, заповнення порожнього або заміна головного зображення
• Ігнорування, доповнення або повна заміна галереї
• Вибір каталогу зберігання всередині директорії image
• Очищення кешу замінених зображень
• Опційне видалення старих файлів після перевірки стандартних посилань OpenCart

Приклад: SKU001.jpg — головне зображення, SKU001@2.jpg і SKU001@3.jpg — додаткові.

SEO URL і метадані

SEO-дані можна імпортувати безпосередньо з файла або формувати під час імпорту товарів за масками.

• Режими: не генерувати, заповнювати лише порожні або перезаписувати
• Окремі маски для SEO URL, Meta Title, Meta Description, Meta Keywords і Meta H1
• Макроси товару, виробника, категорії, ціни та назви магазину
• Автоматична транслітерація URL
• Перевірка унікальності з додаванням суфіксів -1, -2 та далі
• Налаштування однакових або окремих URL для різних мов

Експорт даних

Експорт працює пакетно та формує окремі файли для товарів, характеристик, контенту, фільтрів і стандартних опцій.

• Формати XLSX і CSV
• Вибір потрібних основних і мультимовних полів
• Вибір мов експорту
• Категорії як ID або повний шлях
• Усі характеристики довідника або лише характеристики відібраних товарів
• Фільтрація за категоріями, виробниками, статусом, залишком, ціною, датою створення, датою зміни та магазином
• Довідкові стовпці з назвою товару, виробником і категоріями в експорті характеристик, фільтрів та опцій
• Збереження, завантаження та видалення профілів експорту

Описи експортуються з вихідною HTML-розміткою. Фізичні файли зображень не копіюються — до таблиці потрапляють їхні шляхи.

Експорт довідників

Для підготовки таблиць і правильного зіставлення можна окремо експортувати:

• Групи характеристик і характеристики
• Категорії та виробників
• Опції та значення опцій
• Групи фільтрів і фільтри
• Статуси наявності та податкові класи
• Одиниці ваги й довжини

Шаблони та аркуші XLSX

Для кожного майстра імпорту доступне завантаження XLSX-шаблону з актуальними назвами стовпців. Шаблони враховують мови магазину, видимість полів, додаткові поля бази та наявні ID характеристик.

Якщо книга XLSX містить декілька аркушів, перед зіставленням можна вибрати аркуш із потрібними даними.

Історія імпорту

Завантажені файли товарів, характеристик, контенту, фільтрів та опцій зберігаються у захищеному сховищі разом із параметрами операції.

Файл можна відкрити повторно, вибрати інший аркуш, змінити режим, мови або зіставлення та запустити імпорт ще раз. Історію можна фільтрувати за типом імпорту.

Видимість і додаткові поля

У налаштуваннях можна незалежно приховати непотрібні поля імпорту та експорту, щоб скоротити форми до робочого набору. Поточний ідентифікатор товару завжди залишається доступним.

Модуль сканує додаткові скалярні стовпці таблиць product і product_description. Адміністратор задає зрозумілу назву та окремо дозволяє їх імпорт і/або експорт.

За фактичної наявності відповідних стовпців підтримуються поля ocStore noindex, meta_h1 і main_category.

Пакетна обробка та продуктивність

• Імпорт та експорт виконуються частинами через послідовні AJAX-запити
• Розмір пакета налаштовується в адміністративній частині
• Прогрес відображається без перезавантаження сторінки
• Для XLSX читається лише потрібний діапазон рядків
• Експорт не накопичує весь каталог у пам’яті
• Характеристики можна обмежити фактично використаними у відібраних товарах

Перевірка та безпека даних

• Перевірка обов’язкових стовпців і параметрів до запуску
• Перевірка числових значень, статусів, дат і префіксів
• Зупинка небезпечного рядка, якщо ідентифікатор не знайдено або він не унікальний
• Повідомлення з номером рядка та причиною помилки
• Захист від небезпечних шляхів під час імпорту зображень
• Штатне розділення прав access і modify для кожного розділу

Перед масовим імпортом або режимом заміни рекомендується створити резервну копію бази даних і каталогу image та перевірити файл на декількох товарах.

Адміністративна частина

Модуль створює окремий розділ «Імпорт/Експорт товарів» у лівому меню OpenCart:

• Імпорт товарів
• Імпорт характеристик
• Імпорт контенту
• Імпорт фільтрів
• Імпорт опцій
• Імпорт зображень
• Експорт
• Експорт довідників
• Історія імпорту
• Налаштування та вбудований довідник

Відкритий код і незалежність

Код модуля не закодований і не обфускований. PHP-, Twig-, JavaScript- та XML-файли доступні для перегляду й редагування.

Для роботи з таблицями використовується локально встановлена бібліотека PhpSpreadsheet 5.8.1. Модуль не завантажує її із зовнішніх CDN під час роботи.

Системні вимоги

• OpenCart 3.0.3.x
• PHP 8.1–8.5
• PhpSpreadsheet 5.8.1 із комплекту модуля
• PHP-розширення ctype, dom, fileinfo, filter, gd, iconv, libxml, mbstring, SimpleXML, xml, xmlreader, xmlwriter, zip і zlib
• Права на запис до каталогів завантаження, історії імпорту та image

Встановлення

1. Встановіть архів бібліотеки PhpSpreadsheet через Extensions / Installer
2. Встановіть основний архів Product Import/Export через Extensions / Installer
3. Перейдіть у Extensions / Modifications та оновіть кеш модифікаторів
4. У групі користувачів адміністратора надайте права access і modify для потрібних маршрутів product_import
5. Відкрийте розділ «Імпорт/Експорт товарів → Налаштування»
6. Перевірте системні вимоги та збережіть робочі параметри

Службові таблиці перевіряються та створюються автоматично під час відкриття сторінки налаштувань. Окрема установка модуля у списку Extensions / Modules не потрібна.

Важливі примітки

• Імпорт не замінює резервне копіювання
• Вже оброблені пакети не відкочуються після закриття або скасування сторінки
• Порожня зіставлена комірка може очистити поле в режимі заміни
• Не запускайте одночасно дві операції одного типу в одній адміністративній сесії
• XLSX має обмеження 32767 символів в одній комірці; для довгих HTML-описів використовуйте CSV
• Фізичне видалення старих зображень є незворотним
• Додаткові поля сторонніх модулів потрібно вмикати лише після перевірки допустимого формату їх значень

Ліцензія

Ліцензія поширюється на один домен і його піддомени.