https://github.com/notdest/yandex-yml-generator
:sunglasses: Генератор YML для Яндекс.Маркет на php, не требует других библиотек.
https://github.com/notdest/yandex-yml-generator
yandex-market-language yml
Last synced: about 1 year ago
JSON representation
:sunglasses: Генератор YML для Яндекс.Маркет на php, не требует других библиотек.
- Host: GitHub
- URL: https://github.com/notdest/yandex-yml-generator
- Owner: notdest
- Created: 2015-06-19T16:47:23.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2022-07-27T15:51:02.000Z (almost 4 years ago)
- Last Synced: 2024-11-25T09:06:47.285Z (over 1 year ago)
- Topics: yandex-market-language, yml
- Language: PHP
- Homepage:
- Size: 233 KB
- Stars: 48
- Watchers: 2
- Forks: 15
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Yml генератор на php
============
Генератор YML для быстрого подключения вашего магазина к Yandex.Market.
- Встраивается по принципу «Удали лишнее из примера».
- Очень прост, состоит из всего двух классов - `ymlDocument` и `ymlOffer`.
- Зависит только от встроенных библиотек - `php-xml` и `php-mbstring`, обычно они уже установлены.
### Установка
```bash
composer require notdest/yandex-yml-generator
```
Если без композера - подсоединяем два файла из папки `/src/`, как в примерах.
### Проверка работоспособности
Скачиваем проект и запускаем пример [arbitrary.php](examples/arbitrary.php). Может ругаться, что не может создать файл - даем права на запись папке с примерами. Получившийся файл `arbitrary.xml` проверяем [сервисом](https://webmaster.yandex.ru/tools/xml-validator/) Яндекса.
### Устройство примеров
Для каждого типа описаний сделан свой пример использования по принципу "удали лишнее". Порядок следования полей такой же, как и в документации, за исключением вынесенных в конструктор. Примеры выглядят вот так:
```php
// model, vendor, id, price, currencyId, categoryId , [price from - "цена от ххх руб." ]
$offer = $y->arbitrary( '3811', 'Brand', 'id01id1111', 900, "USD", 15 /* , true*/ );
$offer ->cbid(80) // Размер ставки на карточке товара. 0,8 у.е.
->url("http://magaz.ru/tovar.html") // !!! условно обязательный. URL страницы товара
//->vat('VAT_10_110') отсутствует в схеме // Ставка НДС для товара.
```
Здесь `arbitrary()` создает предложение типа «произвольный», в него вынесены гарантированно обязательные поля. Метод `cbid()` уже не обязателен, его можно просто удалить, если он не нужен. Метод `url()` также можно удалить, но без него не будет работать модель «Переход на сайт» . Далее, метод `vat()` описан в документации, но отсутствует в xsd-схеме указанной в [технических требованиях](https://yandex.ru/support/webmaster/goods-prices/technical-requirements.html) и не проходит валидацию.
Каждая строчка имеет комментарий. Файлы примеров:
Тип предложения | Пример | Дата валидации
---------------- | ------------- | -------
Упрощенный | [examples/simple.php](examples/simple.php) | 11.08.2019
Произвольный | [examples/arbitrary.php](examples/arbitrary.php) | 11.08.2019
Книги | [examples/book.php](examples/book.php) | 11.08.2019
Аудиокниги | [examples/audiobook.php](examples/audiobook.php) | 11.08.2019
Аудио и видеопродукция | [examples/artist.php](examples/artist.php) | 11.08.2019
Туры | [examples/tour.php](examples/tour.php) | 11.08.2019
Мероприятия | [examples/event.php](examples/event.php) | 11.08.2019
Лекарства | [examples/medicine.php](examples/medicine.php) | 11.08.2019
Валидация проводилась с помощью [сервиса Яндекса](https://webmaster.yandex.ru/tools/xml-validator/), указывая тип *"Маркет"*.
### Сверить с документацией Яндекса
Документация у Яндекса сделана преимущественно в виде таблиц. Соответственно я задокументировал свои примеры такими же таблицами с аналогичным порядком следования полей, описав текущие правила и ограничения. Просто открываете рядом два окна браузера, с документацией Яндекса и моей, и ищете различия. Нет различий - хорошо, есть - пишете на *e-mail* в профиле.
Таблица Яндекса | Таблица моя
----------------------- | -------------
[Общие поля магазина](https://yandex.ru/support/partnermarket/export/yml.html) | [Общие поля магазина](docs/yml.md)
[Упрощенный тип](https://yandex.ru/support/partnermarket/offers.html) | [Упрощенный тип](docs/simple.md)
[Произвольный тип](https://yandex.ru/support/partnermarket/export/vendor-model.html) | [Произвольный тип](docs/arbitrary.md)
[Книги](https://yandex.ru/support/partnermarket/export/books.html) | [Книги](docs/book.md)
[Аудиокниги](https://yandex.ru/support/partnermarket/export/audiobooks.html) | [Аудиокниги](docs/audiobook.md)
[Аудио и видеопродукция](https://yandex.ru/support/partnermarket/export/music-video.html)| [Аудио и видеопродукция](docs/artist.md)
[Туры](https://yandex.ru/support/partnermarket/export/tours.html) | [Туры](docs/tour.md)
[Мероприятия](https://yandex.ru/support/partnermarket/export/event-tickets.html) | [Мероприятия](docs/event.md)
[Лекарства](https://yandex.ru/support/partnermarket/export/medicine.html) | [Лекарства](docs/medicine.md)
Не обязательно проверять все, используются обычно общие поля и какой-то один тип.
Также был сделан нагрузочный тест [examples/stress-test.php](examples/stress-test.php). Для генерации файла объемом 500 Мб (максимально разрешенный Яндексом) понадобилось 143 секунды, потребление памяти составило 2 Мб. Или 31 секунда на моем новом компе.
В случае необходимости внести изменения, рекомендую сначала ознакомиться с документацией по классам [ymlDocument](docs/ymlDocument.md) и [ymlOffer](docs/ymlOffer.md).
**P.S.** Ставь звездочки, если считаешь, что проект должен быть в топе.