Эта инструкция даст ответы на вопросы: "Что такое YML фид?", "Как импортировать товары из YML фида в WooCommerce?".
Что такое YML фид?
YML фид (YML файл) — это специальный формат каталога товаров, который используется для автоматической выгрузки ассортимента интернет-магазина на Яндекс Маркет и другие торговые площадки, включая обычные интернет магазины на базе WordPress + WooCommerce.
Установка и активация плагина Import from YML
Для импорта товаров из YML в WooCommerce необходимо скачать и установить плагин Import from YML из официального репозитория WordPress. Перед установкой убедитесь, что ваш сайт соответствует перечисленным ниже минимальным требованиям.
Минимальные требования
Для успешной работы плагина Import from YML необходимо выполнение следующих условий:
- Версия WordPress: Плагин разработан для работы с WordPress версии 5.9 и выше.
- Версия WooCommerce: Плагин совместим с WooCommerce версии 4.5.0 и выше. Рекомендуемая версия WooCommerce — 9.3 и выше.
- Версия PHP: Минимальная поддерживаемая версия PHP — 7.4. Рекомендуется использовать PHP версии 8.3 и выше для оптимальной производительности и безопасности.
- Функционирующий WP_CRON: Минимальный интервал срабатывания CRON должен составлять не менее 1-го раза в 2 минуты. Если вы отключили WP_CRON в пользу серверного, то обязательно следуйте рекомендациями из этой статьи.
С версии 4.4.0 в плагине появилась поддержка командной строки WP-CLI. Если на вашем сайте выключен вордпресовский крон, то вы можете запустить генерацию через командную строку.
Установка плагина
Для установки откройте раздел "Плагины", выберите "Добавить плагин". В строке поиска введите "YML" и нажмите "Установить сейчас" напротив плагина Import from YML.
После установки активируйте, нажав кнопку "Активировать плагин".
После активации перейдите на страницу "IPYTW", откроется страница со списком фидов (изначально он будет пуст). Нажмите на кнопку "Добавить новый фид".
Откроется страница настроек фида с тремя основными вкладками:
- Основные настройки — задаёт источник данных, периодичность импорта, базовые параметры и статус публикации товаров.
- Поведение при импорте & Фильтрация — определяет правила обработки товаров: обновление, фильтрацию дубликатов и действия с отсутствующими позициями.
- Данные товара & Медиа — настраивает импорт конкретных данных (артикулы, штрихкоды, описания, цены) и обработку изображений.
Забегая вперёд, скажу, что для того, чтобы начать импорт, достаточно изменить значение поля "Начать автоматический импорт" на любое, кроме "Не начинать", а также указать ссылку на YML файл в поле "YML файл" или загрузить файл с компьютера с помощью кнопки ниже. Затем нажать "Сохранить & Начать импорт".
В качестве альтернативы можно воспользоваться командами WP-CLI. Подробную информацию о поддерживаемых командах вы найдете в этой инструкции (она пока на стадии написания).
Настройка плагина (импорт товаров из YML фида)
Теперь более подробно разберём содержимое вкладок.
Вкладка "Основные настройки"
Эта вкладка — отправная точка для настройки плагина: корректная конфигурация здесь обеспечит бесперебойную работу последующих этапов импорта. Содержит ключевые параметры для настройки процесса импорта товаров из YML‑фида. Здесь вы задаёте:
- источник данных (URL или загрузка файла) и учётные данные для доступа к фиду;
- периодичность и время запуска импорта;
- общие правила обработки товаров (например, импорт как партнёрских);
- технические ограничения (время выполнения скрипта, таймаут загрузки изображений);
- базовые параметры публикации товаров (автор, статус после импорта);
- служебные метки (назначение фида для внутренней навигации).
Импортирование фида. Секция управляет статусом импорта YML‑фида. Если выбрано:
- Отключить импортирование этого фида — импорт товаров остановлен.
- Импортировать фид ... — плагин регулярно проверяет и импортирует обновления из фида согласно заданному интервалу.
Примечание. Если выбрано "Импортировать фид один раз и НЕ обновлять его" — то после завершения импорта товаров статус автоматически изменится на "Отключить импортирование этого фида".
Запустить в указанное время - отвечает за момента запуска импорта. Если выбрано:
- Сейчас — импорт стартует немедленно после нажатия кнопки "Сохранить & Начать импорт".
- Пользовательское время — импорт стартует в конкретное время (например, 13-00).
Назначение фида. Не влияет на импорт товаров. Внутренняя заметка для вашего удобства.
Максимальное время выполнения скрипта — параметр, определяющий, сколько секунд беспрерывно может выполняться скрипт при импорте товаров.
- Значение по умолчанию: 26 секунд
- При возникновении зависания во время импорта фида рекомендуется:
- Увеличить параметр на 10–30 единиц
- Например, установить значение 36–56 секунд
Важно учитывать:
- Увеличение времени выполнения может потребоваться при работе с большими объёмами данных
- Чрезмерное увеличение параметра может привести к перегрузке системы
- Настройка помогает избежать ошибок при генерации фида из-за превышения времени выполнения скрипта, разрешенного вашим сервером
При настройке данного параметра следует найти оптимальное значение, при котором:
- Система работает стабильно
- Процесс импорта фида завершается успешно
- Не возникает ошибок выполнения скрипта
При импорте изображений ждать не более - параметр задаёт максимальное время ожидания ответа от удаленного сервера при импорте изображений. Если удаленный сервер не успеет ответить за отведенное время, изображение будет пропущено.
YML‑файл. Одна из главных настроек фида. В ней указывается, откуда плагин должен взять данные о товарах для импорта. Есть два способа:
- Указать URL‑адрес фида для на стороннем сервере (например, https://site.ru/feed.yml). Используйте этот способ, если фид хранится онлайн и доступен по ссылке.
- Загрузить файл со своего компьютера, нажав на кнопку ниже поля для URL. Выберите нужный YML‑файл на вашем устройстве. Этот вариант подходит, если у вас есть готовый файл и вы хотите загрузить его напрямую. Под полем для ввода будет отображаться статус "Файл не выбран", пока вы не укажете URL или не загрузите файл. После выбора источника статус изменится на название файла или URL.
Поля Логин для доступа к фиду и Пароль для доступа к фиду заполняются только если требуется авторизация для доступа к YML‑фиду. Введите логин и пароль от источника фида в случае защиты паролем. Если фид открыт — оставьте поля пустыми, плагин автоматически это распознает.
Импортировать все товары как внешние/партнёрские. Возможные значения:
- Отключено (по умолчанию) — товары импортируются в стандартном режиме.
- Включено — все импортируемые товары будут отмечены как внешние/партнёрские. Т.е кнопка "Купить" будет вести на сторонний сайт.
Важно: функция находится в стадии тестирования. В текущей реализации только простые товары (без вариаций и модификаций) из YML‑фида будут импортированы как внешние/партнёрские.
Партнёрская ссылка. Укажите URL‑параметр или полную ссылку, которая будет добавлена к карточкам импортируемых товаров (например, ?partner=12345).
Условие применения: поле активно и учитывается плагином только при установленном значении "Включено" в опции "Импортировать все товары как внешние/партнёрские". При "Отключено" поле игнорируется.
Вкладка "Поведение при импорте & Фильтрация"
Эта вкладка позволяет настроить правила обработки товаров при импорте из YML‑фида: определить, какие товары загружать, как обновлять существующие позиции и что делать с отсутствующими или дублирующимися элементами.
Что импортировать. Здесь вы выбираете, какие товары из YML‑фида будут загружены на сайт:
Только обычные товары — плагин импортирует лишь простые товары, у которых нет вариаций (например, разных цветов или размеров).
Вариативные и обычные товары — будут загружены все товары, в том числе те, у которых есть вариации (например, футболка в разных цветах и размерах).
Если товар был ранее импортирован. Эта настройка определяет, что произойдёт с товарами, которые ранее были импортированы на ваш сайт из конкретного фида. При выборе:
- Обновить целиком — все данные о товаре (название, цена, описание, изображения и т. д.) будут перезаписаны новыми из фида.
- Обновить всё, кроме категорий — все поля обновятся, кроме категорий, к которым отнесён товар.
- Обновлять всё, кроме изображений и категорий — сохранятся текущие изображения и категории товара, а остальные данные (цена, описание и т. д.) обновятся.
- Обновляйте только изображения — плагин заменит только изображения товара на новые из фида.
- Обновить только цену — изменится только цена товара, всё остальное останется как было.
- Обновить только наличие — обновится только информация о наличии товара (остатки на складе).
- Обновить только цену и наличие — изменятся только цена и информация о наличии.
- Не обновлять этот товар — если товар уже есть, плагин его пропустит и не будет вносить никаких изменений.
Пропустить товары, которые ранее были импортированы, но находятся в корзине. При отключении этой опции, если товар ранее был импортирован и сейчас находится в корзине, плагин его восстановит и обновит данные. Если же опцию включить, товар который ранее был импортирован и сейчас находится в корзине, будет пропущен при импорте (плагин не будет пытаться достать из корзины и обновлять).
Если только одна вариация. Эта опция срабатывает, если в фиде обнаружен товар, который технически является вариативным (имеет group_Id), но при этом имеет лишь одну вариацию (например, один цвет футболки). Варианты:
- Пропустить — такой товар не будет загружен на сайт.
- Добавить как простой товар — плагин преобразует эту единственную вариацию в обычный (простой) товар и импортирует его.
Если на сайте есть товар с таким же артикулом. Опция задаёт то действие, которое необходимо выполнить, если при импорте обнаружится товар с артикулом, совпадающим с уже существующим на вашем сайте. Варианты:
- Не импортировать — плагин пропустит этот товар, чтобы избежать дублирования.
- Заменить товар на вашем сайте — существующие данные о товаре будут обновлены информацией из фида (цена, описание, изображения и т. д.).
- Импортировать без артикула — товар будет добавлен в каталог, но поле "Артикул" останется пустым, чтобы избежать дубликатов.
Если товара нет в фиде. Настройка определяет обработку товаров, которые ранее были импортированы, но в текущем YML‑фиде отсутствуют:
- Ничего — статус и данные товара останутся без изменений. Он продолжит отображаться в каталоге как раньше.
- Удалить товар, но не удалять его вложения — товар исчезнет из каталога, но его изображения и другие файлы останутся на сервере.
- Удалить товар и его вложения — товар полностью удаляется с вашего сайта вместе со всеми связанными файлами (изображениями и т. д.). Используйте эту опцию с осторожностью!
- Установить статус "Нет в наличии" — товар остаётся в каталоге, но получает статус "Нет в наличии". Это позволяет сохранить карточку товара и историю продаж.
Очень важно! Эта функция сейчас тестируется и в редких случаях может вызвать повышенную нагрузку на сервер. Перед применением на большом объёме данных сделайте резервную копию сайта.
Вкладка "Данные товара & Медиа"
Вкладка позволяет настроить, какие данные о товарах (артикулы, штрихкоды, описания, цены и т. д.) будут импортироваться из YML‑фида, а также задать правила обработки изображений: режим загрузки, ограничения по размеру и проверку после импорта.
Когда импортировать категории. Здесь вы выбираете, как плагин будет обрабатывать категории товаров при импорте:
- Всегда — категории будут обновляться при каждом импорте. Если в фиде появились новые категории, они добавятся на сайт.
- Импортировать один раз — категории загружаются на ваш сайт только при первом импорте. При последующих импортах категории существующих товаров не меняются.
- Никогда — плагин полностью игнорирует информацию о категориях из фида. Товары будут импортироваться без привязки к категориям.
Описание товара помещать в. Определяет, в какое поле на сайте попадёт описание товара из фида: полное или краткое.
Штрихкод. Выбор способа импорта штрихкода товара (GTIN, UPC, EAN, ISBN):
Не импортировать — штрихкод игнорируется и не загружается.
Импорт в стандартное поле WooCommerce "GTIN, UPC, EAN or ISBN" (рекомендуемый вариант) — штрихкод запишется в стандартное поле товара в WooCommerce.
Импорт в глобальный атрибут — штрихкод будет добавлен как глобальный атрибут товара (может использоваться для фильтрации).
Импортировать в метаполе — штрихкод сохраняется в метаполе товара. Если выбран этот вариант, обязательно заполните поле "Имя метаполя" ниже, указав имя метаполя строго на английском языке и БЕЗ пробелов (например, _my_barcode).
Артикул. Выбор элемента в YML‑фиде, который содержит артикул товара. При выборе значения Не импортировать — артикулы товаров не будут импортироваться. В остальных случаях выберите тег в фиде, который содержит артикул (для этого нужно будет открыть фид и посмотреть, в каком теге записан артикул). Плагин возьмёт значение оттуда.
Добавьте префикс Артикул. при необходимости введите префикс (например, sp1_). Он будет добавлен перед артикулом товара (получится sp1_12345). Это полезно для разделения артикулов из разных источников и борьбы с дублированиями артикулов.
Разделитель значений для param. Если в одном элементе param в фиде содержится сразу несколько значений, например:
<param name="Цвет">красный, синий</param>, укажите символ или набор символов, который их разделяет (в нашем случае это запятая). Плагин использует его, чтобы правильно разбить данные на отдельные параметры товара.
Цена распродажи (oldprice). Определяет, нужно ли импортировать старую цену товара (цену до скидки), которая указывается в теге <oldprice> фида.
Режим импорта изображений. Опция отвечает за выбор стратегии загрузки изображений товаров и напрямую влияет на скорость импорта, а также потребление ресурсов:
- Немедленный импорт изображений (включен по умолчанию) загружает все изображения сразу в процессе импорта. Этот вариант самый простой, но и самый ресурсоемкий и затратный по времени. При большом количестве товаров он может существенно замедлить обработку фида.
- Выполнить импорт изображений позже (в фоновом режиме) — плагин сначала импортирует данные о товарах, а затем в фоновом режиме загружает изображения. Это ускоряет основной процесс импорта и снижает нагрузку на сервер, но картинки будут появляться не сразу.
- Не импортировать — изображения игнорируются. В карточках товаров не будет картинок.
Пропускать изображения больше, чем. Укажите максимальный размер файла изображения в мегабайтах (МБ), который плагин будет пытаться загрузить. Изображения большего размера будут пропущены.
По умолчанию установлено значение 5 МБ. Например, если вы укажете 3, то все картинки размером более 3 МБ не будут импортированы. Это помогает избежать загрузки слишком тяжёлых файлов и экономит место на сервере и увеличивает скорость импорта.
Проверить фото после импорта. Опция для дополнительной проверки изображений после их загрузки.
Важно: включение этой функции замедляет скорость импорта, особенно при большом количестве изображений. Используйте её, если критично убедиться в работоспособности всех картинок.
Как запустить процесс импорта?
После того, как вы заполните настройки фида - перейдите на вкладку "Основные настройки" и нажмите "Сохранить & Начать импорт". После этого нужно нужно будет перейти на другие страницы админки, чтобы стартовала CRON-задача и начался импорт (уведомление о процессе импорта появится вверху страницы админке).
Если импорт не начался - проверьте работу крона, а также то, что ваш сайт удовлетворяет минимальным требованиям плагина либо используйте WP-CLI, для старта импорта в режиме командной строки.
Описание других настроек плагина
Как добавить ещё один источник для импорта?
Чтобы добавить новый фид, перейдите на страницу "IPYTW", откроется страница со списком фидов . Нажмите на кнопку "Добавить новый фид" вверху страницы.
Как посмотреть все товары, импортированные из конкретного фида?
Чтобы посмотреть все товары, которые были импортированы из конкретного фида перейдите на страницу "Товары" и воспользуйтесь фильтром "Фильтровать по фиду (IPYTW)".
Как редактировать фид?
Откройте список фидов. Наведите на желаемый фид мышкой и нажмите на всплывающую ссылку "Редактировать".
Как удалить все импортированные товары?
Чтобы удалить все импортированные из фида товары отметьте его галочкой, затем раскройте выпадающий список "Действия". Выберите пункт пункт "Удалить все импортированные товары".
Как удалить фид?
Чтобы удалить фид, отметьте его галочкой, затем раскройте выпадающий список "Действия". Выберите пункт "Удалить фид. Не удалять импортированные товары".
