cgi-mailer: an easy to use form-to-email gateway

 [cgi-mailer]

Administrator Documentation

Contents


Requirements

cgi-mailer requires perl 5.001 or later and the LWP module. See the Perl Home Page for information on how to get perl and/or how to get the LWP module.

If you want to use Mail::Send or Net::SMTP instead of sendmail to deliver the email, then you will need to get the MailTools or libnet modules, respectively.

cgi-mailer has been tested under Unix, and may work on other systems such as MacOS or Windows NT. Please email me with any information on changes needed to get cgi-mailer running on other systems.


Obtaining cgi-mailer

cgi-mailer source is available in the following formats:

unix tar:
ftp://www.unimelb.edu.au/pub/www/tools/unix/cgi-mailer/cgi-mailer-1.9.6.tar (80k)
unix tar, compressed:
ftp://www.unimelb.edu.au/pub/www/tools/unix/cgi-mailer/cgi-mailer-1.9.6.tar.Z (31k)
unix tar, GNU zipped:
ftp://www.unimelb.edu.au/pub/www/tools/unix/cgi-mailer/cgi-mailer-1.9.6.tar.gz (15k)
pkzip:
ftp://www.unimelb.edu.au/pub/www/tools/unix/cgi-mailer/cgi-mailer-1.9.6.zip (24k)

Because some users have reported difficulties in retrieving cgi-mailer by ftp, due to slow internet links, I have created an autoresponse system where the cgi-mailer distribution can be mailed to you.

To obtain cgi-mailer via email, send a message to auto-mailer@www.unimelb.edu.au with no subject, and the following line (exactly) in the body of the message:

send <filename>

where <filename> is one of the filenames above (e.g. cgi-mailer-1.9.6.tar.gz etc.)


Installation & Configuration

After you obtain the source, open cgi-mailer.pl in your text editor. You'll need to set the variables for the location of sendmail (unless you have the MailTools module installed), the location of your logfile and your local domain if you wish to restrict use of cgi-mailer to those within your organisation. You may need to change the invocation line (the first line in the file) to reflect the location of perl on your system.

Once you've set the configuration variables, copy cgi-mailer.pl into your cgi-bin (or similar) directory. Make sure the permissions are set to read and execute (chmod a+rx cgi-mailer.pl). You should be ready to go. There is a sample HTML form in the test directory of the distribution that you can use to check that everything is working. Be sure to put your email address in the appropriate place in the form before using it.

Note: If you are using Windows 95 or NT, Apply the instructions above to the file cgi-mailer.bat in the Win32 subdirectory of the distribution.

You should make a local copy of user-doc.html from the distribution, and change all instances of your-local-host to the hostname where you have cgi-mailer.pl installed (and remove the <i> tags). You can then give your users the URL of the local copy of the user documentation.


Please report any bugs, suggestions or corrections to gleeson@unimelb.edu.au.


Created:       23 April 1996
Last modified: 28 February 2000
Access:        Unrestricted.
Copyright © 1996-2000 Martin Gleeson.
<URL:http://www.unimelb.edu.au/cgi-mailer/admin-doc.html>

Martin Gleeson, gleeson@unimelb.edu.au

HTML 4.0 Checked!