Create responsive HTML emails with mjml.io.

Installation

Install the module with Composer in the usual way.

$ composer require drupal/mjml

Enable the module on the administration UI or with Drush.

Select and configure the MJML renderer

Install the MJML NodeJS library.
Configure the path of the NodeJS library in the settings.php:

<?php
$settings['mjml'] = [
  'renderer' => [
    'binary' => [
      'options' => [
        'path' => 'PATH_TO_THE_MJML_BINARY'
      ]
    ]
  ]
];

Clear all cache in Drupal. (Ex.: Run drush cr)

https://mjml.io/api.

Install juanmiguelbesada/mjml-php library with Composer.

$ composer require juanmiguelbesada/mjml-php

Set your API credentials and change the default MJML renderer in the settings.php

<?php
$settings['mjml'] = [
  'default_renderer' => 'mjml.renderer.api',
  'renderer' => [
    'api' => [
      'client' => [
        'application-id' => 'YOUR_APPLICATION_ID',
        'secret-key' => 'YOUR_SECRET_KEY',
      ]
    ]
  ]
];

Clear all cache in Drupal. (Ex.: Run drush cr)

(Optional) Send a test email

<?php
$params = [
  'name' => 'YOUR_NAME',
];
$addressee = 'YOUR_EMAIL@ADDRESS.COM';
$mail_manager = \Drupal::service('plugin.manager.mail');
$template = \Drupal::moduleHandler()->moduleExists('swiftmailer') ? 'test_mail_mjml_twig_template_swiftmailer' : 'test_mail_mjml_twig_template';
$mail_manager->mail('mjml', $template, $addressee, \Drupal::service('language.default')->get()->getId(), $params);

Usage

Check the mjml.module file for examples how you can use this module with

the default mail implementation in Drupal,
the MailSystem module,
or the SwiftMailer module.

RoadMap

The current implementation depends on the PHP integration provided by
notfloran/mjml-bundle Symfony bundle. This may change in the
future.

This project is managed and maintained on Github.

MJML

Issues

Problem with composer installationActiveCode Created about 1 year ago

Problem with composer installation
Active
Code
Created about 1 year ago