##################################################
##  install.txt (C)2005 Wes Blaylock            ##
##################################################
##    Wes Blaylock (http://www.cgitoolbox.com)  ##
##                                              ##
##    		 ClikGate Pro                   ##
##            
## COPYRIGHT NOTICE:				     
##						
##
## Copyright 2005 Wes Blaylock.			
## All Rights Reserved.			           
##						            
## The above copyright must survive all changes
##################################################

Installing ClikGate is very very simple. First, ftp into
your server and create a directory to run CGI scripts.

In this example, we will call the directory "gate" and put
it in our cgi-bin. So it would look like this cgi-bin/gate.

Now create a directory in "gate" and call it "data". It must
be called "data". 

Now you must create 2 directories in "data" called: 

html
mail

Those directory names MUST be exactly like that to work. The only
directory that can be named different is "gate". 

That is all that has to be done to your server. 

Now open admin.cgi, signup.cgi, lost.cgi and link.cgi and make sure the very 
first line is the correct path to perl on your server.

Now upload all .cgi scripts to your "gate" directory and 
chmod them to 755. Upload config.txt to your "gate" directory
and chmod to 777.

Upload exp.txt, members.txt, and temp.txt to the "data" directory
and chmod them to 777.

Now run admin.cgi by typing the full URL to admin.cgi. In our example
above, it would look like this:

http://www.yourdomain.com/cgi-bin/gate/admin.cgi

This will bring you to the login area. Login with the password

admin

Now go to the bottom of the script and click on "Change Settings"
Fill out the form with your correct server information. 

For these questions:
Should ClikGate Check Referrer for Signup.cgi?  
Should Admin Have to Approve Accounts? 

a 1 equals yes, and a 0 equals no. So for the two fields above
you need to either put a 1 or a 0, depending on what options you
want to use.

If "Should ClikGate Check Referrer for Signup.cgi?" is set to 1,
then for "Who Should be the Referrer?" needs to be the reffering
URL that can access the script. This feature is used when somebody
orders, the script checks to see if the referring URL of the person
visiting signup.cgi matches what the admin(you) specified. You can
put your order form URL in here so that nobody can access the 
signup.cgi script unless they order from you.. :)

You can have as many different expirations dates as you want. You
may want to copy the HTML for signup.cgi and put it into an HTML
page to do different plan expirations. Use a hidden form tag such
as:

<input type="hidden" name="plan" value="30">

The form tag name has to be "plan" and the value is how many days
the users account will expire.If you don't want a certan plan to
expire, you just use a 0.

After this form is completed, you should go to "Edit Mail Messages"
and "Edit HTML Messages" to edit the mailings that are sent out and
the HTML that people will see, you can use personalization tags where
defined.

Everytime you log into the admin, you should click the "Purge Accounts"
button to seperate the expired accounts from the active accounts. If
there are any expired accounts, it will send them the "Expired" email
that you created in the "Edit Mail Messages" section.

Troubleshooting:
If you have a problem, you may need to chmod the data directories to 777.
It depends on your server, we didn't have to do it but some servers might
require it.

To use the protection against password distribution feature, you need to
call the link.cgi script using an SSI from the page that people login to. 
Use this SSI tag:

<!--#exec cgi="/cgi-bin/gate/link.cgi" --> 

You put this tag on the page(s) that the members view when they first
login to your password protected directory.

You can copy and paste the HTML code for lost.cgi and put it on any
regular HTML. Members can enter their username or email address and 
have their login information emailed to them!

Thats about it. Send me an email if you have any feature request or would
like to give your opinion on the script. If you send a testimonial, I may
put it on the ClikGate Pro page with a link back to you :)

If you have any suggestions, questions, find a bug, or comments, email me
by going to the contact form at http://www.cgitoolbox.com

Happy Mailings :)
Wes Blaylock
CGI Toolbox
www.cgitoolbox.com
