Отправка электронной почты с использованием Node.js

Он берет на себя почти весь процесс создания электронных писем в формате HTML и многое другое.

Библиотека предоставляет следующие возможности:

• Поддержка ejs, Jade, Swig, Handlebars, Emblem and Dust
• Предварительная обработка CSS с использованием Less, SASS, Stylus или Styl
• CSS inlinig, используя Juice
• Интеграция с Nodemailer, Postmark
• Поддержка пакетной отправки

Другими словами, это раковина HTML-писем для Node. Давайте посмотрим на это, и как это использовать.

использование

Установить через npm:

 npm install email-templates

Затем создайте каталог где-нибудь для хранения ваших шаблонов. В рамках этого создайте каталог для каждого типа электронной почты. Например, один каталог для писем с подтверждением, другой для инструкций по сбросу пароля и, возможно, универсальная оболочка для сообщений.

Вот пример структуры каталогов:

 templates
  emails
    confirm-email
    password-reset
    welcome

Далее создайте свои шаблоны. Как минимум, каждому из ваших почтовых производных нужен шаблон для рендеринга HTML-версии. Его имя файла важно — оно должно называться html.ext.ext Так, например, если вы используете Handlebars, вы захотите назвать свой файл html.hbshtml.jade Обратите внимание, что вам нужно убедиться, что установлен соответствующий шаблонизатор!

Скорее всего, вы также захотите создать таблицу стилей. Вызовите этот styles.ext .css.scss.less

Если вы предпочитаете создавать свою собственную текстовую версию, создайте файл с именем text.ext С расширением действуют те же правила, что и с шаблоном HTML, поэтому оно будет называться как text.hbstext.jade

Чтобы проиллюстрировать это, вот как вы можете расположить каталог confirm-email

 templates
  emails
    confirm-email
      html.hbs
      text.hbs
      styles.scss

Далее вам нужно настроить свой транспортный механизм. Библиотека работает без проблем с NodeMailer и Postmark ; для целей этой статьи мы будем использовать Nodemailer, поскольку он не требует никаких сторонних сервисов и является одним из самых популярных вариантов отправки электронной почты с Node.ks.

В большинстве случаев вам, вероятно, захочется использовать Nodemailer через SMTP, хотя есть и другие виды транспорта , от Sendmail до SES и Sendgrid .

Вот пример использования SMTP:

 var nodemailer = require('nodemailer');
var transport = nodemailer.createTransport(smtpTransport({
  host: 'smtp.yourprovider.org',
  port: 25,
  auth: {
    user: 'username',
    pass: 'password'
  }
}));

Если вы используете Gmail, который использует некоторые нестандартные настройки, вы можете использовать следующий ярлык:

 var nodemailer = require('nodemailer');
var transport = nodemailer.createTransport({
  service: 'gmail',
  auth: {
    user: '[email protected]',
    pass: 'password'
  }
});

Теперь, когда он настроен, вы можете отправить одно электронное письмо следующим образом:

 emailTemplates(templatesDir, function(err, template) {

  if (err) {
    console.log(err);
  } else {

  var locals = {
    email: '[email protected]',
    url: 'http://acme.com/confirm/xxx-yyy-zzz'
  };

    // Send a single email
    template('confirm-email', locals, function(err, html, text) {
      if (err) {
        console.log(err);
      } else {
        transport.sendMail({
          from: 'Acme Corp <[email protected]>',
          to: locals.email,
          subject: 'Please confirm your e-mail address',
          html: html,
          text: text
        }, function(err, responseStatus) {
          if (err) {
            console.log(err);
          } else {
            console.log(responseStatus.message);
          }
        });
      }
    });
  }
});

За и против из библиотеки шаблонов электронной почты

Очевидно, что библиотека решает множество проблем, связанных с HTML-письмами. Это также дает вам большую степень гибкости. Если вы хотите использовать Jade и SASS, вы можете — также Handlebars and Less или Swig and Stylus.

Однако одно: если у вас большой объем отправляемых электронных писем, вы можете отправлять их партиями, и библиотека будет обрабатывать ваши шаблоны только один раз за пакет. Однако в следующий раз, когда вы отправите электронное письмо или пакет электронных писем, он снова пройдет весь процесс. Если вы отправляете ОЧЕНЬ много писем, вам лучше создать предварительно скомпилированные шаблоны.

Помните также, что вам нужно позаботиться о том, чтобы ссылки и пути к ресурсам были абсолютными, а также при необходимости оптимизировать свои изображения или загружать ресурсы в сеть доставки контента (CDN).

Тестирование ваших электронных писем в формате HTML

Конечно, ни одно руководство по отправке электронных писем в формате HTML не будет полным без примечания о тестировании.

Mailcatcher — действительно полезный инструмент для «перехвата» электронных писем, отправленных из вашего приложения. Вы просто запускаете его как фоновый процесс на своем компьютере, настраиваете приложение для использования соответствующего порта и можете просматривать электронные письма через веб-интерфейс на своем компьютере. Мэтью Сеттер написал подробное введение в нее здесь, на SitePoint .

Также стоит проверить Litmus для тестирования ваших электронных писем в формате HTML, сравнивая скриншоты того, как ваша электронная почта отображается в различных клиентах.

Вывод

Письма в формате HTML могут быть настоящей болью, но многие головные боли могут быть смягчены с помощью автоматизации. В этой статье я рассмотрел несколько вариантов, как из приложений Node.js, так и с помощью запуска задач, таких как Grunt. Надеюсь, я дал вам достаточно ресурсов, чтобы вы начали. Посмотрите вокруг и посмотрите, что подходит вам, вашему рабочему процессу и вашему приложению лучше всего. Если вы знаете какие-либо другие полезные инструменты, которые я не рассмотрел, дайте мне знать в комментариях.