SurgeWeb is setup for easy customisation of the basic look and feel of the interface, and basic rebranding of the interface. There is an customisation interface built in to SurgeMail that allows customisation to be done at the following levels:
Reloading surgeweb interface and domain customisation disable
Customisation is applied "over the top of" the existing interface. This means it the core templates should not need to be modified and surgemail upgrades remain straight forward. If there are any interface problems it is possible to use a single domain setting to completely disable customisation on a domain for easy troubleshooting.
In the customisation interface the colour of the 'combined value' of any setting shows at what level it has been customised. For any particular setting the "deepest" level will win. So domain will override global and group will override domain.
global | domain | group |
The documentation below shows current surgeweb operation, but everything documented here is still under development and thus subject to change.
Login page Appearance - A single css file allows complete customisation of the login page. 3 Examples are provided and your own css file can be specified.
  | |||
default | like old smooth | like old panel |   |
default + blue buttons | dune | loud | kevin |
To add your own skins, add these to surgeweb/custom/skins/ directory (surgeweb 5.0j-10+) - you can start with example and modify as needed.
Ajax 'panel look' - The panels of the Ajax interface can be setup to have gaps between them and have slightly rounded or square corners:
default | narrow | wide | none |
default | custom | text ads | image ads |
Much of the interface can be rebranded as required using the basic rebranding settings.
Login title - Main login page email service title
Login page end comment - Comment on the bottom of the login page
Logo image - Logo image as displayed on the main email interface
Info panel - Additional panel for custom messages
Footer text - Text in the footer line
Browser titlebar - Browser page title bar
title | comment | logo | footer | info panel |
login screen | mail screen |
  |   | ||
popup windows | tabbed windows |   |   |
  | |||
preview normal | preview widescreen | no preview |   |
Default folder names - Surgeweb will choose the first found of several default folders for the Draft, Sent and Trash folders.
The actual folder used can be set instead to a fixed folder.
Surgeweb has the facility to extend the default surgeweb behaviour using a custom css and a custom javascript file.
These are advanced features for developers only and are still subject to be changed. However an example of extension is included
which displays scrollable wikimapia maps in a custom pane in the left hand column:
Example extension - Enable / disable wikimapia extension - this also enables the extension css and extension javascript if
they are not already enabled.
  |   |   | |
Example extension |
You can use a form on your own arbitrary web page to login to surgeweb directly. You need to pass these form fields: "username_ex", "password" and "interface_ex".
eg.
<html><head><title>Some arbitrary page</title></head> <body> SURGEWEB LOGIN SCREEN <form action="http://mydomain.com/surgeweb" method="post" name="login"> User:<input type="text" name="username_ex" value="" ><br> Password:<input type="password" name="password" value=""><br> <INPUT id=cmd_login name=cmd_login type=submit value="Log In"> <!-- need to pass in interface eg fixed as "ajax" or via selection (ajax does not work on some browsers) <select name="interface_ex"> <option value="ajax">ajax</option> <option value="html">basic</option> <option value="mobile">mobile</option> </select> --> <input type=hidden name="interface_ex" value="ajax"> <!-- Optional pass in the domain to login as - normally identified from url <input type=hidden name="domain_ex" value="mydomain.com" --> </form> </body></html>The above will work regardless of url, provided the form gets directly submitted to surgeweb from the browser. If instead you wish to setup surgeweb as part of a central login service (generally on a url separate to the surgeweb host name) this is documented on the clustering page.
The following account management links can be added to the surgeweb login page, by manually adding these settings to config_*.dat files. (surgemail 5.0j-9+)
# Forgot password link showlink_forget_pass true # New account creation link showlink_create_account true # Custom help link showlink_login_help true login_help_link http://myserver.com/myhelp/pages.htm