Модуль ProductImagesImporter для OkayCMS

Модуль дозволяє масово завантажувати фото товарів у магазин: окремими файлами або ZIP-архівом. Фото можна просто зберегти на сервері або одразу прикріпити до товарів за SKU чи ID у назві файлу.

Можливості

Масове завантаження фото

• Підтримка форматів: JPG, PNG, GIF, WebP.
• Підтримка ZIP-архівів із фото.
• Автоматичне збереження файлів у теку files/originals/products.

Режими прикріплення до товарів

• Тільки зберегти файли на сервері (без прив’язки до товарів).
• Прикріпити за SKU в назві файлу.
• Прикріпити за ID товару / external_id в назві файлу.

Кілька фото на один товар

Для файлів на кшталт SKU_1.jpg, SKU-2.jpg, 45123 (1).jpg можна увімкнути правила нормалізації назв:

• прибрати суфікс _число;
• прибрати суфікс -число;
• прибрати (число) в кінці;
• прибрати (число) в кінці.

Політика обробки колізій

Якщо файл з такою назвою вже є на сервері:

• Унікальне ім’я;
• Пропустити;
• Перезаписати.

Якщо товар не знайдено (для режимів SKU/ID):

• зберегти файл на сервері;
• або пропустити файл.

Журнал імпорту

• Окрема сторінка журналу останнього імпорту.
• Статуси: успіх / попередження / помилка.
• Показує операцію, повідомлення та, якщо знайдено, посилання на товар.

Вимоги

• OkayCMS v4.5.2

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

Варіант 1: Скачування з GitHub

1. Скачайте останню версію модуля з останнього релізу на GitHub.
2. Розпакуйте архів на сервері в каталог: {OkayCMS_root}/Okay/Modules/

Варіант 2: Встановлення через Git

1. Виконайте команду в директорії {OkayCMS_root}/Okay/Modules/Sviat:

   git clone https://github.com/devSviat/ProductImagesImporter-OkayCMS.git ProductImagesImporter

Результат встановлення

Шлях до модуля має бути таким:

{OkayCMS_root}/Okay/Modules/Sviat/ProductImagesImporter/

Після встановлення перейдіть в адмін-панель → Модулі → Знайдіть «ProductImagesImporter» → Натисніть «Встановити».

Налаштування і використання

1. Перейдіть в адмін-панель → Імпорт → Імпорт фото.
2. Оберіть режим прикріплення:
   • тільки зберегти;
   • за SKU;
   • за ID/external_id.
3. Для режимів SKU/ID (за потреби) увімкніть правила очищення суфіксів у назвах файлів.
4. Виберіть політику:
   • що робити з файлами, які вже існують;
   • що робити, якщо товар не знайдено.
5. Завантажте файли або ZIP.
6. Натисніть «Імпортувати фото».
7. Перевірте результат у Журналі імпорту фото.

Важливо

• Для правильного автоприкріплення назва файлу має відповідати SKU або ID (залежно від обраного режиму).
• Якщо використовуєте ZIP, кожен файл в архіві обробляється окремо.
• Перед великим імпортом бажано протестувати на невеликій вибірці файлів.

Ліцензія

Модуль розповсюджується за вільною ліцензією MIT