Настройка модуля Выгрузка на прайс агрегаторы для Интернет-магазина {SEO-Mагазин}, OpenCart 2.х, 3.х, ocStore

Для установки модуля “NeoSeo Выгрузка на прайс агрегаторы” необходимо:

• Перейти в административную панель сайта и выбрать раздел “Дополнения”->”Каналы продвижения”:
• В открывшемся списке модулей выбрать “NeoSeo Выгрузка на прайс агрегаторы” и нажать кнопку “Установить”:
• Перейти в раздел “Дополнения”->”Менеджер дополнений” и в открывшемся окне нажать на кнопку “Обновить”:

На этом установка модуля завершена и можно переходить к настройке экспорта.

Статус модуля - опция, со значениями Включено/Отключено, определяющая статус модуля

Формирование экспорта - опция определяющая тип создания файла:

• по запросу - файл будет формироваться каждый раз при обращении по ссылке. Оптимальный вариант при выгрузке не большого объема информации.
• по расписанию - файл будет формироваться по расписанию. Для этого ссылку на скрипт генерации необходимо добавить в планировщик на сервере. Этот тип формирования необходимо использовать при генерации большого объема файла.

При выборе формирования файла по расписанию будет выведена ссылка, которую необходимо добавить в планировщик.

Отладка - опция, со значениями Включено/Отключено, определяющая статус логирования работы модуля. Если необходимо проанализировать ход генерации экспорта, нужно включить данную опцию.

В модуле предустановлены самые популярные форматы:

• facebook.com,
• google merchant,
• hotline.ua,
• hotline.ua,
• yml,
• yml+цвет+размер

Для создания нового формата необходимо перейти на вкладку Форматы в настройках модуля и нажать кнопку создания формата.

После нажатия кнопки появится форма создания нового формата. Форма содержит два поля:

Формат - поле для названия формата.

XML код - поле для ввода шаблона формата. Шаблон создается на основе синтаксиса Twig. Доступные переменные шаблона перечислены ниже или на вкладке Поля в настройках модуля.

Перечень переменных шаблона:

• {date} - Дата экспорта. По умолчанию текущая дата
• {url} - URL адрес ИМ
• {currency} - Валюта предложений (устанавливается на вкладке экспорты)
• {categories} - Массив категорий экспорта
• {category} - Массив категории экспорта
• {category.id} - Идентификатор категории
• {category.parentId} - Идентификатор родительской категории
• {category.name} - Название категории
• {offers} - Массив товаров экспорта
• {offer} - Массив товара экспорта
• {offer.id} - Идентификатор экспорта
• {offer.url} - URL адрес товара
• {offer.price} - Цена товара
• {offer.currencyId} - Валюта товара (устанавливается на вкладке экспорты)
• {offer.categoryId} - Идентификатор категории товара
• {offer.name} - Наименование товара
• {offer.description} - Описание товара
• {offer.model} - Модель товара
• {offer.vendor} - Продавец товара
• {offer.vendorCode} - Код продавца
• {offer.image} - Массив ссылок на изображения товара
• {image} - Ссылка на изображение товара
• {offer.options} - Массив опций товаров
• {option} - Массив опции товара
• {option.name} - Наименование опции товара
• {option.value} - Значение опции товара
• {option.available} - Наличие товара
• {offer.attributes} - Массив атрибутов товаров
• {attribute} - Массив атрибута товара
• {attributes.name} - Наименование атрибута
• {attributes.value} - Значение атрибута

Рассмотрим структуру формата на примере популярного формата YML.

<?xml version="1.0" encoding="UTF-8"?>

<yml_catalog date="{{date}}"> - дата формирования файла

<shop>

<name>Мой магазин</name> - Название магазина

<company>Большая компания</company> - Название компании

<url>{{url}}</url> - URL адрес ИМ магазина

<currencies>

<currency id="{{currency}}" rate="1"/> - Валюта экспорта

</currencies>

<categories>

{% for category in categories%} - Перебор массива категорий

<category id="{{category.id}} - ИД категории" {% if category.parentId %} parentId="{{category.parentId}} - ИД родительской категории" {% endif %}>{{category.name}}</category>

