README

CentralNews系统API库。

实现文档

根据以下文档连接到CentralNews： http://centralnews.itstudio.cz/bundles/centralnewssubscriber/doc/ws.pdf

安装

Composer: composer require itstudiocz/centralnews-api-php

使用示例

创建客户端实例

$params = array(
    CentralNews\Service\Client::URL => 'https://',
    CentralNews\Service\Client::TOKEN => 'xxxxxxxxxxxxxxx',
    CentralNews\Service\Client::USER => 'user',
    CentralNews\Service\Client::PASSWORD => 'password',
);

$client = new CentralNews\Service\Client($params);

// proměnné použité dále v příkladech
$groupId = 1; // je číselný identifikátor skupiny (1,2, ..)
$email = "info@itstudio.cz"; // je platná emailová adresa

创建新的订阅组

$newGroup = new CentralNews\Entity\SubscriberGroup();
$newGroup->setName('New Group');
$newGroup->setDescription('description');

$subscriberManager = $client->getSubscriberManager();
$subscriberManager->addGroup($newGroup);

列出订阅组

$subscriberManager = $client->getSubscriberManager();
$groups = $subscriberManager->getGroups();

订阅者数量

• 总数

$subscriberManager = $client->getSubscriberManager();
$count = $subscriberManager->getSubscribersCount();

• 组内数量

$subscriberManager = $client->getSubscriberManager();
$group = new \CentralNews\Entity\Group($groupId);
$count = $subscriberManager->getSubscribersCount($group);

订阅者信息

$group = new \CentralNews\Entity\Group($groupId);
$subscriberManager = $client->getSubscriberManager();
$subscriber = $subscriberManager->getSubscriber($email, $group);

订阅者项

• 全部

$subscriberManager = $client->getSubscriberManager();
$data = $subscriberManager->getSubscriberFields();

• 在组内

$subscriberManager = $client->getSubscriberManager();
$group = new \CentralNews\Entity\Group($groupId);
$data = $subscriberManager->getSubscriberFields($group);

从组中删除订阅者

$group = new \CentralNews\Entity\Group($groupId);
$subscriberManager = $client->getSubscriberManager();
$subscriberManager->deleteSubscriber($email, $group);

添加订阅者

• 如果存在，则更新其数据

$subscribers[] = new CentralNews\Entity\Subscriber($email);
$group = new CentralNews\Entity\Group($groupId);
$subscriberManager = $client->getSubscriberManager();
$subscriberManager->saveSubscribers($subscribers, $group);

• 如果订阅者存在，则跳过（不更新）

$subscribers[] = new CentralNews\Entity\Subscriber($email);
$group = new CentralNews\Entity\Group($groupId);
$subscriberManager = $client->getSubscriberManager();
$subscriberManager->importSubscribers($subscribers, $group);

事件 - 被遗弃的购物车

$eventManager = $client->getEventManager();
$lostCart = new \CentralNews\Entity\LostCart();
$lostCart->setEmail($email);
$product = new CentralNews\Entity\Product();
$product->setName('product name');
$product->setPrice(100);
$lostCart->addProduct($product);
$eventManager->callLostCart($lostCart);

发送自定义请求

$manager = $client->getManager();
$request = new CentralNews\Service\Request($operation, $params);
$response = $manager->sendRequest($request);