Customization Do's and Don'ts

This section describes various files that are critical and can break
your customizations if they are not edited with caution. Some files often
contain bug fixes. These changes can be lost if appropriate care is not taken.

Files That Should not be Edited

The following table lists the files that should not be edited. These
files often have bug fixes and are not needed for customization in most cases.

Table 2–1 List of files that often
contain bug fixes

browser.js

compRecipient.js

dtree.js

main.js

form.js

lookup.js

mailui.js

util.js

searchusers.js

setdomain.js

smimeapplet.js

Files That Should be Edited with Caution

The following table lists files that should be edited with caution.
These files are highly readable and self-explanatory. Some of them have HTML
code at the bottom. It is recommended that you limit your customization to
the HTML portion. Also, do not add or modify any JavaScript functions. If
you see a need for a new JavaScript function, create a new file and source
it in the HTML code.

Table 2–2 List of files that should
be edited with caution while customizing Communications Express

applet_fs_lr.html

attach_fs_lr.html

collect_fs_lr.html

comp_fs_lr.html

fldr_fs_lr.jsp

mbox_fs_lr.jsp

msg_fs_lr.jsp

receipt_fs_lr.html

searchmsg_fs_lr.html

setpermission_fs_lr.html

srchresults_fs_lr.html

subscribe_fs_lr.html

Files Related to Global Fonts and Colors

The following table lists files that are related to customizing global
styles and fonts. A
number of tools are available in the market that can help you find out values
of a particular color. It is recommended that you edit these files to achieve
the customizations for font and color. However, you can add new styles if
you find it impossible to change the styles in these files.

Table 2–3 List of files related to
global fonts and colors

dtree.css

mail_css_ie5win.css

mail_css_ns6up.css

master-style.css

master-style_ie5up.css

master-style_ns4sol.css

master-style_ns6up.css

master-style_ns4win.css

Customizing Image Files

While customizing images in Communications Express it is recommended that you
replace the existing images with the new ones without changing the file names.
The file names of the image are read and cached by Communications Express and then rendered.
If you want to change the names of the files, you have to change the name
in the property files and then restart the web container. Replacing the image
files with the new images while maintaining the same file names will avoid
restarting of the web container.