Skip to content
This repository has been archived by the owner on Sep 20, 2023. It is now read-only.

Latest commit

 

History

History
63 lines (45 loc) · 2.2 KB

README.md

File metadata and controls

63 lines (45 loc) · 2.2 KB

GremoZurbInkBundle

Latest stable Downloads total GitHub issues

Creating email templates is hard. This Symfony Bundle provides help.

The original bundle thampe/ZurbInkBundle is abandoned. This fork is under development and aims to provide maintained version of the original project.

Installation

Install the bundle via composer:

composer require gremo/zurb-ink-bundle

Then enable the bundle in the kernel:

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Gremo\ZurbInkBundle\GremoZurbInkBundle(),
        // ...
    );
}

Usage

Email clients typically support only a subset of valid HTML, and don’t have strong support for CSS (especially CSS in the <head> of the HTML email). Yahoo, Outlook, and even Gmail strip CSS that’s included in the <head> of your HTML, so in most cases CSS inlining is necessary.

Foundation for Emails is a framework for building HTML responsive emails. Extend the base layout and override the body or content block:

{% extends 'GremoZurbInkBundle:FoundationForEmails:2/base.html.twig' %}

{% block content %}
    {# your custom HTML or Inky language #}
{% endblock %}

CSS added using zurb_ink_styles.add will be inlined. You can add custom CSS overriding the preHtml block:

{# ... #}

{% block preHtml %}
    {# your custom CSS #}
    {{ zurb_ink_styles.add("css/style1.css") }}
    {{ zurb_ink_styles.add("@AppBundle/Resources/public/css/style2.css") }}
{% endblock %}

If you prefer not to have the CSS style also in the <head> of your HTML document (that is, rely only on inlining) add the following block:

{# ... #}

{% block headStyles %}{% endblock %}