Previous Contents Index DocHome Next |
iPlanet Messenger Express 5.0 Customization Guide |
Chapter 1 Introduction to Messenger Express and Customization
iPlanet Messenger Express 5.0 is a Web-based electronic mail program that lets end users access their mailboxes using a browser running on an Internet-connected computer system using HTTP. Messenger Express clients send mail to a specialized web server that is part of iPlanet Message Server. The HTTP service then sends the message to the local Message Transfer Agent (MTA) or to a remote MTA for routing or delivery.Almost all features of Messenger Express are fully customizable, but for the sake of simplicity, this manual discusses only the basic features. In addition, you can customize most features easily during an upgrade.
This chapter contains these sections:
Messenger Express Customization Overview
Messenger Express Customization Overview
iPlanet Messenger Express 5.0 lets you rewrite the "static" portion of the pages served by the Messenger Express HTTP daemon to produce a fully customized webmail service. Messenger Express supports both JavaScript and HTML in implementing customization schemes.
Messenger Express Components
iPlanet Messenger Express consists of two components: the client and the server. The client reads and interprets the JavaScript language. The HTTP server understands proprietary protocols that communicate with Messenger Express. The JavaScript files reside on the server and are downloaded to the client. The client extracts data from the JavaScript code to customize Messenger Express functions. All modifications and customizations are done on the server.HTML files contain both text and markup describing how the text is formatted and handled. Markup is implemented through a set of tags, which specify things like headers, indents, font size, italics and so on. These are largely static tags that deal exclusively with text within the HTML file on the client. However, the HTML also contains dynamic tags, such as JavaScript embedded in the client file, that point to files and functions on the server. The dynamic tags enable the HTML file client to pull in data processed on the server for use in otherwise static Web pages.
HTML files provide the skeleton structure of each of the interfaces, whereas JavaScript files give the specific attributes. Each of the JavaScript main functions are contained within an HTML parent function. There are also differentiations within the JavaScript files themselves. The file main.js primarily controls the layout of the interfaces, whereas the file i18n.js controls the text. The i18n.js file also can be localized to fit the language of many regions in the world.
The HTML files are the "parent" functions that call the "main" functions in the JavaScript files to initiate actions.
Location of Customizable Files
The Messenger Express JavaScript and HTML files that can be customized reside in the server-root/html directory, where server-root represents the directory path in which you install the Message Server software.Table 1-1 lists the files that you edit to customize Messenger Express, and which part of Messenger Express each file controls.
Table 1-1    Messenger Express Customizable Files
Files
What the File Controls in Messenger Express
Messenger Express Localization
You can localize any feature of iPlanet Messenger Express. You can create different pages for each language your users speak. When you create language-specific static webmail pages, you group them in subdirectories under the main document directory. The webmail code automatically detects the client's language preference and fetches webmail pages from the appropriate subdirectory.When you change common sections of the static webmail pages, you must make the changes multiple times if modifications (for example, to JavaScript behavior) are desired across languages. Conversely, you can make language-specific modifications selectively throughout the application.
Specific Locales
Table 1-2 lists the specific locales (and their abbreviations) that Messenger Express services. The protocol's default language is English.
Table 1-2    Messenger Express Specific Locales
Locale
Abbreviation
Location of Locale-Specific Customizable Files
The localized Messenger Express JavaScript and HTML files reside in the server-root/html/locale_specific directory, where server-root represents the directory path in which you install the Message Server software.
Basic Interfaces and Associated Functions
This section presents the underlying functions associated with the various Messenger Express screens, including:Tables list the functions associated with each button on the Messenger Express screens.
The files containing the functions reside in the server-root/html directory, where server-root represents the directory path in which you install the Message Server software.
Inbox Screen
The Messenger Express inbox screen, shown in Figure 1-1, enables you to view all your messages, and specifies if they have been read. The inbox screen gets new messages and enables you to search for or delete old messages, as well as move messages into other folders.
Figure 1-1    Messenger Express Inbox Screen
![]()
Inbox Screen Functions
Table 1-3 lists the functions needed to customize the inbox screen, including "main." functions (found in main.js) and "parent." functions (found in mbox_fs.html).
Table 1-3    Inbox Screen Functions
Item
Function
Message Screen
The Messenger Express message screen, shown in Figure 1-2, displays the message previously selected from the inbox screen. The message screen gives the option of replying to the sender(s), forwarding the message, moving the message to a different folder, or deleting the message. The message screen also enables direct access to the next or previous message.
Figure 1-2    Messenger Express Message Screen
![]()
Message Screen Functions
Table 1-4 lists the functions needed to customize the message screen, including "main." functions (found in main.js) and "parent." functions (found in msg_fs.html).
Table 1-4    Message Screen Functions
Item
Function
Folders Screen
The Messenger Express folders screen, shown in Figure 1-3, displays all folders that can be accessed. The folders screen lists the number of messages contained and the size of each folder. The folders screen also enables creating new folders, renaming or deleting old ones, moving a folder within another one, updating the inbox, and composing new messages. Like the inbox screen, the folders screen also has the functionality of collecting external mail.
Figure 1-3    Messenger Express Folders Screen
![]()
Folders Screen Functions
Table 1-5 lists the functions needed to customize the folders screen, including "main." functions (found in main.js) and "parent." functions (found in fldr_fs.html).
Table 1-5    Folders Screen Functions
Item
Function
Options Screen
The Messenger Express options screen, shown in Figure 1-4, enables access to the subscriber's account summary, personal information, password, settings, appearance, delegated administrator, and vacation message, all of which are adjustable.
Figure 1-4    Messenger Express Options Screen
![]()
Options Screen Functions
Table 1-6 lists the "parent." functions (found in opts_fs.html) needed to customize the options screen.
Table 1-6    Options Screen Functions
Item
Function
Composition Window
The Messenger Express composition window, shown in Figure 1-5, is used primarily for composing a new message. You can also use the window to save a draft or attach a file to the message, look up a recipient in the address book, access the help file, and cancel the composition altogether. Recipients can be added in the form of "to," "cc," or "bcc," and senders can be added as well. Furthermore, the composition window enables the option of requesting different mailing priority or a return receipt.
Figure 1-5    Messenger Express Composition Window ![]()
Composition Window Functions
Table 1-7 lists the functions needed to customize the composition window, including "main." functions (found in main.js) and "parent." functions (found in comp_fs.html).
Table 1-7    Composition Window Functions
Item
Function
Previous Contents Index DocHome Next
Copyright © 2000 Sun Microsystems, Inc. Some preexisting portions Copyright © 2000 Netscape Communications Corp. All rights reserved.
Last Updated September 29, 2000