Yii2 Mailchimp
==============

![License](https://img.shields.io/packagist/l/cinghie/yii2-mailchimp.svg)
![Latest Stable Version](https://img.shields.io/github/release/cinghie/yii2-mailchimp.svg)
![Latest Release Date](https://img.shields.io/github/release-date/cinghie/yii2-mailchimp.svg)
![Latest Commit](https://img.shields.io/github/last-commit/cinghie/yii2-mailchimp.svg)
[![Total Downloads](https://img.shields.io/packagist/dt/cinghie/yii2-mailchimp.svg)](https://packagist.org/packages/cinghie/yii2-mailchimp)

Yii2 MailChimp extension to manage the Mailchimp Email Marketing Platform:

 - Website: https://www.mailchimp.com/
 - PHP API: https://github.com/drewm/mailchimp-api
 - Documentation: https://developer.mailchimp.com/documentation/mailchimp/

Installation
------------

The preferred way to install this extension is through [composer](http://getcomposer.org/download/).

Either run

```
$ php composer.phar require cinghie/yii2-mailchimp "*"
```

or add

```
"cinghie/yii2-mailchimp": "*"
```

Configuration
-------------

Set on your configuration file

```
use cinghie\mailchimp\components\Mailchimp as MailchimpComponent;
use cinghie\mailchimp\Mailchimp;

'components' => [

	'mailchimp' => [
		'class' => MailchimpComponent::class,
		'apiKey' => 'YOUR_MAILCHIMP_API_KEY'
	],

],

'modules' => [ 
    
    'mailchimp' => [
        'class' => Mailchimp::class,
        'showFirstname' => true,
        'showLastname' => true
    ]
    
]
```

Usage
---------------------------

```
\Yii::$app->mailchimp;
\Yii::$app->mailchimp->getClient();
\Yii::$app->mailchimp->getLists();
\Yii::$app->mailchimp->getListMembers($listID);
```

Widget Subscription Example
---------------------------

```
<?= Subscription::widget([
    'list_id' => 'MYLISTID' // if not set raise Error
]) ?>
```

alternative to list_id you can set an list_array to set a list_id to a specific language

```
<?= Subscription::widget([
    'list_array' => [
        'en' => 'MYLISTID_EN',
        'es' => 'MYLISTID_ES',
        'it' => 'MYLISTID_IT',                        
    ]
]) ?>
```

Actions
-------

<ul> 
  <li>Lists View: PathToApp/index.php?r=mailchimp/default/lists</li>
  <li>Lists View with Pretty Urls: PathToApp/mailchimp/default/lists</li>
  <li>List View: PathToApp/index.php?r=mailchimp/default/list?id=XXX&name=XXX</li>
  <li>List View with Pretty Urls: PathToApp/mailchimp/default/list?id=XXX&name=XXX</li>
</ul>