weblee/mandrill

Laravel 5 Mandrill API Wrapper

Mandrill

Simple Mandrill API wrapper for Laravel 5., _(*1)

This packages gives you the ability to fully interact with Mandrill api ie, sending email via templates, getting user data, adding emails to blacklist..., _(*2)

Requirements

Laravel 5 & PHP 5.3 and later., _(*3)

Documentation

Full Mandrill API documentation can be found here., _(*4)

Installation

Per usual, install Commander through Composer., _(*5)

"require": {
    "weblee/mandrill": "dev-master"
}

Next, update config/services.php with your Mandrill API key. You are better off using Laravel env file to store you key., _(*6)

    'mandrill' => [
        'secret' => env('MANDRILL_KEY'),
    ],

Now you are ready to register the service provider and facade if you wish config/app.php., _(*7)

    'providers' => [
        ......
        Weblee\Mandrill\MandrillServiceProvider::class,
    ],

    'aliases' => [
        ......
        'MandrillMail'  => Weblee\Mandrill\MandrillFacade::class
    ]

Usage

Either inject the service into your construct or class method or use the supplied facade., _(*8)

Examples:, _(*9)

<?php

namespace App;

use Weblee\Mandrill\Mail;

class SendMyMail{

    private $mandrill;

    /**
    * Via construct injection
    *
    */
    public function __construct(Mail $mandrill)
    {
        $this->mandrill = $mandrill;
    }

    public function sendTemplate($data)
    {
        $this->mandrill->messages()->sendTemplate($data)
    }

    // ----- OR  -------    

    /**
    * Via method injection
    *
    */
    public function sendMail(Mail $mandrill, $data)
    {
        $mandrill->messages()->sendTemplate($data)
    }

    // ----- OR  -------

    /**
    * Via the Facade
    *
    */
    public function sendMailByFacade($data)
    {
        \MandrillMail::messages()->sendTemplate($data);
    }
}

Just follow the Mandrill docs on what call's you can do and the data to provide., _(*10)