System status
Deutsch

Usecases and practical examples

Current article:
More articles in this category:

TAL-practice example: eMailing- and LeadPage templates

  • Updated
Follow

Objective

The goal of this article is to show you the numerous possibilities how to use TAL for the creation of eMailing/LeadPage and article templates. The following examples are covered:

Individualized page title

In this example the following is demonstrated:

  • Depending on whether the current e-mail is generated with a profile, either the subject is set as the page title or a fallback text.
eMailing template Output (HTML)
<head> <title
tal:condition="not: THIS/getCurrentUser/isDummy">${THIS/getSubjectForCurrentUser}</title> <title tal:
condition="THIS/getCurrentUser/isDummy">This is a general title</title> </head>

The following TAL functions are used:

Select language container based on profile language

In this example the following is demonstrated:

  • The language of the current profile is read out. If none is set, German (id = 1) is the fallback.
  • All containers in the specified folder ("langFolder") are scanned. The container whose name corresponds to the profile language is set as the language container (langContainer).
  • If no matching container is found because there is no matching container for the current language, the English language container remains as a fallback.
  • The attribute "READMORE" of the language container is output.
eMailing template Output (HTML)
<div tal:define="lang THIS/getCurrentUser/getValuesRaw/LANGUAGE|string:1; langFolder string:1681176;global langContainer THIS/getContainer/23471899" tal:omit-tag="true" tal:repeat="object THIS/getCategoryContent/byDescription/${langFolder}" style="display:none"> <div
tal:condition="equals:string:${lang}/${object/getDescription}" tal:omit-tag="true"> <div
tal:define="global langContainer THIS/getContainer/${object/getId}" tal:omit-tag="true">&nbsp;</div> </div> </div>
<span>${langContainer/getAttributeByName/READMORE}</span>

The following TAL functions are used:

Flexible navigation from the link list of the content container

In this example the following is demonstrated:

  • To generate a link table, a link list is evaluated from the content container.
  • If the link list is empty, the table is not displayed.
  • Iterates over every link object in the link list, taking only the first 4 into account.
  • If tracking is accepted for the current profile, tracking links are generated. Otherwise the links are not trackable.
eMailing template Output (HTML)

The following TAL functions are used:

Use image picker for header image in the Visual Editor

In this example the following is demonstrated:

  • If the current e-mail or LeadPage is displayed in the Visual Editor, an image picker is used.
  • Otherwise an image is displayed whose URL is stored in the INPUTFIELD_9.
  • The image is automatically scaled to a width of 800 pixels.
  • The image picker reads all images from the corresponding directory and offers them as selection.
  • The ID of the image directory is in INPUTFIELD_10.
  • Finally, the JavaScript required to display the image picker is only loaded when displayed in the Visual Editor.
eMailing template Output (HTML)
<script type="application/javascript" tal:condition="THIS/isAppendMode">overlayInit();</script>

The following TAL functions are used:

Editorial with personal salutation and table of contents

In this example the following is demonstrated:

  • If the e-mail is generated with a profile, a personal salutation is displayed. Otherwise, a fallback text is displayed.
  • The editorial is inserted as a replacement variable so that it can be edited in the Visual Editor.
  • If there are articles in the current e-mail, a table of contents is displayed.
  • For this purpose, all filled slots are iterated through. An unsorted list is generated for each slot.
  • For each article in the respective slot, a link is inserted with a jump marker to the article and the article title as link text.
  • If there is more than one article in a slot, they are numbered consecutively.
eMailing template Output (HTML)

The following TAL functions are used:

Outputting single and multi-column slots with TAL

In this example the following is demonstrated:

  • If the eMailing or LeadPage is output in the Visual Editor, the slots are created in a table using replacement variables.
  • A heading is inserted for each slot containing at least one article. This is done in the Visual Editor using replacement variables, in the output of the eMailing or LeadPage using TAL.
  • If the eMailing or LeadPage is not called in the Visual Editor and a slot contains at least one article, a table is created for this slot.
  • Depending on the slot, the articles are displayed in a table with one, two or three columns.
eMailing template Output (HTML)

The following TAL functions are used:

In this example the following is demonstrated:

  • Depending on whether one or more links are contained in SmartLink, a table of links is created or a single link is output.
  • If the current profile has agreed to tracking, tracking links are generated.
eMailing template Output (HTML)

The following TAL functions are used:

Consider URL parameter for link to online version

In this example the following is demonstrated:

  • The link to the online version of the emailing is only displayed if the URL parameter ("online") is set.
  • The corresponding parameter is appended to the link to the online version.
eMailing template Output (HTML)
<p tal:condition="not:equals:string:${REQUEST/online}/true">If this newsletter is not displayed correctly please click <a href="{$ONLINEMAIL_URL},online=true">here</a></p>

The following TAL functions are used:

Article template with TAL

In this example the following is demonstrated:

  • A language container is loaded via the eMailing/LeadPage object belonging to the article. The ID of the language container is in INPUTFIELD_0 of the eMailing- or LeadPage.
  • A jump marker is placed on the article.
  • Depending on whether the current article has an even or odd position in the current slot, a column is inserted to the left or right of the article text.
  • The position of the article within the slot is built into the article heading.
  • A METAL macro is used for the article image. This means that the source code for the article image only has to be written/changed once instead of four times.
  • The URL of the image is read from an article attribute.
  • If a landing page link is provided, the image is linked and a call-to-action link is displayed.
  • An attribute from the article is read as the label of the call-to-action link. If this is empty, the corresponding text from the language container is used as a fallback.
Article template Output (HTML)

The following TAL functions are used:

Was this article helpful?
1 out of 2 found this helpful
Return to top

Related articles