Skip to content

Sync Laravel Models with MailChimp as Members or Interests

License

Notifications You must be signed in to change notification settings

warksit/laravel-mail-chimp-sync

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Laravel MailChimp Sync for Laravel 5.2

Codeship Status for warksit/laravel-mail-chimp-sync

A package to sync subscribers and interests (using eloquent events) with MailChimp (API v3) for Laravel 5.2+. It's only dependency is Guzzle 6.

Installation

To get started, require this package:

composer require warksit/laravel-mail-chimp-sync

Add the ServiceProvider in config/app.php:

    'providers' => [
        ...
        Warksit\LaravelMailChimpSync\MailingListServiceProvider::class,
    ],

Next run vendor:publish to copy the migrations.

php artisan vendor:publish --provider="Warksit\LaravelMailChimpSync\MailingListServiceProvider"

Run the migrations:

php artisan migrate

Usage

This package has 2 main uses. It syncs subscribers to a list(s) and syncs a list of interests of an interest group(s). It makes use of eloquent events to detect changes and also makes use of queued jobs so the relative expensive calls to MailChimp don't slow your program flow. The one exception is deleting a model as we need to remove that from MailChimp while the record still exists.

Sync Subscribers

This allows you to keep changes you make to an Eloquent Model in sync with a MailChimp List. It uses eloquent events. This is achieved through the Warksit\LaravelMailChimpSync\EloquentTraits\MailChimpSyncMember trait. This requires a few methods on the model which are enforced by implementing the Warksit\LaravelMailChimpSync\EloquentTraits\CanSyncMailChimpMember interface. Have a look in the doc blocks for more details. If you have overidden the boot() method make sure you call parent::boot() no worries if you haven't.

    use Warksit\LaravelMailChimpSync\Interfaces\CanSyncMailChimpMember;
    use Warksit\LaravelMailChimpSync\EloquentTraits\MailChimpSyncMember;
    
    class YourModel extends Model implements CanSyncMailChimpMember
    {
        use MailChimpSyncMember
        
        protected static function boot()
        {
            parent::boot();
            ...
        }
    }

Sync Interest

This allows you to keep changes you make to an Eloquent Model in Sync as the Interest for an Interest Group. This is achieved through the Warksit\LaravelMailChimpSync\EloquentTraits\MailChimpSyncInterest trait. This requires a few methods on the model which are enforced by implementing the Warksit\LaravelMailChimpSync\EloquentTraits\CanSyncMailChimpInterest interface. Have a look in the doc blocks for more details. Again if you have overidden the boot() method make sure you call parent::boot() no worries if you haven't.

    use Warksit\LaravelMailChimpSync\Interfaces\CanSyncMailChimpInterest;
    use Warksit\LaravelMailChimpSync\EloquentTraits\MailChimpSyncInterest;
    
    class YourInterestModel extends Model implements CanSyncMailChimpInterest
    {
        use MailChimpSyncInterest;
        
        protected static function boot()
        {
            parent::boot();
            ...
        }
    }

Manual Sync

If you would like to trigger a sync for a model at another time just call $memberModel->mailingListSubscribe() to resync a member or $interestModel->addInterestGroup() on the relevant model. This is particularly useful to add a new interest to a member.

Contributing

Please! This meets my needs but am open to help. If you find an issue, or have a better way to do something, open an issue or a pull request. There are some tests. To get the integration tests to work copy .env.example to .env and enter your MailChimp credentials.

About

Sync Laravel Models with MailChimp as Members or Interests

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages