pastuhov/yii2-yml-catalog

YML (Yandex Market Language) generator.

Компонент выгрузки каталога товаров в Яндекс.Маркет (YML)

, _(*1)

Установка

Via Composer, _(*2)

``` bash $ composer require pastuhov/yii2-yml-catalog, <sub>(*3)</sub>

## Features

* легкий
* базируется на официальной документации https://yandex.ru/support/partnermarket/yml/about-yml.xml

## Использование

1. Реализуем интерфейсы (примеры реализации всех классов смотри в директории `tests`)

2. Создаем консольный контроллер:
```php
namespace console\controllers;

use pastuhov\ymlcatalog\actions\GenerateAction;
use yii\console\Controller;

/**
 * Class GenerateController
 */
class YmlController extends Controller
{
    /**
     * @inheritdoc
     */
    public function actions()
    {
        return [
            'generate' => [
                'class' => GenerateAction::className(),
                'enableGzip' => true, # запаковать gzip-ом yml после генерации
                'fileName' => 'yml-test.xml', # желаемое название файла
                'publicPath' => '@runtime/public', # публичная директория (обычно корень веб сервера)
                'runtimePath' => '@runtime', # временная директория
                'keepBoth' => true, # опубликовать yml и .gz
                'shopClass' => 'pastuhov\ymlcatalog\Test\models\Shop',
                'currencyClass' => 'pastuhov\ymlcatalog\Test\models\Currency',
                'categoryClass' => 'pastuhov\ymlcatalog\Test\models\Category',
                'localDeliveryCostClass' => 'pastuhov\ymlcatalog\Test\models\LocalDeliveryCost',
                'offerClasses' => [
                    'pastuhov\ymlcatalog\Test\models\SimpleOffer'
                ],
            ],
        ];
    }
}

1. Запускаем из консоли:

$ yii yml/generate

Дополнительно

Дополнительно с именем класса, реализации интерфейса, можно передавать следующие параметры: 1. Объект класса ActiveQuery, или его наследника., <sub>(*4)</sub>

'categoryClass' => [
    'class' => 'pastuhov\ymlcatalog\Test\models\Category',
    'query' => \pastuhov\ymlcatalog\Test\models\Category\Category::find(),
]

В данном случае, выборка данных будет производиться с помощью передаваемого ActiveQuery или его наследника; Позволяет использовать уже созданный объект, для выборки данных., <sub>(*5)</sub>

1. Объект класса ActiveDataProvider, или его наследника.

'categoryClass' => [
    'class' => 'class' => 'pastuhov\ymlcatalog\Test\models\Category',
    'dataProvider' => new ActiveDataProvider([
        'query' => Category::find(),
        'pagination' => [
            'pageSize' => 1000,
        ]
    ]),
]

В данном случае, выборка данных будет производиться с помощью передаваемого ActiveDataProvider или его наследника;, <sub>(*6)</sub>

Позволяет делать выборку данных с использованием постраничной пагинации., <sub>(*7)</sub>

Так-же может быть передан true, в качестве параметра, для автоматического создания объекта класса ActiveDataProvider со значением количества строк в странице равной 1000., <sub>(*8)</sub>

'categoryClass' => [
    'class' => 'class' => 'pastuhov\ymlcatalog\Test\models\Category',
    'dataProvider' => new ActiveDataProvider([
        'query' => Category::find(),
        'pagination' => true,
    ]
]

На больших объемах данных, выборка, с использованием ActiveQuery->batch(), расходует оперативную память, гораздо большую, чем значение установленное в конфигурацилнных файлах. (Скорее всего особенности работы библиотеки PDO)., <sub>(*9)</sub>

Внимание: Использование ActiveDataProvider увеличивает время генерации выгрузки., <sub>(*10)</sub>

Преобразование символов " & > < ' в html-сущности

Яндекс Маркет ругается на символы " & > < '. Их нужно преобразовывать в html-сущности, чтобы проверка прайса проходила успешно. Чтобы это сделать, в модели необходимо реализовать интерфейс pastuhov\ymlcatalog\EscapedAttributes и определить метод getEscapedAttributes, который возвращает список необходимых для чистки атрибутов. В примере ниже мы указываем, что атрибут name необходимо фильтровать:, <sub>(*11)</sub>

use pastuhov\ymlcatalog\EscapedAttributes;
use pastuhov\ymlcatalog\SimpleOfferInterface;
class SimpleOffer extends ActiveRecord implements SimpleOfferInterface, EscapedAttributes
{
...
    public function getEscapedAttributes() {
        return [
            'name'
        ];
    }
...
}

Тестирование

$ composer test

или, <sub>(*12)</sub>

$ phpunit

Проверить качество сгенерируемого файла можно следующими способами: 1. Официальным валидатором https://old.webmaster.yandex.ru/xsdtest.xml 2. При помощи xmllint (пример: xmllint --valid --noout yml-test.xml) 3. IDE PhpStorm также может помочь, <sub>(*13)</sub>

Security

If you discover any security related issues, please email kirill@pastukhov.su instead of using the issue tracker., <sub>(*14)</sub>

Credits

• Kirill Pastukhov
• All Contributors

License

GNU General Public License, version 2. Please see License File for more information., <sub>(*15)</sub>