{% endfor %}

</categories>

<offers>

{% for offer in offers%} - Перебор массива товаров

<offer available="true" id="{{offer.id}} - ИД товара">

<url>{{offer.url}} </url> - URL товара

<price>{{offer.price}}</price> - Цена товара

{% if offer.oldprice %}<oldprice>{{offer.oldprice}}</oldprice>{% endif %} – Цена товара без скидки

<currencyId>{{offer.currencyId}}</currencyId> - ИД валюты товара

<categoryId>{{offer.categoryId}}</categoryId> - ИД категории товара

<name>{{offer.name}}</name> - Название товара

<description>{{offer.description}}</description> - Описание товара

<model>{{offer.model}}</model>- Модель товара

<vendor>{{offer.vendor}}</vendor> - Производитель товара

<vendorCode>{{offer.vendorCode}}</vendorCode>- Артикул товара

<pickup>false</pickup>

<delivery>false</delivery>

<store>false</store>

{% for image in offer.image % }- Перебор массива изображений товара

<picture>{{image}}</picture>- Ссылка на изображения товара

{% endfor %}

{% for attribute in offer.attributes %} - Перебор атрибутов товара

<param name="{{attribute.name}} - Название атрибута">{{attribute.value}} - Значение атрибута</param>

{% endfor %}

</offer>

{% endfor %}

</offers>

</shop>

</yml_catalog>

В модуле предустановлены экспорты с настройками по умолчанию на самые популярные площадки:

• ava.ua,
• facebook.com,
• google merchant,
• hotline.ua,
• hotprice.ua,
• nadavi.net,
• market.yandex.ru,
• price.ua,
• prom.ua,
• rozetka.com.ua,
• torg.mail.ru

На вкладке Экспорты в настройках модуля содержится таблица с перечнем существующих в системе экспортов. Рассмотрим более детально структуру таблицы и назначение каждого столбца.

Экспорт - название экспорта.

Формат - название используемого в экспорте формата.

Статус экспорта - включен или отключен экспорт.

Ссылка - ссылка на файл экспорта (вид ссылки зависит от типа формирования). Данную ссылку нужно добавить в кабинете прайсагрегатора.

Ссылка при ручном формировании экспортов.

Ссылка при формировании экспортов по запросу.

Генерация кэша изображений - кнопка (Сгенерировать) генерации кэша изображений. Ускоряет генерацию файла, если в экспорте отключено использование оригинальных изображений. Ускорение осуществляется за счет того, что изображения в кэше будут сгенерированы заранее, а не в процессе обмена.

Действие - кнопка редактирования или удаления экспорта.

Для создания нового экспорта необходимо перейти на вкладку Экспорты в настройках модуля и нажать кнопку создания экспорта.

После нажатия кнопки появится форма создания нового экспорта. Форма содержит множество настроек. Рассмотрим каждую более детально.

Статус экспорта - опция, со значениями Включено/Отключено, определяющая статус экспорта. Если не нужно использовать экспорт, отключите его.

Формат - перечень форматов, которые существуют в модуле (вкладка Форматы в настройках модуля)

Экспорт - название экспорта

Название файла - будет отображаться в урле, по которому будет доступен экспорт. Заполняется автоматически при вводе в поле Экспорт.

Магазин - перечень магазинов, с которых выгружать товары.

Список доверенных ip адресов - укажите свой личный ip адрес или ip сервера прайс-агрегатора, чтобы больше никто не имел доступ к вашим товарам.

Язык экспорта - перечень языков, которые доступны в магазине. В опции необходимо выбрать язык, на котором будут выгружаться описания товаров и категорий.

Использовать главную категорию - выводить в {{offer.categoryId}} ИД родительской категории, а не первой категории из “Показывать в категориях”.

Используемые категории - какие категории будут выгружаться в экспорте встроенные или альтернативные категории, которые необходимо заранее создать. Как создавать альтернативные описано ниже.

Категории - список категорий магазина или альтернативных категорий. Необходимо выбрать, какие категории выгружать. Если категории не выбраны, тогда будут выгружены все.

