Email Tokens

Intro

To manage GES emails in BP 2.5, navigate to the "Emails" page in the WordPress admin dashboard and do a search for "ges". You should see four emails created by GES that looks like this:

If not, deactivate GES and reactivate it and the emails should be generated.

Tokens

BuddyPress 2.5 introduced native emails, which includes a Tokens system.

For GES 3.7.0, we are adding support for BuddyPress 2.5 and with that, some custom tokens of our own:

Activity sendouts

• {{ges.action}} - The activity action used by GES. Includes HTML. eg. [Ray] started the topic [Awesome] in the forum [Awesome].
• {{ges.subject}} - The subject line used by GES. This is basically the same as {{ges.action}}, but without HTML tags.
• {{ges.email-setting-description}} - Descriptive text for the user's current group description. eg. Your email setting for this group is: All Email.
• {{ges.email-setting-links}} - Group setting and unsubscribe links with descriptive text. Used in plain-text emails. eg. To change your email setting for this group, please log in and go to: LINK.
• {{usermessage}} - The content being posted.
• {{thread.url}} - Link to the item being posted.

These are used in the email footer:

• {{ges.settings-link}} - Link to change the group email settings for the recipient.
• {{ges.unsubscribe}} - Group unsubscribe link for the recipient.
• {{ges.unsubscribe-global}} - Global unsubscribe link for the recipient. Will unsubscribe the user from all groups. Only takes effect if the Global Unsubscribe link option is enabled on the WP admin dashboard's Group Email Options page.

The following tokens are un-used in the default email content:

• {{poster.url}} - Link to the poster's profile page.
• {{poster.name}} - Display name of the poster.
• {{recipient.id}} - The recipient's user ID.
• {{group.id}} - The group ID.

---

Digest sendouts

• {{ges.digest-summary}} - For daily digests, shows a list of groups that has activity listed in the email for the recipient. Weekly digest emails do not display anything.
• {{ges.subject}} - The subject line used by GES.
• {{ges.settings-link}} - Link to change the group email settings for the recipient.
• {{usermessage}} - The content being posted.

These are used in the email footer:

• {{ges.settings-link}} - Link to change the group email settings for the recipient.
• {{ges.unsubscribe}} - Group unsubscribe link for the recipient.
• {{ges.unsubscribe-global}} - Global unsubscribe link for the recipient. Will unsubscribe the user from all groups. Only takes effect if the Global Unsubscribe link option is enabled on the WP admin dashboard's Group Email Options page.

The following tokens are un-used in the default email content:

• {{ges.subscription_type}} - Either dig for daily digests or sum for weekly digests.
• {{recipient.id}} - The recipient's user ID.
• {{poster.url}} - Link to the poster's profile page.
• {{poster.name}} - Display name of the poster.

---

Welcome email sendouts

(This email is sent when a group administrator sends a welcome email from example.com/groups/MY-GROUP/admin/notifications)

• {{group.name}} - Group name.
• {{group.url}} - Group URL.
• {{group.link}} - HTML link to group with anchor text of the group name.
• {{ges.subject}} - The subject line used by GES.
• {{usermessage}} - The content being posted.

The following tokens are un-used in the default email content:

• {{group.id}} - The group ID.

---

Notice sendouts

(This email is sent when a group administrator sends a group notice from example.com/groups/MY-GROUP/admin/notifications)

• {{group.name}} - Group name.
• {{group.url}} - Group URL.
• {{group.link}} - HTML link to group with anchor text of the group name.
• {{ges.subject}} - The subject line used by GES.
• {{usermessage}} - The content being posted.

These are used in the email footer:

• {{ges.settings-link}} - Link to change the group email settings for the recipient.
• {{ges.unsubscribe}} - Group unsubscribe link for the recipient.
• {{ges.unsubscribe-global}} - Global unsubscribe link for the recipient. Will unsubscribe the user from all groups. Only takes effect if the Global Unsubscribe link option is enabled on the WP admin dashboard's Group Email Options page.

The following tokens are un-used in the default email content:

• {{recipient.id}} - The recipient's user ID.
• {{group.id}} - The group ID.