PerlDomo v.07


Package Files:
        
         File         Perms         Description
        
        mailer.pl   - (755) Handles the actual mailing
        letter.htm  - (644) Sample html file to compose mail
        log.pl      - (755) Add's eMail address to mailing list
        log.htm     - (644) Sample html file to subscribe to list
        email.log   - (666) Log file
        del.pl      - (755) Deletes eMail address from log file
        del.htm     - (644) Sample html page for deleting
        domo.setup  - (666) File containing variables
        temp.log    - (666) Temperary log
        lock.file   - (666) Locking file
        user.dat    - (666) User/Password file
        mkpass.pl   - (755) Sets original username/password for PerlDomo administrator
        mkpass.htm  - (644) html file to set admin's username/password
	readme.txt  -       This file.

Total Files: 14

Installation
-------------

1. Upload all the files. It is recomended that the html files are put into your
   usual public_html directory, perl files in cgi-bin (or comperable dir) and
   the log/data files be put in a new dir (cgi-bin/files).
2. Make sure that all the permissions are set correctly.
3. Make sure that the path to perl, domo.setup, and cgi-lib.pl are how you have them on your server
   in all the perl scripts, and the domo.setup.
   If not, edit it. Default settings are:
        #!/usr/bin/perl
        require "/cgi-bin/cgi-lib.pl";
        require "domo.setup";
4. Configure the domo.setup file (see below)
5. Make sure html form variables are set correctly, assuming you do not use the
   given sample html files. (see below)
6. Make a user name and password. This is done from the mkpass.htm file. This file is only
   needed once (as well as mkpass.pl) and can be removed after using. If you do not remove it, don't
   worry, it will not make any new username/passwords once one is already made. Why only one?
   This is because even if multiple people were to have access to sending mailings, they are still
   having access to the same program. There are no access levels, so one is sufficient. This also,
   helps with security, one username/password is easier to keep track of than many.
7. Subscribe yourself and test it.
8. Send eMail to kmeltz@cris.com to register it and help me track its usage.


domo.setup configuration
------------------------

Because most of the same variables are used throughout the scripts, I felt it would
be easiest to set them once, hence this domo.setup file. The file itself explains
what each setting is used for. If you place the files on your server as suggested
above, there is only minimal things you have to set.

html file form variables
------------------------

del.htm     - The only variable used by the scripts is 'item'. The name of the input which
              asks for the eMail address must be 'item'. (see sample file)
log.htm     - The only variable here is the one asking for the email address. This
              must be names 'email'. (see sample file)
letter.htm  - The textarea for the body of the message must be called 'letter'.
              The box asking for the password must be named 'password', and the box asking
              for a user name must be names 'user_name'. (see sample file)

Support
-------
Please do not send me mail asking for support and saying 'It doesn't work!'. I have tested
this package and it works. If you are having problems, start by making sure the perms are set correctly then make
sure that the domo.setup file is correct. Of course, you should know where to look by the
error, or lack of, you get.

Register
--------
I would appreciate some eMail to kmeltz@cris.com if you are using this package. I will send you
updates that I make, and it will help me track where/how PerlDomo is being used.

Suggestions/Modifications
-------------------------
If you make any modifications to this package that are not user-specific, and you feel that
everyone would benefit from it, please let me know. Also, if you have any suggestions for modifications
and/or enhancements, please let me know.

Thanks!

        
