The most used parameters and placeholders in Giotto

The following is a non-exhaustive list of the most used parameters and placeholders in the Giotto language.

A parameter can be defined by adding the attribute <mn:param> in an HTML tag and specifying its ID using <mn:name>

<meta mn:param mn:name="myparam"/>.

To print a parameter or variable, write: [param:name{defaultValue}].

Contact

Contactstats

Messages

Link

Text formatting

You can format the value of each placeholder in different ways.

Multiple choice

Workflow variables

You can display the value of a workflow variable.

Encoding

You can define specific encoding based on user needs.

• encode="encodejs": replaces javascript characters
• encode="urlencode": encodes the value as a URL parameter.

Example:

        <meta mn:param mn:name="text" mn:type="text" mn:default="; à é & '" />

        [param:text]

        [param:text encode='encodehtml']

        [param:text encode='encodejs']

        [param:text encode='urlencode']
    

Using placeholders in CSS blocks

Within CSS (Cascading Style Sheets) code, the typical square bracket placeholder syntax like [param:backgroundcolor] cannot be used directly.

To solve this issue, two syntaxes are available:

• Comments to replace the entire value of an attribute:
  color: blue /*[param:color]*/
• Comments to replace part (token) of a value of an attribute:
  border: 1px solid /**[param:bordertype]*/ blue /**[param:color]*/

If you use the regular comment, i.e., '/* ... */', then Giotto replaces the comment with the attribute's value.
If you use the comment with double asterisks '/** ... */', Giotto replaces only the part preceding the comment.

Currently, there is no syntax to manage the qualifier '!important'

Pay attention and consider that for sending email messages, the "Inline CSS" technique is usually applied, meaning that Giotto will include all rules defined within the <style> tags in the 'style' attributes to improve compatibility with different email clients.

Complete example:

        <style>

        .myClass {

                /* Replace the entire value */

                color: blue /*[param:color]*/;

                /* Replace 'solid' and 'blue' independently */

                border: 1px solid /**[param:bordertype]*/ blue /**[param:color]*/; 

        }

        </style>