Tutorial 7: Use recursive placeholders

<< Click to Display Table of Contents >>

Navigation:  Tutorial >

Tutorial 7: Use recursive placeholders

 

info_32 Example: {r} {%salutation_{%language%}%} {/r}

This placeholder requires:

You create a column "language" in the recipient list containing the entries "DE" and "EN". You create for templates with the names "salutation_DE" and "salutation_EN" for both cases. Here you enter the text which is to be inserted in the respective case.

 

Follow these steps:

1.Select "content Content" in the Navigation.

 

2.Right-click at the position where you want to add the placeholder.

 

3.Navigate in the opening context menu to Placeholder->Functions and choose "Recursive Placeholder" from the list. A dialog to insert placeholders should now show up.
 

4.In the first step, please enter the name for the outer value. This is the beginning of the template, which is to be used in this placeholder function (example: "salutation_").
The end of the template name will automatically be replaced with the respective column entry of your recipient list, which will be defined in the next step.
After you finished this step, please click on "Next".
 

5.In this step you will define the name of the inner value, which represents the end of the template, defined in the first step.
Select the text (default is "INNERVALUE") and right-click on it. In the context menu select "Recipients Fields" and click on the column name of the recipient list you want the template to be dependent on. (example: "language").
After you finished this step, please click on "Next".
 

6.In the following dialog you will get the possibility to create a new quick part of the created placeholder. This step is optional.
 

7.If you followed this example this placeholder appears in the text at the position of the cursor:
{r} {%salutation_{%language%}%} {/r}

 

 

The following diagram visualizes the structure of a recursive placeholder:

recursive_placeholder_diagram

 

info_32 Please note:

The template names must be adjusted to the possible entries in the referred column. It is recommended to separate beginning and end of the template name with a "_" (underscore), as seen in the example at the top.