Skip to content

A composer package for the MailChimp API PHP class (as provided by MailChimp) which supports the Laravel 4 framework.

Notifications You must be signed in to change notification settings

hugofirth/laravel-mailchimp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mailchimp API w. support for Laravel

The package supports use with the Laravel framework (v4) providing a MailchimpWrapper facade.


###Setup:

In order to install add the following to your composer.json file within the require block:

"require": {
    
    "hugofirth/mailchimp": "2.0.*",
    
}

Within Laravel, locate the file ..app/config/app.php *.

Add the following to the providers array:

'providers' => array(
    …
    'Hugofirth\Mailchimp\MailchimpServiceProvider',
    …
),

Furthermore, add the following the the aliases array:

'aliases' => array(
    …
    'MailchimpWrapper'       => 'Hugofirth\Mailchimp\Facades\MailchimpWrapper',
    …
),

Publish the configuration

$ php artisan config:publish hugofirth/mailchimp

Lastly, run the command composer update.

* The subsequent steps should be repeated for any file app.php created for additional environments.


###Usage:

Your unique MailChimp API key should be set in the package's config found in app/config/packages/hugofirth/mailchimp/config.php

Methods of the MailChimp api class work as described by the MailChimp API docs found Here. Examples of actual usage can be found Here (Warning: Examples use CakePHP). Thanks to Laravel's use of the "Facade" design pattern, all methods may be called in the following manner:

…
//Retrieve an array of lists for your account
$lists = MailchimpWrapper::lists()->getList()['data'];
…
//Subscribe a user, with email: $email_address, to a list with id: $list_id
MailchimpWrapper::lists()->subscribe($list_id, array('email'=>$email_address));

In order to allow for auto-completion, you can include a use statement for the Facade:

<?php

use Hugofirth\Mailchimp\Facades\MailchimpWrapper;

class SomeClass
{
    public function someMethod()
    {
        MailchimpWrapper:: //You should be able to get auto completion here for the API methods/properties
    }
}

Enjoy!

About

A composer package for the MailChimp API PHP class (as provided by MailChimp) which supports the Laravel 4 framework.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages