Reusable HTML Content Overview

The "HTML Content" feature allows you to store HTML or Smarty content that can be inserted into any template using a tag. We sometimes refer to these as "includes". This is useful for common blocks of branded content such as headers or footers that will often be the same across many templates.

You can call HTML Content into any template using the following tag:

{include 'content:contentKey'}

Replace "contentKey" with the key name you gave the content in the system.

For example: Lets assume you have 2 blocks of content; "Header" where the key = "header1" and "Footer" where the key = "footer1".

You may include more than one block of HTML Content:

{include 'content:header1'}
  Unique body content for this template here
{include 'content:footer1'}

The include is useful when you have many templates referencing the same centralized HTML content. Any edits to the content within the include will effectively cascade across all templates where that content is included.

Using the Scope parameter

If you are defining Smarty variables in an HTML content include and wish to render them in the message template, you will need to use the Scope parameter. Setting the scope parameter to parent will place the HTML content include at the top of the hierarchy, making it accessible to subsequent variables and functions.

Additionally, we assign the HTML output to a variable called blackhole.  This variable is never used, which means we will not use the HTML output of the Include, only the $data variable that is built up.

Example where the variable is defined in the HTML content:

HTML Content with a key of "header":

{$greeting = "Hello World"}

Message template that includes the HTML Content:

{include 'content:header' scope='parent' assign='blackhole'}
{$greeting}

Rendered Output:

Hello World