Загрузка 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 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.
Можно загружать все товары или только от указанных продавцов. Осуществляется привязка новых товаров к определённому продавцу.

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

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

Установка

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

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

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

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

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

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