Выгрузка товаров в Яндекс.Маркет. Часть 1

Тот, кто имеет какой-либо интернет-магазин, всегда готов делать все что угодно, для того, чтобы увеличить продажи и привлечь покупателей на свой сайт. Одним из лучших способов найти покупателей – это разместить свои предложения не только у себя на сайте, но и у кого-то другого. Желательно, чтобы это был большой проект. Еще желательно, чтобы это был проект, который хорошо индексируется поисковиками. А еще лучше если бы это был сам поисковик, который в поисковых запросах будет выдавать товары. Именно таким проектом и стал Яндекс.Маркет. Все преимущества этой системы можно посмотреть на этой страничке. На той же странице можно пройти регистрацию.
По сути, Яндекс.Маркет – это большой каталог, в котором размещены различные товары по категориям. Любой пользователь может зайти на маркет и купить любой товар, который доступен для продажи.
Для того чтобы добавить свои товары, нужно, кроме регистрации, выгрузить все товары из своего магазина в систему маркета. Это делается с помощью специального файла формата YML (Yandex Market Language). Описание этого формата можно найти здесь. Сам по себе формат YML является разновидностью языка XML и полностью подчиняется его правилам.

Библиотека
Для генерации файла YML я создал небольшую библиотеку, которую назвал YMarket. Скачать ее можно здесь. После распаковки архива должна образоваться папка YMarket, в которой находится вся библиотека. Это вводная статья для работы с этой библиотекой. Не буду говорить, что работать с библиотекой просто. Нет, работать не просто и не легко, но работать можно. Кому нужно, тот разберется, кому не нужно, тот может и не напрягаться.

Состав
Библиотека состоит из нескольких классов. Для корректной работы библиотеки для начала нужно подключить файл Ymarket.class.php

include_once 'YMarket/YMarket.class.php';

Этот файл подключит некоторые другие файлы, нужные для работы. Кроме всего прочего, файл подлючит:
components/Offer.class.php
components/Category.class.php
components/Currency.class.php
Из названий файлов можно понять, что это: Предложение, Категория и Валюта. Но о них немного позже.
После того, как мы подключили файл YMarket.class.php, можно приступать к работе. Сначала нужно создать объект класса YMarket.

$market = new YMarket(string $shopName, string $companyName, string $siteURL);

Параметры:

• $shopName – название магазина;
• $companyName – название компании;
• $siteURL – адрес сайта.

Таким образом создается новый «магазин», в который мы позже добавим все нужные данные. Для добавления каких-либо данных существует метод add().

bool YMarket::add(Component $comp, bool $replace = false)

Параметры:

• $comp – объект класса Component, который объявлен в файле Component.class.php и является предком почти для всех остальных классов в библиотеке;
• $replace – если true, то уже существующий компонент будет переписан. По умолчанию имеет значение false.

Вернет булевое значение -  результат добавления компонента.

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

Currency Currency:: __construct(string $id, string|float $rate='NBU', int $plus=0)

Параметры:

• $id – текстовый идентификатор валюты. Например, RUR для российского рубля, UAH – для украинской гривны, USD – для долларов США и т.д.;
• $rate – курс валюты. Может принимать значения: NBU – по курсу Национального банка Украины, CBRF – по курсу Центрального банка РФ, CB – по курсу центрального банка той страны, к которой относится магазин или число, которое указывает курс валюты;
• $plus – собственная надбавка в процентах к указанному курсу. Например, курс USD соответствует курсу ЦБ РФ + 3%. В этом случае будет выглядеть так:

  new Currency(‘USD’, ‘CBRF’, ‘3’);

Во-вторых, должны быть категории, в которых будут расположены предложения. Категории представлены компонентом Category(). И у этого компонента конструктор вобрал в себя практически всю функциональность:

Category Category:: __construct(int $id, string $name, int $parentId = null)

Параметры:

• $id – идентификатор категории, уникальный во всем магазине. Должен быть положительным целым числом, больше нуля;
• $name – имя категории;
• $parentId – идентификатор категории предка.

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

Популярность: 22%