Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/welpdev/mailchimp-bundle

MailChimp integration with Symfony and MailChimp API V3
https://github.com/welpdev/mailchimp-bundle

bundle mailchimp mailchimp-api mailchimp-bundle packagist php symfony symfony-bundle symfony2 symfony3

Last synced: 4 days ago
JSON representation

MailChimp integration with Symfony and MailChimp API V3

Awesome Lists containing this project

README

        

# mailchimp-bundle

[![Build Status](https://travis-ci.org/welpdev/mailchimp-bundle.svg?branch=master)](https://travis-ci.org/welpdev/mailchimp-bundle)
[![Packagist](https://img.shields.io/packagist/v/welp/mailchimp-bundle.svg)](https://packagist.org/packages/welp/mailchimp-bundle)
[![Packagist](https://img.shields.io/packagist/dt/welp/mailchimp-bundle.svg)](https://packagist.org/packages/welp/mailchimp-bundle)
[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/welpdev/mailchimp-bundle/master/LICENSE.md)
[![Documentation](https://img.shields.io/badge/documentation-gh--pages-blue.svg)](https://welpdev.github.io/mailchimp-bundle/)

This bundle will help you synchronise your project's newsletter subscribers into MailChimp throught MailChimp API V3.

## Features

* [x] Use your own userProvider (basic `FosSubscriberProvider` included to interface with FosUserBundle)
* [x] Use your own listProvider (`DoctrineListProvider` included to retrieve your list from a database)
* [x] Synchronize Merge Fields with your config
* [x] Synchronize your subscriber with a List
* [x] Use lifecycle event to subscribe/unsubscribe/delete subscriber from a List
* [x] Retrieve [MailChimp Object](https://github.com/drewm/mailchimp-api) to make custom MailChimp API V3 requests
* [x] Register Webhooks

## Setup

Add bundle to your project:

```bash
composer require welp/mailchimp-bundle
```

Add `Welp\MailchimpBundle\WelpMailchimpBundle` to your `AppKernel.php`:

```php
$bundles = [
// ...
new Welp\MailchimpBundle\WelpMailchimpBundle(),
];
```

## Minimal Configuration

In your `config.yml`:

```yaml
welp_mailchimp:
api_key: YOURMAILCHIMPAPIKEY
```

More configuration on the [documentation](https://welpdev.github.io/mailchimp-bundle/configuration/).

## Full Documentation

Look at the full documentation at

* Setup
* Configuration
* Subscriber Provider
* List Provider
* Usage
* Synchronize merge fields
* Full synchronization with command
* Unit synchronization with events
* Subscribe new User
* Unsubscribe a User
* Update a User
* Change User's email address (WORKAROUND)
* Delete a User
* Retrieve [MailChimp Object](https://github.com/drewm/mailchimp-api) to make custom MailChimp API V3 requests
* Webhook
* Update User when subscribe/unsubscribe

## Contributing

If you want to contribute to this project, look at [over here](CONTRIBUTING.md)