snowcap/mailjet-bundle

Mailjet wrapper for Symfony2

Snowcap Mailjet Bundle

The Snowcap Mailjet Bundle is a bundle used at Snowcap to help us with the Mailjet API:, _(*1)

It includes an refactored version of Mailjet API client (found on https://www.mailjet.com/plugin/php-mailjet.class.php) with:, _(*2)

• PSR-0 standards
• New constants
• A bundle configuration

Prerequisites

This version of the bundle requires Symfony 2.1+., _(*3)

Installation

Download SnowcapMailjetBundle using composer

Add SnowcapCoreBundle in your composer.json:, _(*4)

{
    "require": {
        "snowcap/mailjet-bundle": "*"
    }
}

Now tell composer to download the bundle by running the command:, _(*5)

``` bash $ php composer.phar update snowcap/mailjet-bundle, <sub>(*6)</sub>

Composer will install the bundle to your project's `vendor/snowcap` directory.

### Enable the Bundle


Enable the bundle in the kernel:

``` php
<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Snowcap\MailjetBundle\SnowcapMailjetBundle(),
    );
}

Configure Mailjet

In your config.yml:, <sub>(*7)</sub>

``` yml snowcap_mailjet: api_key: %mailjet_api_key% secret_key: %mailjet_secret_key%, <sub>(*8)</sub>

An optional parameter "debug" is available (0 by default). See Mailjet's doc for more information.

### Usage

The API is available with the "snowcap_mailjet" service.
In your controller (or elsewhere):

``` php
public function newsletterAction()
{
    // Get Mailjet client
    $client = $this->get('snowcap_mailjet');

    // Add an email to a mailing list
    $client->listsAddcontact(
        array(
            'contact' => 'someone@email.com',
            'id'      => 'your-list-id',
            'force'   => true,
            'method'  => 'POST'
        )
    );
}