Create email templates

More
05 May 2011 15:28 #1110 by pete
Create email templates was created by pete
You can create joomlamailer email templates according to the MailChimp instructions. Or you can download one of the templates from within the component and adjust it to your needs. joomlamailer has its own template tags just like MailChimp does, in order to be able to insert contents and other things defined in the component itself.

<#subject#> - This tag will be replaced with the email subject.
<#intro_content#> - This tag will be replaced with the Intro text entered in the WYSIWYG editor.
<#title#> - This tag will be replaced with the title of the selected articles.
<#content#> - This tag will be replaced with the content of the selected articles.
To allow the selection of more than one article you must use the repeater:
<#repeater#>...<#/repeater#> - Everything between these two tags will be repeated for each selected article. Example of usage:
Code:
<#repeater#> <table cellspacing="0" cellpadding="0" width="100%"> <tr> <td><h3><#title#></h3></td> </tr> <tr> <td><#content#></td> </tr> </table> <#/repeater#>

<#tableofcontents#> - This tag allows to create a list of the included articles as links to your website. Example of usage:
Code:
<#tableofcontents#> <h3>In this issue</h3> <ul> <#title_repeater#> <li><#article_title#></li> <#/title_repeater#> </ul> <#/tableofcontents#>

<#populararticles#> - This tag allows to create a list of the 5 most read articles on your website based on hits. Example of usage:
Code:
<#populararticles#> <h3>Popular Articles</h3> <ul> <#popular_repeater#> <li><#popular_title#></li> <#/popular_repeater#> </ul> <#/populararticles#>

<#vm_products#> - This allows to display VirtueMart products with an optional thumbnail image and information like name and price. Each product can be linked to the details page on your website. Example of usage:
Code:
<#vm_products#> <h3>Top Products</h3> <table> <#vm_repeater#> <tr> <td align="center"> <p> <#vm_content#> </p> </td> </tr> <#/vm_repeater#> </table> <#/vm_products#>

<#twitter#> - This tag allows you to include a link to Twitter.com. Example of usage:
Code:
<#twitter#> <a href='http://twitter.com/<#twitter-name#>'><img src="/twitter.png" /></a> <#/twitter#>

<#facebook#> - This tag allows you to include a link to Facebook. This must be a complete URL which starts with: http:// Example of usage:
Code:
<#facebook#> <a href='<#facebook-url#>'><img src="/facebook.png" /></a> <#/facebook#>

<#myspace#> - This tag allows you to include a link to MySpace. Example of usage:
Code:
<#myspace#> <a href='http://www.myspace.com/<#myspace-name#>'><img src="/myspace.png" /></a> <#/myspace#>

<#jomsocialprofiles#> - This tag allows you to include Links to the JomSocial profiles of your users. Example of usage:
Code:
<#jomsocialprofiles#> <h3>Featured Members</h3> <table width="100%"> <#jomsocialprofilesrepeater#> <tr> <td width="50"><#jsAvatar#></td> <td><#jsName#></td> <td><#jsfieldsrepeater#><#jsFieldTitle#>: <#jsFieldValue#> <#/jsfieldsrepeater#></td> </tr> <#/jomsocialprofilesrepeater#> </table> <#/jomsocialprofiles#>
o <#jsAvatar#> - This will be replaced with the user's avatar linking to his profile.
o <#jsName#> - This will be replaced with the user's name linking to his profile.
o <#jsFieldTitle#> - If you select additional fields, this will be replaced with the field's title.
o <#jsFieldValue#> - If you select additional fields, this will be replaced with the field's value.

<#jomsocialdiscussions#> - This tag allows you to include JomSocial discussions. Example of usage:
Code:
<#jomsocialdiscussions#> <h3>Discussions</h3> <table width="100%"> <#jomsocialdiscussionsrepeater#> <tr> <td><#jsDiscussionContent#></td> </tr> <#/jomsocialdiscussionsrepeater# </table> <#/jomsocialdiscussions#>

<#aec#> - This tag allows you to include AEC subscriptions. Example of usage:
Code:
<#aec#> <h3>Subscription Plans</h3> <table width="100%"> <#aecrepeater#> <tr> <td><#aeccontent#></td> </tr> <#/aecrepeater#> </table> <#/aec#>

<#ambra#> - This tag allows you to include Ambra subscriptions. Example of usage:
Code:
<#ambra#> <h3>Subscription Plans</h3> <table width="100%"> <#ambraRepeater#> <tr> <td><#ambraContent#></td> </tr> <#/ambraRepeater#> </table> <#/ambra#>


Merge tags

All Merge tags can be used without any changes but keep the following in mind:

*|ARCHIVE|* - This phrase will be replaced with the URL to a web version of the campaign.
Example of usage: Having trouble reading this email? <a href='*|ARCHIVE|*'>View it on your browser</a>
*|UNSUB|* - This phrase will be replaced with the URL to unsubscribe from the list.
Example of usage: Not interested anymore? <a href='*|UNSUB|*'>Unsubscribe Instantly</a>
*|FORWARD|* - This phrase will be replaced with the URL to a forward-to-a-friend form.
Example of usage: <a href='*|FORWARD|*'>Forward this email to a friend</a>
*|UPDATE_PROFILE|* - This phrase will be replaced with a URL to the preferences center where subscribers can update their details and manage their subscriptions.
Example of usage: <a href='*|UPDATE_PROFILE|*'>Edit your email preferences</a>
*|FACEBOOK:LIKE|* - Adds a Facebook "Like" button to your campaign. Learn more about Facebook "Like"


Editor tags cannot be used because the MailChimp editor is not available within joomlamailer!


Template package

The template package must obey the following structure:
* packed in zip format
* contain a template.html file. (This is the actual template.)
* contain a screenshot.jpg file. (Allowed: jpg, bmp, png, gif)
* contain all used image files and no sub-folders
* a css file can be included and referenced in the template.html file but it is recommended to put all css directly into the template.html file (preferably inline) for compatibility reasons with all the different email clients

template.html

This file must contain the template structure as HTML code. It must also include the following tags to be able to insert content via the joomlamailer interface: <#intro_content#> , <#title#> , <#content#> . The <#repeater#>...<#/repeater#> tag is mandatory to allow the selection of more than one article.

We recommend that you use one of our free templates as a reference or starting point when developing your custom template. The templates are included in the joomlamailer component. You can download them from within the component.
The topic has been locked.