Модуль Диспетчер YML\XML для Opencart\ocStore v2.0

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

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

Основные возможности:
Производители

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

Категории

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

Атрибуты

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

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

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

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

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

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

На текущий момент в состав модуля входят следующие драйверы:

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

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

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

Загрузчик состоит из 2-х дополнительных блоков:
Обработчик вариантов (делается под конкретный фид)
АПИ сохранения связанных опций
Тестирование проводилось на фиде от , который содержит примерно 10700 товаров
Для подобных проектов ОБЯЗАТЕЛЬНО используйте VDS!
Для указанного поставщика время загрузки ВСЕХ товаров (по 3-5 изображения в каждом, плюс изображения опций цвета) составляет 5-6 часов.
Обновление цен и остатков - 30-40 минут.
По вопросам приобретения расширений писать в ЛС или на почту.

Установка модуля:
Модуль имеет единый дистрибутив для всех версий OpenCart.

Для всех сборок ниже 2.3:
Hаспакуйте архив zoxml2.170209.zip (или более позднюю версию) в корень вашего сайта.
Цифры означают дату выпуска дистрибутива — ГГММДД.

Для 2.3:
Распакуйте архив zoxml2_3.170209.zip (или более позднюю версию) в корень вашего сайта.
Распакуйте архив zoxml2_yml.170209.zip в корень вашего сайта (драйвер обработки YML)
Распакуйте архив zoxml2_scripts.170209.zip в корень вашего сайта (дополнительные скрипты и фильтры)
Если вы приобрели дополнительные драйверы, то также распакуйте их в корень вашего сайта.

Для версий 1.5.Х:
Дополнительно также распакуйте архив zoxml1.160511.zip
Далее перейти в админке в список модулей, найти в нем "Диспетчер YML\XML" и активировать модуль.

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

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

Нажмите для раскрытия...

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

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

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

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

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

• Выберите нужного поставщика из списка
• Установите необходимые базовые параметры
• Сохраните настройки
• Нажмите "Загрузить производителей, категории и атрибуты"
• По окончании загрузки приступайте к настройке производителей, категорий и атрибутов

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

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

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

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

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

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

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

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

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

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

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

• Выберите поставщика из списка
• Нажмите иконку "Загрузить товары"

Удаление поставщика

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

Лицензирование модуля:

• Приобретая модуль вы получаете право его использования на одном публичном домене
• использование на локальных серверах не ограничивается
• Дополнение является объектом авторского права и принадлежит его создателю
• Вы не можете передавать, продавать, распространять, обмениваться и сдавать в аренду какую-либо часть дополнения
• Вы не можете размещать дополнение на других сайтах, чтобы оно было доступно для скачивания
• Перенесение с одного домена на другой ранее приобретенной Лицензии не осуществляется

Демо-сайты:
Для ocStore 1.5.5:

demo\demo

Для OpenCart 2.1:

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-как YML" или "Загрузить CSV (windows-1251) как YML"
• Далее работаем как с обычным XML-фидом
• CSV файл обязательно должен в 1-й строке содержать названия столбцов
• При включенном отладчике XML-версия фида будет сохранена в DIR_CACHE