Версия документации от 02.11.2012
Настройка модуля Яндекс.Маркет PRO заключается в выборе схемы yml и сопоставления атрибутов товара в магазине, полям в формате yml, а так же установке дополнительных параметров выгрузки.
Например, чтобы сопоставить поле yml name с нужным атрибутом в магазине, необходимо в настройках модуля в поле Name выбрать из выпадающего списка нужный атрибут (обычно, Name, либо любой произвольный).
В результате этих действий, при формировании файла yml для ЯМ в поле name yml будет подставляться значение атрибута Name для каждого обрабатываемого товара.
Пункт настройки | Назначение |
---|---|
Включен | Включение/выключение модуля.
|
Логин | Логин для http авторизации (может быть пустым). Если пусто, авторизация не применяется. |
Пароль | Пароль для http авторизации. |
Название магазина | Короткое название магазина (название, которое выводится в списке найденных на Яндекс.Маркете товаров). Не должно содержать более 20 символов. Нельзя использовать слова, не имеющие отношения к наименованию магазина ("лучший", "дешевый"), указывать номер телефона и т.п. Название магазина, должно совпадать с фактическим названием магазина, которое публикуется на сайте. При несоблюдении данного требования наименование может быть изменено Яндексом самостоятельно без уведомления Клиента. Обязательное поле. |
Компания | Полное наименование компании, владеющей магазином. Не публикуется, используется для внутренней идентификации. Обязательное поле. |
URL магазина | URL-адрес главной страницы магазина, без http://. Обязательное поле. |
Основная валюта магазина | Основная валюта магазина, для нее будет установлен курс валюты 1. Доступно RUB, UAH, BYR, USD, EUR, KZT. |
Local_delivery_cost для всех товаров | В элементе local_delivery_cost указывается стоимость доставки для своего региона. Будет применена ко всем товарам у которых не установлен этот параметр. |
Схема YML | Упрощенная или vendor.model. Схема устанавливается для всех товаров в файле. |
Name | Название товарного предложения. |
Шаблон наименования товара (name) |
Позволяет вставлять атрибуты в название товарного предложения с помощью плэйсхолдеров {{}}. Если заполнено, то будет использоваться вместо атрибута Name, name из атрибута будет проигнорировано. Пример: |
Delivery | Элемент позволяет указать возможность доставки соответствующего товара. «false» — товар не может быть доставлен. «true» — товар доставляется на условиях, которые описываются в партнерском интерфейсе Яндекс.Маркет. |
Local_delivery_cost | Стоимость доставки данного товара в своем регионе. |
TypePrefix | Группа товаров \ категория. |
Vendor | Производитель. |
VendorCode | Код товара (указывается код производителя). |
Model | Модель. |
Description | Описание товарного предложения. |
Sales_notes | Элемент используется для отражения информации о минимальной сумме заказа, минимальной партии товара или необходимости предоплаты, а так же для описания акций, скидок и распродаж. Допустимая длина текста в элементе — 50 символов. |
Manufacturer_warranty | Элемент предназначен для отметки товаров, имеющих официальную гарантию производителя. |
Country_of_origin | Элемент предназначен для указания страны производства товара. |
Barcode | Штрихкод товара, указанный производителем. |
Pickup | Элемент позволяет указать возможность зарезервировать выбранный товар и забрать его самостоятельно. «false» — возможность «самовывоза» отсутствует. «true» — товар можно забрать самостоятельно. |
Store | Элемент позволяет указать возможность купить соответствующий товар в розничном магазине. «false» — возможность покупки в розничном магазине отсутствует. «true» — товар можно купить в розничном магазине. |
Cron |
|
Имя файла в который будет выгружаться yml по cron | Если заполнено, то yml будет генерироваться в файл с заданным в этом поле именем, иначе import.yml |
Имя файла в который будет выгружаться snippet yml по cron | Если заполнено, то yml сниппета будет генерироваться в файл с заданным в этом поле именем, иначе import.snippet.yml |
Выгружать все картинки товара |
|
Статистика |
Внимание! При длинных названиях товара возможно превышение допустимаой длины URL и получения предупреждения от Яндекса. В этом случае рекомендуется отключить метки статистики. |
Категорию в URL |
|
Использовать минимальную цену товара |
|
Настройка Яндекс.Маркет Гардероб заключается в выборе атрибутов которые будут использоваться для значений цвета/размера.
Выгружаются простые и конфигурируемые товары. Для выгрузки в Гардероб атрибут цвет обязателен.
Все атрибуты должны иметь тип Список.
Пункт настройки | Назначение |
---|---|
Включен | Включение/выключение модуля.
|
Атрибуты Цвета |
Атрибуты использующиеся для указания Цвета. Множественный выбор. В выгрузку будет подставлен первый найденный артибут из списка. Обязательный атрибут. |
Атрибуты Размера |
Атрибуты использующиеся для указания Размера. Множественный выбор. В выгрузку будет подставлен первый найденный артибут из списка. Обязательный для товаров к которым применимо понятие размерности. Если атрибут в товаре отсутствует, то соотв. тег param не выгружается. |
Юнит Размера (unit) |
Атрибуты использующиеся для указания Юнита. Множественный выбор. В выгрузку будет подставлен первый найденный артибут из списка. Рекомендуемы обозначения размерных сеток в атрибуте unit: По странам:
По типу измерения:
|
Юнит Размера (unit) по умолчанию. | Если атрибут юнита не найден в товаре, будет подставлен юнит из этого поля. |
Атрибуты Пола |
Атрибуты использующиеся для указания Пола. Множественный выбор. В выгрузку будет подставлен первый найденный артибут из списка. Если атрибут в товаре отсутствует, то соотв. тег param не выгружается. |
Атрибуты Возраста |
Атрибуты использующиеся для указания Возраста. Множественный выбор. В выгрузку будет подставлен первый найденный артибут из списка. Если атрибут в товаре отсутствует, то соотв. тег param не выгружается. |
Атрибуты Материала |
Атрибуты использующиеся для указания Материала. Множественный выбор. В выгрузку будет подставлен первый найденный артибут из списка. Если атрибут в товаре отсутствует, то соотв. тег param не выгружается. |
метод | свойства |
---|---|
rugento_yml_collection |
Вызывается после формирования коллекции, и перед подстановкой атрибута для фильтрации товаров выгрузки (yml). Пример использования:/** * Меняем код атрибута для фильтрации с yml на my_new_attribute */ public function changeAttribute($event) { //получили объект с фильтром $attributeFilter = $event->getEvent()->getData('attribute_filter'); //заменили код атрибута на нужный $attributeFilter->setData('attribute_code', 'my_new_attribute'); return $this; } |
rugento_yml_product_before |
Флаги
Вызывается перед передачей товара на обработку. Пример использования:/** * Что-то делаем) */ public function fnc($event) { //получили товар $product = $event->getEvent()->getData('product'); //получили ноду offers $xml_offers_node = $event->getEvent()->getData('xml_offers_node'); //получили вычисленный id категории товара $product_category_id_before = $event->getEvent()->getData('product_category_id_before'); //получили категорию маркета $market_category_value_before = $event->getEvent()->getData('market_category_value_before'); //что-то сделали //поставили флаг прекращения дальнейшей обработки, если нужно $product->setData('_noLoadToXml', true); return $this; } |
rugento_yml_market_category |
Вызывается перед подстановкой ноды категории ЯМ. Пример использования:/** * Меняем категорию ЯМ */ public function changeCategory($event) { //получили объект с категорией $category = $event->getEvent()->getData('category'); //заменили категорию $category->setData('category', 'Подарки, сувениры, цветы/Декоративная посуда'); return $this; } |
rugento_yml_product_xml_out |
Вызывается после обработки товара и формирования ноды. Пример использования:/** * Добавляем произвольный тег param * и меняем название товара */ public function addParamTag($event) { $_helper = Mage::helper('ymlpro'); //получили ноду $offer = $event->getEvent()->getData('xml_offer'); //добавляем param $param = $offer->addChild('param', $_helper->filterElement('значение_param')); //добавляем атрибут для param, если нужно $param->addAttribute('название атрибута', $_helper->filterElement('значение_атрибута')); //меняем название товара $offer->{'name'} = 'Новое название товара'; return $this; } |
Метод | Описание |
---|---|
getSimpleXmlProductNode |
Создает и прикрепляет к заданной ноде обработанный товар.
$xmlNode = Mage::helper('ymlpro')->getSimpleXmlProductNode($product, $parentNode); |
getMarketCategoryArray |
Возвращает массив всех категорий ЯМ.
$yamCategory = Mage::helper('ymlpro')->getMarketCategoryArray(); |
getValue |
Возвращает значение атрибута для заданного товара.
$value = Mage::helper('ymlpro')->getValue($attribute, $product); |
filterElement |
Фильтрует строку для безопасной подстановки в xml.
$yamCategory = Mage::helper('ymlpro')->filterElement($string); |