Перейти к содержимому

YML Feed Export для JoomShopping 5+

YML Feed Export формирует XML-фид товаров JoomShopping в формате YML для внешних каталогов, маркетплейсов и других сервисов. Документация ниже сосредоточена на практической работе с расширением: установке, создании профиля, настройке полей, фильтров, маппинга, генерации XML и автоматическом обновлении фида.

Что можно передавать

Названия, описания, цены, наличие, характеристики, производителя, артикул, изображения, URL и другие данные товаров. Структура фида настраивается под требования конкретной площадки.

Как работает расширение

  • 1. Профиль
    Создаете отдельный профиль под конкретный сервис, язык, валюту или набор товаров.
    ШАГ 1
  • 2. Основные данные
    Задаете название магазина, компанию, e-mail и имя XML-файла.
    ШАГ 2
  • 3. Валюта и язык
    Выбираете язык контента и валюту, в которой будут передаваться цены.
    ШАГ 3
  • 4. Фильтры
    Определяете, какие категории, производители и товары попадают в экспорт.
    ШАГ 4
  • 5. Mapping
    Сопоставляете поля JoomShopping с YML-элементами и параметрами.
    ШАГ 5
  • 6. Export
    Генерируете XML и проверяете его в сервисе-приемнике.
    ШАГ 6
  • 7. Cron
    После проверки настраиваете автоматическое обновление по расписанию.
    ШАГ 7

Шаг 1. Установка

1. Скачайте Nevigen Installer из личного кабинета.
2. Установите его через стандартный менеджер расширений Joomla.
3. Откройте Система → Установка → Установить с Nevigen.com.
4. Найдите YML Feed Export и установите расширение.
5. Введите лицензионный ключ для домена, на который оформлен заказ.

Где находится YML Feed Export

После установки откройте JoomShopping → Опции → Импорт и Экспорт → YML Feed Export.

Шаг 2. Создайте профиль экспорта

Профиль — это отдельная конфигурация YML-фида. Для разных маркетплейсов или языков лучше создавать отдельные профили, чтобы не менять настройки вручную перед каждым экспортом.
  • Profile name
    Понятное название профиля.
    ПРОФИЛЬ
  • Profile description
    Необязательное описание, для чего используется этот фид.
    ПРОФИЛЬ
  • Generated file name
    Имя выходного файла без расширения. Фактически будет создан файл .xml.
    ФАЙЛ

Шаг 3. Основные параметры

На вкладке Main parameters задаются данные профиля и служебная информация магазина, которая попадает в YML.
Основные параметры YML Feed Export для JoomShopping
На скриншоте видны поля Profile name, Profile description, Generated file name, а также блок General <shop> settings с названием магазина, компанией и контактным e-mail.
  • Shop name
    Короткое название магазина. Выводится в <name>.
    YML
  • Company full name
    Полное наименование компании. Выводится в <company>.
    YML
  • Contact email
    Контактный e-mail магазина.
    YML
  • Generated file name
    Например nevigen_export_yml; результат будет XML-файлом.
    ФАЙЛ

Шаг 4. Язык, валюта и формат контента

На вкладке Extra settings задаются параметры, которые влияют на язык, валюту, URL и очистку описаний.
Дополнительные параметры YML Feed Export: язык, валюта, SEF URL и HTML
Эти настройки особенно важны для разных языковых версий магазина и площадок со своими требованиями к URL и описаниям.
  • Content language
    Язык названий, описаний и другого мультиязычного контента.
    ЯЗЫК
  • Price list currency
    Валюта, в которой нужно передавать цены.
    ВАЛЮТА
  • Конвертация валют
    Если валюта товара отличается, цены могут пересчитываться по курсам JoomShopping.
    ВАЛЮТА
  • Disable SEF
    Управляет использованием SEO/SEF URL в фиде.
    URL
  • Remove HTML tags
    Удаляет HTML-разметку из описаний, если внешний сервис ожидает чистый текст.
    ОПИСАНИЕ

Шаг 5. Фильтрация товаров

На вкладке Product filters задается, какие товары должны попасть в XML. Это позволяет создавать разные фиды для отдельных частей каталога.
Фильтры товаров YML Feed Export: категории, производители, товары, остаток и цена
Для категорий доступны режимы Do not consider, Only selected и Exclude selected. Аналогичная логика может применяться и к другим группам фильтрации.
  • Category filter
    Не учитывать, экспортировать только выбранные категории или исключить выбранные.
    КАТЕГОРИИ
  • Manufacturer filter
    Ограничить экспорт производителями/брендами.
    ПРОИЗВОДИТЕЛИ
  • Product filter
    Дополнительно ограничить набор конкретными товарами.
    ТОВАРЫ
  • Minimum stock
    Не включать товары с остатком ниже заданного.
    НАЛИЧИЕ
  • Minimum price
    Не включать товары дешевле заданной суммы.
    ЦЕНА

Шаг 6. Настройте Offer parameters

Вкладка Offer parameters управляет структурой данных внутри каждого товарного элемента <offer>. Именно здесь задается, какие поля нужно передавать конкретному сервису.

Требования площадок отличаются

Перед настройкой <offer> проверьте документацию сервиса-приемника: набор обязательных полей для разных платформ может отличаться.

