It is a Java servlet allows you to support web-based
private mail service including mail-lists. So all mail (private, and mail lists)
will be saved and distributed within your server. This servlet offers user
interface to read/send mail, create and maintain mail lists etc. In other words
it is a special forum (message board) where the interface is organized
like e-mail package. So this servlet is yet another way to create your own community
(see also for example our discussions or forum servlets).
WebMail supports local mail stores but you can also forward (send) messages to external addresses. So for any address contains @ package will send letter to this external address.
How to use it:
a) copy webmailPackage.jar into your WEB-INF/lib directory.
b) define servlet in your web.xml file. In order to run this servlet you have to set two initial parameters:
- configuration file (is mandatory). Parameter name is 'config'
- administrative password for mail-lists. Parameter name is 'admin'
c) describe a mapping for this servlet in web.xml. E.g.:
the usage is:
The rest of that is standard as for any another mail package. Each user must sign in and setup own name and password. This user name is user's address within the WebMail scope. Mail lists can be created in the so called administrative mode (see below).
Configuration file is a text file, each line describes one parameter in the form of
Empty lines and any line starts with # or // are ignored. Current version supports the following list of parameters:
# webmail config
# login screen background (default value is #FFFFF)
# login screen foreground (default value is #000000)
# login screen font size (by default is current font)
# login screen font face (by default is current font)
# mail screen left frame background (default value is #FFFFF)
# mail screen left frame foreground (default value is #000000)
# mail screen left frame font size (by default is current font)
# mail screen left frame font face (by default is current font)
# mail screen right frame background (default value is #FFFFF)
# mail screen right frame foreground (default value is #000000)
# mail screen right frame font size (by default is current font)
# mail screen right frame font face (by default is current font)
# frames settings. Default value is 20%,80%
# border settings. Default value is 1
# enable/disable frames resize. Default value is 1 (enable)
# base dir (data srote). This parameter is mandatory and describes
# any existing directory on your server
# or for Win 95/98/NT some like dir=c:\my_path
# title (default walue: WebMail)
# date format (0 : Month/Day, 1: Day/Month, default value is 0)
# localization support. In case of your servletrunner can not support by
# characters (you will see ?), you can set here explicit characters encoding
# for input parameters. Default value is ISO-8859-1
# logo. You can add your own logo for the login page. File you set here
# can contains any html code. By default this value is empty.
# header. You can set here some file contains any html-code. This code
# outputted at the beginning of the each page. So you can set for example some banners or CSS styles.
# By default this value is empty
# footer. You can set here some file contains any html-code. This code will be
# outputted at the bottom of the each page. So you can set for example some
# banners. By default this value is empty
# external mail settings
# port. Default value is 25
# domain. Local domain settings. External mail will be sended from user_name@domain
# Default value is localhost.
More about the usage
1. For running WebMail in the administrative mode (create/delete mail lists)
use your admin password:
In case you did not set any password in the properties file default
password is 'welcome'.
2. You can bypass system initial screen. Just use the following:
a) for direct access to login screen
b) for direct access to signup screen
3) You can create you own form for login procedure. You have to post
to this servlet two values: user name and password. Fields names are:
wmu and pwd
4) You can create you own form for signup procedure. You have to
post to this servlet three values: user name and password (twice). Fields names are:
wmu, pwd, pwd1
For downloading: webmailPackage.jar
Sample of configuration file: mailconf
© Coldbeans Comments?
See also JSOS - the largest collection of servlets and filters.