Communications Express allows you to customize all the three components namely Mail, Calendar and Address Book for a specific domain. The sections contained in this chapter are,
The default user preferences that will be used for a first-time user can be configured on a per-domain basis. The default user preferences can be configured in the uwcdomainconfig.properties file.
To configure default user preferences for a specific domain, for example, siroe.com, you need to do the following:
Create a directory with the name same as the domain name in <domain-dir> directory. For example, create <domain-dir>/siroe.com directory.
Copy uwcdomainconfig.properties file from <domain-dir>directory to the newly created directory.
Make the required changes to uwcdomainconfig.properties file in<domain-dir>/siroe.com directory. You can configure the default user preferences for global, calendar and address book.
Restart the web server to apply changes
You can configure themes on a per-domain basis.
Currently Communications Express does not support customization of themes on a per-user basis
To configure a theme for a specific domain, for example, siroe.com and a locale ja and fr, you need to do the following.
Create a directory with the name same as the domain name in <domain-dir> directory. For example, create <domain-dir>/siroe.com directory
Copy uwcdomainconfig.properties file from <domain-dir> to the <domain-dir>/siroe.com directory.
Modify the parameter uwc-user-attr-sunUCTheme to the required theme name in uwcdomainconfig.properties file in <domain-dir>/siroe.com directory. For example, to configure a theme “christmas“set uwc-user-attr-sunUCTheme=christmas. To configure a theme called “christmasJA” for japanese locale, set uwc-user-attr-sunUCTheme-ja=christmasJA. To configure a theme called “christmasFR” for french locale, set uwc-user-attr-sunUCTheme-fr=christmasFR. The parameter “uwc-user-attr-sunUCTheme” is used for default locale. It is important that though the theme name could be anything, the property name should end with corresponding locale as mentioned in the example.
Create the directories <skin-dir>/christmasJA, <skin-dir>/christmasFR and <skin-dir>/christmas.
Copy themes.properties from <skin-dir>/ to <skin-dir>/christmasJA, <skin-dir>/christmasFR and <skin-dir>/christmas
Edit the corresponding themes.properties to point to the customized style sheets and images.
For help on various parameters in this file, refer to the Appendix D of the Communications Express Administration Guide. Look for “themes.properties” under the “Configuration Parameters Reference” section.
Restart the web server to apply changes.
This section describes how to customize the mail interface for each domain.
You can perform the following tasks to customize the client interface:
Create a directory for mail with the domain name under msg_svr_base/config/html directory.
Populate this directory with the customized versions of the files from the default directory hierarchy.
For example, assume that you have a domain called siroe.com. To change the icon for the domain siroe.com, add a new icon in the imx directory of siroe.com and change the reference to it in the main.js file. The following is the directory structure for the domain siroe.com
Directory |
Description |
---|---|
html/... |
// default interface |
html/imx/... |
// default interface |
html/en/... |
// default interface |
html/siroe.com/main.js |
// refers to imx/bottle.gif |
html/siroe.com/imc/bottle.gif |
// refers to imx/bottle.gif |
After login, the server refers the user agent to pick the main.html file that is located in the domain/lang directory. The main.html file contains the relative references to the rest of the interface. The client requests all the files in the directory to make the interface. If these files exist in the domain/lang directory they are displayed, otherwise the default setup files from html/en/ are displayed.
If you have many domains and only a few distinct ”brands’ then you can use links to make the server point to the correct brand
Directory |
Description |
---|---|
html/... |
// default interface |
html/sesta.com/... |
// customized interface for brand 1 |
html/varrius.com -> sesta.com |
// default interface |
The server listens to all IP addresses and presents a customized interface before the authentication occurs. The server does this by looking at the URL and determines if it contains a known domain and presents the per domain Login screen for the domain.
For example, for the per domain Login screen: http://webmail.sesta.com/, the server presents the page from the location: html/sesta.com/en/default.html.
In this case a user does not have to suffix @domain to the username to login.
For more information on Customizing the Mail Component, refer the Sun Java System Messenger Express Customization Guide.
In address book, all UI related source files (xml/xsl) are located under <uwcinstall>/WEB-INF/ui/html/abs directory by default. To customize the UI for a domain, follow these steps.
Create a directory with a domain name, (e.g. siroe.com) under <uwcinstall>/WEB-INF/ui/html.
Copy all files from <uwcinstall>/WEB-INF/ui/html/abs to<uwcinstall>/WEB-INF/ui/html/<domain>.
Make the required changes in XSL files as explained in the previous sections.
Although all images are located under <uwcinstall>/absimx by default, you may create a directory with a domain name (e.g. <uwcinstall/absimx/sireo.com) under it and include the icons that are customizable under the newly created domain directory. Also ensure that the path reference to the newly created directory is updated in <uwcinstall>/WEB-INF/ui/html/<domain> search-images.xsl and commonimages.xsl.