Chapter 8 Customizing Communications Express for a Specific Domain

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,

• Customizing Default User Preferences for a Specific Domain

• Customizing Theme for a Specific Domain and Locale

• Customizing Mail for a Specific Domain

• Customizing Address Book for a Specific Domain and a Locale

Customizing Default User Preferences for a Specific Domain

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:

To Customize the Default User Preferences for a Domain

Steps

1. Create a directory with the name same as the domain name in <domain-dir> directory. For example, create <domain-dir>/siroe.com directory.

2. Copy uwcdomainconfig.properties file from <domain-dir>directory to the newly created directory.

3. 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.

4. Restart the web server to apply changes

Customizing Theme for a Specific Domain and Locale

You can configure themes on a per-domain basis.

---

Note –

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.

To Customize a Theme for a Specific Domain

Steps

1. Create a directory with the name same as the domain name in <domain-dir> directory. For example, create <domain-dir>/siroe.com directory

2. Copy uwcdomainconfig.properties file from <domain-dir> to the <domain-dir>/siroe.com directory.

3. 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.

4. Create the directories <skin-dir>/christmasJA, <skin-dir>/christmasFR and <skin-dir>/christmas.

5. Copy themes.properties from <skin-dir>/ to <skin-dir>/christmasJA, <skin-dir>/christmasFR and <skin-dir>/christmas

6. Edit the corresponding themes.properties to point to the customized style sheets and images.

7. 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.

8. Restart the web server to apply changes.

Customizing Mail for a Specific Domain

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

Table 8–1 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

Table 8–2 Linking Multiple Domains to few distinct brands

Directory	Description
html/...	// default interface
html/sesta.com/...	// customized interface for brand 1
html/varrius.com -> sesta.com	// default interface

Domain From URL

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.

Customizing Address Book for a Specific Domain and a Locale

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.

To Customize Address Book for a Specific Domain and Locale

Steps

1. Create a directory with a domain name, (e.g. siroe.com) under <uwcinstall>/WEB-INF/ui/html.

2. Copy all files from <uwcinstall>/WEB-INF/ui/html/abs to<uwcinstall>/WEB-INF/ui/html/<domain>.

3. 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.