wiredmedia/to-inline-style-email-bundle

A Symfony2 bundle for using the CssToInlineStyles translator by tijsverkoyen

dev-master / 1.1.x-dev 2013-06-06 00:00 UTC

This package is not auto-updated.

Last update: 2024-03-16 10:02:18 UTC


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 5.3.3 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": {
        "tijsverkoyen/css-to-inline-styles": "dev-master",
        "robertotru/to-inline-style-email-bundle": "dev-master"
    },

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
          
   $converter->setHTML($html);
   $converter->setCSS($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', 
       array('param_1'=>$val_of_param_1, ..., 'param_n'=>$val_of_param_n));
   }

The preceding function must be used in vece of function setHTML().

Read the docs in the files for further details on the usage of the service.

Contributing

ToInlineStyleEmailBundle is an open source project. Contributions are encouraged. Feel free to contribute to improve this bundle.

About the author of the bundle

ToInlineStyleEmailBundle has been originally developed and is mantained by Roberto Trunfio (see more on the author at www.trunfio.it)