Производители - список производителей магазина. Если производители не выбраны, тогда будут выгружены все. Если производителей нет в магазине, тогда товары могут быть не выгружены.

Выгружать товары - ручной список товаров. Можно выбрать товары, которые нужно выгрузить.

Не выгружать товары - черный список товаров. Выберите товары, которые не нужно выгружать.

Валюта предложений - список доступных валют магазина. Необходимо выбрать в какой валюте выгружать товары.

Использовать оригиналы изображений - опция, которая определяет выгружать оригинальные изображения или же изображения с измененным размером из кэша.

Ширина картинки товара - ширина изображения товара. Опция доступна, если отключена опция Использовать оригиналы изображений. Измеряется в пикселях, рекомендуемое значение - 600.

Высота картинки товара - высота изображения товара. Опция доступна, если отключена опция Использовать оригиналы изображений. Измеряется в пикселях, рекомендуемое значение - 600.

Максимальное количество картинок - лимит изображений, которые выгружаются для одного товара. Чаще всего агрегаторы принимают не более 10 картинок на товар.

Заменять перенос строки <br>,<br/> на \n - опция, которая отвечает за замену переноса строки.

SQL для тонкой настройки - поле для более тонкой настройки выборки. Например, для отбора товаров в наличии или товаров с ценой больше 1000. Укажите любое SQL выражение с использованием префикса p. "Например p.price > 100 или p.price > 100 and p.quantity > 0"

SQL для подготовки данных - поле для подготовки данных перед выгрузкой. Например, необходимо всем товарам присвоить определенного производителя или перед выгрузкой заменить какой-то параметр. Укажите серию SQL запросов, которые будут выполнены перед формированием данных. Все запросы необходимо разделять точкой с запятой - ";"

Далеко не все прайс агрегаторы принимают товары или структуру категорий в том виде, в каком они находятся в интернет магазине. Часто площадки типа hotline.ua требуют чтобы товары были выгружены по той структуре категорий, которая существует именно на hotline.ua. Но не переделывать же из-за этого весь сайт целиком?

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

Вкратце это выглядит так:

1. Создается дерево категорий, которое соответствует по структуре тому что находится на прайс агрегаторе.
2. Распределяете товары по альтернативным категориям.
3. В настройках экспорта выбираете выгрузку альтернативных категорий.
4. Профит - и сайт работает на своих категориях, и выгрузка получает нужные.

А теперь рассмотрим все это более детально.

Для создания дерева альтернативных категорий необходимо перейти в раздел Каталог - Категории мультиэкспорта.

В данном разделе можно создавать неограниченное количество категорий.

Важно следовать правилу: Для каждого прайсагрегатора должна быть создана родительская категория. Например, необходимо создать свою структуру на две площадки: Hotline и Яндекс.Маркет.

Для начала необходимо создать две категории, которые будут иметь название площадки (на самом деле называть можно по разному, главное, чтобы Вы понимали к какому прайсагрегатору будущее дерево категорий должно относится).

Для создания новой категории необходимо нажать кнопку создания категории

Форма создания новой категории имеет два поля:

Название категории - укажите название категории.

Родительская категория - список существующих категорий, которые были созданы ранее. Если у категории должна быть родительская, необходимо выбрать ее из списка.

В результате создания получилось две главные категории:

Например,

• Яндекс.Маркет должен содержать такую категорию, как Мебель для спальни
• Hotline должен содержать такую категорию, как Кухонный гарнитур, и Кухонных гарнитур - Аксессуары.

Дополним дерево категорий

В результате получим такое дерево категорий

Для создания дерева альтернативных категорий необходимо перейти в раздел Каталог - Категории мультиэкспорта.

В данном разделе можно создавать неограниченное количество категорий.

Важно следовать правилу: Перед импортом дерева категорий для каждого прайсагрегатора должна быть создана родительская категория.

Скачать пример файла с нужной структурой можно тут.

Рассмотрим импорт категорий для Hotline.

Для импорта категорий необходимо нажать кнопку “Обновить справочник”.

