How can we help?

Get started: for designers

Overview

Cordial empowers designers to create dynamic templates that enable marketing teams to send highly personalized messages. You can build these templates using either the HTML editor or the Sculpt editor.

For advanced personalization, we developed a template syntax based on a custom version of Smarty (a php-based template language). To take full advantage of Cordial's personalization capabilities, you should be proficient with Smarty syntax and know how to code templates that use variables, link functions, conditional logic, and data looping.

How Cordial stores data

Before you dive into Smarty, it's important to know that Cordial stores data in separate collections. Smarty references these collections when rendering data in messages using Smarty variables.

Visit these articles to learn about our data collections:

In addition to leveraging the above data collections, you can reference external data such as RSS feed, Instagram feed, weather, and data from any other source when personalizing message content.

Personalization with Smarty

Once you understand what data is available to you and how it's stored in Cordial, you can access and render it in messages using Smarty.

Introduction to Smarty

For an introduction to Smarty, go here: Get started with Smarty syntax.

Here are the fundamentals:

  • Smarty is wrapped in curly braces.
  • CSS also uses curly braces, so be sure to escape CSS using the literal tag, or you'll get errors when trying to save messages.
  • Smarty renders when previewing a message or at the time of sending a message.
  • You can select a contact's email address when previewing messages to see a live preview of their personalized content.
  • Smarty supports variables, conditional statements, data looping, and other functions and modifiers.

Variables

Smarty can access data using variables. Variables can access system data, account data, contact attribute data, and much more. Here are some articles that show what you can do with Smarty variables:

  • Variables overview: Get an overview of how variables are used in Cordial.
  • System variables: Certain variables are reserved for system values such as email address and message ID.
  • Account variables: Account variables are used for account-specific values that can be used for CAN SPAM/CASL compliance in message footers.
  • Contact variables: Used to render contact attribute values for each contact such as first name, address, and more.
  • Assigning variables: Variables can be set in a message and then recalled throughout. This is useful for link appends or building complex Smarty logic.
  • Date and timestamp variables: Used for rendering dates in a message.
  • Variable modifiers: Modifiers are used to change the way variables are rendered, such as date formats, numbers, and capitalization.

Link functions

Cordial's custom version of Smarty adds functionality to links beyond simply pointing to a web page. Learn about link functions in the articles below.

Conditional statements and data looping

In addition to rendering variables and link functions, Smarty is used for conditional if/then statements for rendering dynamic content. You can also loop through data arrays and render specific values using {foreach} statements.

Get data arrays

Using Smarty, you can access data arrays from a given collection (such as products), filter the results, and render them in a message. These are called Get data array methods. When you combine these with conditional statements and variables, you pave the way for highly personalized, dynamic content.

The following articles provide explanations and examples of different array methods available:

  • Get products: Filter and render products from your product catalog.
  • Get events: Filter and render event data such as items browsed on a site.
  • Get orders: Filter and render order data in a message.
  • Get supplements: Filter and render supplement data in a message.
  • Get JSON: Render data from an external source such as an Instagram feed.

HTML content includes

Reusable HTML snippets can be saved in our content library and then rendered in multiple messages using Smarty. Check out the Reusable HTML content overview article to learn more.

Sculpt editor

The Sculpt editor provides an easy way to create complex message layouts using a combination of Sculpt templates and Sculpt blocks.

You start by creating a Sculpt template to use as a starting point for messages. From there, you create Sculpt blocks that can be dragged into templates during message creation.

Both Sculpt templates and Sculpt blocks support advanced personalization using Smarty.

Sculpt templates

Before you can use the Sculpt editor to create messages, a Sculpt template must be created and saved in your account. A Sculpt template is the HTML shell that can accept Sculpt blocks.

Sculpt blocks

Sculpt blocks are created separately from Sculpt templates and live within the Sculpt block library. When creating messages, marketers choose a Sculpt template as a starting point and then drag in Sculpt blocks to build engaging layouts and customize content.

Designers working in Cordial create a library of Sculpt blocks that marketing teams can use for messages. Any element within a Sculpt block (images, colors, fonts, etc.) can be set as editable using variables and then customized.

Helpful resources

These resources can be useful when creating and testing your messages.

Comments

0 comments

Please sign in to leave a comment.