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. Введите лицензионный ключ для домена, на который оформлен заказ.
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.

На скриншоте видны поля 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 и очистку описаний.

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

Для категорий доступны режимы 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 фида, название профиля, скриншоты его настроек и точный текст ошибки сервиса-приемника.