YML-фид Яндекса

YML-фид Яндекса для OpenCart 4

Расширение типа «Каналы» для OpenCart 4.1.0.4: выгружает каталог магазина в формате YML (Yandex Market Language), который принимают Яндекс Маркет, Яндекс Товары (через Вебмастер), товарные кампании Яндекс Директа и совместимые площадки. В OpenCart 4.1.0.4 фидов нет; модуль строит фид прямо из базы магазина по своему адресу и хранит готовый результат в кэше.

Что выгружается

• Магазин: название и компания (из настроек фида или магазина), адрес, платформа и версия, валюта фида с курсом 1 (рубль — с кодом RUR).
• Категории: все включённые категории на языке фида или только отмеченные с их родителями; родители всегда раньше потомков.
• Предложения: включённые товары отобранных категорий с ценой больше нуля — ссылка, цена и цена до скидки (oldprice) для выбранной группы покупателей, наличие, картинки (0–20), доставка и самовывоз, название, производитель (vendor), артикул из поля «Модель» (vendorCode), штрихкод из идентификатора товара (barcode), описание (текст или простая разметка в CDATA), характеристики (param), вес в килограммах и габариты в сантиметрах, условия продажи (sales_notes).

Цены считаются так же, как на витрине для выбранной группы покупателей: акция, затем скидка на 1 штуку, с налогом, если магазин показывает цены с налогом; пересчёт в валюту фида по курсам магазина. Товары с нулевым остатком выгружаются с available="false" или исключаются — по настройке.

Настройки

Маркетинг → YML-фид Яндекса (пункт меню появляется после установки; та же страница открывается из Расширения → Расширения → Каналы). Вверху — адрес фида и кнопка «Открыть фид».

• Магазин: название (до 20 знаков по правилам площадки), компания, валюта фида, группа покупателей для цен.
• Отбор товаров: категории (список флажков с полными названиями), «Не выгружать отсутствующие».
• Состав предложения: описание (не выгружать / текст до 3000 знаков / простая разметка), число картинок, характеристики, артикул из «Модели», штрихкод (какой идентификатор товара выгружать), вес и габариты, доставка, самовывоз, условия продажи до 50 знаков.
• Параметры: формат даты фида — RFC 3339 с часовым поясом (Маркет, Товары) или ГГГГ-ММ-ДД чч:мм (требования Директа); кэш в минутах (0 — без кэша) и кнопка «Очистить кэш».

Вкладка «Руководство» открывает полное руководство пользователя внутри панели.

Совместная работа с модулем «SEO-поля»

Если установлен модуль «SEO-поля» (в сборке OCM Store — всегда), товары с выключенной индексацией в фид не попадают, категорией предложения становится главная категория товара, а при включённом каноническом адресе ссылка на товар строится с путём главной категории — тот же адрес, что в теге canonical страницы товара. Без «SEO-полей» категорией предложения становится первая по номеру из выгружаемых категорий товара.

Установка

1. Расширения → Установщик → «Загрузить» — файл yml_feed_oc4.ocmod.zip (имя не менять: OpenCart 4 берёт из него код расширения) → «Установить».
2. Расширения → Расширения, тип «Каналы» → «Установить» у «YML-фид Яндекса».
3. Обновите страницу: в разделе «Маркетинг» появился пункт «YML-фид Яндекса». Фид уже работает со значениями по умолчанию: все категории, валюта и группа покупателей магазина, 5 картинок, описание текстом, кэш 60 минут.
4. Укажите адрес фида в кабинете площадки как источник данных. Чтобы получить фид на другом языке магазина, добавьте к адресу &language=код.

Ядро не изменяется, OCMOD и обновление модификаторов не требуются. Права получает группа пользователя, который нажал «Установить»; другим группам их выдают в Система → Пользователи → Группы пользователей (маршрут extension/yml_feed_oc4/feed/yml).

Входит в состав OCM Store

Модуль входит в бесплатную русскую сборку OpenCart 4.1.0.4 OCM Store: там он уже установлен, фид доступен сразу после установки магазина. Отдельный пакет нужен для обычного OpenCart 4.1.0.4.

Обновление

Новую версию ставят поверх: Расширения → Установщик → удалить прежний пакет (кнопка «Удалить» у пакета удаляет только файлы) → загрузить новый архив → «Установить». Компонент в «Каналах» при этом не удалять: удаление компонента стирает настройки.

Удаление

Расширения → Расширения → Каналы → «Удалить» у «YML-фид Яндекса», затем Расширения → Установщик → удалить пакет. Настройки и пункт меню удаляются, кэш фида очищается.

Совместимость и ограничения

• OpenCart 4.1.0.4, PHP 8.2, тема Default — проверено; фид от темы витрины не зависит.
• OpenCart 4.0.x, ocStore 4 и сторонние сборки не проверялись.
• Товары с опциями выгружаются одним предложением по базовой цене; delivery-options с ценами и сроками, несколько фидов, тип предложений vendor.model, enable_auto_discounts, гарантия и страна производства, защита адреса ключом — в следующих версиях.
• Приём фида проверяется валидатором площадки на реальном домене магазина.

Список изменений

1.0.0 — первый выпуск: фид YML для Маркета, Товаров и Директа; категории, предложения с ценами и акциями, наличием, картинками, производителем, артикулом, штрихкодом, описанием, характеристиками, весом и габаритами; отбор категорий, валюта, группа покупателей, формат даты, кэш; учёт модуля «SEO-поля»; пункт меню «Маркетинг»; руководство во вкладке.