============================================================================= 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)": Створення декількох автоматичних завдань для оновлення за розкладом з індивідуальними налаштуваннями відповідності полів та модифікаторів.