grunt-mandrill

Send emails though mandrill as part of your build. Created to test our email template builds.

This is being hastily deployed for internal consumption. You probably shouldn't use this yet.

Getting Started

This plugin requires Grunt

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-mandrill --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-mandrill');

Use case

We have a build pipeline that compiles jade and sass into inline-styled HTML pages for email msgs.

The final step is to shoot out tests of each template to make sure nothing looks wonky.

mandrill task

Run this task with the grunt mandrill command.

Task targets, files and options may be specified according to the grunt Configuring tasks guide.

Options

key

Type: String

Your Mandrill API key

sender

Type: String

The 'from' name and address. Acceptable domains may be restricted by your mandrill account settings

recipient

Type: String or Array

One or more email addresses to send your msg to. Multiple addresses should be entered as an array.

subject

Type: String

The subject of your email

body

Type: String

If no files are specified in src:, the mandrill task will send a plaintext email using body for the msg content.

Usage

src: is one or more files to be used as an email body. A new email will be sent for each file.

module.exports = function(grunt){

  grunt.initConfig({
    mandrill: {
      mailer: {
        options: {
          key: 'your-mandrill-API-key',
          sender: '[email protected]',
          recipient: '[email protected]'.
          subject: 'This is a test email'
        },
        src: ['templates/*.html']
      }
    }
  });
  
  grunt.loadNpmTasks('grunt-mandrill');
  });