YML Feed Export для JoomShopping 5+
YML Feed Export формує XML-фід товарів JoomShopping у форматі YML для зовнішніх каталогів, маркетплейсів та інших сервісів. Документація нижче зосереджена на практичній роботі з розширенням: встановленні, створенні профілю, налаштуванні полів, фільтрів, маппінгу, генерації XML та автоматичному оновленні фіда.
Що можна передавати
Назви, описи, ціни, наявність, характеристики, виробника, артикул, зображення, URL та інші дані товарів. Структура фіда налаштовується під вимоги конкретного майданчика.
Як працює розширення
Крок 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-фіда. Для різних маркетплейсів або мов краще створювати окремі профілі, щоб не змінювати налаштування вручну перед кожним експортом.
Крок 3. Основні параметри
На вкладці Main parameters задаються дані профілю та службова інформація магазину, яка потрапляє у YML.
На скріншоті видно поля Profile name, Profile description, Generated file name, а також блок General <shop> settings із назвою магазину, компанією та контактним e-mail.
Крок 4. Мова, валюта та формат контенту
На вкладці Extra settings задаються параметри, які впливають на мову, валюту, URL і очищення описів.
Ці налаштування особливо важливі для різних мовних версій магазину та майданчиків із власними вимогами до URL і описів.
Крок 5. Фільтрація товарів
На вкладці Product filters задається, які товари мають потрапити до XML. Це дозволяє створювати різні фіди для окремих частин каталогу.
Для категорій доступні режими Do not consider, Only selected та Exclude selected. Аналогічна логіка може застосовуватися до інших груп фільтрації.
Крок 6. Налаштуйте Offer parameters
Вкладка Offer parameters керує структурою даних усередині кожного товарного елемента
<offer>. Саме тут задається, які поля потрібно передавати конкретному сервісу.Вимоги майданчиків відрізняються
Перед налаштуванням
<offer> перевірте документацію сервісу-приймача: набір обов’язкових полів для різних платформ може відрізнятися.Крок 7. Product elements і Product parameters
Кнопки Product elements і Product parameters використовуються для налаштування маппінгу: які поля JoomShopping повинні перетворитися на стандартні YML-елементи та параметри.
Product parameters
Параметри товарів працюють як selected params: у фід потрапляють тільки ті параметри, які вибрані у поточному профілі.
Крок 8. Ціни, стара ціна та модифікація
Крок 9. Доставка та службові поля
Крок 10. Збережіть профіль і сформуйте XML
Після завершення налаштування натисніть Save, а потім Export. Файл буде сформовано з розширенням
.xml.Перший запуск краще робити на невеликому наборі
Обмежте профіль однією категорією або невеликою кількістю товарів, сформуйте XML і перевірте структуру. Після успішної перевірки розширте фільтри на весь потрібний каталог.
Крок 11. Автоматичне оновлення через CLI / Cron
Після того як ручний експорт перевірено, фід можна оновлювати автоматично за розкладом через CLI/Cron. Це особливо важливо для великих каталогів, де ціни й залишки змінюються регулярно.
CLI / Cron
Параметр
--live-site повинен містити завершальний символ /. Це важливо для коректного формування посилань під час запуску експорту через CLI.Приклади профілів
Типові проблеми
Підтримка
Якщо XML генерується, але зовнішній сервіс його не приймає, перед зверненням у підтримку підготуйте файл або URL фіда, назву профілю, скріншоти його налаштувань і точний текст помилки сервісу-приймача.