Skip to content

Latest commit

 

History

History
86 lines (64 loc) · 2.55 KB

README.md

File metadata and controls

86 lines (64 loc) · 2.55 KB

Hapi mailer plugin Build Status

A wrapper around Nodemailer used for sending email. It can be used with or without a template engine.

Installation

npm install hapi-mailer

Usage

Server configuration:

The plugin accepts the following configuration options:

  • transport: A Nodemailer transport mechanism. If it is not set nodemailer-direct-transport transport is used. If it is a regular object nodemailer-smtp-transport is used and the value is passed as SMTP configuration.
  • views: The views configuration as described in the server's views option. Note that due to the way node require() operates, plugins must require rendering engines directly and pass the engine using the engines.module option. Note that relative paths are relative to the plugin root, not the working directory or the application registering the plugin.

Example:

var Handlebars = require('handlebars');

var options = {
    transport: {
        service: 'Gmail',
        auth: {
            user: '[email protected]',
            pass: 'password'
        }
    },
    views: {
        engines: {
            html: {
                module: Handlebars.create(),
                path: Path.join(__dirname, 'lib/views/emails')
            }
        }
    }
};

var plugin = {
    register: require('hapi-mailer'),
    options: options
};

server.register(plugin, function (err) {
    ...
});

Handler:

In handlers, the Mailer object can be accessed as request.server.plugins.mailer. It has a sendMail function which can be used to send an email. It accepts the following configuration options:

  • data: Defines the mail content the same way as Nodemailer. There is only one additional property context, which is an optional object used by the template to render context-specific result.
  • callback: It is a callback function to run once the message is delivered or it failed.

Example:

var handler = function (request, reply) {

    var data = {
        from: '[email protected]',
        to: '[email protected]',
        subject: 'Example Subject',
        html: {
            path: 'handlebars.html'
        },
        context: {
            name: 'Example User'
        }
    };

    var Mailer = request.server.plugins.mailer;
    Mailer.sendMail(data, function (err, info) {

        reply();
    });
};

server.route({ method: 'POST', path: '/', handler: handler });