Main Page
Features

Download
Buy Now
Setup Help

Ability Mail Server
Help, configuration and tips.


Tutorial: Editing WebMail Templates
The advice offered on this page should only be used by users who are confident in the modification of HTML pages. If you are unsure about this process, we recommend that you first learn a basic knowledge of HTML before you continue to make any modifications. For more detailed information on what each option of the WebMail settings is for, please view the WebMail Settings page.

 

What are WebMail Templates and How Do They Work?
The WebMail service is basically an integrated web server which has its own built in script system. The pages displayed by the WebMail service are simply HTML files and normal GIF graphics. These HTML files are generated from template HTML and text files which contain tags to indicate where certain information should be inserted (e.g. ####USERACCOUNT#### gets replaced with the User/Login name). When a user accesses a particular page, the relevant template files are loaded, processed and then sent to the user as a single HTML file.
Ability Mail Server comes installed with a free template called ‘Original’. This template is intended to form the base of any customization you may wish to create.


Non-Enhanced Templates (Versions Prior to 2.50)
The WebMail service has support for 2 types of template, the older templates and the newer enhanced templates, which became available in version 2.50. If you have only ever installed version 2.50 or later, then by default enhanced templates are enabled. If you started using Ability Mail Server before the release of version 2.50 and haven't enabled enhanced templates yet, you will still be using the non-enhanced type. For information on editing non-enhanced templates, please view the Tutorial: Editing WebMail Non-Enhanced Templates. For information on how to enable enhanced templates, please view this FAQ answer.


Before Making Changes
It is important that before making any changes, you create a copy of the original template folder. This folder should be appropriately named, such as 'My Company WebMail'. This is important as installing future software updates may result in the original template being updated. This means that without correctly creating a copy of the original template folder, you may lose your changes when you next install an update.


Quick Changes
The template system is designed so that certain common modifications are easy to achieve, these are listed below.

Removing Code-Crafters Branding
The simplest modification to the template is to remove all 'Code-Crafters' branding and replace them with your own company name. To achieve this you need to modify two files. Using your favorite GIF editor, open the file 'maintitle.gif' in the 'images' folder, edit as required and then simply re-save. Then using notepad or wordpad, open the file 'part_all_pagebottom.txt' in the main folder, replace the string 'www.code-crafters.com' to a more appropriate web address then re-save. The result is that the login page will display your graphic and all pages will now contain your web address.

Changing the Color Scheme
If you want to make WebMail better match your company color scheme, this can achieved by editing a single file. Using notepad or wordpad, open the file 'part_all_colors.txt' in the main folder, adjust the HTML color values and then simply re-save. The effect can dramatically alter WebMail's look and feel and instantly blend better with your main website.


Partial or Complete Customizations
To perform a partial or complete customization of WebMail, it helps to fully understand the syntax of the template language. The next 2 sections will describe the available tags and also the file structure of the 'original' template.

Template Language
The template language consists of 6 types of tag. Any tag must always appear between '<!--' and '-->' or '####' and '####' markers (e.g. <!--SUBJECT--> or ####SUBJECT####), otherwise it will be ignored and treated as a non-tag component. The following list describes the 6 types of tag...

  • Insertion - Eg. ####USERACCOUNT#### - This is the most common type of tag and is a simple insertion point marker. Every page in WebMail has a selection of insertion tags available. When a user requests a particular page, those tags get replaced with the relevant information.
  • INCLUDE - Eg. ####INCLUDE:part_all_fontscustom.txt#### - This tag is almost identical to the common server side 'includes', available in other scripting languages. The format is ####INCLUDE:FILENAME####. The file that is included is also processed and so can also contain tag code if required. The 'original' template makes great use of this feature by encapsulating common HTML code into separate files, such as the folder list.
  • INSERT - Eg. ####INSERT:<p>Search Mode</p>#### - This tag allows insertion of text or HTML code into the HTML file and the format is ####INSERT:TEXTORHTML####. This tag is most commonly used with the IF tag, which effectively allows dynamic content to be achieved. If you need to insert some tag code, then replace the #### with @@@@ (eg. ####INSERT:@@@@USERACCOUNT@@@@####).
  • SET - Eg. ####SET:COLOR_TEXT:INSERT:#000000#### - This tag allows you to define your own insertion tags and the format is ####SET:TAGNAME:TAGCODE####. In the example, after the tag has been processed, any occurrence of COLOR_TEXT will result in INSERT:#000000 being processed, which in the end result will mean #000000 will be inserted into the final HTML file.
  • CACHE - Eg. ####CACHE:part_all_pagetop.txt#### - This tag is available purely for efficiency gains and the format is ####CACHE:FILENAME####. If the INCLUDE tag is used more than once in a single template file, then some where at the start of the file, you can request that the file be cached for faster processing.
  • IF and IFNOT - Eg. ####IF:IS_SESSION:INCLUDE:part_all_pagetop.txt#### - This tag allows the HTML pages to contain dynamic content and allows pages to adapt based on a set of conditions. The format for this tag is ####IF/IFNOT:CONDITIONNAME:TAGCODE####. Each page has its own unique selection of conditions. The tag code is often either an INSERT or INCLUDE type tag. If the tag IF is used, then only a condition which is true causes the tag code to be processed. The IFNOT tag works in opposite and requires the condition to be false.

'Original' Template File Structure and Rules
It is important to understand that the 'original' template is designed for editing, but some things need to be adhered to, such as filenames and structure. The following list describes important rules you should remember while making changes...

  • Currently all existing HTML files and most text files cannot be renamed or removed as the filenames and assumed existence is a permanent part of WebMail. For this reason we recommend you do not rename or delete any of the existing files.
  • Adding new files to the template is fine, accessing any new HTML files can be achieved with the two types of URL; http://yourdomain:8000/_htmlfilename (non-session type access) or http://yourdomain:8000/_htmlfilename?id=sessionid (session type access). It is important not to include the .html part of the filename in the URL. The session ID is available with the tag ####ID####.
  • Complicated pages such as the _folder.html or _readmail.html are generally composed of several smaller text files too. The smaller text files usually contain HTML source code, such as a row in a table.
  • There are two types of pages; session and non-session. Non-session pages include the login page, logged out page, sign-up page...etc. Session pages include any page associated with a logged in user.
  • The _signup.html page has built in extra tag code to handle when certain fields are required. When adding new fields, It is important to follow the semantics of pre-existing fields on the sign-up page. This will ensure correct and consistent behavior.


Files, Tags and Conditions
The 'original' template makes use of almost all available tags and conditions, and so provides a useful base on which to start any modification. The table below describes the purpose of each file, the available conditions and tags. Any file which appears in the 'original' template but is not listed below is a non-permanent file, which means that the file is probably only used for INCLUDE purposes by another page.

Files and Purpose
Type
Insertion Tags
IF / IFNOT Conditions
All Files
Both session and non-session pages have access to these tags and conditions.
Both
ADMINADDRESS - The admin email address provided in General settings.
ERRORMSG - The text contained in the URL query parameter 'errormsg' (eg. http://yourdomain.com/_index?errormsg=Failed).
ERRORMSGRETURNLINK - A return link back to the calling page.
HTTPREQ_HOST
- The host field used in the HTTP request. If a port is provided with the host field, this is removed before insertion.
HTTPREQ_URL - The URL used to access the page.
ISSET_ADMINADDRESS - True when an admin email address is set in the General settings.
ISSET_AUTOSIGNUPS - True when automatic sign-ups are enabled.
IS_SESSION - True when the current request is a session type request.
IS_CONNECTIONSECURE - True when the current HTTP connection is secure (ie. SSL is in use).
ISSET_LOGINONLYWITHEMAILADDRESS - True when users need to login with the full email address.
ISSET_ERRORMSGRETURNLINK - True when there is a return link available.
IS_HTTPREQ_HOST_HOSTNAME - True when the HTTPREQ_HOST tag matches the provided host name (Eg. IN_DOMAIN_www.yourdomain.com).
All Session Files
part_all_folderlist_entry.txt
Any session page has access to these tags and conditions.
Session
ID - The current session ID.
WELCOMELINK - A link to the welcome page.
COMPOSELINK - A link to the compose page.
COMPOSEADMINADDRESSLINK - A link to the compose page, with the admin email address pre-inserted into the to line.
LOGOUTLINK - A link to logout the session.
INBOXFOLDERLINK - A link to the Inbox folder page.
SENTFOLDERLINK - A link to the sent folder page.
DRAFTSFOLDERLINK - A link to the drafts folder page.
DELETEDFOLDERLINK - A link to the deleted folder page.
ADDRESSBOOKLINK - A link to the address book page.
FILESTORELINK - A link to the file store page.
EDITFOLDERSLINK - A link to the edit folders page.
OPTIONSLINK - A link to the options page.
EDITPERSONALDATALINK - A link to the personal data page.
EDITAUTORESPONSELINK - A link to the auto-response page.
EDITSIGNATURESLINK - A link to the signatures page.
CHANGEPASSWORDLINK - A link to the change password page.
EDITFILTERSLINK - A link to the filters page.
ACCOUNTOPTIONSLINK - A link to the account options page.
EDITPOP3RETRSLINK - A link to the POP3 retrievals page.
DOMAINADMINLINK - A link to the domain administrator page.
TRIGGERPOP3RETRLINK - A link to manually trigger POP3 retrievals.
USERADDRESS - The current users email address.
USERACCOUNT - The current users user / login name.
USERDISPLAYNAME - A valid display name, which is most commonly the given name of the user.
MAXMAILSIZEKB - The maximum mail size in KBs.
MAXMAILSIZEMB - The maximum mail size in MBs.
MAXACCOUNTSIZEKB - The maximum account size in KBs.
MAXACCOUNTSIZEMB - The maximum account size in MBs.
ACCOUNTSIZEKB - The current size of the account in KBs.
ACCOUNTSIZEMB - The current size of the account in MBs.
ACCOUNTSIZEPERCENT - The current % of account space in use.
UNREADMAILCOUNT - The total number of unread mails in the account.
COMPOSECHARSET - The currently selected charset in the account options.
FOLDEROPTIONLIST - An HTML option list of all folders in the account.
SET_SHOWSELECTEDFOLDER - Nothing is inserted into the page, but signals that the current page should show the currently selected folder in the folder list.
FOLDERLIST - A list of the available account folders.
FOLDERENTRY_TAB - In use only during folder list insertion. Inserts a number of &nbsp; HTML elements depending on the depth of the sub folder.
FOLDERENTRY_LINK - In use only during folder list insertion. Inserts a link to the folder.
FOLDERENTRY_NAME - In use only during folder list insertion. Inserts the name of the folder.
FOLDERENTRY_UNREADMAILCOUNT - In use only during folder list insertion. Inserts the number of unread mail in the folder.
KBLEFT_HIGH - True when the account has plenty of space remaining.
KBLEFT_LOW - True when the account is almost full.
KBLEFT_NONE - True when the account is full.
IN_GROUP_GROUPNAME - True when the account is part of the provided group name (Eg. IN_GROUP_<Default>).
IN_DOMAIN_DOMAINNAME - True when the account is part of the provided domain name (Eg. IN_DOMAIN_yourdomain.com).
HAS_SENTFOLDERSET - True when the account has a sent folder set.
HAS_DRAFTSFOLDERSET - True when the account has a drafts folder set.
HAS_DELETEDFOLDERSET - True when the account has a deleted folder set.
IS_PAGEAREA_AREANAME - True when the current page is in the area name. Available area names are UNKNOWN, WELCOME, COMPOSE, FOLDER, FOLDER_INBOX, FOLDER_SENT, FOLDER_DRAFTS, FOLDER_DELETED, ADDRESSBOOK, FILESTORE and OPTIONS.
IS_GROUPACCESS_ALLOWEDSENDTOEXTERNAL - True when the account is allowed to compose and send mail to external addresses.
IS_GROUPACCESS_EDITADDRESSBOOKS - True when the account is allowed to edit the address book.
IS_GROUPACCESS_EDITFILESTORE - True when the account is allowed to edit the file store.
IS_GROUPACCESS_EDITPOP3RETRS - True when the account is allowed to edit the POP3 retrievals.
IS_GROUPACCESS_EDITAUTORESPONSE - True when the account is allowed to edit the auto-response.
IS_GROUPACCESS_EDITFILTERS - True when the account is allowed to edit the filters.
IS_GROUPACCESS_EDITPASSWORD - True when the account is allowed to change the password.
IS_GROUPACCESS_EDITFROMHEADER - True when the account is allowed to edit the from header when composing mails.
IS_GROUPACCESS_EDITREDIRECTION - True when the account is allowed to edit the redirection settings.
IS_DOMAINADMIN - True when the account is a domain administrator.
IS_ENABLED_HTMLCOMPOSING - True when the WebMail settings permit HTML composing.
IS_ENABLED_JUNKFOLDER - True when the WebMail settings have enabled the junk button.
FOLDERENTRY_IS_SELECTED - In use only during folder list insertion. True when the current folder is the selected folder and show currently selected folder is set.
FOLDERENTRY_HAS_UNREADMAIL - In use only during folder list insertion. True when the current folder has some unread mail.
FOLDERENTRY_HAS_CHILDREN - In use only during folder list insertion. True when the current folder has sub folders.
_accountoptions.html
Allows users to view and edit their account options.
Session
POSTLINK - A link to process the HTML form.
STARTPAGEOPTIONLIST - An HTML option list of start pages.
FORWARDMODEOPTIONLIST - An HTML option list of forward modes.
CHARSETOPTIONLIST - An HTML option list of charset modes.
SENDREADRECEIPTMODEOPTIONLIST - An HTML option list of send receipt modes.
USEREPLYTO - If enabled, the text "checked".
REPLYTO - The reply-to email address.
USECOMPOSEHTML - If enabled, the text "checked".
USEREQUESTREADRECEIPT - If enabled, the text "checked".
USESENTDIR - If enabled, the text "checked".
SENTDIROPTIONLIST - An HTML option list of all folders in the account.
USEDELETEDDIR - If enabled, the text "checked".
DELETEDDIROPTIONLIST - An HTML option list of all folders in the account.
USEAUTODELETE - If enabled, the text "checked".
AUTODELETE - The auto delete number.
USEDRAFTSDIR - If enabled, the text "checked".
DRAFTSDIROPTIONLIST - An HTML option list of all folders in the account.
USEPASSRESETTING - If enabled, the text "checked".
PASSRESETQUESTION - The password reset question.
PASSRESETANSWER - The password reset answer.
USEREDIRECTADDRESS - If enabled, the text "checked".
REDIRECTADDRESS - The redirection email addresses. If multiple are present, they are separated with ';' characters.
USESTILLDELIVER - If enabled, the text "checked".
 
_addressbook.html
part_addressbook_entryentry.txt
part_addressbook_groupentry.txt
Allows users to view and edit their address book.
Session
POSTLINK - A link to process the HTML form.
ENTRYCOUNT - The number of entries.
GROUPCOUNT - The number of groups.
ENTRYLIST - A list of the entries.
ENTRYLISTENTRY_INDEX - In use only during entry list insertion. Inserts the entry listing index number.
ENTRYLISTENTRY_LINK - In use only during entry list insertion. Inserts a link to the entry's page.
ENTRYLISTENTRY_COMMONNAME - In use only during entry list insertion. Inserts the entry's common name.
ENTRYLISTENTRY_FULLNAME - In use only during entry list insertion. Inserts the entry's full name (given name and surname).
ENTRYLISTENTRY_EMAILADDRESS - In use only during entry list insertion. Inserts the entry's email address.
ENTRYLISTENTRY_GIVENNAME - In use only during entry list insertion. Inserts the entry's given name.
ENTRYLISTENTRY_SURNAME - In use only during entry list insertion. Inserts the entry's surname.
ENTRYLISTENTRY_ORGANIZATION - In use only during entry list insertion. Inserts the entry's organization (company).
ENTRYLISTENTRY_ORGANIZATIONALUNIT - In use only during entry list insertion. Inserts the entry's organizational unit (department).
ENTRYLISTENTRY_STREET - In use only during entry list insertion. Inserts the entry's street.
ENTRYLISTENTRY_LOCALITY - In use only during entry list insertion. Inserts the entry's locality (city).
ENTRYLISTENTRY_STATE - In use only during entry list insertion. Inserts the entry's state.
ENTRYLISTENTRY_POSTALCODE - In use only during entry list insertion. Inserts the entry's postal code.
ENTRYLISTENTRY_COUNTRY - In use only during entry list insertion. Inserts the entry's country.
ENTRYLISTENTRY_TELEPHONENUMBER - In use only during entry list insertion. Inserts the entry's telephone number.
ENTRYLISTENTRY_DESCRIPTION - In use only during entry list insertion. Inserts the entry's description.
GROUPLIST - A list of the groups.
GROUPLISTENTRY_INDEX - In use only during group list insertion. Inserts the group listing index number.
GROUPLISTENTRY_LINK - In use only during group list insertion. Inserts a link to the group's page.
GROUPLISTENTRY_COMMONNAME - In use only during group list insertion. Inserts the group's description.
GROUPLISTENTRY_MEMBERS - In use only during group list insertion. Inserts a number representing the group's member count.
GROUPLISTENTRY_DESCRIPTION - In use only during group list insertion. Inserts the group's description.
IS_SELECTING - True when the address book is being used for a compose insertion into the to, cc or bcc fields.
HAS_ENTRIES - True when the address book contains some entries.
HAS_GROUPS - True when the address book contains some groups.
_addressbookexport.html
_addressbookimportfile.html
_addressbookimportmap.html
_addressbookimportmode.html
_addressbookimportoverwrite.html
_addressbookimportresult.html
Allows users to import and export address book entries.
Session

POSTLINK - A link to process the HTML form.
FORMATOPTIONLIST - An HTML option list of CSV formats.
COMMONNAMEOPTIONLIST - An HTML option list of the fields found in the CSV file.
EMAILADDRESSOPTIONLIST - An HTML option list of the fields found in the CSV file.
GIVENNAMEOPTIONLIST - An HTML option list of the fields found in the CSV file.
SURNAMEOPTIONLIST - An HTML option list of the fields found in the CSV file.
ORGANIZATIONOPTIONLIST - An HTML option list of the fields found in the CSV file.
ORGANIZATIONALUNITOPTIONLIST -
An HTML option list of the fields found in the CSV file.
STREETOPTIONLIST - An HTML option list of the fields found in the CSV file.
LOCALITYOPTIONLIST - An HTML option list of the fields found in the CSV file.
STATEOPTIONLIST - An HTML option list of the fields found in the CSV file.
POSTALCODEOPTIONLIST - An HTML option list of the fields found in the CSV file.
COUNTRYOPTIONLIST - An HTML option list of the fields found in the CSV file.
TELEPHONENUMBEROPTIONLIST - An HTML option list of the fields found in the CSV file.
DESCRIPTIONOPTIONLIST - An HTML option list of the fields found in the CSV file.
OKCOUNT - The number of imported CSV records.
FAILCOUNT - The number of failed CSV records during import.
TOTALCOUNT - The total number of CSV records processed during import.
RETURNTOADDRESSBOOKLINK - A link to the return the user back to the address book.
DOWNLOADEXPORTLINK - A link to download the address book in CSV format.

IS_SUCCESS - True when the import completed successfully.
_addressbookentry.html
Allows users to view, add or edit an address book entry.
Session
POSTLINK - A link to process the HTML form.
ORIGINALCOMMONNAME - If editing an existing entry, this inserts the original common name.
COMMONNAME - The common name.
GIVENNAME - The given name.
SURNAME - The surname.
EMAILADDRESS - The email address.
ORGANIZATION - The organization (company).
ORGANIZATIONALUNIT - The organizational unit (department).
STREET - The street.
LOCALITY - The locality (city).
STATE - The state.
POSTALCODE - The postal code.
COUNTRYOPTIONLIST - An HTML option list of countries.
TELEPHONENUMBER - The telephone number.
DESCRIPTION - The description.
IS_NEW - True when the user is editing a new entry.
_addressbookgroup.html
part_addressbookgroup_entryentry.txt
Allows users to view, add or edit an address book group.
Session
POSTLINK - A link to process the HTML form.
ENTRYCOUNT
- The number of entries in the address book.
ORIGINALCOMMONNAME - If editing an existing group, this inserts the original common name.
COMMONNAME - The common name.
DESCRIPTION - The description.
ENTRYLIST - A list of the address book entries, selecting the appropriate members.
ENTRYLISTENTRY_INDEX - In use only during entry list insertion. Inserts the entry listing index number.
ENTRYLISTENTRY_COMMONNAME - In use only during entry list insertion. Inserts the entry's common name.
ENTRYLISTENTRY_CHECKED - In use only during entry list insertion. If the entry is a member, inserts the text "checked".
ENTRYLISTENTRY_EMAILADDRESS - In use only during entry list insertion. Inserts the entry's email address.
IS_NEW - True when the user is editing a new group.
HAS_ENTRIES - True when the address book contains some entries.
_autoresponse.html
Allows users to view or edit their auto-response.
Session
POSTLINK - A link to process the HTML form.
USEAUTORESPONSE
- If enabled, the text "checked".
USEREPLYTO - If enabled, the text "checked".
REPLYTO - The reply-to email address.
SUBJECT - The subject.
BODY - The body.
 
_badlogin.html
_badlogin_badsecuritycode.html
_badlogin_webmaildisallowed.html
_badsessionid.html
_loggedout.html
_resetpassword1.html
_resetpasswordok.html
_signupwelcome.html
_termsofuse.html
_toomanyfailures.html
_toomanylogins.html
General pages displayed to a user during non-session access.
Non-Session
   
_changepassword.html
Allows users to change their password.
Session
POSTLINK - A link to process the HTML form.  
_changepasswordok.html
_pop3retrstriggeredok.html
_options.html
_readmailblockedok.html
_welcome.html
General pages displayed to a user during session access.
Session
   
_compose.html
part_compose_attachmententry.txt
Allows users to compose, send and save new mail.
Session
POSTLINK - A link to process the HTML form.
ALIASOPTIONLIST
- An HTML option list of available aliases for the account.
FROM - The from address.
TO - The to addresses.
CC - The cc addresses.
BCC - The bcc addresses.
SUBJECT - The subject.
ATTACHMENTS - A list of the attachments.
ATTACHMENTENTRY_NAME - In use only during attachment list insertion. Inserts the attachment name.
USECOPYTO - If enabled, the text "checked".
SENTFOLDEROPTIONLIST - An HTML option list of all folders in the account.
IMPORTANCEOPTIONLIST - An HTML option list of importance modes.
BODYHTML - The HTML formatted version of the body.
BODYTEXT - The text formatted version of the body.
IMAGEATTACHMENTOPTIONLIST - An HTML option list of image type attachments.
ATTACHEDIMAGELINKSTART - A partial link to the view an image attachment.
IS_HTMLMODE - True when the formatting mode is set to HTML.
IS_EDITINGDRAFT - True when the composed mail is editing a draft.
HAS_ATTACHMENTS - True when the composed mail has attachments.
HAS_IMAGEATTACHMENTS - True when the composed mail has image type attachments.
IS_BODYEMPTY - True when the body is empty.
ATTACHMENTENTRY_IS_FIRST - In use only during attachment list insertion. True when inserting the first attachment.
HAS_ALIASES - True when the account has any aliases.
_composeeditattachments.html
part_composeeditattachments_attachmententry.txt

Allows users to edit the attachments of a composed mail.
Session
POSTLINK - A link to process the HTML form.
ATTACHMENTLIST
- A list of the attachments.
ATTACHMENTLISTENTRY_NAME - In use only during attachment list insertion. Inserts the attachment name.
ATTACHMENTLISTENTRY_VIEWLINK - In use only during attachment list insertion. Inserts a link to download the attachment.
ATTACHMENTLISTENTRY_DELETELINK - In use only during attachment list insertion. Inserts a link to delete the attachment.
ATTACHMENTLISTENTRY_SIZEKB - In use only during attachment list insertion. Inserts the size of the attachment in KBs.
TOTALATTACHMENTSIZEKB - The total size of all attachments in KBs.
FILESTOREOPTIONLIST - An HTML option list of files available in the file store.
FILEUPLOADED - The name of the uploaded file.
HAS_ATTACHMENTS - True when the composed mail has any attachments.
DOES_FILESTORE_HAVEFILESAVAILABLE - True when the file store has any available files.
IS_FILEUPLOADED - True when a file has been uploaded.
_composesent.html
part_composesent_addressentry.txt
Displayed to the user when they successfully send a composed mail.
Session
SENTTOLIST - The sent to email address list.
SENTTOLISTENTRY_ADDRESS - In use only during address list insertion. Inserts the email address.
SENTTOLISTENTRY_ADDRESSBOOKLINK - In use only during address list insertion. Inserts a link to the address book entry of the email address.
SENTTOLISTENTRY_IS_INADDRESSBOOK - In use only during address list insertion. True when the email address exists in the accounts address book.
_customfilter.html
Allows users to view, add or edit a custom filter.
Session
POSTLINK - A link to process the HTML form.
ORIGINALNAME
- If editing an existing custom filter, this inserts the original name.
CONDITIONMODESUBJECT - If set, the text "checked".
SUBJECT - The subject trigger.
CONDITIONMODEFROM - If set, the text "checked".
FROM - The from address trigger.
ACTIONMODEDELETE - If set, the text "checked".
ACTIONMODETODIR - If set, the text "checked".
DIROPTIONLIST - An HTML option list of all folders in the account.
IS_NEW - True when the user is editing a new custom filter.
_domainadmin.html
Allows users to view, add, edit and delete user accounts for their domains.
Session
POSTLINK - A link to process the HTML form.
USEROPTIONLIST
- An HTML option list of all users on the domain.
DOMAIN_CURRENTUSERS - The number of users on the domain.
DOMAIN_MAXUSERS - The maximum number of users for the domain.
HAS_DOMAIN_MAXUSERS - True when there is a maximum number of users for the domain. Always false when there is more than one administrable domain.
_domainadminuser.html
Allows users to view, add or edit a user account.
Session
POSTLINK - A link to process the HTML form.
ORIGINALNAME
- If editing an existing user, this inserts the original user.
USEENABLED - If enabled, the text "checked".
DOMAINOPTIONLIST - An HTML option list of all administrable domains.
USER - The user.
PASS - An appropriate password string.
CONFIRMPASS - An appropriate password string.
ALIASOPTIONLIST - An HTML option list of all aliases.
USEREDIRECTADDRESS - If enabled, the text "checked".
REDIRECTADDRESS - The redirection email addresses. If multiple are present, they are separated with ';' characters.
USESTILLDELIVER - If enabled, the text "checked".
IS_NEW - True when the user is editing a new user.
_editfolders.html
part_editfolders_folderentry.txt
Allows users to view, add, edit, rename, move and delete account folders.
Session
POSTLINK - A link to process the HTML form.
FOLDEREDITCOUNT
- The number of sub folders in the current folder.
CURRENTEDITFOLDER - The name of the current folder.
EDITFOLDERLIST - A list of the sub folders.
EDITFOLDERLISTENTRY_INDEX - In use only during folder list insertion. Inserts the folder listing index number.
EDITFOLDERLISTENTRY_LINK - In use only during folder list insertion. Inserts a link to set the folder as the current folder.
EDITFOLDERLISTENTRY_NAME - In use only during folder list insertion. Inserts the folder name.
EDITFOLDERLISTENTRY_PATH - In use only during folder list insertion. Inserts the folder path.
EDITFOLDERLISTENTRY_MAILS - In use only during folder list insertion. Inserts the folder mail count number.
EDITFOLDERLISTENTRY_SIZEKB - In use only during folder list insertion. Inserts the folder size in KBs.
EDITFOLDERLISTENTRY_VIEWLINK - In use only during folder list insertion. Inserts a link to the folder.
EDITFOLDERMOVEOPTIONLIST - An HTML option list of all folders in the account.
EDITFOLDERLISTENTRY_IS_PARENTLINK - In use only during folder list insertion. True when the current folder is actually the parent link.
CURRENTEDITFOLDER_HAS_CHILDREN - True when the current folder has any sub folders.
_error.html
_notfound.html
404notfound.html
General pages displayed to a user during either session or non-session access.
Both
   
_filestore.html
part_filestore_fileentry.txt
Allows users to view, download, add and delete files from the file store.
Session
POSTLINK - A link to process the HTML form.
TOTALFILESTORESIZEKB
- The total size of all files in file store in KBs.
FILELIST - A list of files.
FILELISTENTRY_NAME - In use only during file list insertion. Inserts the file name.
FILELISTENTRY_MODDATE - In use only during file list insertion. Inserts the file modified date.
FILELISTENTRY_VIEWLINK - In use only during file list insertion. Inserts a link to download the file.
FILELISTENTRY_DELETELINK - In use only during file list insertion. Inserts a link to delete the file.
FILELISTENTRY_SIZEKB - In use only during file list insertion. Inserts the file size in KBs.
FILEUPLOADED - The name of the uploaded file.
HAS_FILES - True when the file store has any files.
IS_FILEUPLOADED - True when a file has been uploaded.
_filters.html
Allows users to view and edit their filters settings.
Session
POSTLINK - A link to process the HTML form.
USESPAM
- If enabled, the text "checked".
SPAMMODEDELETE - If set, the text "checked".
SPAMMODETODIR - If set, the text "checked".
SPAMDIROPTIONLIST - An HTML option list of all folders in the account.
USEBLOCKLIST - If enabled, the text "checked".
BLOCKLISTOPTIONLIST - An HTML option list of all blocked email addresses.
BLOCKLISTMODEDELETE - If set, the text "checked".
BLOCKLISTMODETODIR - If set, the text "checked".
BLOCKLISTDIROPTIONLIST - An HTML option list of all folders in the account.
USEEXCLUSIVE - If enabled, the text "checked".
EXCLUSIVEMODEDELETE - If set, the text "checked".
EXCLUSIVEMODETODIR - If set, the text "checked".
EXCLUSIVEDIROPTIONLIST - An HTML option list of all folders in the account.
CUSTOMFILTEROPTIONLIST - An HTML option list of all custom filters.
IS_LICENSEALLOW_SPAM - True when the license settings have SPAM features enabled.
_folder.html
part_folder_jumptopageentry.txt
part_folder_mailentry.txt
Allows users to view an account directory.
Session
POSTLINK - A link to process the HTML form.
FOLDERDISPLAYNAME
- The name of the folder.
FOLDERUNREADMAILCOUNT - The total number of unread mails in the folder.
FOLDERSIZEKB - The total size in KB of all mails in the folder.
SEARCHDISPLAYTEXT - If search mode is active, then this will contain what was searched.
FROMORTO - If this is the sent folder, the text "To". Any other folder, the text "From".
SORTONFROMORTOLINK - A link to sort the mails by the from or to.
SORTONSUBJECTLINK - A link to sort the mails by subject.
SORTONDATELINK - A link to sort the mails by date.
SORTONSIZELINK - A link to sort the mails by size.
LISTSTARTNO - The index of the first mail in the list.
LISTENDNO - The index of the last mail in the list.
TOTALMAILCOUNT - The total number of mails in all pages.
PAGENO - The current page number.
PAGECOUNT - The total number of pages.
PREVPAGELINK - A link to the previous page.
NEXTPAGELINK - A link to the next page.
JUMPTOPAGESLINKS - A list of links to nearby page numbers.
JUMPTOPAGEENTRY_PAGENO - In use only during page number list insertion. Inserts the page number.
JUMPTOPAGEENTRY_LINK - In use only during page number list insertion. Inserts a link to the page.
MAILLIST - A list of the mails in the current page.
MAILLISTENTRY_IMPORTANCENAME - In use only during mail list insertion. Inserts the mail's importance text, which can be "importancelow", "importancemedium" or "importancehigh".
MAILLISTENTRY_ICONNAME - In use only during mail list insertion. Inserts the mail's icon name text, which can be "maildraft", "mailreceiptread", "mailreceiptunread", "mailrepliedforwarded", "mailreplied", "mailforwarded", "mailread" or "mailunread".
MAILLISTENTRY_INDEX - In use only during mail list insertion. Inserts the mail's listing index number.
MAILLISTENTRY_UID - In use only during mail list insertion. Inserts the mail's UID number.
MAILLISTENTRY_LINK - In use only during mail list insertion. Inserts a link to read the mail.
MAILLISTENTRY_FROMORTOADDRESSBOOKLINK - In use only during mail list insertion. Inserts a link to view the address book entry for the to or from email address.
MAILLISTENTRY_FROMORTO - In use only during mail list insertion. Inserts the to or from email address.
MAILLISTENTRY_SUBJECT - In use only during mail list insertion. Inserts the mail's subject.
MAILLISTENTRY_DATE - In use only during mail list insertion. Inserts the mail's received date.
MAILLISTENTRY_DATESHORT - In use only during mail list insertion. Inserts the mail's received date in a shortened format.
MAILLISTENTRY_SIZE - In use only during mail list insertion. Inserts the mail's size in KBs.
HAS_MAILS - True if there is any mails to display.
HAS_MULTIPLEPAGES - True if there is more than one page.
IS_SEARCHMODE - True if search mode is active.
IS_SENTFOLDER - True if the folder is the sent folder.
JUMPTOPAGEENTRY_IS_CURRENTPAGE - In use only during page number list insertion. True if the page is the current page.
MAILLISTENTRY_IS_READ - In use only during mail list insertion. True if the mail is unread.
MAILLISTENTRY_IS_FROMORTOINADDRESSBOOK - In use only during mail list insertion. True if the to or from email address exists in the accounts address book.
_index.html
The main index page of WebMail which also deals with logging in.
Non-Session
DOMAINLOGINOPTIONLIST - An HTML option list of available domains.
CAPTCHAIMAGELINK - A link to the captcha security code image.
CAPTCHAIMAGECODE - The code number of the captcha security code image.
IS_CAPTCHAIMAGEREQUIRED - True if login requires a captcha security code image.
IS_DOMAINLISTREQUIRED - True when the WebMail settings have enabled the domain option list during login.
_personaldata.html
Allows users to view or edit their personal data.
Session
POSTLINK - A link to process the HTML form.
GIVENNAME - The given name.
SURNAME - The surname.
EMAILADDRESS - The email address.
ORGANIZATION - The organization (company).
ORGANIZATIONALUNIT - The organizational unit (department).
STREET - The street.
LOCALITY - The locality (city).
STATE - The state.
POSTALCODE - The postal code.
COUNTRYOPTIONLIST - An HTML option list of countries.
TELEPHONENUMBER - The telephone number.
DESCRIPTION - The description.
 
_pop3retr.html
Allows users to view, add or edit a POP3 Retrieval.
Session
POSTLINK - A link to process the HTML form.
ORIGINALNAME
- If editing an existing POP3 Retrieval, this inserts the original name.
USEENABLED - If enabled, the text "checked".
HOST - The host.
PORT - The port number.
SSLMODEOPTIONLIST - An HTML option list of SSL modes.
USER - The login user.
PASS - An appropriate password string.
CONFIRMPASS - An appropriate password string.
DELIVERTOOPTIONLIST - An HTML option list of all folders in the account.
USELEAVEONSERVER - If enabled, the text "checked".
USEDELETEAFTERDAYS - If enabled, the text "checked".
DELETEAFTERDAYS - The number of days.
USEDELETEAFTERCOUNT - If enabled, the text "checked".
DELETEAFTERCOUNT - The max number of mails.
IS_NEW - True when the user is editing a new POP3 Retrieval.
_pop3retrs.html
Allows users to view or edit POP3 Retrievals.
Session
POSTLINK - A link to process the HTML form.
POP3RETROPTIONLIST
- An HTML option list of POP3 Retrievals.
 
_pop3retrstriggeredok.html
Displayed to the user when the POP3 Retrievals have been successfully manually triggered.
Session
RETURNLINK - A link to return the user to the correct folder.  
_readmail.html
_readmail_nobody.html
part_readmail_addressentry.txt
part_readmail_attachmententry.txt
part_readmail_displayheader.txt
part_readmail_displaytop.txt
part_readmail_displaybottom.txt
Allows users to view and respond to a mail.
Session

POSTLINK - A link to process the HTML form.
FROM - An email address list with a single entry as the from email address.
TO - An email address list for the to addresses.
CC - An email address list for the cc addresses.
ADDRESSENTRY_ADDRESS - In use only during email address list insertion. Inserts the email address.
ADDRESSENTRY_ADDRESSBOOKLINK - In use only during email address list insertion. Inserts a link to view the account address book entry for the email address.
UID - The UID number.
FROMEMAILADDRESSONLY - From email address.
DATE - The date.
SUBJECT
- The subject.
ATTACHMENTS - The attachment list.
ATTACHMENTENTRY_LINK - In use only during attachment list insertion. Inserts a link to download the attachment.
ATTACHMENTENTRY_NAME - In use only during attachment list insertion. Inserts the attachment name.
EDITLINK - A link to edit the mail.
REPLYLINK - A link to reply to the mail.
REPLYALLLINK - A link to 'reply to all' to the mail.
FORWARDLINK - A link to forward the mail.
DELETELINK - A link to delete the mail.
JUNKLINK - A link to move the mail into the junk account directory.
BLOCKLINK - A link to block the sender of the mail.
VIEWASTEXTLINK - A link to view the mail as text.
VIEWASHTMLLINK - A link to view the mail as HTML.
VIEWASSOURCELINK - A link to view the mail source.
PREVMAILLINK - A link to view the previous mail.
NEXTMAILLINK - A link to view the next mail.
CLOSELINK - A link to return to the mail's folder.
DISPLAYMAILLINK - A link to view a printable form of the mail.
PREMOVETOFOLDERLINK - The first part of a link to move the mail to a specified folder. To create a link to move the mail, simply use the tag with the folder name proceeding it, eg. <a href="####TAG####Not%20Junk">.

HAS_CC - True if the mail has any Cc addresses.
HAS_ATTACHMENTS - True if the mail has any attachments.
IS_DRAFT - True if the mail is a WebMail draft.
IS_MDN - True if the mail is an MDN.
IS_TEXTVIEW - True if the current view is text mode.
IS_HTMLVIEW - True if the current view is HTML mode.
IS_SOURCEVIEW - True if the current view is source mode.
IS_NOBODYVIEW - True if the current view is not text, HTML or source mode.
IS_ATTACHEDMAIL - True if the mail is an attached mail in another mail.
ADDRESSENTRY_IS_FIRST - In use only during email address list insertion. True if this is the first address in the list.
ADDRESSENTRY_IS_INADDRESSBOOK - In use only during email address list insertion. True if the email address exists in the accounts address book.
ATTACHMENTENTRY_IS_FIRST - In use only during attachment list insertion. True if this is the first attachment in the list.
ATTACHMENTENTRY_IS_MAIL - In use only during attachment list insertion. True if this attachment is an attached mail.
_readmailforwardmode.html
Allows users to select the appropriate forwarding mode when asked.
Session
POSTLINK - A link to process the HTML form.
FORWARDMODEOPTIONLIST
- An HTML option list of forwarding modes.
_readmailsendreceipt.html
Allows users to select the appropriate action when a read mail requests a 'Read Receipt'.
Session
POSTLINK - A link to process the HTML form.
RECEIPTADDRESSDISPLAY
- The email address and name that has requested the receipt.
 
_resetpassword2.html
Allows users to reset their password should they forgot it.
Non-Session
POSTLINK - A link to process the HTML form.
EMAILADDRESS
- The email address.
QUESTION - The password resetting question.
 
_search.html
Allows users to search an account directory.
Session
POSTLINK - A link to process the HTML form.
SEARCHMODEOPTIONLIST
- An HTML option list of search modes.
FOLDERPATH - The search folder.
 
_signatures.html
Allows users to view and edit their signature.
Session
POSTLINK - A link to process the HTML form.
USESIGNATURENEW
- If enabled, the text "checked".
SIGNATURENEW - The signature for new mails.
USESIGNATUREREPLYFORWARD - If enabled, the text "checked".
SIGNATUREREPLYFORWARD - The signature for replying and forwarding.
 
_signup.html
Allows users to sign-up for an account automatically.
Non-Session
POSTLINK - A link to process the HTML form.
SIGNUPDOMAINOPTIONLIST
- An HTML option list of allowed sign-up domains.
COUNTRYOPTIONLIST - An HTML option list of countries.
CAPTCHAIMAGELINK - A link to the captcha security code image.
CAPTCHAIMAGECODE - The code number of the captcha security code image.
FIELDTEXT-FIELDNAME - The text contained in the URL query parameter field name (eg. http://yourdomain.com/_index?user=bob allows the use of ####FIELDTEXT-bob####).
IS_PASSWORDRESETREQUIRED - True when the password resetting information is required.
IS_REQUIREDFIELD-FIELDNAME - True when the field name is a required field.
HAS_ERRORMSG - True when there is an error message to display.
IS_CAPTCHAIMAGEREQUIRED - True if sign-up requires a captcha security code image.