Skip to content

Email Template

John Henley edited this page Oct 2, 2024 · 6 revisions

Tokens in Subject Line and Body

The subject line and body can be tailored using a template and token substitutions. A subscriber can either be a "forum subscriber" (if subscribed to a particular forum but not to a given topic) or a "topic subscriber" (if subscribed to a given topic).

Email Tokens

(Here are new tokens added in 07.00.05 and 07.00.07 to craft more meaningful subject lines)

[NEWPOST] inserts text "new post" if not a reply

[NEWREPLY] inserts text "new reply" if a reply

[POSTEDTO] inserts text "posted to" if not a reply

[REPLIEDTO] inserts text "replied to" if a reply

[POSTEDORREPLIEDTO] will insert "replied to" if a reply or "posted" if not a reply

[SUBSCRIBEDTOPIC] "Subscribed Topic"

[SUBSCRIBEDTOPICSUBJECT] "Subscribed Topic {subject}"

[SUBSCRIBEDTOPICFORUMNAME] "Subscribed Topic {subject} on Forum {forumname}"

[SUBSCRIBEDFORUM] "Subscribed Forum"

[SUBSCRIBEDFORUMNAME] "Subscribed Forum {forumname}"

[SUBSCRIBEDFORUMORTOPICSUBJECTFORUMNAME] "Topic {subject} on Subscribed Forum {forumname}" (if a forum subscriber) or "Subscribed Topic {subject} on Forum {forumname}" (if a topic subscriber)

Default Email subject for new installations:

[DISPLAYNAME] [POSTEDORREPLIEDTO] [SUBSCRIBEDFORUMORTOPICSUBJECTFORUMNAME] on [PORTALNAME]

Sample subject lines

  1. A [NEWPOST][NEWREPLY] has been added to [FORUMNAME] results in: A new post has been added to Sample Forum 2

  2. A [NEWPOST][NEWREPLY] has been added to [SUBSCRIBEDTOPICFORUMNAME][SUBSCRIBEDFORUMNAME] on [PORTALNAME] results in:

a. A new reply has been added to Subscribed Forum Sample Forum 2 on My Website [for a forum subscriber]

b. A new reply to Subscribed Topic RE: I need help on Forum Questions and Answers on My Website [for a topic subscriber]

  1. [DISPLAYNAME] [POSTEDTO][REPLIEDTO] [SUBSCRIBEDTOPICFORUMNAME][SUBSCRIBEDFORUMNAME] on [PORTALNAME] results in:

a. John User posted to Forum Questions and Answers on My Website[for a forum subscriber]

b. John User replied to Subscribed Topic RE: I need help on Forum Questions and Answers on My Website[for a topic subscriber]

  1. [DISPLAYNAME] [POSTEDORREPLIEDTO] [SUBSCRIBEDFORUMORTOPICSUBJECTFORUMNAME] on [PORTALNAME] results in:

a. John User posted I need help on Subscribed Forum Questions and Answers on My Website[a new post for a forum subscriber]

b. John User replied to Subscribed Topic RE: I need help on Forum Questions and Answers on My Website[for a topic subscriber]

Email Tokens

Token Description Applies To
[BODY] Inserts the body of a post. SubscribedEmail
[COMMENTS] For moderation emails, the reason for the not approving the post. SubscribedEmail
[DISPLAYNAME] The display name of the users. ForumView, SubscribedEmail
[FIRSTNAME] The first name of the users. SubscribedEmail
[FORUMLINK] The hyperlink to the forum. For a text URL, use [FORUMURL]] TopicView, TopicsView, SubscribedEmail
[FORUMNAME] The name of the forum. ForumView, TopicView, TopicsView, SubscribedEmail
[FORUMURL] The link to the forum as text. For a hyperlink to the forum, use [FORUMLINK]]. SubscribedEmail
[FULLNAME] The full name of the users. SubscribedEmail
[GROUPNAME] The name of a forum group. ForumView, TopicView, TopicsView, SubscribedEmail
[HYPERLINK] A hyperlink to the topic. Same as [LINK]] SubscribedEmail
[LASTNAME] The last name of the users. SubscribedEmail
[LINK] A hyperlink to the topic. Same as [HYPERLINK]]. For URL as text, use [LINKURL]] SubscribedEmail
[LINKURL] The URL for the topic as text. For hyperlink, use [LINK]] SubscribedEmail
[NEWPOST] If a new posting (not a reply), inserts 'a new post'. For replies, use [NEWREPLY]]. For either, use [NEWPOST]][NEWREPLY]] and the correct one will be substituted. SubscribedEmail
[NEWREPLY] If a reply, inserts 'a new reply'. For new posts, use [NEWPOST]]. For either, use [NEWPOST]][NEWREPLY]] and the correct one will be substituted. (New in 07.00.05) SubscribedEmail
[POSTDATE] The date of the post. TopicView, SubscribedEmail
[POSTEDTO] If a new posting (not a reply), inserts 'posted to'. For replies, use [REPLIEDTO]]. For either, use [POSTEDTO]][REPLIEDTO]] and the correct one will be substituted. (New in 07.00.05) SubscribedEmail
[POSTEDORREPLIEDTO] If a new posting (not a reply), inserts 'posted'; for a reply, inserts 'replied to'. (New in 07.00.07) SubscribedEmail
[REPLIEDTO] If a reply, inserts 'replied to'. For new posts, use [POSTEDTO]]. For either, use [POSTEDTO]][REPLIEDTO]] and the correct one will be substituted. (New in 07.00.05) SubscribedEmail
[SUBSCRIBEDFORUM] Inserts the words 'Subscribed Forum'. (New in 07.00.05) SubscribedEmail
[SUBSCRIBEDFORUMNAME] Inserts 'Subscribed Forum {forumname}'. (New in 07.00.05) SubscribedEmail
[SUBSCRIBEDFORUMORTOPICSUBJECTFORUMNAME]] "Topic {subject} on Subscribed Forum {forumname}" (if a forum subscriber) or "Subscribed Topic {subject} on Forum {forumname}" (if a topic subscriber). (New in 07.00.07) SubscribedEmail
[SUBSCRIBEDTOPIC] Inserts the words 'Subscribed Topic'. (New in 07.00.05) SubscribedEmail
[SUBSCRIBEDTOPICSUBJECT] Inserts 'Subscribed Topic {subject}'. (New in 07.00.05) SubscribedEmail
[SUBSCRIBEDTOPICFORUMNAME] Inserts 'Subscribed Topic {subject} on Forum {forumname}'. (New in 07.00.05) SubscribedEmail
[SUBJECT] The subject of the topic. TopicView, TopicsView, SubscribedEmail
[USERID] The user’s id number. ForumView, TopicView, SubscribedEmail
[USERNAME] The username. TopicView, SubscribedEmail
Clone this wiki locally