Выгрузка в YML содержимого магазина на Woocommerce

Описывается выгрузка в YML (Yandex Markup Language) содержимого интернет-магазина на WordPress + Woocommerce. Формат YML – это описание магазина, категорий и товаров на жестко формализованном Яндексом подмножестве языка XML и используется для загрузки информации в Yandex Market, а так же для некоторых других приложений. Выгрузка осуществляется при помощи плагина BG_YML_Dump. The same in English

В процессе выгрузки:

• создается заголовок с названием интернет-магазина, компании, агентства WEB-дизайна, которые берутся из парамертов плагина;
• создается секция валют. Основная валюта берется из настроек Woocommerce. Ее курс 1. Если интернет-магазин работает для нескольких стран, то в секцию будут включены валюты этих стран. Их курсы будут браться по центральному банку страны, которая выпускает основную валюту магазина;
• создается секция категорий;
• выводятся все товары;
• имеется возможность включать в выгрузку только некоторые выбранные администратором категории товаров или не включать их.

Выгрузка выполняется по расписанию один раз в сутки как фоновое регламентное задание. Файл выгрузки располагается на сервере и может быть загружен по его URL http://URL сайта/wp-content/uploads/yml/имя_файла.xml, где имя файла – URL сайта с точками, замененными на подчеркивание. Например, для сайта www.example.com URL файла выгрузки будет http://www.example.com/wp-content/uploads/yml/www_example_com.xml. Для того, чтобы прекратить выполнение регламентного задания, достаточно деактивировать плагин.

При желании получить выгрузку в реальном времени (тут и сейчас), на любую страницу сайта (лучше на специально созданную) можно разместить шорткод [bg-wc-uml-dump]. Файл выгрузки будет обновляться каждый раз, когда в браузере будет отображаться эта страница.

Установка плагина

Необходимо получить файл плагина bg_yml_dump.zip отсюда

Далее следуйте инструкциям “Как установить плагин WordPress” для его установки и “Как обновить плагин WordPress” для обновления. В поставку включен перевод сообщений на русский язык.

Плагин полностью совместим с сетью виртуальных сайтов WordPress Multisite (см. “Как установить WordPress multisite“, “Как настроить WordPress multisite” и “Как начать работу с WordPress multisite“).

Выгрузка в YML содержимого магазина на Woocommerce (использование плагина)

Для настройки плагина необходимо подготовить следующую информацию:

1. Короткое имя магазина (Short Shop Name).
2. Название компании – владельца магазина (Company Name).
3. Название агентства (Agency Name) WEB-дизайна (WEB-мастера).
4. Адрес электронной почты WEB-мастера (Contact email)
5. Вендор (Vendor) – поставщик или торговая марка продукции.
6. Хотите ли Вы выводить только категорию товара в теге typePrefix или включая все родительские.
7. Если Вы хотите выгружать не весь магазин, а только включать (или не включать) отдельные категории товаров, то список такох категорий.
8. Если Вы хотите ограничить в выгрузке максимальное количество URL изображения для товара, то это число.

Как только плагин установлен, его необходимо активировать на сайте (на целевом сайте для сети виртуальных сайтов WordPress Multisite).

Далее перейти “Параметры” (Settings) -> “Выгрузка товаров в YML” (Product YML Dump). На первой вкладке надо заполнить все поля подготовленной информацией, проверить ввод и нажать кнопку “Сохранить изменения” (Save Changes)  Рис. 1.

Рис. 1. Настройка плагина BG_YML_DUMP (вкладка 1)

На второй вкладке Вы можете ввести необходимые ограничения по категориям при выгрузке товаров и/или максимальное число URL изображений для товара, проверить ввод и нажать кнопку “Сохранить изменения” (Save Changes). (Рис. 2.)

Рис. 2. Настройка плагина BG_YML_DUMP (вкладка 2)

В случае возникновения каких-либо проблем, можно воспользоваться вкладкой помощи (Рис. 3.), открыть которую можно нажав на кнопку “Помощь” справа в самом верху.

Рис. 3. Настройка плагина BG_YML_DUMP (Помощь)

Это все. Раз в сутки Вы будете получать Вашу выгрузку товаров. URL файла можно использовать в Yandex Market или каких других партнерских программах.

Выгрузка в YML. Внесение изменений

Только для тех, кто понимает, что делает! Все изменения рекомендуется сначала протестировать на тестовом сайте и потом переносить на рабочий, предварительно сделав резервную копию (см. “Как организовать резервное копирование сайта“, “Как сделать backup сайта на WordPress” и “Восстановление сайта WordPress из резервной копии“).

1. Производитель товаров (Brand).

Для мультибрендового интернет-магазина можно в тегах <vendor> и </vendor> вывести название компании-производителя товара. Для этого необходимо создать Свойство (Attribute) с любым понятным названием и с ярлыком (slug) “brand“. В качестве значений свойства должны быть все названия компаний-производителей.

Очень Важно! При выборе значения этого свойства для товара, галочку “Используется для вариаций” (Used for variations) НЕ ставить.

2. Размещение файла выгрузки.

Для изменения размещения файла выгрузки в файле functions.php используемой дочерней темы (см. “Дочерняя тема WordPress“) необходимо создать фильтр, который задаст адрес папки для размещения файла выгрузки:

if ( function_exists('bg_yml_dump')) {
    add_filter('bg_yml_dir_name', 'my_dir_name');
    function my_dir_name($dir_name) {
        // Here all staff to change dump directory beginning with $dir_name =
        return $dir_name;
    }
}

3. Изменение названия категорий в теге <typePrefix>…</typePrefix>

Плагин выводит название категории, которой принадлежит товар в теге <typePrefix>…</typePrefix>. Для того, чтобы изменить это, в файле functions.php используемой дочерней темы необходимо создать фильтр, который выведет в этом теге все, что Вы хотите там видеть:

if ( function_exists('bg_yml_dump')) {
    add_filter('bg_yml_type_prefix', 'my_type_prefix', 10, 2);
    function my_type_prefix($type_prefix, $product) {
        // Here all staff
        return $type_prefix;
    }
}

4. Добавление дополнительной информации в описание товара

Некоторые интернет-магазины используют дополнительные плагины или какой иной способ добавления информации к описанию товара. Чтобы дополнить стандартное для Woocommerce описание товара  в выгрузке YML любой информацией, необходимо создать фильтр в файле functions.php используемой дочерней темы :

if ( function_exists('bg_yml_dump')) {
    add_filter('bg_yml_extra_tags', 'my_extra_tags', 10, 2);
    function my_extra_tags($product_extra_tags, $product) {
        // Here all staff
        return $product_extra_tags;
    }
}

В результате работы фильтра в переменная $product_extra_tags должна содержать набор строчек вида:

<tag1>Содержимое tag1</tag1>"\n"

где tag1 есть разрешенный для YML тег.

Описана выгрузка в YML  содержимого интернет-магазина на WordPress + Woocommerce