##############################################################################
# The Ultimate CGI Bin Scripts | http://www.tucb.com #########################
##############################################################################
##############################################################################
# MailList | Version 1.2 #####################################################
##############################################################################
# Copyright (C) 1997, 1998 By Chase Venters. You may use these scripts for  ##
# free. You may also distribute these scripts freely, as long as they are   ##
# kept intact, and I get proper credit for the script's creation. If you    ##
# use this script in internet games, or large products, please include my   ##
# name and e-mail address in the proper area in your credits, listed as     ##
# CGI Programmer or such. I assume responsibility for none of any liability ##
# issues that may arise from this script's use. If you have trouble working ##
# with these scripts, contact "chase@popi.net". It is HIGHLY recommended    ##
# that you register for the mailing list, at least under the bug reports/   ##
# security concerns categories. If you do not, you may never know when a    ##
# corrected version of the script is released!                              ##
##############################################################################
# Read README for information on this script's configuration. ################
##############################################################################

# ReadMe.txt file #

Table of Contents
-----+------+-----
1) What does MailList do?
2) How to Install & Configure MailList
3) Usage of MailList
4) Other Uses
5) History


-=1=- What does MailList do? -=1=-
    MailList allows you to create and maintain an email mailing list.  Users
can add and remove themselves from the list. MailList 1.2 supports multiple
topics within a single list. Users select topics they are interested in.
When you send messages, you check the blanks it relates too, and the appropriate
users receive the email.

-=2=- How to Install & Configure MailList -=2=-
You should first become knowledgeable with configuring TUCB CGI. Such a tutorial
is located on the website. Below is a list of what each setting means.  You
should set the script up in the fashion discussed in the CGI How-To.

Option           +  Description/Value
-------------------------------------
$locking         If the system supports locking, set to 1, otherwise, set to 0
$url             The URL to your homepage, used in notification messages
$maillistname    The mailing list name/email address.  For example,
                 Cool <cool@mail.com>
$dir             The directory where the data & success files are located
                 ** UNIX DIRECTORY ** Don't put a URL here
$data_file       The name of the data file
$sendmail        The full unix path to sendmail
$allow_adver     1 if the script is allowed to put its footer (your nice
                    if you leave this on; it says MailList and my URL ;O)
$success_file    The success HTML template file
$sendpw          If something is put here, MailList will not send out any
                 messages unless the send form has this password in it.
$enable_remove   If users are able to remove email addresses.
%msgnames        The categories followed by the names of the categories

    Once this script is configured, you should proceed by doing the following
steps.  First, open the HTML template file. Edit it however you like, $message
will be changed to whatever MailList has to say. In each of the HTML files
you wish to use, change the
<form action="/url/to/maillist.cgi" method="post">
to refrence the path to MailList. 

-=3=- Usage of MailList -=3=-
    Use the HTML files provided!  The register.html file contains forms that
can be used to add/remove an email address from the list.      

+- Adding Categories -+
1. Open the script and edit in the new categories, giving it a new
"identifier", NO SPACE, and a title.
2. Edit the HTML files, include checkboxes to refrence them.
3. Re-upload it in ASCII.

-=4=- Other Uses -=4=-
To be quite honest, I don't have any ideas, or have seen anything.

-=5=- History -=5=-

(8/12/98) Upgraded to version 1.2
* Fixed -=MAJOR=- bugs
* Re-tested script
* Changed all the www.stormer.com/tucb's to www.tucb.com :)

(6/13/98) After a long wait, uploaded it

(4/10/98) Upgraded to version 1.1
* Fixed Bugs
* Tested script
* Added multiple topic capability