eresults/email-template-bundle

Easily render email subject, body, etc. from a single template or even a database entry.

1.0.0 2020-06-18 14:00 UTC

Requires

• php: >=7.4
• symfony/config: ^4.0|^5.0
• symfony/dependency-injection: ^4.0|^5.0
• symfony/http-kernel: ^4.0|^5.0
• symfony/yaml: ^4.0|^5.0
• twig/twig: ~2.0|~3.0

Requires (Dev)

• dg/bypass-finals: ^1.2
• phpunit/phpunit: ^9.0

MIT

• Niels Janssen
• eResults

• twig email
• doctrine email
• emails integration

README

eResults\EmailTemplateBundle lets you use a single template to encapsulate all aspects of an email, like subject body and even From, CC & BCC fields. This also allows you to store (Twig) templates in your database.

Requirements

• PHP >=7.4
• Symfony ^4.4|^5.0

Installation

composer req eresults/email-template-bundle

Add bundle to your application kernel

// app/AppKernel.php
public function registerBundles() 
{
    $bundles = [
        // ...
        new eResults\EmailTemplateBundle\eResultsEmailTemplateBundle(),
    ];
}

Usage

• Create registration email template in your app

templates/email/user_registered.html.twig

• Edit template

// templates/email/user_registered.html.twig
{% extends '@eResultsEmailTemplateBundle/email.html.twig' %}

{% block from -%}
[e-mail]
{%- endblock %}

{% block subject -%}
Thanks for registering {{ first_name }}!
{%- endblock %}

{% block body -%}
Hello {{ first_name }},
<br />
<br />
Thank you for registering at our website! below your account details:
<br />
<br />
First Name: {{ first_name }}<br />
Last Name: {{ last_name }}<br />
Email: {{ email }}<br />
<br />
Thanks
{%- endblock %}

• Now you can send it from your controller

<?php
// ...
class UserController extends Controller
{
    public function registerAction(LoaderInterface $loader, \Swift_Mailer $mailer) {
        // ...
        if ($form->isValid()) {
            //.. handle your form
            $formData = array(
                'email' => '[e-mail]',
                'first_name' => 'John',
                'last_name' => 'Doe',
            );

            $template = $loader->load('email/user_registered.html.twig', $formData);
            $message = \Swift_Message::newInstance()
                ->setSubject($template->getSubject())
                ->setFrom($template->getFrom())
                ->setBody($template->getBody(), 'text/html')
                ->setTo($formData['email'])
            ;

            $mailer->send($message);
        }
    }
}

Thats's it! John Doe will receive an email as below:

Hello John,
Thank you for registering at our website! below your account details:

First Name: John
Last Name: Doe
Email: [e-mail]

Thanks

Advanced Usage

• Configuration.
• How to use templates with database (Doctrine).