vysokeskoly / to-inline-style-email-bundle
A Symfony bundle for using the CssToInlineStyles translator by tijsverkoyen
Installs: 37 720
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 1
Forks: 34
Type:symfony-bundle
Requires
- php: ^8.1
- symfony/config: ^5.0 || ^6.0
- symfony/dependency-injection: ^5.0 || ^6.0
- symfony/http-kernel: ^5.0 || ^6.0
- symfony/routing: ^5.0 || ^6.0
- tijsverkoyen/css-to-inline-styles: ^2.2.1
- twig/twig: ^3.0
Requires (Dev)
- ergebnis/composer-normalize: ^2.28
- php-parallel-lint/php-parallel-lint: ^1.3
- phpstan/extension-installer: ^1.1
- phpstan/phpstan: ^1.8
- phpstan/phpstan-phpunit: ^1.1
- phpunit/phpunit: ^9.5.20
Conflicts
README
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 8.1 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": { "vysokeskoly/to-inline-style-email-bundle": "^3.0" },
Then, register the bundle in your AppKernel by adding the following line:
VysokeSkoly\ToInlineStyleEmailBundle\ToInlineStyleEmailBundle::class => ['all' => true],
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 in vece of function 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.
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.