Templates-Email
Package for email notifications with editable templates (for important user-related events)
Purpose
This package allows you to create email notifications for events emitted in Laravel app.
Each notification is created as a class describing available variables that can be used in Template (which will be created in database and editable through admin panel). This class must be registered using Template facade from Template package, where you specify which Event it is associated with and which Channel it is sent through (e.g. Email channel when defined in this package).
Installing
composer require escolalms/templates-email
php artisan db:migrate
php artisan db:seed --class="EscolaLms\TemplatesEmail\Database\Seeders\TemplatesEmailSeeder"
Dependencies
Usage
Defining Templates
- Create event which triggers sending email using specified template. This event must implement method getUser() returning User model from LMS Core package.
- Create Class defining template variables, which you will use in email notification,
- Associate your class describing template variables with event and channel through which notifications should be sent. Use
EscolaLms\Templates\Facades\Template::register(Event class, EscolaLms\TemplatesEmail\Core\EmailChannel::class, Variable class);
- Register template in db for admin panel or used
/api/admin/templates
, better described in Template package
Mjml (pre)rendering
- Emails are written using MJML, which then is prerendered into HTML when saving a Template (so that sending an email does not call renderer for each message).
- To render MJML you need to either:
- install
mjml
npm package and configure path to executable binary in this package configbinary_path
key - register to MJML API and configure api id & secret in this package config file
- install
Tests
Run ./vendor/bin/phpunit --filter 'EscolaLms\\TemplatesEmail\\Tests'
to run tests. See tests folder as it contains a basic implementation of Variable (or Template description) class with minimal customisation - a quite good starting point for creating your own.
Permissions
No Permissions defined for this package.