ajrdesign/email-builder

A simple way to build HTML emails using a CMS.

Run the email builder

1. Download MAMP.
2. Clone this repo to a folder that MAMP can access.
3. Launch MAMP and make sure it's running a server.
4. Navigate to that folder to view the app localy (i.e. http://localhost:8888/email-builder/)

Creating templates

There are three files that you need to create a template.

1. Content .txt file. This has the actualy content for the individual emails.
2. Blueprint .yml file. This defines the form fields for the panel/dashboard.
3. Template .php file. This defines how the email will look when combined with the content from the .txt files. Parts of this can be broken up into reusable 'snippets' for consistency.

Set up the email to display correctly:

1. Extract the body of your email (Remove the header and footer sections and just take the main content part)
2. Create a php file in site>templates and place the body section in there.
3. Add this to the top of the file:

   <?php snippet('email-header') ?>

4. Add this to the bottom of the file:

   <?php snippet('email-footer') ?>
   <?php snippet('email-inliner') ?>

5. Add in templating language to the sections you want to edit.

Set up the blueprint to be edited on the panel

Blueprints are the forms that control the templating language from the Panel.

1. Create a .yml file in site > blueprints.
2. Follow the documentation here to set up the editable parts of the email. Note: Structured data is really useful for setting up complicated elements that repeat (i.e. media boxes or cards).

email-builder's Issues

License in your config file

Strip style out of basic template

Need to remove majority of current styling from the template and improve the typography.

Remove Figure wrapping from images in Kirby Text