Full Customization
Mailtraq gives the Administrator access to the ASP pages that present webmail to the User. It is possible to modify these pages to change the look and behavior of Mailtraq webmail.
These are found by default at C:\Program Files\Mailtraq\Webmail
Read more about this topic here.
Simple Customization
Many Mailtraq users don't need to fully customize their builds of WebMail - they just want to make a few adjustments.
Here are the most common customizations.
Got questions? Get answers in the Support Forum here.
When doing Customization, Mailtraq must be shut down. We always suggest that you take a safety backup copy of the entire Webmail folder before you do any customizations, so that if you make a mistake, you can easily restore Mailtraq to its previous state. It is also good practice to make a separate backup copy of any files that you modify in case they are over-written by a general upgrade you might undertake in the future.
Before making any changes always:
Shut down Mailtraq.
Take a backup copy of the folder:
C:\Program Files\Mailtraq\WebMail
Then go to the file and make the change and save.
Restart Mailtraq.
Can I replace the Mailtraq graphics and login texts with our own?
Standard Webmail Graphics:
Identify the graphics you want to replace by right-clicking on the image and selecting 'Properties'. Then simply replace the image file in C:\Program Files\Mailtraq\Webmail with your own graphic of the same size. Make sure you call it the same file name.
EWA Webmail Graphics:
See the Webmail Administration page.
Webmail Texts:
The webmail texts are held in C:\Program Files\Mailtraq\WebMail\lang and
C:\Program Files\Mailtraq\WebMail\ewa\lang The English texts are in en.cfg,
and the other languages are in the same folder.
Simply replace the text string with the wording of your choice, and save the change.
For example: the welcome text is:
strLoginTitle=Welcome to Mailtraq WebMail
which could be changed to
strLoginTitle=Welcome to My Company's WebMail
Can I automatically log in to my Webmail Inbox?
You need to think carefully about the security implications of this, but if it is right for your environment then you can create a desktop shortcut with this format (one line with no breaks):
Standard Webmail
http://mail.mydomain.com/login.asp?user=mailboxname&password=password&btn_login=submit
EWA Webmail
http://mail.mydomain.com/ewa/login.asp?user=mailboxname&password=password&btn_login=submit
Can I change the login default when using IE6/7 ?
If webmail detects that IE6/7 is being used it will automatically offer Enhanced (EWA) webmail and set that to be the selected version at the login page. You can prevent your users from accessing Enhanced/EWA webmail at all from the Webmail Administration page, but if you just want to change the default option you can make this change to the code:
In login.asp find the code below and change "1" to "0"
Code: var co = Request.HasField("ewa") ? Request.Fields("ewa") : "1";
Can I modify the Previous - Next button actions?
In Standard webmail what do [Next] & [Previous] mean ?
Mailtraq starts with the latest message, so that 'Next' means an older message.
Previous will mean a younger message.
Mailtraq follows the Outlook convention in this regard.
If you want the action to be inverted you can make the following modification.
Tip: Make a backup copy of viewmsg.asp before you start, and watch your line breaks.
Find (in viewmsg.asp)
if (Request.HasField(BUTTON_PREVIOUS)) {
mid = mailslot.GetPreviousMessage(mid,
Session.Get(FIELD_CURRENTFOLDER),
Session.Get(FIELD_MESSAGEFILTER));
}
if (Request.HasField(BUTTON_NEXT)) {
mid = mailslot.GetNextMessage(mid, Session.Get(FIELD_CURRENTFOLDER),
Session.Get(FIELD_MESSAGEFILTER));
}
And change to
if (Request.HasField(BUTTON_NEXT)) {
mid = mailslot.GetPreviousMessage(mid,
Session.Get(FIELD_CURRENTFOLDER),
Session.Get(FIELD_MESSAGEFILTER));
}
if (Request.HasField(BUTTON_PREVIOUS)) {
mid = mailslot.GetNextMessage(mid, Session.Get(FIELD_CURRENTFOLDER),
Session.Get(FIELD_MESSAGEFILTER));
}
Can I make the Calendar be the default view?
Standard only:
Yes - you must modify a page in the Mailtraq folder C:\Program Files\Mailtraq\Webmail
In the file: login.asp
replace "browse.asp" with "calendar.asp"
Will the Calendar view refresh itself?
Standard only:
The calendar-view does not automatically refresh like the email-view does.
Should you wish to do so:
In the file: calendar.asp
add the line
Response.AddHeader("Refresh", "400; URL=calendar.asp");
right before
if (Request.HasField(BUTTON_PRINT)) {
to make it refresh. Reduce 400 to the number of seconds you want.
Can I disable Password changes?
Builds from 1822 have this feature in WebMail | Admin (which honors the User Privilege in the Console).
+++
Older Mailtraqs can be adapted by making this change:
In pwdchng.asp find the line
<% if (Session.Get(FIELD_USER) == "") Server.Transfer("login.asp"); %>
and add, after it,
<% Server.Transfer("options.asp"); %>
which will disable password changes.
So, shut down Mailtraq.
Take a backup copy of the folder:
C:\Program Files\Mailtraq\WebMail
Then go to the file calendar.asp and make the change above and save.
Restart Mailtraq.
Can I suppress the Public /Personal preference on the Login page?
Edit the login.asp page -- it is very easy to read.
Just find the lines
<P><%= RAD("usecookie", "0", null, "<@strPublicComputer@>") %>
<BR>
<%= RAD("usecookie", "1", ((Request.Fields("usecookie") != "0")
?
"1" : "0"), "<@strPrivateComputer@>") %> </P>
and remove them
Can I adjust how frequently webmail updates (to display new mail)?
The default is 5 minutes, and it is set in "browse.asp" in this line:
setInterval("window.location.href='browse.asp'", 300000);
There is a fallback setting earlier, which is
Response.AddHeader("Refresh", "400; URL=browse.asp");
This is used where scripts are disabled, but is less reliable.
All about Customizing the Address Book
You will also need to prevent your users from accessing Enhanced/EWA webmail from the Webmail Administration page.
Can I suppress the Global Address Book?
Yes, by removing the following line
| DISBOOK_GLOBAL + "\t<@strGlobalContacts@>\t" +
from contacts.asp
So, shut down Mailtraq.
Take a safety backup copy of the folder:
C:\Program Files\Mailtraq\WebMail
Then go to the file contacts.asp and make the change above and save.
Restart Mailtraq.
Can I sort Contact by Department in the Address Book?
Yes, in contacts.asp you will find a line
| var sorting = Toolkit.FirstNonBlank(Session.Get(FIELD_CONTACTSORT),DIS_COMMONNAME);
Change "DIS_COMMONNAME" to "DIS_ORGANIZATIONUNIT"
So, shut down Mailtraq.
Take a backup copy of the folder:
C:\Program Files\Mailtraq\WebMail
Then go to the file contacts.asp and make the change above and save.
Restart Mailtraq.
Can I sort entries in the Address Book by Last Name, First Name ?
Yes, the method is to modify contacts.asp :-
To change the sorting, replace
var sorting = Toolkit.FirstNonBlank(
Session.Get(FIELD_CONTACTSORT), DIS_COMMONNAME);
with
var sorting = Toolkit.FirstNonBlank(
Session.Get(FIELD_CONTACTSORT), DIS_SURNAME);
To change the display, replace
Toolkit.FirstNonBlank(Toolkit.DisToHtml(
Toolkit.TabMap(item, map, DIS_COMMONNAME)),
"<I><@strNoName@></I>"),
with
Toolkit.FirstNonBlank(Toolkit.DisToHtml(
Toolkit.TabMap(item, map, DIS_SURNAME) + ", " +
Toolkit.TabMap(item, map, DIS_FIRSTNAME)),
"<I><@strNoName@></I>"),
Remember:-
When making changes to the files found in
C:\Program Files\Mailtraq\Webmail
Mailtraq MUST be shut down first.
Always take a back up of the Webmail folder before making any changes, and be aware that future upgrades of your Mailtraq installation may over-write any customization. In which case you would need to do this again.
