Placeholders

Version 5 (Ole Wiemeler, 05.01.2009 06:06 pm)

1 4 Schorsch Leciejewski
h1(title). Placeholders - Text substitution
2 1
3 4 Schorsch Leciejewski
h1. Contents
4 1
5 4 Schorsch Leciejewski
{{toc}}
6 4 Schorsch Leciejewski
7 4 Schorsch Leciejewski
h1. Audience
8 4 Schorsch Leciejewski
9 4 Schorsch Leciejewski
SalesKing Users who want to customize text in emails or elsewhere.
10 4 Schorsch Leciejewski
11 4 Schorsch Leciejewski
h1. Example
12 4 Schorsch Leciejewski
13 4 Schorsch Leciejewski
Placeholders occur in text you are using inside the SalesKing. 
14 4 Schorsch Leciejewski
15 4 Schorsch Leciejewski
For example in an email:
16 1
<pre>
17 1
Dear [customer.name],
18 1
thanks for your payment of Invoice no.: [invoice.number] which was: [invoice.total_sum]
19 1
</pre>
20 4 Schorsch Leciejewski
21 4 Schorsch Leciejewski
h1. Description
22 1
23 1
Each placeholder is made up of a prefix, to specify the realm of the following data field value.
24 3 Schorsch Leciejewski
25 1
The surrounding brackets [] tell the system that this is a special text which will be substituted with real data.
26 1
27 1
<pre>
28 1
[invoice.number] -> realm invoice field number
29 1
[client.number] -> realm client, field number
30 1
[product.number] -> realm product, field number
31 5 Ole Wiemeler
[company.name] -> realm company, field name
32 1
[settings.company_info] -> realm settings (invoice print settings), field company_info
33 1
</pre>
34 1
35 2 Schorsch Leciejewski
If a placeholder can“t be substituted because the field is not available it will show the placeholder itself.
36 1
37 2 Schorsch Leciejewski
If a placeholder is available but empty, it will be substituted with this empty string.