Плагин/аддон для Joomshopping формирует прайс (экспорт данных) в формате xml/YML для интернет-магазина, построенного на CMS Joomla и компоненте JoomShopping. Поддерживаются версии Joomla 2.5 – 3.8 с соответствующими им версиями Joomshopping и даже Joomla 1.5 (отдельная ограниченная версия).

Тип описания данных

Тип описания данных – произвольный товар, “vendor.model”. Этот тип является универсальным, наиболее удобным и рекомендован для описания товаров большинства категорий Яндекс.Маркет. Согласно схемы этой модели, кроме основных тегов (название, категория, цена, валюта, фото, наличие или доступность товара под заказ), плагин поддерживает такие теги, как бренд производителя, модель, код товара, характеристики товара. Пример файла

Параметры выгрузки

Описание параметров выгрузки и YML тегов:

• имя файла (файл выгрузки имеет расширение .xml);
• название и email разработчика сайта;
• выбор изображений товара – только главное или все, или изображение категории;
• возможность пересчета цен товаров на главную валюту;
• тег <store> – наличие розничного магазина;
• тег <pickup> – возможность самовывоза;
• тег <delivery> – возможность доставки и её стоимость;
• тег <delivery-options> – для указания стоимости и сроков курьерской доставки по своему региону: cost, days, order-before. Можно указать несколько условий.
• включить атрибуты товара, кроме указанных;
• включить характеристики товара, кроме указанных;
• автоматическое определение <unit> в названиях атрибутов размеров и в значениях характеристик;
• тег <vendorCode> из полей "Код товара", "Артикул", Краткое описание или Характеристика товара;
• тег <barcode> – штрихкод товара из полей "Код товара", "Артикул", Краткое описание или Характеристика товара;
• выбор одного из четырёх полей описания товара JoomShopping, включая Second Short Description (Краткое описание 2), или описание категории товара;
• список категорий товара, которые нужно включить или исключить из прайса.
• Вместо категорий Joomshopping можно указать общую категорию на Маркете как полный путь по каталогу Маркета.
• Список производителей, которые нужно включить или исключить из прайса;
• список продавцов – все или только указанные (если Продавцы включены в настройках Joomshopping);
• список товара для исключения из экспорта;
• для склада – включить товар только в наличии;
• выбор цены для группы покупателей (поддержка плагина "Product price for User Group");
• дополнительные цены товара в зависимости от количества;
• тег <oldprice> – старая цена товара для расчёта скидки;
• тег <market_category> – категория товара согласно структуре Яндекс.Маркет.
  ВНИМАНИЕ! Кроме <market_category> также можно использовать альтернативные названия категорий;
• тег <model> – модель, можно задать через характеристики, чтобы формировалось правильное название в Маркете;
• тег <typePrefix> – вид/категория товаров;
• тег <manufacturer_warranty> – информация о гарантии производителя;
• тег <country_of_origin> определяет страну производителя из названия Производителя или через Характеристики;
• тег <adult> – товар для взрослых;
• тег <sales_notes> – примечание, например о минимальной сумме для бесплатной доставки;
• тег <cpa> – участие магазина/товара в программе Заказ на Маркете;
• тег <enable_auto_discounts> – разрешить автоматические скидки на Маркете.
• Теги available, store, pickup, model, market_category, typePrefix, vendorCode, barcode, delivery-options, sales_notes, country_of_origin, cpa (Заказ на Маркете), enable_auto_discounts можно указать для каждого товара через "Характеристики" Joomshopping (см.иллюстрацию выше). В параметрах выгрузки укажите им соответствие.
• Нет нужного xml-тега? Создайте произвольный тег из Характеристик.
• Возможно составное название товара: <name>{тип} + {бренд} + {название} + {код}</name>
• Транскодирование кириллицы в ссылках.
• Параметры в ссылках товаров для отслеживания трафика.

Аддон позволяет сохранять и вызывать на выполнение разные шаблоны/профили параметров. Вы можете сделать несколько профилей экспорта, настроенные под разные сайты, которым передаёте свои прайсы.

Так как Яндекс требует соблюдения уникальности товара в прайсе, плагин автоматически исключает дубли страниц для товаров, которые встречаются одновременно в нескольких категориях. Приоритет у категории с меньшим ID.

