bukashk0zzz/ymlgenerator

YML (Yandex Market Language) file generator

YML (Yandex Market Language) file generator

About

YML (Yandex Market Language) generator. Uses standard XMLWriter for generating YML file. Not required any other library you just need PHP 5.5.0 or >= version.

Generator supports this offer types:

• OfferCustom (vendor.model)
• OfferBook (book)
• OfferAudiobook (audiobook)
• OfferArtistTitle (artist.title)
• OfferTour (tour)
• OfferEventTicket (event-ticket)
• OfferSimple (empty)

Installation

Run composer require

composer require bukashk0zzz/yml-generator

Or add this to your composer.json file:

"require": {
	"bukashk0zzz/yml-generator": "dev-master",
}

Usage examples

<?php

use Bukashk0zzz\YmlGenerator\Model\Offer\OfferSimple;
use Bukashk0zzz\YmlGenerator\Model\Category;
use Bukashk0zzz\YmlGenerator\Model\Currency;
use Bukashk0zzz\YmlGenerator\Model\Delivery;
use Bukashk0zzz\YmlGenerator\Model\ShopInfo;
use Bukashk0zzz\YmlGenerator\Settings;
use Bukashk0zzz\YmlGenerator\Generator;

$file = tempnam(sys_get_temp_dir(), 'YMLGenerator');
$settings = (new Settings())
    ->setOutputFile($file)
    ->setEncoding('UTF-8')
;

// Creating ShopInfo object (https://yandex.ru/support/webmaster/goods-prices/technical-requirements.xml#shop)
$shopInfo = (new ShopInfo())
    ->setName('BestShop')
    ->setCompany('Best online seller Inc.')
    ->setUrl('http://www.best.seller.com/')
;

// Creating currencies array (https://yandex.ru/support/webmaster/goods-prices/technical-requirements.xml#currencies)
$currencies = [];
$currencies[] = (new Currency())
    ->setId('USD')
    ->setRate(1)
;

// Creating categories array (https://yandex.ru/support/webmaster/goods-prices/technical-requirements.xml#categories)
$categories = [];
$categories[] = (new Category())
    ->setId(1)
    ->setName($this->faker->name)
;

// Creating offers array (https://yandex.ru/support/webmaster/goods-prices/technical-requirements.xml#offers)
$offers = [];
$offers[] = (new OfferSimple())
    ->setId(12346)
    ->setAvailable(true)
    ->setUrl('http://www.best.seller.com/product_page.php?pid=12348')
    ->setPrice($this->faker->numberBetween(1, 9999))
    ->setCurrencyId('USD')
    ->setCategoryId(1)
    ->setDelivery(false)
    ->setName('Best product ever')
;

// Optional creating deliveries array (https://yandex.ru/support/partnermarket/elements/delivery-options.xml)
$deliveries = [];
$deliveries[] = (new Delivery())
    ->setCost(2)
    ->setDays(1)
    ->setOrderBefore(14)
;

(new Generator($settings))->generate(
    $shopInfo,
    $currencies,
    $categories,
    $offers,
    $deliveries
);

Adding custom elements

if you need additional offers elements in your yml file using method addCustomElement('type','value'). For example:

$offers[] = (new OfferSimple())
    ->setId(12346)
    ->setAvailable(true)
    ->setUrl('http://www.best.seller.com/product_page.php?pid=12348')
    ->setPrice($this->faker->numberBetween(1, 9999))
    ->setCurrencyId('USD')
    ->setCategoryId(1)
    ->setDelivery(false)
    ->setName('Best product ever')
    ->addCustomElement('type', 'value')
;

Copyright / License

See LICENSE

ymlgenerator's Issues

Adding product photo

How to add product photo? (Maximum 10 photos from Yandex instructions)

How to add a quantity to an offer?

<offer>
<count>7</count>
</offer>

github/workflows

Addingd typePrefix

https://yandex.ru/support/partnermarket/elements/vendor-name-model.html

в элементе typePrefix — тип или категорию товара;

добавить размеры товаров

https://yandex.ru/support/partnermarket/offers.html#offers

было бы полезна функция для добавления размеров товара в упаковке

Added purchase_price

For pricelabs format

https://yandex.ru/support/pricelabs/rate/rate-marg.html#fix__import

Content-type

del

Return the generated data in a string.

When working with a small product catalog, I want to generate and give it away each time a bot accesses without using files.

Acceptance criteria: the generated product catalog can be obtained as a string variable.

- name: Obfuscate with PSU uses: psuDevelopment/[email protected]

Wrong break line

Trying to load file in yandex and got error https://skr.sh/sHyHN7C1CvV
After change this https://skr.sh/sHywt84cCbl to this https://skr.sh/sHya3o9cEV8 (one line), all becomes is ok.

Add availability field

In my project I need to add an availability field with params

<availability>
  <isAvailable/>
  <daysFrom/>
  <daysTo/>
</availability>

(https://yandex.ru/support/autoru-legal/price-list-parts.html)
I didn't find solution for this. It would be perfect to add some custom blocks of xml inside every offer while generating file

No image method ?

Hello, i can't add image in YmlGenerator

Add custom attributes for categories

Hey.

In my case, i need to add custom attributes for the categories. As an example url.

Use iterable instead of arrays in Generator

It would allow to use generators, thus greatly reducing memory usage.

How to add custom Attribute in addCustomElement method ?

How to add custom Attribute in addCustomElement method ?
Like this

Yml file

• name: google-api-fetch-token-action
  uses: cardinalby/[email protected]

How do I use that ^ & what is a yml file how do I paste tokens into my yml file??

How add custom stock tag?

How add custom stocks?

 <offer id="1638" available="false" group_id="12345">
        <url>http://example.com/product/id1638</url>
        <price>545.30</price>
        <categoryId>1293</categoryId>
        <categoryId>1345</categoryId>
        <picture>http://example.com/images/1638_1.jpg</picture>
        <name>Товар 2</name>
        <param name="Цвет">Белый</param>
        <description>Описание товара 1638</description>
        <vendor>Название производителя</vendor>
        <model>Модель товарного предложения</model>
        <stock id="Москва">
          <available>true</available>
          <price>500</price>
          <oldprice>550</oldprice>
          <url>http://example.com/product/id1638</url>
          <picture>http://example.com/images/1638_2.jpg</picture>
        </stock>
        <stock id="Екатеринбург">
          <available>true</available>
          <price>540.50</price>
          <oldprice>600</oldprice>
          <url>http://example.com/product/id1638</url>
          <picture>http://example.com/images/1638_3.jpg</picture>
        </stock>
      </offer>

Ability to add enable_auto_discounts tag for offers and shop info

https://yandex.ru/support/partnermarket/elements/enable_auto_discounts.html

Было бы полезно добавить возможность управлять тегом enable_auto_discounts глобально из ShopInfo и индивидуально в Offers, чтобы все было из коробки. Сейчас проблему можно решить наследованием. Предложение больше для удобства