Following are the changes you can make to the Web Messaging templates and other configuration files to alter their appearance and functionality. Most configuration files are located in the \IMail\Web directory and are in the format of config_filename.cgi. You should not modify any .cgi file that does not begin with config_. The binext.txt file that determines whether attachments should be handled as binary files is located in the \IMail directory.
Customizations in Bold should be done immediately following installation.
You can edit colors globally in the stylesheet.cgi file. Don't forget to edit the bgcolor parameter of the tag at the end of that file, so that browsers that do not support CSS will display the correct background color.
Changing Button Labels and Logos
For buttons and logos that have a.gif file, you can replace them with your own .gif file. To create your own button, you can use one of the following blank button gif files, located in the IMail/web directory.
blank_button_57_24.gif (small button: height 57 pixels, width 24)
blank_button_74_24.gif (large button: height 74 pixels, width 24)
Edit Header and Footer Globally
- Edit the footer globally in the footer.cgi file. It will display a link to your support@ address for your primary domain, so change or delete that if you don't have one.
- Edit the message trailer content in the config_MessageTrailer.cgi file. If you want a different trailer for different domains, just create a Web directory in the other domains' directories, and put JUST the customized trailer file in it. (Same goes for other customizations, like the common address book, folder names, etc.) NOTE: Double quotation marks are NOT allowed in the message trailer file.
- If desired, edit the Header globally in the headerstart.cgi file. (Here's where you might want to put a smaller logo, or a banner ad that rotates with Java script, or links back to your main site, etc.)
Editing the Language Displays
- config_DefaultLanguage.cgi. The default language, e.g. "English". This must match the OptValue [i] entry from your config_LanguageSelections.cgi file.
- config_DefaultLanguageCharset.cgi. The default language character set, e.g. "ISO-8559-1" for regular Western ISO English, or "euc-jp" for both English and Japanese.
- config_HideLanguageSelections.cgi. Set to 1 to hide the language selector choices.
- config_LanguageSelections.cgi. List the languages you wish to offer in the list as formatted. The values for this file are as follows: OptDisp[i] is what appears in the language selection list. OptValue[i] This value must match the exact filename in the web/languagePacks directory. OptFontSize[i] This is the font size of the Text. OptHelpPath [i] This is the directory location of the Help files for the language.
- config_MailBoxSizeLimitKB.cgi. This file's contents should be set to the domain-specific account size limit, in kilobytes. For example, a setting of 10000 is ten thousand kilobytes, or approximately 10MB. If you set this file to "0", all users on the domain will have an unlimited mailbox size (in the web interface), and will not get warning pop-ups or a size graph. To customize this size limit for virtual domains, give the virtual domain a /web directory, and put just the customized config_ file in it. If you want certain users (i.e. system administrators) to have no limit, you should not alter this file. Instead, enter a very large size limit, such as 1000000000 (approx. 1 GB), in the Mailbox size limit setting in IMail Administrator for those users (note that IMail Administrator uses Bytes instead of Kilobytes).
- If desired, edit the Recipient Field Length Limit in the config_RecipientFieldLengthLimit.cgi file. The default is 1000 characters. We recommend values between 200 and 2000; if set high, you risk spammers using your system to BCC very long lists of recipients. Do not use commas, spaces, or carriage returns in this file.
- config_SystemTitle.cgi. The title of your WebMail system, that shows up in title bar of browser. Default is "ClassicWebMail"
- config_YouveGotIMailDomain.cgi. This is an add-on product. For information on how to configure this file, see the You've Got IMail readme.html file. For now, just put in your primary official host name (like "domain.com").
- Common Address Book: Edit your config_CommonAddrBook.cgi file to display a comma-delimited list of common e-mail addresses in every user's address book. Be sure to format the list exactly the way it's shown in the example list, do NOT include any single quotation marks (') in the values, and make certain you don't have a trailing carriage return on the comma-delimited list of addresses. Here is the sample format in case yours gets messed up:
- Sales - firstname.lastname@example.org,Support - email@example.com,Info - firstname.lastname@example.org
config_CommonAddrBookDivider.cgi. This is simply the text of the divider line between a user's personal address book entries, and the common address book entries. Use whatever you want, but make sure there are no carriage returns present.
- Binext.txt. Web Messaging reads this file, located in the \IMail directory, to determine the file attachment types that should automatically be treated as binary files. If there are additional file types that you want to avoid being handled as text file attachments, add the file type to the binext.txt file. Each entry in the binext.txt file should on a separate line and be formatted as follows: .ext
- For example, if you want to handle Macromedia® Flash® files as binary attachments, add a line in the binext.txt file as follows: .fla