Есть версия "Export YML Plus 4" для магазинов, торгующих одеждой, обувью или мебелью: товары с атрибутами размер и цвет с одинаковой ценой. Формируются "виртуальные" товары для каждой комбинации цвето-размерных (и других) атрибутов. Спрашивайте! Укажите это при оформлении заказа в примечании.

Учитывается функция "Склад" Joomshopping: если "Склад" включен, статус наличия товара определяется по остатку на складе. Опция "Только в наличии" позволяет включить в экспорт только товар с положительным остатком на складе. Если функция "Склад" не активна, опция "Только в наличии" при экспорте не учитывается и весь товар считается доступным.

Страна производителя из названия производителя выводится специальным тегом <country_of_origin>.
Например, если производитель "HTC, Китай", то в xml-прайсе название производителя будет "HTC" и добавится тег <country_of_origin>Китай</country_of_origin> Также, если Производитель указан как страна, например, "Малайзия", это тоже будет показано тегом <country_of_origin>Малайзия</country_of_origin> и имеет приоритет над страной из Производителя.
Для корректной работы этой функции в справочнике Joomshopping => Опции => Список стран нужно перевести на русский язык все те страны, которые встречаются в производителях.
Кроме того, страна производителя может быть задана через Характеристики товара.

Единицы измерений unit для тега <param name="Размер экрана" unit="дюйм"> для Характеристик нужно указать в названии Характеристики в конце через запятую с пробелом, например: Размер экрана, дюйм
Плагин определяет такие обозначения: дюйм, литр, грамм, гр, кг, мм, см, метр, м, кв.м

Размерная сетка одежды, обуви для тега <param name="Размер" unit="RU"> для Атрибутов нужно добавить к названию атрибута в круглых скобках, например: Размер (RU)
Плагин определяет такие обозначения: см, INT, RU, UA, EU, DE, IT, FR, UK, US, AU, CA

<cpa> также позволяет управлять включением товара в прайс. Для этого выберите в параметре "Заказ на Маркете" опцию "Исключать из прайса"

Значениями <cpa> (Заказ на Маркете) могут быть {0, 1, да, нет, участвует, не участвует} – в прайсе будет заменено на соответствующее стандартное значение 0 или 1.

• Если у товара характеристика 'cpa' не указана или её значение "1", "да", "участвует" – товары попадают в прайс.
• Если значение характеристики 'cpa' – "0", "нет", "не участвует" – такие товары в прайс не попадут

То есть, вместо того, чтобы перечислять ID товаров в строке "Исключить товар", можно воспользоваться характеристикой <cpa>.

К данной выгрузке доступны дополнения: Блок «Promo акции» на Маркете

Установка и настройка

Аддон устанавливается из Joomshopping: Панель управления => Компоненты => Joomshopping => Установка и обновление. Проверьте в Настройках JoomShopping, "Информация о магазине" должны быть заполнены поля "Название магазина" (до 20 символов), "Название компании" (соответствует названию, под которым регистрировали компанию у Яндекса).

В панели управления Joomla плагин будет здесь: Компоненты => JoomShopping => Опции => Импорт и Экспорт => Экспорт YML imaud.

Автоматическое выполнение можно настроить через Cron:

1. Установить в списке Joomshopping => Опции => Импорт и экспорт метку "Автоматическое выполнение" только там, где нужно.
2. Командная строка для CRON (это одна строка):
   wget -O /dev/null "http://{Ваш_Домен}/index.php?option=com_jshopping&controller=importexport&task=start&ie_id={xx}&key={Ключ безопасности}"
   или
   wget "http://{Ваш_Домен}/index.php?option=com_jshopping&controller=importexport&task=start&ie_id={xx}&key={Ключ безопасности}" -O /dev/null
   или
   curl "http://{Ваш_Домен}/index.php?option=com_jshopping&controller=importexport&task=start&ie_id={xx}&key={Ключ безопасности}"
   где {xx} это id вашей выгрузки в "Импорт и экспорт",
   {Ключ безопасности} нужно взять здесь: Joomshopping => Настройки => Ключ безопасности (много букв и цифр).
3. Вставить эту ссылку в задание Cron сервера, настроить периодичность выполнения.
4. У каждого сервера могут быть свои нюансы настройки CRON. Спрашивайте у техподдержки сервера.