После нажатия будет показана форма для загрузки и обработки файла.

В поле “Родительская категория” выбираем категорию, в которую нужно импортировать дерево категорий из файла.

В поле “Файл” выбираем файл, который нужно обработать.

После необходимо нажать кнопку “Обработать”.

В результате обработки все категории из файла будут помещены в категорию Hotline.

Перед распределением товаров по альтернативным категориям, необходимо создать альтернативную структуру и в настройках экспорта выбрать выгрузку альтернативных категорий (порядок действий описан выше).

Для распределения товаров по альтернативным категориям необходимо перейти в раздел Каталог - Связи мультиэкспорта.

В разделе предоставлена возможность поштучного переопределения категорий и массового.

Для каждого экспорта есть возможность распределить товары по своей категории. Для этого необходимо выбрать экспорт в вверху раздела.

Для того, чтобы определить товар в альтернативную категорию необходимо напротив товара выбрать нужную категорию. Все настройки применяются без перезагрузки страницы.

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

Возможность распределить товар по альтернативным категориям реализована и в форме редактирования товара.

Для этого необходимо перейти в раздел Каталог - Товары, выбрать интересующий товар, перейти в его редактирование.

На вкладке Связи будет выведено поле с возможностью смены категории.

Добавлена возможность восстановления настроек форматов экспорта по умолчанию без необходимости переустановки модуля. Для этого на закладке форматы необходимо нажать кнопку “Форматы по умолчанию”.

Согласиться перезаписать данные

После чего вы увидите сообщение об успешном выполнении действий

Добавлена возможность управлять поведением модуля в случае отсутствия картинки у экспортируемого продукта. Модуль может либо пропускать отсутствующее изображение, либо отдавать вместо него картинку- заглушку (no_image.png). Для этого в настройках експорта установите соответствующее значение для поля “Пропуск изображений”.

Значение поля по умолчанию “Пропустить”.

Добавлена возможность при выгрузке устанавливать наценку на стоимость товара и цену опции. Для этого зайдите в настройки необходимого вам экспорта и установите значения для следующих полей:

Тип наценки - определяет как будет рассчитываться наценка (фиксированное значение - цена товара или опции будет изменена на указанное вами фиксированное число; процент - цена товара или опции будет изменена на указанное вами количество процентов).

Наценка на товар - значение, используемое при расчете наценки на товар.

Наценка на опции продукта - значение используемое для расчета цены опции у продукта.

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

Если в настройках вашего магазина включен расчет налогов, то налоги рассчитываются после расчета наценки.

Добавлен вариант доступа к сформированному файлу экспорта, если прямой доступ к папке  “download” закрыт. 

При использовании формирования экспорта по расписанию, на вкладке “Экспорты” в таблице с перечнем существующих в системе экспортов, в поле Ссылка” теперь содержится два вида ссылок:

Первая ссылка необходима для получения файла выгрузки, если доступ к папке  “download” запрещен. При нажатии на данную ссылку файл выгрузки будет скачан на Ваш компьютер или будет считан соответствующим прайс агрегатором при обращении по данной ссылке.

Вторая ссылка необходима для открытия файла выгрузки через браузер или для считывания соответствующим прайс агрегатором. При нажатии на данную ссылку Вы можете просмотреть файл выгрузки, при условии, что папка “download” открыта для доступа:

Добавлен новый формат и экспорт besplatka для выгрузки товарных позиций на площадку besplatka.ua. 

Ссылку для импорта вы используете в личном кабинете сайта  Бесплатка. Ее необходимо добавить в разделе “Импорт”

Добавлена возможность использовать в выгрузке мета теги товара {offer.meta_title}, {offer.meta_h1},{offer.meta_description},{offer.meta_keyword},{offer.tag}

Добавлена возможность использовать в выгрузке следующие теги:

• {offer.meta_title} - Мета заголовок товара
• {offer.meta_h1} - Поле мета Н1 товара
• {offer.meta_description} - Мета описание товара
• {offer.meta_keyword} - Ключевые слова товара
• {offer.tag} - Мета теги товара

