The "IClient.config"
file has many configurable web client settings that can be updated and change settings for all Web Client users. The "IClient.config"
file default location is
"...\Program Files\Ipswitch\IMail\WebDir\WebClient"
See Maintaining XML File for Websites to configure websites to globally display for all web client users.
Listed below are the current configurable items to meet the different needs for the IMail Administrator.
Note: The Auto Refresh Frequency has been moved to the Web Client User Options. Go to Action >
Manage User Options > Receiving Messages.
Tip: For changes made to this file to take affect a restart of the web application is required.
<add value="true" key="EnableAdminLink"/>
<add value="-1" key="AjaxTimeout"/>
<add value="60" key="AutoLogoutMinutes"/>
<add value="IMail Web Client" key="PageTitle"/>
<add value="true" key="EnableCachableFileVersioning"/>
Note: Disabling this feature can sometimes cause problems after a software upgrade when improvements have been made and they are not reflected with caching in place.
"View More"
link will appear below the last item, which will switch to a day view. <add value="3" key="MaxMonthViewAppointmentItemsPerDay" />
<add value="false" key="EnableAutoLoginForChrome"/>
Note: This configuration was created in the hopes that a future Chrome version be released that this issue is no longer a problem.
<add value="true" key="EnableContactPhotos"/>
<add value="jpg, jpeg, gif, png, bmp" key="ValidContactImageFileTypes"/>
<add value="true" key="EnableContactImageResizing"/>
Contacts - Disable Contact Checking in Messages
Warning: Performance can be slowed for user's with a large number of address books or contacts with this feature enabled.
<add value="true" key="EnableExistingContactCheck"/>
<add value="RijndaelManaged" key="EncryptionType"/>
<add value="4f005a9fe0e56fc43aaacd349c3b50558169461124185d93b8b9f392965e9e47" key="SecurityKey"/>
<add value="4f005a9fe0e56fc43aaacd349c3b50558169461124185d93b8b9f392965e9e47" key="Salt"/>
Example: To allow only Calendaring, the IMail Administrator must enable the Personal Information Managers and then disable all the unwanted features displayed below.
<add value="true" key="EnableAppointments"/>
<add value="true" key="EnableMeetingRequests"/>
<add value="true" key="EnableNotes"/>
<add value="true" key="EnableTasks"/>
<add value="true" key="EnableRssFeeds"/>
<add value="true" key="EnableSaveTaskApptsBodyAsRTF"/>
"false"
will disable reminders system-wide.<add value="true" key="EnableReminderCheck"/>
Note: With this feature enabled the key="ReminderCheckFrequency"
(by default set to "1" minute), can be updated to improve system performance.
<add value="true" key="EnableForwardTo"/>
<add value="true" key="EnablePasswordChange"/>
Note: In addition to being enabled here, Anti-spam must be installed and licensed on the IMail Server for the button to appear.
<add value="true" key="EnableSpamReporting"/>
<add value="true" key="EnableAltFromAddresses"/>
<add value="true" key="EnableUsageChart"/>
<add value="true" key="DisplaySystemMessageOnLoginPage"/>
<add key="EnableUsageChart" value="true"/>
<add key="AvailableColor" value="#cccccc"/>
<add key="SafeUsageColor" value="#33cc33"/>
<add key="WarningUsageColor" value="#ffff33"/>
<add key="DangerUsageColor" value="#ff0000"/>
<add key="WarningThresholdPercentage" value="85"/>
<add key="DangerThresholdPercentage" value="95"/>
<add key="ChartType" value="Pie"/>
<add key="RenderIn3D" value="true"/>
Domain, Enable Invalid Domain Logging
<add value="false" key="EnableInvalidDomainLogging"/>
<add value="true" key="EnableHelpLink"/>
<add value="true" key="EnableIEBlankSrcFix"/>
Note: Only one character is allowed for use, be sure it is one that is not found in email addresses or login names.
<add value="/" key="ImpersonationDelimiter"/>
<add value="true" key="AllowUserImpersonationBySystemAdmins"/>
<add value="true" key="AllowImpersonatorsToSeeMail"/>
"Inbox"
to display upon initial login.Note: Once enabled, this feature will disable the Web Client User Options > General Options > Initial Item To Display drop down menu.
<add value="true" key="EnableInboxDisplayUponLogin"/>
<add value="en-US" key="DefaultLanguage"/>
The valid options are:
Example: en-US is English, requiring a need for a resource string named "en-US" in each of the resource string files.
<add value="native" key="LanguageDisplayFormat"/>
<add value="" key="MessageTranslationLanguageCodes"/>
Language Missing Resource String Logging
<add value="" key="MessageTranslationLanguageCodes"/>
Lite Client - Disable Storing Mailbox in Session
<add value="true" key="EnableLiteMailInSession"/>
Note: Keeping this configuration "enabled" improves paging for users with large mailboxes.
Lite Client Only (Disable Web Client)
key name is as follows:
<add key="EnableLiteOnlyMode" value="false"/>
Note: By default, this setting is set to "false"
An added security feature has been created to lockout the user temporarily by the "IClient.config"
file setting, after the Allowed Login Attempts have been met. The user's account will not be permanently suspended until the Allowed Lockouts Before Account Suspension is met.
Note: To disable this lockout feature set "MinutesToWaitBetweenLockouts"
value to "0".
<add value="1" key="MinutesToWaitBetweenLockouts"/>
<add value="1440" key="MinutesToWaitBeforeReset"/>
Example:
Domain Property Settings
IClient.config Setting
Note: Successful access to the Web Client will reset all lockout attempts to zero
Logging, Enable Invalid Domain Logging
<add value="false" key="EnableInvalidDomainLogging"/>
Logging, Disable for Web Client
<add value="true" key="AllowApplicationLogging"/>
Mapping Url Examples
Note: While most of the major online mapping services will work, it is possible that some may not. Any mapping service that requires the address to be submitted as more than just one query string value will most likely not work.
<add value="http://maps.google.com/maps?f=q%26source=s_q%26geocode=%26q={0}" key="MappingUrl"/>
<add value="true" key="ShowMappingUrlInNewWindow"/>
Note: Web page load time and overall performance will decrease as this increases.
<add value="2000" key="MaxAllowedContactsBeforeSearch"/>
Message Encoding Options for Compose
<add value="UTF-8,US-ASCII,ISO-8859-15,BIG5,GB2312,ISO-2022-JP" key="MessageEncodings"/>
Mobile Devices Using the Lite Client
<add key="MobileUserAgents"
value="midp,j2me,avant,docomo,novarra,palmos,palmsource,
240x320,opwv,chtml,pda,windowsce,mmp/,blackberry,BlackBerry8910,
mib/,symbian,wireless,nokia,hand,mobi,phone,cdm,up.b,audio,SIE-,
SEC-,samsung,HTC,mot-,mitsu,sagem,sony,alcatel,lg,eric,vx,NEC,
philips,mmm,xx,panasonic,sharp,wap,sch,rover,pocket,benq,
java,pt,pg,vox,amoi,bird,compal,kg,voda,sany,kdd,dbt,sendo,
sgh,gradi,jb,dddi,moto,iphone,ipad,android,iemobile" />
Note: The remaining portion of the note will be visible when viewing or editing it.
<add value="250" key="NotesDisplaySize"/>
Performance Improvements for the Web Client
<add value="1" key="ReminderCheckFrequency"/>
Note: Setting this value to "0"
will still check reminders when a user first logs in. To disable this feature completely, update the key="EnableReminderCheck"
.
"false"
will disable reminders system-wide.<add value="true" key="EnableReminderCheck"/>
Note: With this feature enabled the key="ReminderCheckFrequency"
(by default set to "1" minute), can be updated to improve system performance.
Warning: Performance can be slowed for user's with a large number of address books or contacts with this feature enabled.
<add value="true" key="EnableExistingContactCheck"/>
<add value="true" key="EnableLiteMailInSession"/>
Note: Keeping this configuration "enabled" improves paging for users with large mailboxes.
View Messages [Tab] > Read Receipt Action will no longer be displayed and
Composing Messages [Tab] > Request a read receipt for all sent messages will no longer display.
<add key="EnableReadReceipts" value="true"/>
Note: Setting this value to "false"
will disable all Read Receipt functionality, although the Web and Console Administration will still display the User Options.
Remember Email / Password - Hide
"Remember My Email Address"
and "Remember My Password"
options on the Web Client login page, forcing users to manually enter their email address and password for every login. key name is as follows:
<add key="HideRememberMeOptions" value="false"/>
Note: By default, this setting is set to "false"
"false"
will disable reminders system-wide.<add value="true" key="EnableReminderCheck"/>
Note: With this feature enabled the key="ReminderCheckFrequency"
(by default set to "1" minute), can be updated to improve system performance.
Reminder Checking - Frequency Change
<add value="1" key="ReminderCheckFrequency"/>
Note: Setting this value to "0"
will still check reminders when a user first logs in. To disable this feature completely, update the key="EnableReminderCheck"
.
"Do you want to escape these characters?"
prompt to appear. It is not recommended that these values be changed.<add value="{}()|*+,.:[]^$" key="RulesSpecialCharacters"/>
<add value="true" key="EnableRssFeeds"/>
Note: See Web Client Features to Disable below for more information.
None, SSL, StartTLS
. A blank value here is the same as "None"
Note: The SMTP server must be set up to allow SSL
or StartTLS
if either option is chosen, otherwise sending a message will result in an error. -->
<add value="none" key="SmtpSSLOption"/>
<add value="25" key="SmtpPort"/>
<add value="newmail.wav" key="EmailSoundFile"/>
Switch to Full Web Client - Disable
<add value="true" key="EnableLiteFullSwitchLink"/>
<add value="false" key="DisplaySystemMessageAsPopup"/>
"<appSettings>"
node of the "iclient.config"
file, change the value for the following "TabLimit"
key:<add value="10" key="TabLimit"/>.
Warning: Opening too many tabs will adversely affect the performance of the browser.
To disable this feature and allow unlimited tabs, set the value to 0.
Important: Setting "TabLimit" to "1" will automatically close the previous open tab when a new tab is opened.
Note: The "TabLimit"
setting affects all Web Client users.
<add value="25" key="MaxMonthViewTaskItemsPerDay" />
Note: Unlike appointments, a "View More" link is not available. The user will have to switch to Day view manually to view all tasks.
Tasks / Appointments Notes Saved as RTF
"False"
setting with default formating to "Plain Text".Note: Outlook requires this data to be in RTF format for synchronizing with your IMail Collaboration Client.
<add value="true" key="EnableSaveTaskApptsBodyAsRTF"/>
"enable theme changes"
"is set to "false"
.<add value="Default" key="DefaultTheme"/>
<add value="true" key="EnableThemeChanges"/>
<add value="true" key="EnableAdminLink"/>
Example: To allow only Calendaring, the IMail Administrator must enable the Personal Information Managers and then disable all the unwanted features displayed below.
<add value="true" key="EnableAppointments"/>
<add value="true" key="EnableMeetingRequests"/>
<add value="true" key="EnableNotes"/>
<add value="true" key="EnableTasks"/>
<add value="true" key="EnableRssFeeds"/>
<add value="true" key="EnableSaveTaskApptsBodyAsRTF"/>
"false"
will disable reminders system-wide.<add value="true" key="EnableReminderCheck"/>
Note: With this feature enabled the key="ReminderCheckFrequency"
(by default set to "1" minute), can be updated to improve system performance.
<add value="true" key="EnableForwardTo"/>
<add value="true" key="EnablePasswordChange"/>
Note: In addition to being enabled here, Anti-spam must be installed and licensed on the IMail Server for the button to appear.
<add value="true" key="EnableSpamReporting"/>
<add value="true" key="EnableAltFromAddresses"/>
<add value="true" key="EnableUsageChart"/>
<add value="true" key="DisplaySystemMessageOnLoginPage"/>