MailWebForm 0.9: Description

MailWebForm 0.9

webbased mail sending for unlimited implementations and skins

Site Content:

MailWebForm allows you to send an e-mail from a web site. It processes a HTML form, composes an e-mail - optionally by processing a template - and delivers it.

A great feature is MailWebForm's spam protection: The recipient's address is not specified in the HTML form; MailWebForm uses a well protected mechanism (property files) to get the mail's destination. Of course flexibility and ease-of-use are MailWebform's design goals.

MailWebForm accepts three levels of parameter input: A global property file, user property files and HTML form input. The setup is easily done through a administration web site.

It uses Java Servlet API (version 2.2+ required), Java Mail API (version 1.3+) and JRE (version1.3.1+).

Quick Installation Notes:

Install an open source servlet runner like Apache Tomcat or Mortbay Jetty or a commercial one.
Create a directory that acts as MailWebForm's config directory (hence referred to as "<configdir>"). The servlet runner, i.e. the user that runs it, must have write access to this directory, but it shouldn't be accessible for someone else (except the administrator, of course). Copy the files included in the distribution's config directory to this new directory.
Configure your servlet runner to have a JVM start-up option named "mailwebform.configdir" that points to the new <configdir>. See More detailed installation information, if you don't know how to do this. Restart your servlet runner.
Configure your servlet runner to have a context for MailWebForm (e.g. "mailwebform"), pointing to the mailwebform.war file of the binary distribution file. Alternatively, you may copy the mailwebform.war file to the servlet runner's deploy directory. See More detailed installation information, if you don't know this directory, or refer to the servlet runner's documentation.
Open admin.html in your browser (through the servlet runner's web server and the above configured MailWebForm context, not by just dragging it into the browser!).
Enter a login name and a password and log in. Because this is the first time the admin tool is accessed, the admin password file (named <configdir>/mailwebform.credentials) is generated, and you should see a message box that confirms the creation of this admin account, in case JavaScript is activated.
To reset the admin account, delete the password file and log in to the admin tool again.
Configure the provider(s). For the description, see How to set up providers.

How to access MailWebForm (examples for the default ports of Tomcat and Jetty):

Connect with a web browser to

http://<YourHost>[:<ServletRunnerPort>][/<yourContext>/], e.g.

http://myserver.anywhere.com:8080/mailwebform/index.html or
http://myserver.anywhere.com:8080/mailwebform/mailwebformservlet

for the default mail send form implementation or e.g.

http://myserver.anywhere.com:8080/mailwebform/admin.html or
http://myserver.anywhere.com:8080/mailwebform/adminservlet

for the AdminTool.

License:

Copyright (c) 2001 - 2005 by All Time Flash Dreamer Ltd.
MailWebForm comes with ABSOLUTELY NO WARRANTY.
This program is free software; you can redistribute it and / or modify it under the terms of GNU General Public License as published by the Free Software Foundation; either version 2 of the license or (at your option) any later version.
This program is distributed in the hope that it will be useful but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the
Free Software Foundation, Inc., 675 Mass Ave, Cambrigde, MA, 02139, USA.

This software is not fully tested and not claimed to work properly.
You take the full responsability of any hazard, wanted or unwanted result this software may produce. By executing the first bit or more of MailWebForm you accept this license and get liable to the full extend of what ever follows!

Download source:

Download the software from:

ftp://ente.limmat.ch/pub/software/servlets/MailWebForm/