Для использования данных тегов необходимо:

1. В настройках модуля “NeoSeo Мульти Экспорт” перейти на вкладку “Форматы”.
2. Выбрать формат, в котором необходимо использовать данные теги и нажать на кнопку “Редактировать”
   
3. На форме редактирования формата добавим в поле “XML код” следующие строки:
   <meta_title>{{offer.meta_title}}</meta_title>
   <meta_h1>{{offer.meta_h1}}</meta_h1>
   <meta_description>{{offer.meta_description}}</meta_description>
   <meta_keyword>{{offer.meta_title}}</meta_keyword>
   <tag>{{offer.tag}}</tag>
   
   Обратите внимание, что данные строки должны находиться внутри цикла, который перебирает товары: {% for offer in offers%}.
4. Сохраните формат выгрузки:
   

В результате, выгрузка в формате YML будет иметь следующий вид:

Переменная path теперь работает с категориями мультиэкспорта.

В экспорт добавлена опция "Разделитель имен категорий".

На форме редактирования экспорта добавлена опция "Разделитель имен категорий". Данная опция предназначена для того, чтобы указать разделить между именем главной категории и именами дочерних категорий в файле экспорта.

Для примера рассмотрим экспорт в формате “Besplatka.ua”. Для добавления разделителя имен категорий необходимо:

• В настройках модуля “NeoSeo Мультиэкспорт” перейти на вкладку “Экспорты”.
• Открыть форму редактирования экспорта
  
• На форме редактирования экспорта указать необходимый разделить для опции "Разделитель имен категорий"
  
• Сохранить настройки экспорта
  

В результате, выгрузка в формате “Besplatka.ua” будет иметь следующий вид:

Добавлена возможность использовать скидки товара {offer.special.N}, где N идентификатор группы покупателя, для которой активна скидка.

Данный тег необходимо использовать в том случае, если для товаров требуется указать акционную цену для определенного типа покупателей.

Для примера, добавим акцию для товара “Ручка шариковая CANDY”:

Данная акция добавлена для группы покупателей “Розничный покупатель”.

Для того, чтобы указать акционную цену для данного типа покупателя необходимо:

• Перейти в настройки модуля “NeoSeo Мультиэкспорт” на вкладку “Форматы”, выбрать формат и нажать на кнопку “Редактировать”:
  
• На форме редактирования формата добавим в поле “XML код” следующую строку:
  <offer.special.1>{{offer.special.1}}</offer.special.1>
  где 1 - идентификатор группы покупателей, для которой добавлена скидка. Для того, чтобы узнать идентификатор группы покупателей необходимо в административной панели сайта выбрать пункт меню “Покупатели” - “Группы покупателей” и нажать на кнопку редактирования для интересующей группы:
  На форме редактирования группы покупателей, в строке браузера будет указан идентификатор данной группы.
  
  Обратите внимание, что строка <offer.special.1>{{offer.special.1}}</offer.special.1> должна находиться внутри цикла, который перебирает товары: {% for offer in offers%}:
  В результате, выгрузка в формате “AVA.UA” будет иметь следующий вид:
  

Для версии 2.3 добавлена возможность выгружать отключенные товары.

На форме редактирования экспорта добавлена опция "Выгружать только включенные товары". При выборе значения “Включено” в файл экспорта будут добавлены только товары со статусом “Включено”. При выборе значения “Отключено” в файл экспорта будут добавлены товары со статусами “Включено” и “Отключено”.

Для примера проведем выгрузку из магазина в котором добавлены следующие товары:

Для того, чтобы выгрузить все товары (со статусами “Включено” и “Отключено”) необходимо:

• В настройках модуля “NeoSeo Мультиэкспорт” перейти на вкладку “Экспорты”.
• Открыть форму редактирования экспорта
  
• Для опции “Выгружать только включенные товары” выбрать значение “Отключено”
  
• Сохранить настройки модуля
  

В результате файл выгрузки будет иметь следующий вид:

При выборе значения “Включено” для опции “Выгружать только включенные товары” в файл выгрузки будет добавлен только товар со статусом “Включено”: