-
Notifications
You must be signed in to change notification settings - Fork 6
/
ch023_advanced-templating.xhtml
70 lines (70 loc) · 3.09 KB
/
ch023_advanced-templating.xhtml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><title/></head><body><h1>More template placeholders
</h1>
<p>This chapter contains additional details that may be useful for a designer who is creating a template for use in phpList. 
</p>
<p><span>[SUBJECT] </span>
</p>
<p>[SUBJECT] adds the subject of the email within the newsletter text.
</p>
<h3>[CONTENT] - a mandatory placeholder
</h3>
<p>This is where the message's content (body) will be inserted. Every template must have a [CONTENT] placeholder. 
</p>
<h3>[FOOTER]
</h3>
<p>The message footer 
</p>
<h3>[SIGNATURE]
</h3>
<p>[SIGNATURE] prints the phpList image signature.
</p><strong>[FORWARDURL] </strong>
<p>[FORWARDURL] is replaced with the personalised URL only. To use this, you will need to wrap it in HTML, like this:
</p>
<p><a href="[FORWARDURL]">Forward to a Friend</a>
<br/></p>
<p><strong>[PREFERENCESURL] </strong>
</p>
<p>[PREFERENCESURL] allows the recipient to edit their subscribe preferences, for example update their email or the number of lists they belong to. This essentially allows them to maintain your list up to date for you and is an invaluable feature. 
</p>
<h3>[UNSUBSCRIBEURL] - a mandatory placeholder
</h3>
<p>[UNSUBSCRIBEURL] allows the recipient to totally unsubscribe from all your lists. In phpList you must include this placeholder somewhere in your body or footer. It is best to use this along side [PREFERENCESURL] if you manage multiple lists, so subscribers can leave just one list rather than all lists if they want. 
</p>
<h3>[DOMAIN]
</h3>
<p>Prints your domain, e.g. yourdomain.com as listed in your configuration settings.
</p>
<h3>[EMAIL]
</h3>
<p>Prints the subscribers email address;
</p>
<h2>Some older placeholders
</h2>
<p>These are some older placeholders which still work, but are not recommended for use: 
</p>
<h3>[FORWARD]
</h3>
<p>[FORWARD] is a link where the recipient can go to “forward this message”. The default text for this placeholder is <strong>this link.</strong>
</p>
<p>For example, if you use "If you want to forward this message to a friend click [FORWARD]", it will come out as:
<br/></p>
<p><img src="/phplist/_edit/static/forward.png" alt=""/></p>
<p><strong>[UNSUBSCRIBE]</strong>
</p>
<p> Like Forward the link that subscribers can use to unsubscribe. It will also be replaced with "This Link", which means you can use it like this:
</p>
<p align="center">To unsubscribe from our newsletter click [UNSUBSCRIBE]
</p>
<p><strong>[PREFERENCES]</strong>
</p>
<p> Like Forward and Unsubscribe the link that subscribers can use to update their personal details and preferences. It will also be replaced with "This Link", which means you can use it like this:
</p>
<p align="center">To change your preferences click [PREFERENCES]
</p>
<h2>Feedback
</h2>
<p>Discuss this chapter <a href="https://discuss.phplist.org/t/advanced-templating-manual-chapter-feedback-and-discussion/221">here</a>.
<br/></p></body></html>