109 lines
12 KiB
Plaintext
109 lines
12 KiB
Plaintext
=============================================================================
|
||
Easy Import/Export [NAT]
|
||
Version: 1.0.0
|
||
Compatibility: OpenCart 3.0.x / ocStore 3.0.x
|
||
Author: NAT
|
||
Support: info@nat.od.ua
|
||
=============================================================================
|
||
|
||
---------------------------------------------------------
|
||
🇷🇺 РУССКИЙ ЯЗЫК
|
||
---------------------------------------------------------
|
||
УСТАНОВКА:
|
||
1. В админ-панели OpenCart перейдите в раздел "Модули / Расширения" -> "Установка расширений". Загрузите архив `easy_import_export_nat_OC_30_1_0.ocmod.zip`.
|
||
2. Перейдите в "Модули / Расширения" -> "Модификаторы" и нажмите синюю кнопку "Обновить" (Очистить кэш).
|
||
3. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите вашу группу (Administrator), нажмите "Выделить все" в правах просмотра и изменения, затем сохраните.
|
||
4. Перейдите в "Модули / Расширения" -> "Расширения" -> тип "Модули", найдите "Easy Import/Export [NAT]" и нажмите "Установить", затем "Редактировать".
|
||
|
||
ОБНОВЛЕНИЕ:
|
||
1. Загрузите новый архив через "Установка расширений" поверх старого.
|
||
2. Обновите кэш в разделе "Модификаторы".
|
||
3. Очистите кэш браузера (Ctrl+F5) на странице настроек модуля.
|
||
|
||
УДАЛЕНИЕ:
|
||
1. Перейдите в "Модули / Расширения", найдите модуль и нажмите красную кнопку "Деинсталлировать".
|
||
2. Перейдите в "Установка расширений", найдите модуль в истории загрузок и удалите его файлы.
|
||
3. Обновите кэш модификаторов.
|
||
|
||
КЛЮЧЕВЫЕ ФУНКЦИИ И ВОЗМОЖНОСТИ:
|
||
* Интерактивное превью: При загрузке файла или получении по ссылке модуль моментально выводит таблицу с первыми 5 строками. Это позволяет визуально проверить структуру данных и соответствие колонок перед запуском импорта.
|
||
* Умное автосопоставление: Автоматическая привязка колонок прайс-листа к полям OpenCart (Модель, SKU, Цена, Количество, Статус) по встроенным словарям синонимов, защищенная от дублирования связей.
|
||
* Живые счетчики импорта: Панель импорта в реальном времени отображает ход работы (Всего строк, Обновлено товаров, Не найдено в каталоге, Пропущено).
|
||
* Условные модификаторы цен и остатков: Тонкая настройка правил (например, "Если цена меньше 100 — умножить остаток на 2") с WAF-совместимыми кодами сравнения (eq, ne, gt, lt), которые не блокируются серверами хостинга.
|
||
* Парсер ссылок Google Sheets: Автоматическое определение ссылок совместного доступа Google Таблиц и их конвертация в прямую WAF-безопасную ссылку на CSV экспорт.
|
||
* Интеграция с REST API поставщиков [BETA]: Встроенный гибкий клиент, поддерживающий GET/POST запросы, авторизацию Basic/Bearer/Custom POST Token, постраничную пагинацию или пагинацию со смещением, а также потоковую memory-safe запись JSON/XML ответов на диск.
|
||
|
||
КАК РАБОТАТЬ С МОДУЛЕМ:
|
||
1. Вкладка "Настройки": Управление лицензией, отображение быстрых кнопок действий в каталоге и редакторах, пути для экспорта.
|
||
2. Вкладка "Экспорт": Выгрузка данных в CSV, XML, JSON или Excel. Настройка идентификаторов, фильтров категорий/производителей и формул модификации перед скачиванием.
|
||
3. Вкладка "Импорт": Загрузка файлов или указание ссылок, настройка соответствия колонок по превью и запуск импорта с живой статистикой.
|
||
4. Вкладка "Автоимпорт (CRON)": Создание множественных задач для автоматического обновления цен и остатков по расписанию с индивидуальными настройками связей и условных модификаторов.
|
||
|
||
|
||
---------------------------------------------------------
|
||
🇬🇧 ENGLISH
|
||
---------------------------------------------------------
|
||
INSTALLATION:
|
||
1. Go to OpenCart admin panel: "Extensions" -> "Installer".
|
||
2. Upload the `easy_import_export_nat_OC_30_1_0.ocmod.zip` archive.
|
||
3. Go to "Extensions" -> "Modifications" and click the blue "Refresh" button.
|
||
4. Go to "System" -> "Users" -> "User Groups", edit your group (Top Administrator), click "Select All" for Access and Modify permissions, then Save.
|
||
5. Go to "Extensions" -> "Extensions" -> choose "Modules", find "Easy Import/Export [NAT]", click "Install" and then "Edit".
|
||
|
||
UPDATE:
|
||
1. Upload the new zip file via Extension Installer over the old one.
|
||
2. Refresh modifications cache.
|
||
3. Hard refresh your browser cache (Ctrl+F5) on the module settings page.
|
||
|
||
UNINSTALLATION:
|
||
1. Go to Extensions -> Modules, click the red "Uninstall" button next to the module.
|
||
2. Go to the Extension Installer history and delete the module files.
|
||
3. Refresh modifications cache.
|
||
|
||
KEY FEATURES:
|
||
* Interactive Pre-upload Preview: Displays a 5-row preview table immediately after file upload or URL fetch to verify data structure and mapping presets.
|
||
* Smart Auto-mapping: Auto-detects columns using synonym dictionaries for standard OpenCart fields (Model, SKU, Price, Qty, Status) without mapping collisions.
|
||
* Live Import Dashboard: Monitors import runs in real-time, showing count tiles for Total, Updated, Not Found, and Skipped products.
|
||
* Conditional Modifiers: Setup robust target-modifier conditions (e.g. "If Price lt 100 -> Qty * 2") using WAF-safe alphanumeric operators (eq, ne, gt, lt).
|
||
* Google Sheets Link Converter: Automatically transforms shared Google Sheets URLs into direct CSV export endpoints.
|
||
* Supplier REST API Client [BETA]: Built-in flexible client supporting GET/POST requests, Basic/Bearer/Custom POST Token auth, offset/page-based paginations, and memory-safe streaming of JSON/XML payloads.
|
||
|
||
HOW TO USE:
|
||
1. "Settings" Tab: Manage license, paths, and visibility of Fast Import/Export catalog action buttons.
|
||
2. "Export" Tab: Dump product data to CSV, XML, JSON, or Excel with custom filters, fields, and pricing modifiers.
|
||
3. "Import" Tab: Direct file upload or URL inputs, mapping configurations through visual preview table, and live update stats.
|
||
4. "Auto Import (CRON)" Tab: Manage multiple scheduled automation cron tasks, each configured with specific mapping and modifier rules.
|
||
|
||
|
||
---------------------------------------------------------
|
||
🇺🇦 УКРАЇНСЬКА МОВА
|
||
---------------------------------------------------------
|
||
ВСТАНОВЛЕННЯ:
|
||
1. В адмін-панелі OpenCart перейдіть до "Модулі / Розширення" -> "Встановлення розширень". Завантажте архів `easy_import_export_nat_OC_30_1_0.ocmod.zip`.
|
||
2. Перейдіть до "Модулі / Розширення" -> "Модифікатори" і натисніть синю кнопку "Оновити".
|
||
3. Перейдіть до "Система" -> "Користувачі" -> "Групи користувачів", виберіть вашу групу (Administrator), натисніть "Виділити все" у правах перегляду та зміни, збережіть.
|
||
4. Перейдіть до "Модулі / Розширення" -> "Розширення" -> тип "Модулі", знайдіть "Easy Import/Export [NAT]", натисніть "Встановити", а потім "Редагувати".
|
||
|
||
ОНОВЛЕННЯ:
|
||
1. Завантажте новий архів через "Встановлення розширень" поверх старого.
|
||
2. Оновите кеш у розділі "Модифікатори".
|
||
3. Очистіть кеш браузера (Ctrl+F5) на сторінці налаштувань модуля.
|
||
|
||
ВИДАЛЕННЯ:
|
||
1. Перейдіть у "Модулі / Розширення", знайдіть модуль та натисніть червону кнопку "Деінсталювати".
|
||
2. Перейдіть у "Встановлення розширень", знайдіть модуль в історії та видаліть його файли.
|
||
3. Оновите кеш модифікаторів.
|
||
|
||
КЛЮЧОВІ ФУНКЦІЇ ТА МОЖЛИВОСТІ:
|
||
* Інтерактивне прев'ю: Миттєво виводить перші 5 рядків завантаженого файлу чи посилання для візуальної перевірки відповідності колонок перед стартом імпорту.
|
||
* Розумне автозіставлення: Автоматично розпізнає колонки за словниками синонімів для полів OpenCart (Модель, SKU, Ціна, Кількість, Статус) без перехресних конфліктів.
|
||
* Живі лічильники імпорту: Панель відображає прогрес виконання у реальному часі (Всього рядків, Оновлено, Не знайдено в каталозі, Пропущено).
|
||
* Умовні модифікатори цін і залишків: Гнучкі правила (наприклад, "Якщо ціна менша 100 — помножити кількість на 2") з WAF-безпечними символами порівняння (eq, ne, gt, lt), які не блокуються хостингами.
|
||
* Парсер лінків Google Sheets: Розпізнає посилання спільного доступу Google Таблиць та перетворює їх на прямі WAF-безпечні лінки CSV експорту.
|
||
* Інтеграція з REST API постачальників [BETA]: Вбудований гнучкий клієнт, що підтримує GET/POST запити, авторизацію Basic/Bearer/Custom POST Token, постраничну пагінацію або пагінацію зі зміщенням, а також потоковий memory-safe запис JSON/XML відповідей на диск.
|
||
|
||
ЯК ПРАЦЮВАТИ З МОДУЛЕМ:
|
||
1. Вкладка "Налаштування": Керування ліцензією, активація швидких кнопок імпорту/експорту в каталозі, налаштування шляхів.
|
||
2. Вкладка "Експорт": Вивантаження каталогу в CSV, XML, JSON чи Excel з налаштуванням фільтрів та модифікаторів перед скачуванням.
|
||
3. Вкладка "Імпорт": Завантаження прайс-листів, налаштування зв'язків колонок по прев'ю та імпорт з показом статистики в реальному часі.
|
||
4. Вкладка "Автоимпорт (CRON)": Створення декількох автоматичних завдань для оновлення за розкладом з індивідуальними налаштуваннями відповідності полів та модифікаторів. |