Crossjoin\PreMailer converts CSS in a given HTML source to inline styles and optimizes it for sending it via e-mail. It also creates a text version of the HTML source.
This is a composer package. See the composer website for basic installation information.
Add the following line to your composer.json file:
{
"require": {
"crossjoin/pre-mailer": "1.0.*"
}
}- Extracts CSS from HTML sources
- Can move CSS to the body of the HTML document (so it won't be removed by some e-mail clients)
- Can remove comments from the HTML document
- Can remove all class attributes from the HTML document
- Compresses the CSS
- Creates a text version of the HTML document (for the alternative part of the e-mail)
- ...
You can read different HTML sources.
// Read HTML file$htmlFileName = "path/to/file.html";
$preMailer = new \Crossjoin\PreMailer\HtmlFile($htmlFileName);
// Read HTML string$htmlString = "<html>...</html>";
$preMailer = new \Crossjoin\PreMailer\HtmlString($htmlString);The default charset is "UTF-8". You can change it to the preferred charset.
// Sets the charset of the HTML file.$preMailer->setCharset("ISO-8859-1");You can set different options to influence the PreMailer behavior.
// Remove HTML comments (default)$preMailer->setOption($preMailer::OPTION_HTML_COMMENTS, $preMailer::OPTION_HTML_COMMENTS_REMOVE);
// Keep HTML comments$preMailer->setOption($preMailer::OPTION_HTML_COMMENTS, $preMailer::OPTION_HTML_COMMENTS_KEEP);
// Move the style tag to the body of the HTML document (default)$preMailer->setOption($preMailer::OPTION_STYLE_TAG, $preMailer::OPTION_STYLE_TAG_BODY);
// Move the style tag to the head of the HTML document$preMailer->setOption($preMailer::OPTION_STYLE_TAG, $preMailer::OPTION_STYLE_TAG_HEAD);
// Remove the style tag from the HTML document// (to use, if ALL of your styles can be written inline)$preMailer->setOption($preMailer::OPTION_STYLE_TAG, $preMailer::OPTION_STYLE_TAG_REMOVE);
// Keep HTML class attributes (default)$preMailer->setOption($preMailer::OPTION_HTML_CLASSES, $preMailer::OPTION_HTML_CLASSES_KEEP);
// Remove HTML class attributes$preMailer->setOption($preMailer::OPTION_HTML_CLASSES, $preMailer::OPTION_HTML_CLASSES_REMOVE);
// Set line-width of the text version (defaults to 75)$preMailer->setOption($preMailer::OPTION_TEXT_LINE_WIDTH, 60);
// Set CSS writer class (class that extends \Crossjoin\Css\Writer\WriterAbstract).// By default the Compact writer (\Crossjoin\Css\Writer\Compact) is used, but for// some purposes another writer (like \Crossjoin\Css\Writer\Pretty) can be useful.$preMailer->setOption($preMailer::OPTION_CSS_WRITER_CLASS, $preMailer::OPTION_CSS_WRITER_CLASS_PRETTY);
// Instead of the constant also the full class name can be used:$preMailer->setOption($preMailer::OPTION_CSS_WRITER_CLASS, '\Crossjoin\Css\Writer\Pretty');
// So you can use your own writer if required:$preMailer->setOption($preMailer::OPTION_CSS_WRITER_CLASS, '\MyNameSpace\Css\Writer\MyWriter');The PreMailer generated an optimized HTML and text version for the e-mail.
// Get the HTML version$html = $preMailer->getHtml();
// Get the text version$text = $preMailer->getText();- Add charset auto-detection (extracted from the HTML document)
- Ability to influence the text version format
- Optimize inline styles (remove declarations that are overwritten within the same inline style)