Built by

lumot-eu

Category

Notification

Version

1.0.6

Last updated

Nov 3, 2024, 21:21:55 PM2 months ago

medusa-plugin-nodemailer

A notification service based on Nodemailer & Handlebars templating engine.

Installation

To install, run the following command in your terminal:
npm install @lumot-eu/medusa-plugin-nodemailer
Add the following values to your Copy to clipboardmedusa-config.js file:
const plugins = [
// ...
{
resolve: "@lumot-eu/medusa-plugin-nodemailer",
options: {
fromAddress: process.env.MAIL_FROM_ADDRESS,
// This object is passed directly into nodemailer.createTransport(),
// so any configuration options supported by nodemailer will work here.
// For more details, see: https://nodemailer.com/smtp/#1-single-connection
transport: {
host: process.env.MAIL_SMTP_HOST,
port: process.env.MAIL_SMTP_PORT,
auth: {
user: process.env.MAIL_SMTP_USER,
pass: process.env.MAIL_SMTP_PASS,
},
tls: {
// do not fail on invalid certs
rejectUnauthorized: false,
},
},
// Path to the directory where your email templates are stored
templatesDir: "email-templates",
// Path to the directory where your layouts are stored
layoutsDir: "email-templates/_layouts",
// Path to the directory where your partials are stored
partialsDir: "email-templates/_partials",
// The name or file path of a template within the `layoutsDir` that will be used as the default layout.
// To disable the use of a default layout, you can provide a falsy value
defaultLayout: "default.hbs",
// Maps templates to MedusaJS events
// Only events listed here will be subscribed to.
templateMap: {
// "eventName": {
// name: "templateName"
// subject: "E-mail subject"
// }
"order.placed": {
name: "order.placed",
subject: "Order confirmation",
},
},
// Helper functions, or "helpers" can be registered with Handlebars
// and used within templates. Helpers provide additional functionality to templates,
// such as transforming output, iterating over data, and more.
hbsHelpers: {
// Example: A helper that divides two numbers
// divide: function (a, b, opts) {
// return a / b;
// },
// Usage in template: {{#divide 50 2}}
},
},
},
];

E-mail templates

Templates for each event should be placed in a sub-directory matching the name specified in the templateMap: eg. Copy to clipboard{templatesDir}/order.placed. The sub-directory must contain two files: Copy to clipboardhtml.hbs for the HTML version and Copy to clipboardtxt.hbs for the plain text version of the email.
If you'd like to try the example email templates, simply comment out Copy to clipboardtemplatesDir, Copy to clipboardlayoutsDir, and Copy to clipboardpartialsDir in your configuration.

Custom events

To send notifications for custom events, include Copy to clipboardto property in the event data payload. This property specifies the recipient e-mail address.

Build your own plugins

Develop your own plugins with our API to speed up your processes.

Make your plugin available via npm for it to be shared in our Plugin Library with the broader Medusa community.