- Возможности плагина
- Системные требования
- Установка
- Обновление товаров по расписанию
- Работа с плагином
- Удаление
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 “Modules/Extensions” section → “Install extensions” in admin panel of your OpenCart store and click “Download” button.
Выберите скаченный архив модуля и подтвердите установку. Дождитесь сообщения об успешной установке.
Перейдите в раздел «Система» → «Пользователи» → «Группы пользователей»
Зайдите в настройки группы администраторов и пометьте галочками пункты 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 - Импорт большого количества товаров может занимать продолжительное время — от нескольких часов до нескольких суток в зависимости от вычислительных ресурсов сервера, в особенности сервера БД. Поэтому слишком частые интервалы запуска не имеют смысла: если предыдущий импорт еще не завершен, новый все равно не будет запущен.
Работа с плагином
Перейдите в раздел «Модули/Расширения» → «Модули/Расширения»
- Нажмите кнопку «Редактировать» для модуля «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, если вы его размещали