Шаг 7. Product elements и Product parameters

Кнопки Product elements и Product parameters используются для настройки маппинга: какие поля JoomShopping должны преобразовываться в стандартные YML-элементы и параметры.
  • <description>
    Полное или краткое описание товара. Если нужен чистый текст — используйте удаление HTML.
    ОПИСАНИЕ
  • <vendor>
    Производитель/бренд.
    БРЕНД
  • <vendorCode>
    EAN, Code или SKU — в зависимости от структуры каталога.
    АРТИКУЛ
  • <param>
    Характеристики товара: цвет, размер, материал, вес и т. д.
    ХАРАКТЕРИСТИКИ

Product parameters

Параметры товаров работают как selected params: в фид попадают только те параметры, которые выбраны в текущем профиле.

Шаг 8. Цены, старая цена и модификация

  • Основна ціна
    Передается в выбранной валюте профиля.
    ЦЕНА
  • Old Price
    Может использоваться для генерации <oldprice> и передачи старой цены.
    СКИДКА
  • Price modification
    Позволяет применять модификацию цены при формировании фида.
    МОДИФИКАЦИЯ
  • Порожня ціна
    Товары с пустой ценой могут быть пропущены при генерации.
    КОНТРОЛЬ

Шаг 9. Доставка и служебные поля

  • Delivery
    Можно передавать информацию о доставке в соответствии с конфигурацией профиля.
    YML
  • Sales Notes
    Текстовое примечание об условиях продажи, если оно требуется сервису-приемнику.
    YML
  • SEO-friendly URL
    Расширение поддерживает SEO-дружественные ссылки для товаров и категорий.
    URL

Шаг 10. Сохраните профиль и сформируйте XML

После завершения настройки нажмите Save, а затем Export. Файл будет сформирован с расширением .xml.

Первый запуск лучше делать на небольшом наборе

Ограничьте профиль одной категорией или небольшим количеством товаров, сформируйте XML и проверьте структуру. После успешной проверки расширьте фильтры на весь нужный каталог.
  • Проверьте XML
    Название магазина, валюту, URL, количество товаров, цены, описания, производителя, артикул и характеристики.
    ПРОВЕРКА
  • Проверьте в сервисе
    Загрузите или подключите XML к целевой площадке и проверьте ее валидатор/ошибки.
    ВАЛИДАЦИЯ
  • Сохраните профиль
    Не изменяйте рабочий профиль без необходимости — для другой платформы лучше создать новый.
    ПРОФИЛЬ

Шаг 11. Автоматическое обновление через CLI / Cron

После того как ручной экспорт проверен, фид можно обновлять автоматически по расписанию через CLI/Cron. Это особенно важно для больших каталогов, где цены и остатки меняются регулярно.

CLI / Cron

Параметр --live-site должен содержать завершающий символ /. Это важно для корректного формирования ссылок при запуске экспорта через CLI.

Примеры профилей

  • UA / UAH
    Украинский язык, гривна, нужные категории.
    ЛОКАЛЬНЫЙ ФИД
  • EN / USD
    Английский контент и цены в долларах.
    МЕЖДУНАРОДНЫЙ
  • Окремий маркетплейс
    Собственный набор товаров, полей, параметров и URL.
    ОТДЕЛЬНЫЙ ПРОФИЛЬ
  • Промо-каталог
    Только товары определенной категории или производителя с дополнительной фильтрацией.
    СПЕЦИАЛЬНЫЙ

Типичные проблемы

  • Нет части товаров
    Проверьте Category / Manufacturer / Product filters, Minimum stock и Minimum price.
    ФІЛЬТРИ
  • Неправильная валюта
    Проверьте Price list currency и курсы JoomShopping.
    ВАЛЮТА
  • HTML в description
    Включите Remove HTML tags, если платформа не принимает разметку.
    ОПИСАНИЕ
  • Некорректные URL в Cron
    Проверьте --live-site и завершающий /.
    CLI
  • Нет нужных характеристик
    Проверьте Product parameters и выбранные параметры профиля.
    PARAM
  • Площадка отклоняет фид
    Сверьте Product elements / Offer parameters с требованиями именно этого сервиса.
    MAPPING

Поддержка

Если XML генерируется, но внешний сервис его не принимает, перед обращением в поддержку подготовьте файл или URL фида, название профиля, скриншоты его настроек и точный текст ошибки сервиса-приемника.
Краткий бриф

Расскажите о вашем проекте

Несколько ответов помогут понять задачу и оценить следующий шаг.

01. Задача
02. Детали
03. Контакты
Не нужно готовить полное техническое задание. Опишите задачу своими словами.

Обсудить интеграцию

Опишите сервис и данные, которыми нужно обмениваться. Этого достаточно для предварительной оценки задачи.


Что нужно интегрировать?
Можно выбрать несколько вариантов.
Если документация публичная, добавьте ссылку. Это поможет быстрее оценить возможности интеграции.

Как должен работать обмен данными?
Например: получать остатки из CRM, передавать заказы с сайта или синхронизировать данные в обе стороны.
Какие данные нужно передавать?
Опишите желаемый сценарий работы. Технические термины необязательны.