asil/vkmarket

The PHP library for work with VK Market API

1.0 2017-07-17 13:38 UTC

README

Библиотека реализует работу с VK market API (https://vk.com/dev/market).

Перед использованием библиотеки необходимо зарегистрировать свое приложение для работы с API ВКонтакте (подробнее здесь - https://vk.com/dev/first_guide). Также требуется получить ключ доступа - https://vk.com/dev/access_token.

Установка

Через composer:

composer require asil/vkmarket

Примеры использования

  1. Создаём соединение с VkConnect передав в него предварительно полученный access_token, затем инициализируем объект класса VkServiceDispatcher и вызываем у него необходимые методы для работы с товарами
<?php 
use Asil\VkMarket\VkConnect;
use Asil\VkMarket\VkServiceDispatcher;
  
$accessToken = 'dbe359235b784';
$ownerId = 741281; // идентификатор владельца группы
$groupId = 101234567; // идентификатор группы
  
$connect = new VkConnect($accessToken, $groupId, $ownerId);
$vkService = new VkServiceDispatcher($connect);
  1. Добавление товара в группу
<?php 
use Asil\VkMarket\Model\Photo;
use Asil\VkMarket\Model\Product;
  
$product = new Product('Товар 1', 'Описание товара...', 3, 212);
$photo = new Photo();
  
$photo->createMainPhoto('/img/1.jpg');
$photo->createAdditionalPhoto([
    '/img/1_1.jpg',
    '/img/1_2.jpg'
]);
  
$id = $vkService->addProduct($product, $photo);
  1. Редактирование товара
<?php 
use Asil\VkMarket\Model\Photo;
use Asil\VkMarket\Model\Product;
  
$product = $vkService->getProductById(1432679);
$product->setName('Тестовый товар 2');
  
$photo = new Photo();
$photo->createAdditionalPhoto([
    '/img/6.jpg'
]);
  
$vkService->editProduct($product, $photo);
  1. Деактивация товара
<?php 
$vkService->deactivateProduct(1432679);
  1. Восстановление деактивированного товара
<?php 
$vkService->restoreProduct(1432679);
  1. Удаление товара
<?php 
$vkService->deleteProduct(1432679);
  1. Создание подборки товаров
<?php
use Asil\VkMarket\Model\Photo;
use Asil\VkMarket\Model\Album;
  
$album = new Album('Альбом 1');
  
$photo = new Photo();
$photo->createAlbumPhoto('/img/album_1.jpg');
  
$vkService->addAlbum($album, $photo);
  1. Добавление товара в подборку
<?php
$albumIds = [6, 1];
$vkItemId = 1432679;
$vkService->addProductToAlbum($albumIds, $vkItemId);

Список методов класса VkServiceDispatcher

  • getCategories($count, $offset = '') - возвращает список категорий для товаров
  • addProduct(Product $product, Photo $photo) - добавляет новый товар
  • editProduct(Product $product, Photo $photo = null) - редактирует товар
  • getProductById($id) - возвращает товар по id
  • deleteProduct($id) - удаляет товар
  • deactivateProduct($id) - деактивирует товар
  • restoreProduct($id) - восстанавливает деактивированный товар
  • addAlbum(Album $album, Photo $photo = null) - добавляет новую подборку с товарами
  • getProductsInAlbum($albumId = 0, $count = 10, $offset = 0) - возвращает список товаров в подборке
    (по-умолчанию возвращает все товары)
  • addProductToAlbum(array $albumIds, $itemId) - добавляет товар в подборки
  • getAlbums($count = 10, $offset = 0) - возвращает список подборок
  • getAlbumById($albumId) - возвращает подбороку товаров по id
  • editAlbum($albumId, Album $album, Photo $photo = null) - редактирует подборку с товарами
  • deleteAlbum($albumId) - удаляет подборку

Лицензия

MIT (пожалуйста прочтите файл LICENSE).