DOCUMENTATION - UNIX README 07/30/2001 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. # # Responses on some flavors of UNIX servers were adding extra # domain names to the name of the mail sender. This was sending # emails to the wrong persons. Switch the Name and the Email # address on the mailing routines to stop this from happening. # # Version 1.02 - Bug Fix - 06/08/98 # "Denied" email text file not being read and thus not printing # on the email of the denied accounts. Bug squashed. # # Version 1.03 - Bug Fix - 06/11/98 # The Account Finder email was not placing the subject in the # subject line. Fixed. # # Version 1.04 - Bug Fix - 08/27/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. # # Version 1.05 - Bug Fix - 11/02/98 # 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. # # Version 1.06 - Bug Fix - 08/23/2000 # Security patch. For obvious reasons, we will not be documenting # the changes made. We recommend anyone using a previous version # updates immediately. # # Version 1.07 - Minor Update - 09/03/2000 # $signupresponse was added to the config.pl file, which defines # the Subject of the e-mail sent the administrator upon registration # singup by a potential member. # # Version 1.08 - Upgrade - 07/30/2001 # By popular request, we've added the ability to customize the e-mail # responses to your members/customers. Simply upload the new script files. # If you are using version 1.07, you do not need to upgrade your config.pl # file. Then upload the three text files, approved.txt, denied.txt, and # email.txt to the $memberinfo directory. Feel free to edit these three # files to suit your needs. ############################################################### # 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 subject of the e-mail your user will # receive automatically once they submit their application $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"; # This is the e-mail Subject for the response that is sent back to # you, the administrator, when a signup request is received. $signupresponse = "Account Manager Lite Signup Response"; ################################################################# 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: 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