DOCUMENTATION - NT README  11/02/98

Account Manager LITE 1.0x - by
CGI Script Center (cgi@elitehost.com)

http://cgi.elitehost.com
===============================

Account Manager LITE is designed to offer
Membership Management for your online business or enterprise.

This Shareware release to ensure your satisfaction.

Features of Account Manager:

* Automated User/Member signup
* Administration approval/denial control panel
* Automatic addition/deletion to .htpasswd/.nsconfig files
* Confirmation e-mail sent
* Form fields checked for completion
* Account Finder for lost Username/Passwords
* Customizable Header and Footer information, to match your
website theme and graphics
* And much more

#################################################################
# VERSION INFORMATION
#################################################################
## Version 1.01 - Bug Fix - 05/31/98
# Left an extra mailing routine in the accntman.pl file by mistake.
# It was sending those that signed up two sents of confirmation
# messages.  Removed the extra mailing routine.
#
# Version 1.02 - Bug Fix - 06/08/98
# "Denied" email text not properly being read thus not being
# posted to the email text sent to denied applicants. Bug squashed.
#
# Version 1.03 - Bug Fix - 11/02/98
# When trying to approve or deny individuals, using the DETAILS
# portion of the amadmin.pl program, every waiting account was
# approved or denied, respectively.  Bug found... squashed.
#
# It appears the checking routines we were using were confusing
# some email addresses and passwords, thus causing members with
# similar passwords and email addresses to have problems.
#
# We have rewritten the entire checking system, and make it very
# specific.  Bug squashed.
#
# We also had a problem with users using multi-word usernames.
# We've added a checking routine that will notify the user that
# if they would like a multi-word username, they will need to use
# a dash or underscore between words.  Bug squashed.
#
# Created only one page of configurations, now called config.pl.
# You no longer need to edit anything in either the acctman.pl
# or the amadmin.pl files, except for the "require" line
# near the top of each script.  This tells the programs where
# to find their configurations.
###############################################################
# SETUP INSTRUCTIONS
###############################################################

Open the "config.pl" file in any text editor and
read the setup instructions in the areas marked for user editing:

Edit these configurations (in the config.pl file):

# Add your BODY tag information, like background graphic, color, etc.
$bodyspec = "background=\"\" bgcolor=\"#FFFFFF\" link=\"#0000FF\" vlink=\"#0000FF\"";

# Add your own graphics, text, links, etc., to the top of your pages.
# Give the full directory path to your header.txt file.  DO NOT include
# the header.txt file in the path here, just the directories.
# $header = "/full/path/to/directory";
$header = "";

# Add your own graphics, text, links, etc., to the bottom of your pages.
# Give the full directory path to your footer.txt file.  DO NOT include
# the footer.txt file in the path here, just the directories.
# $footer = "/full/path/to/directory";
$footer = "";

# Edit the font colors of the text on the help and error screens that
# users will see.  This is helpful if you add a background color or
# graphic.
$fontcolor = "#000000";

# Type the name of your organization, group, or company
$orgname = "Account Manager Demo";

# Type an email address that customer/user can respond to
$orgmail = "cgi\@elitehost.com";

# Type a full path for a temp directory that BLAT Mail can use
# as well as store other temporary files
$tempdir = "/full/directory/path/to/temp";

# Type the full path to your Mail program
$mailprog = "/usr/bin/sendmail";

# Here you can create the text message that the potential
# new members/user will receive in the email once they fill
# in your web form.
# Place the information in a text file
# and save the file as: email.txt
# Place the full path to the email.txt file (if any) here.
# DO NOT place the name of the file (email.txt) here, just
# the directory path where the file is kept.
$closing = "c:/full/directory/path/to/info";


# This would be the suject of the Aproval email the user will
# receive if you have Instant Access on.
$response_subject = "Application Received";

# If you use .htaccess or .nsconfig, use a "1", otherwise leave blank
# or set to "0".  This is if you use a secure users area.
$htaccess = "1";

# If you entered "1" above, enter the full path to your
# htpasswd or .nsconfig file.
# Like this: $memaccess = "c:/full/path/to/.htpasswd";
# This is the file that houses the usernames and encrypted passwords
# but is only needed if you use .htaccess or .nsconfig
$memaccess = "/full/directory/path/to/info/.htpasswd";

# Type the full path to the database file that contains all the info
$memberinfo = "/full/directory/path/to/info";

# If you are run the script and receive File Locking (flock)
# errors, remove the number 2 from between the quotes.
# Then it would appear: $LOCK_EX = "";
$LOCK_EX = "2";



# Give the full directory path where you would like your password.txt
# file to be saved.  DO NOT include the name password.txt in the path
# here, just the directories.  $passfile = "/full/path/to/directory";
$passfile = "/full/directory/path/to/pass";



# Type the subject that will appear in the email customer/user
# receives
$subject = "ABC Member Info";



# Create two text files.  One called "approved.txt" and the other
# called "denied.txt".  In each, write the response that you would
# like your prospective members to receive when you have either
# approved or denied their application for membership, respectively.
# Then, upload both text files to your $memberinfo directory.
# The script will do the rest.
# Example, in the "approved.txt" file, you can type:
# "Your account is now active."


# Subject of email that is automatically sent to users that you
# chose not to accept in your Account Manager.
$denied_email_subject = "Application Denied";

# Subject for email that is automatically sent to users that you
# chose to accept in your Account Manager.
$approved_email_subject ="Application Approved";

#################################################################

Once you've edited the configurations above, open your acctman.pl
and your amadmin.pl files in any text editor.  Look for this section
near the top of each script:

##############################################################
# EDIT THE VARIABLES BELOW ###################################
##############################################################

require "/full/directory/path/to/config.pl";

##############################################################
##############################################################

Change the path to the full directory path to where you have
uploaded your config.pl file, then save and upload the file

Be sure that the very first line in each script points to your
server's Perl 5 distribution of Perl.  The default for most
web servers is already place there:

#!/usr/bin/perl

Yours may vary, so contact your server administrator to be sure.


We have included a sample form that is ready to be used by Account
Mangaer, called:  amform.htm.  Feel free to use this form as is
or remove any variables that you do not want included.

Make sure to set the amform.htm to POST to the accntman.pl file.
The accntman.pl file is the program that accepts the input and
checks for completed form fields, etc.

Any Input variables that you remove from the form should be replaced
with Hidden Input variables, since the program is designed to check
for any areas that are not properly filled in by the user/customer.

A Hidden Input variable would appear as:

<INPUT TYPE="HIDDEN" NAME="accounts" VALUE="one">

If you chose to create your own website form for Account Manager, be
sure to use the same field names and values!  Account Manager is
designed to use the field names and values that came with our
example form.

The amadmin.pl file is your Administration Control Panel, to accept
or reject potential new users to your private directory, and maintain
their accounts.

Post your questions, comments, and upgrade ideas at any of our
user bulletin boards located at:

http://cgi.elitehost.com

Enjoy!

Diran Alemshah
CGI Script Center
http://cgi.elitehost.com