PHPackages                             maba/mail-renderer-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. maba/mail-renderer-bundle

ActiveLibrary[Mail & Notifications](/categories/mail)

maba/mail-renderer-bundle
=========================

Symfony bundle for easier email sending

1.1.1(10y ago)094MITPHPPHP >=5.3.3

Since Jun 23Pushed 10y ago1 watchersCompare

[ Source](https://github.com/mariusbalcytis/mail-renderer-bundle)[ Packagist](https://packagist.org/packages/maba/mail-renderer-bundle)[ RSS](/packages/maba-mail-renderer-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (6)Versions (4)Used By (0)

Mail Renderer Bundle
====================

[](#mail-renderer-bundle)

Symfony bundle that collects some libraries together to make sending emails easier:

1. Renders twig template to get subject and content of an email
2. Converts HTML content to plain text if it's not available in template
3. Sets default From email and name to message
4. Gets CSS for mail messages using Assetic, if configured
5. Inlines CSS inside HTML `style` attributes and/or adds `` tag
6. Sends message using swift mailer

Installation
------------

[](#installation)

Add via composer:

```
composer require maba/mail-renderer-bundle jimbojsb/emogrify:@dev

```

Register bundle:

```
new Maba\Bundle\MailRendererBundle\MabaMailRendererBundle(),
```

Configure in `config.yml`:

```
maba_mail_renderer:
    css_assets:
        inline: mail
        imports: mail_imports
    from:
        email: info@example.com
        name: My Awesome Company

assetic:
    assets:
        mail:
            inputs:
                - @bootstrap_css
                - @ApplicationBundle/Resources/less/styles.less
        mail_imports:
            inputs:
                - %kernel.root_dir%/Resources/public/css/mail-imports.css
```

`css_assets` node is optional, as is usage of Assetic.

Usage
-----

[](#usage)

Code:

```
/** @var FormattedMessageMailer $mailer */
$mailer = $this->get('maba_mail_renderer.formatted_message_mailer');

$mailer->sendMessage('customer@example.com', 'ApplicationBundle:Email:welcome.html.twig', array(
    'username' => 'customer123',
    'activationLink' => 'http://www.example.com/activate/ABC123',
));
```

Twig template:

```
{# ApplicationBundle:Email:welcome.html.twig #}

{% block subject %}Hello {{ username }}, welcome to example.com!{% endblock %}

{% block body_html %}
    Hello {{ username }},

        You've registered on example.com. Here you can make lots of stuff:

            Stuff
            More stuff

        To activate your account click here

    See ya!
{% endblock %}
```

That's it!

All CSS rules assigned to classes will be inlined into HTML as `style` attributes.

Extended usage
--------------

[](#extended-usage)

### Templates

[](#templates)

Only these blocks are parsed from template: `subject`, `body_html` and `body_text`. `subject` and at least one of other two are required. Any other blocks or content in template is ignored.

If `body_text` is provided, it will be used as plain text version of mailer message.

Additionally `toEmail` variable is passed to the twig template, which equals to the given recipient.

I'd suggest to use single layout twig file, if there's defined structure in your mails. For example:

```
{# :Email:layout.html.twig #}

{% block body_html %}
    Good afternoon,

    {% block content %}{% endblock %}

    See ya!

    Unsubscribe
{% endblock %}
```

```
{# ApplicationBundle:Email:welcome.html.twig #}
{% extends ':Email:layout.html.twig' %}

{% block subject %}...{% endblock %}
{% block content %}
    ...
{% endblock %}
```

### Styles

[](#styles)

`inline` and `imports` values in `css_assets` configuration node take Assetic asset name, which you should configure using Assetic configuration.

`inline` is used when applying CSS rules to message HTML result - `style` attributes are added to HTML nodes, which would trigger appropriate CSS rules. This is needed as some email readers support neither `` nor ``(for example GMail).

`imports` is used to make `` tag with CSS contents in the mail message itself. This should be as short as possible - usually only for rules that cannot be inlined, like this one:

```
@import url("//fonts.googleapis.com/css?family=Ubuntu:400,400italic,700,700italic&subset=latin,latin-ext");
```

That's why it's called `imports` in configuration.

Why `` instead of ``? To avoid remote resource loading, which is also most commonly disabled by default.

### Changing created message

[](#changing-created-message)

Use `createMessage` instead of `sendMessage` with same parameters in renderer, change or add any required fields and send with swift mailer manually.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~95 days

Total

3

Last Release

3792d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6e131c9aa5f5a4fc3cc2f5e01b377ef33bbc3468acc95ff890fc6e8353d9cf67?d=identicon)[mariusbalcytis](/maintainers/mariusbalcytis)

---

Top Contributors

[![mariusbalcytis](https://avatars.githubusercontent.com/u/1590072?v=4)](https://github.com/mariusbalcytis "mariusbalcytis (8 commits)")

---

Tags

mailemailmailer

### Embed Badge

![Health badge](/badges/maba-mail-renderer-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/maba-mail-renderer-bundle/health.svg)](https://phpackages.com/packages/maba-mail-renderer-bundle)
```

###  Alternatives

[sylius/mailer-bundle

Mailers and e-mail template management for Symfony projects.

728.1M77](/packages/sylius-mailer-bundle)[voku/bounce-mail-handler

Bounce Mail Handler

49230.9k2](/packages/voku-bounce-mail-handler)[boundstate/yii2-mailgun

Mailgun integration for the Yii framework

28160.6k](/packages/boundstate-yii2-mailgun)[yarcode/yii2-mailgun-mailer

Mailgun mailer implementation for Yii2

1576.0k](/packages/yarcode-yii2-mailgun-mailer)[sandstorm/templatemailer

Neos and Flow package for simple handling of template-based emails, including CSS inlining

1147.3k2](/packages/sandstorm-templatemailer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)