README

该库实现了与VK市场API（《https://vk.com/dev/market》）的交互。

在使用该库之前，需要注册您的应用程序以通过API与VKontakte交互（更多信息请参见《https://vk.com/dev/first_guide》）。同时，还需要获取访问密钥 - 《https://vk.com/dev/access_token》。

安装

通过composer

composer require asil/vkmarket

使用示例

1. 在传递预获取的access_token到VkConnect后创建连接，然后初始化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文件)。