Загрузка XML прайса для Joomshopping.
Обновление цен товаров и остатков на складе.

По умолчанию, XML-парсер поддерживает схему данных Яндекс Маркет, YML.

Наполнение товаром интернет-магазина отнимает массу времени и сил. Тем более, когда количество товаров зашкаливает далеко за тысячу. Вводить вручную каждый товар – невероятно трудоёмкое занятие.

К счастью, многие источники позволяют получить товарные предложения путём выгрузки (экспорт данных) в формате XML. Это могут быть готовые прайсы, парсеры или экспорт/выгрузка данных через админку сайта, например, для переноса контента на другой движок магазина.

Наш аддон (плагин) предназначен для того, чтобы загрузить товар из такого источника на сайт магазина, построенного на Joomshopping.

Схемы загружаемого документа XML могуть быть разными, но из-коробки (по-умолчанию) поддерживается только схема YML. Это схема Яндекс Маркет, довольно распространённая и, фактически, общепринятая. В том числе и расширенная версия с блоками <variant>. Среди популярных дилеров – Begemott.ru

На заказ мы можем сделать соответствующие дополнения под разные схемы, с дополнительной оплатой. Учитывая что парсер умеет сохранять различные наборы параметров (работает с шаблонами), Вы сможете загружать фиды от разных поставщиков. Свяжитесь с нами, например, через Отзывы внизу, чтобы уточнить задачу.

• Документация Яндекс по формату xml/YML
• Пример файла xml по схеме YML

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

Данный аддон позволяет обновлять все данные карточки товара или только цены, наличие/остатки товаров на складе путём загрузки соответствующего прайса. Если скрипт находит на сайте товар с Кодом (артикулом) таким же, как в прайсе – происходит обновление его данных (цена, остаток на складе и т.п.). Если кода нет, поиск осуществляется по точному совпадению названия товара. Для прайса типа vendor.model сравнение выполняется по сцепке Бренд+Модель. Если не найден ни код (артикул) ни название – в базу данных добавляется новый товар. Или товар не добавляется, если соответствующая опция отключена.

Категории и Производители, которые отсутствуют в базе Joomshopping, будут созданы автоматически (если включена такая опция). Возможно сохранять несколько категорий для одного товара.

<param name="Характеристики">

Теги xml-прайса <param name> обрабатываются как характеристики и/или атрибуты Joomshopping. Есть возможность настроить соответствие тегов <param name> характеристикам и атрибутам Joomshopping. Поддерживаются характеристики типа текст, список, множественный список. Атрибуты – только независимые.

Для полей <param name>, которые надо сохранить из прайса, в Joomshopping нужно создать соответствующие Характеристики и подвязать их в параметрах плагина. Опции для характеристики типа "Список" создавать не нужно, они создаются автоматически.

Обновлено: Добавлена опция "Создавать характеристики": секция "Привязка характеристик...", внизу, под списком соответствия.
Теперь парсер может создавать все характеристики из прайса. Но это очень сильно напрягает сервер, поэтому не везде будет возможно воспользоваться. Тип характеристики "Список" определяется по наличию атрибута valueid:
<param name="Название характеристики" valueid="">
Другой способ однозначно определить тип поля "список" или "текст" пока не придумали.

Возможны два режима создания характеристик.
Строгий: все характеристики создаются со строгой привязкой к категории товара, с которым они связаны в прайсе. Даже если уже существует характеристика с таким же названием, но для других категорий.
Обычный: повторяющиеся названия характеристик не дублируются, а только дополняется список связанных с ней категорий. Характеристики, которые отмечены "для всех категорий", не дублируются, независимо от режима.

Если нужно чтобы некоторые характеристики были общие, "для всех категорий" – например, Цвет, Габариты, Страна производителя – создайте их вручную заранее и укажите категории "Все".

При желании, перед первой загрузкой прайса можно открыть его в блокноте и для каждой новой характеристики-список (которая встречается только первый раз и её значения являются элементами списка) добавить атрибут valueid как показано выше. Все последующие загрузки будут использовать уже созданные характеристики. Например, характеристики "Цвет", "Тип дисплея", "Разъём USB" лучше сделать тип "Список", чтобы лучше работал модуль фильтра товаров.

Изображения

Если разрешено в опциях, заполняется информация об изображениях товаров, в т.ч. дополнительные. Первое изображение по списку становится главным, остальные – как дополнительные.

Изображения прописываются только для новых товаров. При обновлении всех данных изображения в карточке товара пропускаются, не обновляются, чтобы не испортить то, что возможно было Вами улучшено (исправлены имена файлов, загружены другие и т.п.)

Если включена опция "Загружать файлы", по окончанию обработки прайса для новых товаров будут загружены файлы изображений. Осторожно, эта функция может приводить к прерыванию импорта из-за слишком долгого процесса.

Если опция "Загружать файлы" выключена, файлы изображений автоматически не скачиваются и на сервер не загружаются! В карточках товаров только прописывается о них информация. После загрузки данных вы получите файл со списком ссылок изображений новых товаров. Далее нужно их скачать любым загрузчиком, загрузить на сервер и выполнить обычную для Joomshopping процедуру обновления размеров изображений (см. аддон Resize images products).
В качестве загрузчика фотографий очень удобен Download Master, (см.меню Файл / Импорт / URL из файла).

