bushev/php-realtypult-partner-lib

API библиотека для интеграции с RealtyPult https://realtypult.ru

php-realtypult-partner-lib

API библиотека для интеграции с RealtyPult. Подключение портала недвижимости к партнерской программе., _(*1)

Нужна версия для NodeJS?

https://github.com/bushev/nodejs-realtypult-partner-lib, _(*2)

Как установить

Вы можете скачать последнюю версию библиотеки по ссылке:, _(*3)

https://github.com/bushev/php-realtypult-partner-lib/archive/master.zip, _(*4)

Скопируйте файл realtypult-importer.php в ваш PHP проект и подключите его в коде:, _(*5)

``` php require_once 'realtypult-importer.php';, <sub>(*6)</sub>

Если вы используете Composer для управления зависимостями проекта, вы можете установить библиотеку для RealtyPult напрямую из репозитория.

Обновите ваш файл composer.json (добавьте новую зависимость):

``` json
{
  "require": {
    "bushev/php-realtypult-partner-lib": "^1.0"
  }
}

После чего выполните установку:, <sub>(*7)</sub>

php composer.phar install, <sub>(*8)</sub>

Как пользоваться

``` php require_once 'realtypult-importer.php';, <sub>(*9)</sub>

/** * Обработчик одного объявления * * Требуется реализовать алгоритм: * * 1. Проверить (по $item->id) размещали ли вы это объявления ранее * * Если не размещали: * 2.1 Сохраните объявление в вашей базе данных (не забудьте скачать себе изображения объекта) * 2.2 Верните объект (sdtClass) со ссылкой на объявление на вашем сайте * Например: * $result->url = 'http://your-site.ru/item-123'; * return $result; * * * Если размещали: * 2.1 Проверьте, изменилось ли обновление, если да то обновите его в вашей базе данных * (не забудьте про изображения) * 2.2 Получите из вашей базы данных количество просмотров этого объявления (рекомендуется) * 2.2 Верните объект (sdtClass) со ссылкой на объявление на вашем сайте, * и количеством просмотров (рекомендуется) * Например: * $result->url = 'http://your-site.ru/item-123'; * $result->views = 15; * return $result; * * * В случае если на каком-либо этапе вы понимаете что это объявление не может быть * обработано корректно, верните объект (sdtClass) с сообщением об ошибке * Например: * $result->error = 'Произошел технический сбой'; * return $result; * * * Помните, что сообщение о об ошибке увидит конечный пользователь! * * Примеры частых ошибок: * * > Произошел технический сбой (проблема с базой данных, нет места на диске, и тп.) * > Не удалось определить адрес объекта * > И тп. * * В случае если в вашей базе данных есть очень похожее объявление, верните * объект (sdtClass) со ссылкой на это объявление (размещать это объявление не нужно) * Например: * $result->similarUrl = 'http://your-site.ru/item2'; * return $result; * * * В случае если вы не можете разместить объявление в силу нарушений ваших правил, * верните объект (sdtClass) с сообщением пользователю * Например: * $result->rejectReason = 'Номер телефона заблокирован'; * return $result; * * Примеры частых ошибок: * * > Номер телефона заблокирован * > Слишком низкая цена для этого объявления * > И тп. * * Помните, что сообщение об отклонении объявления увидит конечный пользователь! * * * @param $item - объект содержащий всю информацию об объявлении * @return stdClass - результат обработки */ $onItem = function ($item) {, <sub>(*10)</sub>

echo "Обрабатываем объявление #" . $item->id . "\r\n";

print_r($item);

$result = new \stdClass();

// Успешно размещено
// $result->url = 'http://your-site.ru/item-123';
// $result->views = 15;

// ИЛИ

// Проблема с доступом к базе данных / Недостаточно памяти
// $result->error = 'Произошел технический сбой';

// ИЛИ

// Объявление дубликат
// $result->similarUrl = 'http://your-site.ru/item2';

// ИЛИ

// Не соответствует правилам вашего портала
// $result->rejectReason = 'Номер телефона заблокирован';

return $result;

};, <sub>(*11)</sub>

/** * Обработчик конца импорта * * Здесь нужно удалить из вашей базы данных все объявления которые отсутствовали в * XML фиде (не забудьте удалить изображения) * * @param $report * @param $report ->location - Путь до файла с готовым отчетом (ссылку на него нужно * вставить в личный кабинет партнера) * @param $report ->statistics.total - Общее число объявление в фиде * @param $report ->statistics.success - Число объявление обработанных успешно * @param $report ->statistics.rejected - Число объявление отклоненных от публикации * @param $report ->statistics.errors - Число объявление обработанных с ошибками */ $onEnd = function ($report) {, <sub>(*12)</sub>

echo "Обработка XML фида завершена!\r\n";

var_dump($report);

};, <sub>(*13)</sub>

/** * Обработчик ошибки обработки XML фида * * @param $error */ $onError = function ($error) {, <sub>(*14)</sub>

echo "Произошла ошибка " . $error . "\r\n";

$this->assertEquals('I\'m here!', 'Should not be here!');

};, <sub>(*15)</sub>

$options = new \stdClass();, <sub>(*16)</sub>

// Ссылка на XML фид из личного кабинета партнера $options->xmlFeedUrl = 'https://realtypult.ru/api/xml/export/partner/FORMAT/TOKEN';, <sub>(*17)</sub>

// Путь к файлу отчета, файл будет создаваться автоматически $options->reportFileLocation = '/var/www/my-site/public/rm-report.xml';, <sub>(*18)</sub>

// Формат XML фида ('realtypult' или 'yandex') $options->format = 'realtypult';, <sub>(*19)</sub>

// Функция будет вызвана для каждого объявления из XML фида $options->onItem = $onItem;, <sub>(*20)</sub>

// Функция будет вызвана когда весь XML фид будет обработан $options->onEnd = $onEnd;, <sub>(*21)</sub>

// Функция будет вызвана в случае непредвиденной критической ошибки $options->onError = $onError;, <sub>(*22)</sub>

$importer = new \RealtyPultImporter($options);, <sub>(*23)</sub>

// Запускаем импорт $importer->run(); ```, <sub>(*24)</sub>

Код этого примера находится тут., <sub>(*25)</sub>