WebMail is based on template technology which allows for very easy customisation of the look and feel of your web email service. There are many different ways of configuring WebMail to suit your needs but the most used and recommended methods of customising the WebMail look and feel with surgemail are listed below, with pros and cons :-) For some samples of the webmail template sets see https://netwinsite.com/surgemail/templates.htm and http://netwinsite.com/webmail/gallery/index.htm.
For customizing templates other than the WebMail templates (e.g. user self admin or SurgePlus templates) see http://netwinsite.com/surgemail/help/templates.htm.
WebMail has a limited set of predefined variables that allow you to rebrand key WebMail functions without needing to modify the templates.
The following can be modified:
- WebMails display name and window title (cust_display_name, cust_title)
- Logo displayed in topleft of panel template window (cust_logo_url)
- Logout URL (cust_logout_url)
- Pane background colours and images (cust_panel_bgcolor, cust_panel_menu_bgcolor, cust_panel_fldbar_bgcolor cust_panel_menu_background, cust_panel_fldbar_background )
- Display of custom links (cust_no_surgemail_links, cust_no_pgp_links, cust_no_admin_links)
This can be done on a per vdomain
basis by adding these to vhost sections in surgehost.ini
This can be done on a global basis using the WebMail manager interface. The global settings are stored in the file custom.dat and override any per domain settings.
- You will not not lose your rebranding when you install template updates
- Rebranding is limited to the predefined rebranding settings
If the above is not enough or you want a different template set for each vdomain this can be achieved by installing a different template set (images and template files) and setting the path to this template set on a per vdomain basis in webmail.ini as below. You will need to either copy the panel template set or download another template set from http://netwinsite.com/surgemail/templates.htm (or a WebMail distribution)
Note: You should not have any global "tpl_set # ..." lines defined in this case as these global templates would be available for each vdomain. You can of course define multiple template sets for each defined vdomain using the following syntax:
tpl_set 1 E:\surgemail\webmail\panel /nwimg/mail/panel Panel Set (Panel)
tpl_set 2 E:\surgemail\webmail\marble /nwimg/mail/marble Marble Set (Marble)
tpl_set 3 E:\surgemail\webmail\mydomain2.com /nwimg/mail/mydomain2.com Custom Set (Custom)
- You have complete control over the content and layout of your templates
- You will not get your templates upgraded to include fixes and new functionality by the SurgeMail installer
If you have a template set for each domain you can customise the login page by editing the login.tpl file.
Alternatively you can setup a login from your own arbitraty page by using a login based on the following HTML form. You would typically set this up on your main webserver or you could modify the surgemail/web/index.htm file. (note: To make this work "no_tcode true" should be defined in webmail.ini)
<html><head><title>Some arbitrary page</title></head>
<body> WEBMAIL LOGIN
<form action="http://mydomain.com:7080/scripts/webmail.exe" method="post" name="login">
<input type="hidden" name="frames" value="true" />
User:<input type="text" name="user" value="" > (full username eg firstname.lastname@example.org) <br>
Password:<input type="password" name="pass" value="" > <br>
<INPUT id=quick_login name=quick_login type=submit value=Login>
SurgeMail is distributed with one one templates set. Currently we are setting up a page for downloading a variety of template sets - if you have one you would like to share please let us know :-)
Alternative template sets can be downloaded for free as possible starting points for your own system. These are currently distributed as three template sets available with surgemail. Further information (slightly historic) on customising WebMail can be found in the online version of the WebMail manual - Section Templates.
SurgeMail web interface is based on the same flexible template technology. However there is normally less need for this.