Не забывайте, что Joomshopping каждое фото товара хранит в трёх файлах: оригинал *.jpg, миниатюра thumb_*.jpg и крупный план full_*.jpg, поэтому на каждый файл-источник нужно сделать ещё 2 копии с именами thumb_*.jpg и full_*.jpg

По умолчанию, папка, в которой хранятся файлы фото товаров, находится здесь:
/components/com_jshopping/files/img_products/

Списки ссылок (txt-файлы) для загрузки файлов изображений сохраняются в этой папке:
/components/com_jshopping/files/importexport/imaudimportyml/

См. файлы вида imagesList_YYYYMMDD_hhmmss.txt

Обратите внимание

Если ссылки в источнике SEF-вида, а в конце ссылки – псевдоним товара, эти псевдонимы переносятся в карточку товара. Если псевдонимы товаров в прайсе отсутствуют или не устраивают, можно разрешить транслитерацию названий в латинские буквы. Возможно передавать псевдоним товара отдельно, с помощью тега <alias>.

Предусмотрена возможность загрузки товаров по признаку доступности, наличию. Если в атрибутах offer указано available=”true” stock=”xx” (xx - любое положительное количество), такой товар загружается. Если либо available=”false”, либо остаток stock=”0” – товар будет пропущен, не будет загружен в базу. Опция отключаемая.

Возможно автоматическое изменение цены и/или валюты. Если у вас в магазине валюта отличается от источника или просто есть такая необходимость, можно указать любую другую валюту, которая будет установлена для товаров. Одновременно вы можете указать и курс конвертации или любой коэффициент для цены. Так можно загрузить прайс с ценами в рублях, заменив налету все цены на евро или доллар, или наоборот.

Цена товара из прайса может быть сохранена как основная цена товара в Joomshopping или как закупочная цена.

Можно загружать отдельные категории, бренды и/или диапазон товаров по их ID в прайсе XML.

Поддерживается функция "Продавцы" Joomshopping.
Можно загружать все товары или только от указанных продавцов. Осуществляется привязка новых товаров к определённому продавцу.

Если прайс, который Вы загружаете, от производителя товаров и в нём не указан бренд как <vendor>, укажите его название в поле "Производитель по-умолчанию".

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

Аддон позволяет сохранять шаблоны/профили параметров.
Вы можете работать с несколькими профилями параметров, которые настроены под разные прайсы-источники. Измените "Название шаблона" и нажмите кнопку "Сделать копию шаблона", чтобы получить независимый набор параметров импорта для отдельных поставщиков.

Установка

Установка пакета через Компоненты => Joomshopping => Установка и обновление.

После установки парсер будет здесь: Компоненты => Joomshopping => Опции => Импорт и экспорт
Называется "Import XML (iMaud)". Кликните по названию, чтобы войти в настройки выгрузки.

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

Протокол обработки прайса смотрите в папке /components/com_jshopping/log/ (из-вне она недоступна).

В поле "Схема данных" по-умолчанию установлена опция schema-yml.php.
Это значит, что парсер будет обрабатывать xml-фид по схеме YML (файл или ссылка). Если нужно обрабатывать прайсы с другими схемами, здесь нужно её установить. Для каждого поставщика, со своей схемой данных, Вы можете сохранить шаблон с соответствющими настройками. Просто настройте все опции, дайте название шаблону и нажмите кнопку "Сделать копию шаблона".

Если прайс содержит несколько тысяч товаров, возможна ситуация когда сервер сайта не позволяет обработать файл целиком, за один сеанс. Это связано с ограничениями времени обработки PHP-скрипта на сервере. Стандартное значение 120 секунд (2 минуты). Признак такого финала – пустая страница по окончании процесса. Ничего страшного! Для начала попробуйте задать большее значение опции Set time limit, мин.. Это позволит серверу максимально долго обрабатывать прайс, насколько позволяют другие настройки сервера.

Если увеличение времени не помогает, чтобы всё-таки загрузить файл с большим количеством товара, в опциях предусмотрено задать номер ID товара по файлу, с которого нужно начать/продолжить обработку, и количество товаров на один сеанс. Количество обрабатываемых за один сеанс товаров лучше ограничить 1000...2000 и зависит от настроек вашего сервера, подбирается экспериментальным путём – до нормального возврата на страницу импорта с отображением результатов обработки.

Допустим, в предыдущем сеансе последний обработанный товар был с id=1834 - этот номер будет показан на этой же странице в результате обработки. Далее, нужно просто задать этот номер как начальный и снова запустить импорт.

Опция "Макс. уровень категории фида" позволяет ограничить уровень вложенности категорий фида. Например, если в фиде порядка 800 категорий, а вам на сайте нужны только первые два уровня, укажите это в опции. Тогда товары, которые относятся в фиде к категориям более глубокой вложенности, будут отнесены к ближайшей родительской категории 2 уровня.

Парсер умеет сохранять различные наборы параметров (работает с шаблонами), поэтому Вы сможете загружать фиды от разных поставщиков. Создайте в Joomshopping поставщиков и при загрузке привязывайте к ним их товары – так будет проще с ними работать!

Есть специальная версия загрузки xml для схемы YRL (Yandex Realty Language) – база данных по недвижимости – посмотрите сюда!