Joomla

teeu импортирует товары из Joomla через выгрузку в формате YML — том же, что используется для Яндекс.Маркета. Заводить карточки вручную не нужно: вы указываете ссылку на файл выгрузки, а площадка сама забирает товары и обновляет их 1–2 раза в день.

Что понадобится

• Магазин на teeu — регистрация и размещение товаров бесплатны.

• Ссылка на YML-выгрузку из Joomla, доступная по HTTPS.

Как сформировать YML-фид на сайте Joomla

Сама Joomla не формирует YML-фиды и не содержит встроенного товарного каталога. Для работы интернет-магазина в Joomla используются отдельные компоненты, например JoomShopping, VirtueMart или HikaShop. Поэтому YML-выгрузка создаётся с помощью расширения, совместимого с установленным компонентом магазина.

Перед началом проверьте, какой компонент интернет-магазина установлен на сайте. Обычно его название видно в разделе «Компоненты» административной панели Joomla.

Что понадобится

• Сайт на Joomla с установленным интернет-магазином.

• Заполненный каталог товаров.

• Расширение для формирования YML-фида, совместимое с вашим компонентом магазина и версией Joomla.

• Доступ к административной панели сайта.

• При необходимости — доступ к панели хостинга для настройки автоматического обновления по cron.

1. Определите компонент интернет-магазина

Войдите в административную панель Joomla и откройте раздел:

Компоненты

Найдите используемый компонент магазина. Это может быть:

• JoomShopping;

• VirtueMart;

• HikaShop;

• другой компонент электронной торговли.

Расширение для выгрузки необходимо выбирать именно под этот компонент.

2. Установите расширение для YML-выгрузки

В Joomla 4, 5 или 6 откройте:

Система → Установка → Расширения

Загрузите установочный архив подходящего расширения и выполните установку.

Для JoomShopping существуют отдельные дополнения YML Export. Например, актуальные решения поддерживают Joomla 4–6 и JoomShopping 5, формируют товарный файл и позволяют передавать разные типы товарных предложений.

Также существуют расширения, которые создают YML-фид для JoomShopping с фильтрацией товаров, сопоставлением полей, несколькими профилями и автоматическим обновлением по расписанию.

Важно: перед установкой обязательно проверьте совместимость расширения с вашей версией Joomla, PHP и компонентом магазина.

3. Откройте настройки YML-выгрузки

После установки откройте:

Компоненты → название компонента магазина

Дальнейший путь зависит от установленного расширения. Раздел может называться:

• Импорт и экспорт;

• YML Export;

• YML Feed Export;

• Яндекс Маркет;

• Товарные выгрузки;

• Feeds.

В JoomShopping некоторые дополнения устанавливаются через раздел:

Компоненты → JoomShopping → Установка и обновление

После установки в интерфейсе JoomShopping появляется отдельный пункт экспорта.

4. Создайте профиль выгрузки

Нажмите «Создать», «Добавить профиль» или «Новая выгрузка».

Укажите название профиля, например:

YML для teeu

Если расширение поддерживает несколько профилей, можно создать отдельную выгрузку специально для teeu.

5. Заполните данные магазина

Укажите:

• название магазина;

• название компании;

• адрес сайта;

• основную валюту;

• язык выгрузки;

• домен, на котором размещён магазин.

Адрес сайта должен быть указан с протоколом HTTPS, например:

https://shop.ru/

Это необходимо для формирования абсолютных ссылок на товары и фотографии.

6. Выберите товары и категории

Укажите, какие товары должны попасть в YML-фид:

• весь каталог;

• отдельные категории;

• товары определённых производителей;

• товары в наличии;

• только опубликованные товары;

• товары с заполненной ценой.

Современные расширения для JoomShopping позволяют фильтровать товары по категориям, наличию, статусам и брендам.

Рекомендуется включать только:

• опубликованные товары;

• товары с ценой больше нуля;

• товары, доступные для заказа;

