- Возможности плагина
- Системные требования
- Установка
- Обновление товаров по расписанию
- Работа с плагином
- Удаление
Plugin features
- Import of catalog with subcategories and products.
- Import of pictures, videos and product descriptions.
- Import of product attributes.
- Import of product configurations with aliases and pictures.
- Import of product price ranges and old/discount price.
- Import of product reviews and ratings.
System requirements
- Otapiphpclient library (https://github.com/OTCommerce/otapiphpclient.git). Already available installation archive of the module with all dependencies for php 7.4.
- PHP 7.4 for OpenCart3.
- To automatically update products on a schedule: scheduler (cron).
- MySQL DBMS.
Installation
Before plugin installation it is strongly recommended to create backup copy of website and database files.
Go to “Extensions” section → “Installer” in admin panel of your OpenCart store and click “Upload” button.
Select downloaded module archive and confirm installation. Wait for a message about successful installation.
Go to "Sestem" section → "Users" → "User Groups"
Go to administrator group settings and check boxes extension/module/otapi_import and extension/module/otapi_import_cron in “Access Permission” and “Modify Permission” sections. Save settings.
Go to “Extensions” section → “Extensions”.
Перейдите в раздел «Модули/Расширения» → «Модули/Расширения»
Выберите тип расширения «Модули» и нажмите кнопку «Активировать» для модуля «OT API Import».
Перейдите в раздел «Модули/Расширения» → «Модификаторы» и нажмите справа вверху кнопку «Обновить».
Модуль установлен.
Обновление товаров по расписанию
- Manually copy cli directory from the module archive to the directory where admin folder is located.
- To automatically update products on a schedule, you need to set up cron job to run with a frequency equal to or less than the value of product update launch period (this is Update interval parameter in module settings - update interval in minutes).
- example of running cron job every hour:
@hourly cd "opencart directory"/cli && php7.4 otapi_import_cli.php > /dev/null 2>&1 - Importing a large number of goods can take a long time - from several hours to several days, depending on the computing resources of the server, especially the database server. Therefore, too frequent launch intervals do not make sense: if the previous import has not yet been completed, the new one will still not be launched.
- Импорт большого количества товаров может занимать продолжительное время — от нескольких часов до нескольких суток в зависимости от вычислительных ресурсов сервера, в особенности сервера БД. Поэтому слишком частые интервалы запуска не имеют смысла: если предыдущий импорт еще не завершен, новый все равно не будет запущен.
Work with plugin
Перейдите в раздел «Модули/Расширения» → «Модули/Расширения»
- Нажмите кнопку «Редактировать» для модуля «OT API Import». (Доступен также более короткий путь к настройкам модуля через «Каталог» → «OT API Импорт».
- Задайте необходимые параметры настроек и нажмите кнопку «Сохранить настройки».
- Для быстрого наполнения каталогов товарами рекомендуется установить галочку «Test category filling» (тестовое наполнение каталогов) и задать параметр «Frame size» — размер фрейма 5-10 товаров. Именно столько товаров загрузится для каждой категории.
- Совершите первичную загрузку каталога товаров: перейдите в настройки модуля во вкладку «Импорт каталога» и нажмите кнопку «Импорт каталога».
- После завершения тестового импорта проверить, что все каталоги загрузились и содержат товары. После этого уберите галочку «Test category filling», установите «Frame size» в размере 200-500 и произведите полный импорт каталога.
- По окончании импорта отобразится сообщение об успешной загрузке каталога.
Важные замечания:
- Импорт будет продолжаться до тех пор пока открыта страница в браузере.
- При обновлении страницы или повторном входе в систему для возобновления импорта нужно заново нажать кнопку «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 неделя.
Удаление
- Удалите из cron задание на запуск обновления товаров.
- Перейдите в раздел «Модули/Расширения» и нажмите кнопку «Деактивировать» для модуля «OT API Import».
- Перейдите в раздел «Модули/Расширения» → «Установка расширений» и нажмите кнопку «Деактивировать» для модуля «OT API Import».
- Перейдите в раздел «Модули/Расширения» → «Модификаторы» и нажмите кнопку «Обновить».
- Удалите каталог cli, если вы его размещали