README

在Silverstripe中简单实现Campaign Monitor API

致谢和作者

• Damian Mooyman - https://github.com/tractorcow/silverstripe-campaignmonitor/

许可证

• 待办事项

需求

• SilverStripe 3.0
• PHP 5.3
• Campaign Monitor PHP库 2.5.2

安装说明

composer require "tractorcow/silverstripe-campaignmonitor": "3.0.*@dev"

composer require "campaignmonitor/createsend-php": "v2.5.2"

示例

使用API设置目标列表（SiteConfig扩展）

给定一个硬编码的API密钥，允许用户从其帐户中选择客户端，然后选择一个列表。

	function updateCMSFields(FieldList $fields) {

		// Load base object
		$resources = new CMResources("my api key");

		// Get clients under our account
		$clients = $resources->Clients()->map();
		$fields->addFieldToTab(
			'Root.CampaignMonitor',
			new DropdownField('Client', 'Client', $clients)
		);

		// check if client is available to select
		if($this->owner->Client && ($client = $resources->getClient($this->owner->Client))) {
			$lists = $client->Lists()->map();
			$fields->addFieldToTab(
				'Root.CampaignMonitor',
				new DropdownField('DefaultList', 'Default List', $lists)
			);
		}
	}

保存订阅者

处理表单提交的订阅详情

	public function subscribe($data, $form) {
		$listID = SiteConfig::current_site_config()->DefaultList;
		$resources = new CMResources("my api key");
		if($resources && $listID && $list = $resources->getList($listID)) {
			$this->addUserToList($data, $list);
			Director::redirect($this->Link('thanks'));
		}
		// Error handling here
	}

	protected function addUserToList($data, $list) {
		if(empty($list)) return;
		
		// Create subscriber
		$fields = array(
			'EmailAddress' => $data['Email'],
			'Name' => $data['FirstName'],
			'CustomFields' => array(
				'LastName' => $data['LastName'],
				'Company' => $data['Company'],
				'Phone' => $data['Phone'],
				'Mobile' => $data['Mobile']
			),
			'Resubscribe' => true,
			'RestartSubscriptionBasedAutoresponders' => true
		);
		$subscriber = new CMSubscriber(null, $fields, $list);
		$subscriber->Save();
	}

获取已发送活动的列表

获取客户端所有已发送活动的列表，包括发件人名称、发件人电子邮件、回复电子邮件、网页版URL、ID、主题、名称、发送日期以及收件人总数。

有关更多信息，请参阅[Campaign Monitor API文档]（https://www.campaignmonitor.com/api/clients/#sent_campaigns）。

	public function Campaigns() {
		$resources = new CMResources("my api key");
		if($resources && $client = $resources->getClient("my client id")) {
			return $client->Campaigns();
		}
	}