|
|
IMail Tags
The templates used to create Web Calendar pages consist mostly of HTML code. Some templates also contain JavaScript.
A specialized "tag" language is used within the templates to generate "dynamic" information, such as mailboxes and messages, at run-time - in other words, when a browser requests the information. You can use these tags to customize any Web Calendar page, add pages of your own, and add or rename components of a page.
Tag Syntax
All tags start with the label ICAL. An ICAL tag is always embedded in the standard HTML comment tag. For example:
- ICAL.TagName - This type of tag returns a value, such as the UserID of the currently logged on user, or the IMail Server host name.
- ICAL.TagName.Value - where TagName is the name of the item, such as a button, hyperlink, or check box. You cannot edit the TagName. For text that appears on a button, the TagName has the suffix Button, (for example: LogonButton, SaveButton); for text that appears in a hyperlink, the suffix is Link; for simple text tags, the suffix is Text. Value is the actual text that appears on the button, in the hyperlink, or next to the check box. You can edit the Value to change the text to whatever you want
Types of Tags
You can use the tags to do the following types of operations.
- Normal tags return a value or values. These tags are used to build dynamic information, such as the name of the logged in user.
- Conditional tags check whether a condition is true or false, and then continue processing based on the answer. These tags use If-Then-Else constructs.
- While tags populate a table, such as a list of messages in a mailbox. These tags use For-Each constructs.
- Include tags let you name an HTML, ASP, CGI, CSS or other file to be included at the tag location. If the file extension is .asp or .cgi, then the included file will be further parsed for IMAIL tags. For example, you can use the Include tag to include a standard header in all files.
For a complete guide to using tags in a template, see the document "IMail Server Web Calendar Templates," (iwebcaltags.doc file in the [IMail Top Directory]\Web directory).
|
Ipswitch, Inc. http://www.ipswitch.com |
| ©Ipswitch 2001 | |||