Easy_Import_Export_NAT-4.0/Instruction ru-uk-en.txt

109 lines
12 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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