ToInlineStyleEmailBundle
ToInlineStyleEmailBundle is a Symfony2 bundle to use the CssToInlineStyles translator by Tijs Verkoyen (see https://github.com/tijsverkoyen/CssToInlineStyles for the repository)
Requirements
ToInlineStyleEmailBundle is only supported on PHP 5.5 and up.
Installation
Please, use the Composer to install this bundle in your Symfony2 app.
The following lines should be added in your composer.json
"require": {
"gushphp/to-inline-style-email-bundle": "~1.4.0"
},
Then, register the bundle in your AppKernel by adding the following line:
new RobertoTru\ToInlineStyleEmailBundle\RobertoTruToInlineStyleEmailBundle(),
Documentation and Examples
The bundle provides a service named css_to_inline_email_converter. Use it in a controller to have a nice shortcut to the converter developed by Tijs Verkoyen. E.g.:
public function indexAction() {
$converter = $this->get('css_to_inline_email_converter');
...
}
Get the HTML and the CSS as a string and set this required values to the converter object, e.g.
$converter = $this->get('css_to_inline_email_converter');
$html = ...; // get the HTML here
$css = ....; // get the CSS here
return $converter->inlineCSS($html, $css);
The retrieval of the HTML and CSS files from its folder it is only up-to you. E.g. in your controller retrieve the content of your CSS as:
file_get_contents($this->container->getParameter('kernel.root_dir').'/../src/Acme/TestBundle/Resources/css/mystyle.css');
Of course, it is supposed that a Symfony user will use a template instead of a static HTML page. Hence, for convenience, the service provides a function capable to render a template. E.g.:
$converter->setHTMLByView(
'AcmeTestBundle:MyController:my_template.html.twig',
[
'param_1' => $val_of_param_1,
// ...,
'param_n' => $val_of_param_n
]
);
The preceding function must be used instead of setHTML()
.
To use the generateStyledHTML
method just use it like:
$converter->setHtml($html);
$converter->setCss($css);
return $converter->generateStyledHTML();
You can use inline css directly in Twig template:
{% inlinecss '/css/email.css' %}
<div class="foo">
...
</div>
{% endinlinecss %}
Paths relative to bundle are supported as well:
{% inlinecss '@AppBundle/Resources/css/email.css' %}
<div class="foo">
...
</div>
{% endinlinecss %}
Dynamic variable is supported (Use absolute path with variable with asset or directly with full path to file)
{% set path = asset('css/email.css', null, true) %}
{% inlinecss path %}
<div class="foo">
...
</div>
{% endinlinecss %}
Dynamic variable is supported (Use absolute path with variable with asset or directly with full path to file)
{% set path = asset('css/email.css', null, true) %}
{% inlinecss path %}
<div class="foo">
...
</div>
{% endinlinecss %}
Read the docs in the files for further details on the usage of the service.
Configuration
The css_to_inline_email_twig_extension.web_root
parameter contains the path to the root directory accessible to the web. This path is assumed to be a web
directory just outside the kernel root directory as recommended in Symfony 2-3 (%kernel.root_dir%/../web
). With Symfony 4, the recommended path moved to a public
directory just outside the kernel root directory (%kernel.root_dir%/../public
). Override the parameter with the correct path for your implementation.
Contributing
ToInlineStyleEmailBundle is an open source project, under MIT license. Contributions are encouraged. Feel free to contribute to improve this bundle.
About the author of the bundle
ToInlineStyleEmailBundle has been originally developed by Roberto Trunfio. Currently, the bundle is mantained by Luis Cordova via the gushphp organization.
The initial package on packagist robertotru was moved here to gushphp organization with the author consent for maintenance.