asahasrabuddhe/laravel-mjml

A package that enables using MJML with Laravel Mailables.

Laravel MJML

Build responsive e-mails easily using MJML and Laravel Mailables., _(*1)

MJML

MJML is an awesome tool from MailJet that allows us to create responsive emails very easily. For more information on how to use it, head to their documentation here, _(*2)

Installation

To install this package, require this package using composer as follows:, _(*3)

composer require asahasrabuddhe/laravel-mjml, _(*4)

After composer installs the packages and all the dependencies, publish the package configuration using artisan command:, _(*5)

php artisan vendor:publish, _(*6)

Select the laravel-mjml in the list. You will also need to install the MJML CLI:, _(*7)

npm install --save mjml, _(*8)

Getting Started

1. Create a view containing MJML in your resources/views directory.
2. Create a mailable class using artisan command: php artisan make:mail MJMLEmail

3. In the mailable class, replace, _(*9)

   use Illuminate\Mail\Mailable;, _(*10)

   with, _(*11)

   use Asahasrabuddhe\LaravelMJML\Mail\Mailable;, _(*12)

4. For Laravel 8 and below, in the build method, use:, _(*13)

   public function build()
   {
       return $this->mjml('view.name')
   }
   

   For Laravel 9, in the content method:, use:, _(*14)

   public function content()
   {
       return new Content(
           view: $this->mjml('view.name')->buildMjmlView()['html'],
       );
   }
   

Configuration

By default, the package will automatically detect the path of the MJML CLI installed locally in the project. In case this does not happen or the MJML CLI is installed globally, please update the configuration file likewise., _(*15)

That's it! You have successfully installed and configured the MJML package for use. Just create new views and use them in the mailables class., _(*16)