yml

Плагин для записи данных продуктов компонента JKassa в файл формата YML для последующей их выгрузки в сервис Яндекс Маркет.

Стандарт YML (Yandex Market Language) разработан Яндексом и основан на стандарте XML. Формат YML предоставляет больше возможностей и преимуществ, чем форматы XLS, CSV.

Примечание

Как зарегистрировать магазин на Маркете смотрите в инструкции от Яндекса .

Чтобы узнать, как получить доступ к плагинам экспорта/импорта смотрите это руководство.

 

В этом руководстве


Параметры плагина

Ниде показаны основные параметры плагина.

yml-general
Параметры плагина
  1. Описание продукта
    Позволяет выбрать, откуда будет получено описание продукта для атрибута description.
    * Выберите параметр "Оба", чтобы взять описание с "Мета-тег Description" если нет вводного описания.

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

    Чтобы применялись условия доставки, указанные здесь, в личном кабинете, на странице Подключение и настройки → Настройки доставки, включите опцию "Использовать данные из прайс-листа".

    Одна строка — это информация об одном виде курьерской доставки:

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

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

    Подробное описание элемента delivery-options прайс-листа смотрите в Яндекс помощи .


Детали плагина

Чтобы плагин работал его необходимо включить - 1 и сделать его доступным для определённой группы пользователей - 2.

details
Публикация плагина
* Дополнительную информацию об редактировании деталей и параметров плагина смотрите в документации Joomla .

Дополнительные параметры

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

yml-advanced
Дополнительные параметры
  1. Имя системы
    Наименование формата экспорта, которое будет отображено в списке выбора формата экспорта.

  2. Логотип системы
    Логотип системы формата экспорта, который будет отображен в описании формата экспорта.

  3. Описание системы
    Описание системы формата экспорта, которое будет отображено в описании формата экспорта.


Отображение в JKassa

После включения и настройки плагина, в компоненте JKassa, в разделе "Обмен данными", в списке "Формат файла" появится новая строка (параметр) "Yandex Market" 1 (КомпонентыJKassaИнструментыОбмен даннымиЭкспортФормат файла).

yml-displaying
Обмен данными

Нажмите кнопку экспорта 2 и дождитесь окончания завершения операции. После окончания экспорта в списке сохранённых фалов вам будет доступен новый файл 3 products_xxxxxxxxxx.yml формата YML (Yandex Market Language) с данными для єкспорта в Яндекс Маркет.

* Подробней об операциях экспорта смотрите в разделе Обмен данными.


Cron URLs

Задача CRON — это система, которая автоматически запускает плагин, для создания файла экспорта, без какого-либо вмешательства человека. Используйте, сгенерированные URLs на вкладке CRON, чтобы создать задание CRON на своём веб-сервере.

gmerchant-cron
Cron URLs

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

  1. URL
    Автоматически сгенерированный Cron URL.

  2. Выбор категории
    Категория, из которой будут браться данные о продуктах для файла XML (по умолчанию "Корень").

  3. Элементы (кнопки) управления

    • Добавить строку.
    • Удалить строку.
    • Изменить порядок строки.

Совет

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

После первого успешного выполнения задания Cron в разделе компонента JKassa – "Обмен данными" будет добавлен YML файл с данными о продуктах. После последующих выполнениях заданий Cron файл будет перезаписан, имя файла останется неизменным.

Имя файла YML имеет суффикс cron_ и префикс – параметр pas из Cron-URL.

Пример Cron-URL:

http://your_site/index.php?option=com_jkassa&task=cron.export&key=yml&pas=f89ke926

Пример файла YML:

http://your_site/tmp/jkassa/export_import/cron_f89ke926.yml

В обоих ссылках присутствует определённый набор символов: f89ke926.

 

Пример Cron выражения

0 0 4 */7 * ? curl http://your_site/index.php?option=com_jkassa&task=cron.export&key=yml&pas=f89ke926

В вышеуказанном примере задание будет выполняться в 04:00:00 утра каждые 7 дней, начиная с 1-го числа каждого месяца.

Примечание

О том как создать задачу CRON на вашем сервере обратитесь к документации вашего сервера.