EgzaktMailChimpBundle let you easily integrate a MailChimp Subscription Form in your application simply be configuring an API Key and a Subscription List Unique ID. It supports both List Fields and Groupings. The form is posted via AJAX to a controller inside this bundle so there is no need to create a controller to handle the posted form. All data is validated depending on the field types.
This bundle is still experimental and has been developed for Symfony 2.0, it has not been tested on the latest versions of Symfony.
The form is posted via AJAX so jQuery >= 1.0 is required. If jQuery UI is loaded, datepicker will automatically be added on date fields.
- Installation
- How to use
- Screenshots
-
Add the following to your
depsfile:[EgzaktMailChimpBundle] git=http://github.com/egzakt/EgzaktMailChimpBundle.git target=bundles/Egzakt/MailChimpBundle
-
Register the bundle in your
app/AppKernel.php:... public function registerBundles() { $bundles = array( ... new Egzakt\MailChimpBundle\EgzaktMailChimpBundle(), ... ); }
-
Import the
EgzaktMailChimpBundlerouting to yourapp/config/routing.yml:EgzaktMailChimpBundle: resource: "@EgzaktMailChimpBundle/Resources/config/routing.yml"
-
Configure your MailChimp API Key in your
app/config/config.yml:# MailChimp egzakt_mail_chimp: api_key: 1234567890qwerty-us5
-
Update your database :
app/console doctrine:schema:update --dump-sql -
Create a new
MailChimpSubscriptionListin your database, you will need to create aMailChimpSubscriptionListTranslationfor each Locale of your application. ThelistIdfield is the List Unique Id that you can find in the "Settings" tab in the list configuration page.
To display the Subscription Form in your application, simply include jQuery in your <HEAD> and add this line to a Twig template, where id is the ID of the MailChimpSubscriptionList in your database:
<script src="http://code.jquery.com/jquery-latest.min.js" type="text/javascript"></script>{% render 'EgzaktMailChimpBundle:MailChimp:displayForm' with { id: 1 } %}List of available form field types:
Validations before sending the data to MailChimp API:
Confirmation message when successfully subscribed:
