Диспетчер YML\XML v3.0 для Opencart 2.x - 3.x

Модуль "Диспетчер YML\XML" для Opencart\ocStore версии 2.Х - 3.0

Предназначен для подключения к ИМ неограниченного количества поставщиков, предоставляющих прайс-листы и описания товаров в формате YML\XML\CSV.

Самое актуальное описание доступно на официальной странице модуля: http://opencart.zone/modules-2-0/xml2.html

Основные возможности:

Производители

• выборочная загрузка производителей
  
• перенаправление производителей
• создание производителей из панели модуля

Категории

• выборочная загрузка категорий
  
• перенаправление категорий

Атрибуты

• настройка соответствий каждого входного параметра параметрам вашего ИМ
  

Индивидуальные настройки для каждого поставщика

• режимы добавления\обновления
  
• загрузка изображений
• связующие поля
• модификаторы цены

Индивидуальные логи для каждого поставщика

• лог загрузки
  
• лог уведомлений о появлении у поставщика новых категорий, производителей, атрибутов

Структура модуля

Модуль состоит из основного блока и набора микро-модулей (драйверов), каждый из которых реализует обработку какого либо конкретного формата входных данных по общей схеме. На текущий момент в состав модуля входят следующие драйверы:

• обработка YML - задача решена в общем виде и годится для подавляющего большинства фидов
  

Дополнительно (за отдельную плату) предоставляются драйверы для работы со следующими поставщиками, использующими нестандартные форматы или теги, или предоставляющие собственное API:

• textiloptom.net (API)
  
• odeyalaoptom.ru (API)
• shopntoys.ru (API)
• gifts.ru (API) - дополнительно требуются "Связанные опции" (обязательно) и "Живая цена" (желательно)
• happygifts.ru (API) - дополнительно требуются "Связанные опции" (обязательно) и "Живая цена" (желательно)
• oasiscatalog.com (API)
• Интеграция со "Связанными опциями"

Загрузчик состоит из 2-х дополнительных блоков:

- обработчик вариантов (делается под конкретный фид)

- АПИ сохранения связанных опций

Тестирование проводилось на фиде от https://www.qpstol.ru/ , который содержит примерно 10700 товаров

Для подобных проектов ОБЯЗАТЕЛЬНО используйте VDS!

Для указанного поставщика время загрузки ВСЕХ товаров (по 3-5 изображения в каждом, плюс изображения опций цвета) составляет 5-6 часов.

Обновление цен и остатков - 30-40 минут.

Установка модуля

Модуль имеет единый дистрибутив для всех версий Opencart.

Для 2.3:

1. Распакуйте архив zoxml2_3.170209.zip (или более позднюю версию) в корень вашего сайта.
   
2. Распакуйте архив zoxml2_yml.170209.zip в корень вашего сайта (драйвер обработки YML)
   
3. Распакуйте архив zoxml2_scripts.170209.zip в корень вашего сайта (дополнительные скрипты и фильтры)
   
4. Если вы приобрели дополнительные драйверы, то также распакуйте их в корень вашего сайта.
5. Далее перейти в админке в список модулей, найти в нем "Диспетчер YML\XML" и активировать модуль.
   

Настройка модуля

1. В левой колонке модуля расположен список подключенных поставщиков. Последним в списке идет ссылка на блок общего управления модулем.
   
2. Перейти в блок общего управления модулем
   
3. В закладке "СИСТЕМА" установить нужные параметры

ВНИМАНИЕ: начиная с версии 170209 появилась возможность модифицировать таблицу product - добавлять в нее дополнительное поле supplier (поставщик) для хранения идентификатора поставщика. Будьте осторожны! Использование этой возможности может привести к конфликтам с другими модулями и сделает невозможным восстановление ранее сохраненных копий БД. Поэтому после включения этой возможности сразу сделайте свежую резервную копию БД!

Работа с модулем

В левой колонке модуля расположен список подключенных поставщиков. Последним в списке идет ссылка на блок общего управления модулем.

Добавление поставщика

1. Перейти в блок общего управления модулем
2. В закладке "ПОДКЛЮЧИТЬ ПОСТАВЩИКА" выберите из списка тип входного фида
3. В открывшейся строке "ИМЯ" введите любое удобное для вас имя этого поставщика, например: ООО "Маркет"
4. В остальных открывшихся строках указать необходимые параметры: URL (если требуется), ЛИЦЕНЗИЯ (если требуется)
5. Нажмите "ДОБАВИТЬ"

Настройка поставщика

http://opencart.zone/image/data/xml2/zoxml2_main.jpg

