craigballinger/mailchimp-api-php

此包的最新版本(dev-master)没有提供许可信息。

Mailchimp API v2 的 PHP 封装器

dev-master 2013-07-19 22:54 UTC

This package is not auto-updated.

Last update: 2024-09-24 04:14:42 UTC


README

#Mailchimp API v2 PHP 封装器

此 PHP 库封装了 Mailchimp API 的第 2 版。该库紧密遵循http://apidocs.mailchimp.com/api/2.0/上的文档。

##要求

  • PHP >= 5.3
  • cURL 模块

##版本 0.9 此封装器目前正在测试中,被视为测试版,但很快将投入生产。一旦出现问题,将迅速解决。

##约定 Mailchimp API 的第 2 版分为九个部分:Campaigns、Ecomm、Folders、Lists、Helper、Reports、Templates、User 和 Vip。(http://apidocs.mailchimp.com/api/2.0/#method-sections)此库将每个部分实现为客户属性,并据此访问

  • $mc->campaigns->method();
  • $mc->ecomm->method();

方法和参数与 Mailchimp API 文档中的映射相同,因此应提供关于如何使用此封装器的明确说明。

##使用方法

###创建新的活动

$mc = new Mailchimp\Client('Api Key');

$result = $mc->campaigns->create(
                                'regular', 
                                array(
                                        'list_id' => 'YOUR LIST ID',
                                        'subject' => 'Test Campaign '.date('m/d/y g:ia'),
                                        'from_email' => 'you@yourdomain.com',
                                        'from_name' => 'Test Sender',
                                        'to_name' => 'Test Recipient',
                                ),
                                array(  'html' => '<p>Test Campaign Message</p>')
                              );

###发送活动

$mc = new Mailchimp\Client('Api Key');
$mc->campaigns->send($campaign_id);

###oAuth2

Mailchimp 允许您使用 oAuth2 令牌代替 API 密钥,但数据中心的名称无法从 oAuth 令牌中提取,因此您可以将它设置为 Mailchimp\Client 构造函数的第二个可选参数。

$mc = new Mailchimp\Client('oAuth2 Token', 'us1');

如果您不知道您的数据中心,您可以像这样查找

$mc = new Mailchimp\Client('oAuth2 Token');
$result = $mc->oauth2->metadata();
echo $result->dc;