• товары с заполненным названием и изображением.

7. Настройте цены и валюту

Выберите цену, которая должна передаваться в teeu:

• основная розничная цена;

• цена со скидкой;

• цена для определённой группы покупателей.

Также укажите валюту выгрузки.

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

8. Настройте данные товаров

Сопоставьте поля каталога с элементами YML:

• название товара;

• описание;

• цена;

• старая цена;

• артикул;

• производитель;

• модель;

• штрихкод;

• наличие;

• остаток;

• категория;

• основная фотография;

• дополнительные фотографии;

• характеристики товара;

• цвет;

• размер;

• вес;

• габариты.

Если расширение поддерживает передачу характеристик как параметров, включите необходимые свойства товара. Актуальные дополнения для JoomShopping позволяют сопоставлять дополнительные поля с элементами и параметрами YML.

9. Настройте варианты товаров

Если один товар имеет несколько размеров, цветов или других вариантов, выберите способ их выгрузки:

• отдельное предложение для каждого варианта;

• одно общее предложение;

• только основной вариант.

Для teeu предпочтительно передавать каждый доступный вариант отдельным предложением, сохраняя общий идентификатор группы, если это поддерживает установленное расширение.

10. Укажите имя и расположение файла

Укажите имя файла, например:

teeu-feed.xml

или:

catalog.yml

Несмотря на название YML, расширение может создавать файл с расширением .xml. Это нормально: YML является XML-форматом товарного фида. Например, одно из актуальных расширений JoomShopping изменило расширение создаваемого файла на .xml.

Расширение должно сформировать постоянную публичную ссылку примерно такого вида:

https://shop.ru/feeds/teeu-feed.xml

Точный адрес зависит от установленного расширения.

11. Сформируйте выгрузку

Нажмите:

«Создать файл», «Сформировать», «Экспортировать» или «Generate feed».

После завершения скопируйте полученную ссылку на YML-фид.

Ссылка должна:

• работать по HTTPS;

• открываться без авторизации;

• не требовать входа в Joomla;

• возвращать XML-файл;

• оставаться постоянной после обновления фида.

12. Настройте автоматическое обновление

Проверьте, поддерживает ли расширение обновление:

• при открытии ссылки;

• по внутреннему планировщику;

• по задаче cron;

• через команду CLI.

Для больших каталогов рекомендуется cron. Некоторые актуальные расширения JoomShopping поддерживают регулярное создание фида по расписанию через cron CLI.

Команду и периодичность запуска необходимо брать из документации конкретного расширения.

Рекомендуемая частота обновления:

• каждые 30–60 минут — если цены и остатки часто меняются;

• каждые 2–4 часа — для обычного магазина;

• один раз в сутки — если каталог изменяется редко.

13. Проверьте ссылку

Откройте ссылку в браузере в режиме инкогнито.

Файл должен открываться без авторизации и содержать структуру примерно такого вида:

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="...">
  <shop>
    <name>Название магазина</name>
    <company>Название компании</company>
    <currencies>...</currencies>
    <categories>...</categories>
    <offers>...</offers>
  </shop>
</yml_catalog>

Проверьте:

• наличие товаров;

• корректность цен;

• наличие категорий;

• остатки и доступность;

• ссылки на карточки товаров;

• ссылки на фотографии;

• артикулы;

• характеристики;

• варианты товаров;

• кодировку UTF-8.

YML должен содержать корневой элемент yml_catalog, разделы валют и категорий, а также список предложений offers.

Как подключить

1. Скопируйте постоянную ссылку на файл выгрузки.

2. В кабинете продавца teeu откройте раздел «Выгрузки» и добавьте фид по этой ссылке.

3. Дождитесь первой синхронизации — товары появятся в каталоге.

Что обновляется автоматически

После подключения фида цены, остатки и описания подтягиваются из InSales без вашего участия. Категории товаров teeu определяет автоматически, а фотографии загружает и оптимизирует.