jdtsoftware / laravel-email-templates by tjmartin69

Laravel 5 database driven email templating
2,107
22
8
Package Data
Maintainer Username: tjmartin69
Maintainer Contact: jon@jdtsoftware.co.uk (Jon Braud)
Package Create Date: 2017-03-18
Package Last Update: 2018-06-09
Home Page:
Language: PHP
License: Unknown
Last Refreshed: 2024-05-01 03:00:32
Package Statistics
Total Downloads: 2,107
Monthly Downloads: 1
Daily Downloads: 0
Total Stars: 22
Total Watchers: 8
Total Forks: 8
Total Open Issues: 2

StyleCI

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);