1. В левой колонке модуля расположен список подключенных поставщиков.
   
2. Выберите нужного поставщика из списка
   
3. Установите необходимые базовые параметры
4. Сохраните настройки
5. Нажмите "Загрузить производителей, категории и атрибуты"
6. По окончании загрузки приступайте к настройке производителей, категорий и атрибутов

Настройка производителей

http://opencart.zone/image/data/xml2/zoxml2_vendors.jpg

1. Войти в закладку "ПРОИЗВОДИТЕЛИ" выбранного поставщика
   
2. Если нужный вам производитель отсутствует на сайте, то будет активна кнопка "Добавить" (также можете добавлять производителей обычным способом)
3. Если нужный вам производитель уже есть на сайте, в т.ч. он может присутствовать в иной транскрипции, то просто выберите его из выпадающего списка
4. Сохраните настройки

Настройка категорий

http://opencart.zone/image/data/xml2/zoxml2_category.jpg

1. Войти в закладку "КАТЕГОРИИ" выбранного поставщика
   
2. Если нужная вам категория уже есть на сайте, в т.ч. она может присутствовать в иной транскрипции, то просто выберите ее из выпадающего списка
3. Сохраните настройки

Настройка опций товара

1. Стандарт YML не поддерживает возможность описывать опции товара, но тем не менее многие поставщики включают опции в выгрузку.
2. Из-за отсутствия единого стандарта описания опций товара следует использовать встроенный механизм ПОЛЬЗОВАТЕЛЬСКИЙ ФИЛЬТР и ПОЛЬЗОВАТЕЛЬСКИЙ СКРИПТ

ПОЛЬЗОВАТЕЛЬСКИЙ ФИЛЬТР - обрабатывает нестандартные теги (такие как <options>, <param name="Цвет">, <variants> и подобные им) и формирует выходной массив данных

ПОЛЬЗОВАТЕЛЬСКИЙ СКРИПТ - сохраняет опции товара после того как завершена основная обработка товара. В большинстве случаев можно использовать входящие в комплект поставки 2 готовых скрипта:

- saveOptions - используется если все опции включены в одно товарное предложение

- updateOptions- используется если опции включены в разные товарные предложение, но имеющие например общий артикул

Настройка атрибутов товара

http://opencart.zone/image/data/xml2/zoxml2_option.jpg

1. Войти в закладку "АТРИБУТЫ\ОПЦИИ" выбранного поставщика
2. Если нужный вам атрибут отсутствует на сайте, то добавьте его обычным способом через панель управления атрибутами сайта
3. Если нужный вам атрибут уже есть на сайте, в т.ч. он может присутствовать в иной транскрипции, то просто выберите его из выпадающего списка
4. Сохраните настройки

Загрузка\обновление товаров

1. Выберите поставщика из списка
2. Нажмите иконку "Загрузить товары"
3. Удаление поставщика

Выберите поставщика из списка

1. Нажмите иконку "Удалить поставщика"
2. В появившемся блоке запроса подтверждения подтвердите удаление. При отсутствии действий со стороны пользователя блок запроса подтверждения исчезнет через 10 секунд.

Демо-сайты:

для OpenCart 2.1:

https://yml-marketplace-dispatcher.isp3.ose.su/admin/index.php?route=extension/module/zoxml2&nbsp;

demo\demo

Рекомендации и FAQ:

• для работы с фидами, содержащими большое количество производителей или категорий добавьте в файл .htaccess строку:
• php_value max_input_vars 20000
• модуль очень требователен в хостингу. рекомендуется использование VDS(VPS). Объем доступной памяти должен как минимум в 10 раз превышать размер самого большого фида. Так, если самый большой фид имеет размер 90Мб, то на хостинге должно быть не менее 1Гб памяти
• модуль не работает в "Режиме обслуживания"
• не забывайте чистить логи! Если у вас при входе в модуль возникает ошибка типа Fatal error: Allowed memory size of 134217728 bytes exhausted или подобная, то для очистки логов сделайте повторную инициализацию модуля - "Деактивировать", затем "Активировать". Эта возможность доступна начиная со сборки zoxml2.160727
• работа с CSV:
• подключить как YML-совместимый
• в закладке УПРАВЛЕНИЕ в разделе СПОСОБ ЗАГРУЗКИ выбрать способ загрузки: "Загрузить CSV (UTF-8) как YML" или "Загрузить CSV (windows-1251) как YML"
• далее работаем как с обычным XML-фидом
• CSV файл обязательно должен в 1-й строке содержать названия столбцов
• при включенном отладчике XML-версия фида будет сохранена в DIR_CACHE