README

Laravel Email Templates

Database driven email templates for >= Laravel 5.4 and PHP 7.

Configuration

First register the service provider in config/app.php:

'providers' => [
    # ...
    JDT\LaravelEmailTemplates\ServiceProvider::class,
],

Then, in the same file, add the facade to the aliases config:

'aliases' => [
    # ...
    'EmailTemplate' => JDT\LaravelEmailTemplates\Facades\EmailTemplates::class,
]

Next, run the migrations:

$ php artisan migrate

This will set up 2 tables; email_template and email_layout.

Usage

The package is built in such a way that it plays nicely with the existing Laravel Mailer functionality.

Given a template existing in the above table with the handle 'registration', email can be sent simply as below:

$mail = \EmailTemplate::fetch('registration', ['name' => 'Jon']);
 
\Mail::to('foo@bar.com', $mail);

You can of course pass the language to translate the chosen email, providing you have created an email for that handle/language combination.

$mail = \EmailTemplate::fetch('registration', ['name' => 'Jon'], 'es');
 
\Mail::to('foo@bar.com', $mail);

This package doesn't rely on a templating engine such as Blade or Twig to handle any of the email messages, but does provide it's own view class adhering to Laravel contracts.

This means that you can pass data to the email just as you would any other view, without having to worry about the choice of templating package you use elsewhere in your project.

$mail = \EmailTemplate::fetch('registration', ['first_name' => 'Jon']);
 
$mail->with('last_name', 'Braud');
 
$mail->with([
    'verify_url'=> 'https:/....',
    'signup_time' => \Carbon\Carbon::now()->toDateTimeString()
]);
 
\Mail::to('foo@bar.com', $mail);