Скачать плагин
Для скачивания плагина нажмите на картинку:
Текущая версия плагина: 1.0.10
Внимание!
Для работы плагина необходим ОТ АПИ Ключ, который нужно покупать отдельно согласно установленным тарифам.
Возможности плагина
- Импорт каталога со вложенными каталогами и товарами.
- Импорт картинок, видео и описания товаров.
- Импорт атрибутов товара.
- Импорт конфигураций товара с алиасами и картинками.
- Импорт диапазонов цен и старой/дисконтной цены товара.
- Импорт отзывов и рейтинга товара.
Системные требования
- Библиотека otapiphpclient (https://github.com/OTCommerce/otapiphpclient.git). Уже присутствует в установочном архиве модуля со всеми зависимостями для php 7.4.
- PHP 7.4 для OpenCart версии 3 (в идеале 3.0.3.8).
- Планировщик (cron) для автоматического обновления товаров по расписанию.
- Рекомендуется MySQL версии mariadb 10 и выше.
Установка
Перед выполнением установки дополнения настоятельно рекомендуется создать резервную копию файлов сайта и базы данных.
В админ панели вашего OpenCart магазина перейдите в раздел «Модули» → «Установка расширений» и нажмите кнопку «Загрузить».
Выберите скаченный архив модуля и подтвердите установку. Дождитесь сообщения об успешной установке.
Перейдите в раздел «Система» → «Пользователи» → «Группы пользователей»
Зайдите в настройки группы администраторов и пометьте галочками пункты extension/module/otapi_import, extension/module/otapi_import_cron в секциях «Разрешён просмотр» и «Разрешено внесение изменений», после чего сохраните настройки.
Перейдите в раздел «Модули» → «Модули»
Выберите в выпадающем меню тип расширения «Модули» и нажмите кнопку «Активировать» для модуля «OT API Import».
Перейдите в раздел «Модули» → «Модификаторы» и нажмите справа вверху кнопку «Обновить».
Модуль установлен.
Обновление товаров по расписанию
- Скопируйте вручную каталог cli из архива модуля в каталог, где расположена папка admin.
- Для автоматического обновления товаров по расписанию необходимо прописать в cron запуск задания с периодичностью, равной или меньше значения периода запуска обновления товаров (в настройках модуля это параметр Update interval — интервал обновления в минутах).
пример запуска задания cron каждый час:
@hourly cd "каталог opencart"/cli && php7.4 otapi_import_cli.php > /dev/null 2>&1 - Импорт большого количества товаров может занимать продолжительное время — от нескольких часов до нескольких суток в зависимости от вычислительных ресурсов сервера, в особенности сервера БД. Поэтому слишком частые интервалы запуска не имеют смысла: если предыдущий импорт еще не завершен, новый все равно не будет запущен.
Работа с плагином
- Перейдите в раздел «Модули» → «Модули»
2. Выберите в выпадающем меню тип расширения «Модули», найдите в списке ниже модуль «OT API Import» и нажмите кнопку «Редактировать».
Доступен также более короткий путь к настройкам модуля через «Каталог» → «OT API Импорт».
3. Перейдите во вкладку «Настройки» и установите статус для плагина «Включено». Задайте необходимые параметры.
Обратите внимание, что Ключ Доступа и Секретный Ключ предоставляются OpenTrade Commerce за дополнительную плату.
Для тестового наполнения каталогов товарами рекомендуется задать параметры "Frame size" (размер фрейма) - 5-10 и "Category products limit" (лимит для категории) - 5-10 товаров.
Обязательно настройте интервал обновления данных о товарах в минутах.
4. Нажмите "Сохранить настройки" после того, как заполнили необходимые параметры.
5. Совершите первичную загрузку каталога товаров. Для этого перейдите в настройки модуля во вкладку «Импорт каталога» и нажмите кнопку «Импорт каталога».
6. Проверьте, что все каталоги загрузились и содержат товары.
7. Установите "Frame size" в размере 200-500 и уберите "Category products limit" (лимит для категории) после первичной загрузки каталога товаров.
8. Сделайте полный импорт каталога.
9. По окончании импорта отобразится сообщение об успешной загрузке каталога.
Важные замечания:
- Импорт будет продолжаться до тех пор пока открыта страница в браузере.
- При обновлении страницы или повторном входе в систему для возобновления импорта нужно заново нажать кнопку «Catalog import» (Импорт каталога).
- При этом система предложит выбрать «New import» (Начать импорт сначала) или «Continue import» (продолжить работу с того места на котором импорт был приостановлен).
- В некоторых случаях при запуске импорта может появиться сообщение «Failed to get "otapi_import_lock" on sql connection, another import is running» — это значит импорт уже был запущен другим процессом, например, через cron, или был запущен ранее в другой вкладке браузера.
- Импорт через cron работает циклично, т.е. по завершении импорт будет запущен снова. Еcли такое поведение не нужно, можно после полного импорта каталога отключить импорт в настройках модуля: поле status, или же просто задать для cron больший интервал, например, 1 неделя.
- "Корневая категория" прописывается в виде otc-***. Получить номер категории можно с помощью метода http://docs.otapi.net/ru/Documentations/Method?name=GetRootCategoryInfoList. Чтобы развернуть каждую категорию - делаем отдельный запрос http://docs.otapi.net/ru/Documentations/Method?name=GetCategorySubcategoryInfoList.
- Импорт (выгрузку) нужно делать только тех товаров, которые нужны и не больше 10 000 товаров за раз. Т.к. больше 10 000 товаров за раз плагин не позволит выгрузить.
Удаление
- Удалите из cron задание на запуск обновления товаров.
- Перейдите в раздел «Модули» → «Модули» и нажмите кнопку «Деактивировать» для модуля «OT API Import».
- Перейдите в раздел «Модули» → «Установка расширений» и нажмите кнопку «Деактивировать» для модуля «OT API Import».
- Перейдите в раздел «Модули» → «Модификаторы» и нажмите кнопку «Обновить».
- Удалите каталог cli, если вы его размещали