Web Wiz Guide - Web Wiz CAPTCHA release version 1.0

'****************************************************************************************
'**  Copyright Notice
'**
'**  Web Wiz Guide - Web Wiz CAPTCHA
'**  
'**  http://www.webwizCAPTCHA.com
'**
'**  Copyright 2005 Bruce Corkhill All Rights Reserved.
'**
'**  This program is free software; you can modify (at your own risk) any part of it
'**  under the terms of the License that accompanies this software and use it both
'**  privately and commercially.
'**
'**  All copyright notices must remain in tacked in the scripts and the
'**  outputted HTML.
'**
'**  You may use parts of this program in your own private work, but you may NOT
'**  redistribute, repackage, or sell the whole or any part of this program even
'**  if it is modified or reverse engineered in whole or in part without express
'**  permission from the author.
'**
'**  You may not pass the whole or any part of this application off as your own work.
'**
'**  All links to Web Wiz Guide and powered by logo's must remain unchanged and in place
'**  and must remain visible when the pages are viewed unless permission is first granted
'**  by the copyright holder.
'**
'**  This program is distributed in the hope that it will be useful,
'**  but WITHOUT ANY WARRANTY; without even the implied warranty of
'**  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR ANY OTHER
'**  WARRANTIES WHETHER EXPRESSED OR IMPLIED.
'**
'**  You should have received a copy of the License along with this program;
'**  if not, write to:- Web Wiz Guide, PO Box 4982, Bournemouth, BH8 8XP, United Kingdom.
'**
'**
'**  No official support is available for this program but you may post support questions at: -
'**  http://www.webwizguide.info/forum
'**
'**  Support questions are NOT answered by e-mail ever!
'**
'**  For correspondence or non support questions contact: -
'**  info@webwizguide.info
'**
'**  or at: -
'**
'**  Web Wiz Guide, PO Box 4982, Bournemouth, BH8 8XP, United Kingdom
'**
'****************************************************************************************       




Introduction
===========================================================================================
Thank you for downloading this application and hopefully you will find it of benefit to you.

Web Wiz CAPTCHA has been designed so that it can be intergrated into your own sites web forms
in the most simplest way.

Web Wiz CAPTCHA adds a security code in image format to your web forms that requires the user
to type in the correct code, shown in image format, into a textbox so that the submitted web
form is then processed.

The idea of CAPTCHA images is that robots, OCR software, etc. can not read in the CAPTCHA image 
code and so therefore can not correctly submit the form. This is useful to protect your web forms
form hacking and spamming software robots and remote form submission.


If you have not downloaded this application from Web Wiz Guide then check for the latest
version at: -

http://www.webwizCAPTCHA.com


This application uses ASP and must be run through a web sever supporting ASP. 

===========================================================================================








Using Web Wiz CAPTCHA
===========================================================================================

1. Unzip all the files keeping the directory structure intact.

2. Files must be run through an ASP enabled web server or on ASP enabled web space. (check with 
your hosting company).

3. Point your web browser to the example file 'example.asp' to check that it runs correctly
on the server you have installed the software on.

===========================================================================================






Integration of Web Wiz CAPTCHA
===========================================================================================

Hopefully you should find the software easy to integrate.

The files 'example.asp' and 'example_process_form.asp' are only used as an example of
how Web Wiz CAPTCHA works.


1. Place the folder, and it's contents, named 'CAPTCHA' into the same directory that your 
web form you wish to integrate Web Wiz CAPTCHA into is in.


2. The web page that contains the HTML web form you wish to integrate Web Wiz CAPTCHA into must
have an .asp extension (eg. my_own_form_file.asp (this is an example file name and not a real
file))


3. Open your web form in a text editor and place the following code into the part of your
form where you wish the CAPTCHA image and textarea to be:-

	<!-- include the Web Wiz CAPTCHA form -->
	<!--#include file="CAPTCHA/CAPTCHA_form_inc.asp" -->

	
4. Open the file in a text editor that is to process your web form input, and place the 
following code at the top of the file:-

	<!-- Include file for CAPTCHA form processing -->             
	<!-- #include file="CAPTCHA/CAPTCHA_process_form.asp" -->

	
5. Now within the file you entered the code from the last step into you can call the following 
variable to check that the CAPTCHA code entered is correct.

	blnCAPTCHAcodeCorrect
	
If the CAPTCHA code entered is correct the above variable with be set to true, if the CAPTCHA code
has not been entered correctly the variable will be set to false. 


	5.1 Below is some sample code to check the CAPTCHA code is correct:-
	
		If blnCAPTCHAcodeCorrect = True Then
			Response.Write(" CAPTCHA code is correct")
		ElseIf  blnCAPTCHAcodeCorrect = False Then
			Response.Write(" CAPTCHA code is NOT correct")
		End If



That should be it, hopefully now you have successfully integrated  Web Wiz CAPTCHA into your 
web form.

===========================================================================================









Customising Web Wiz CAPTCHA
===========================================================================================

1. The only customisation that can be done to this software is to make it NOT case sensitive
by editing the file 'CAPTCHA/CAPTCHA_setup.asp' and altering the following variable:-

	blnCAPTCHAcaseSensitive = true

===========================================================================================









Removing Links Back to Web Wiz Guide
===========================================================================================

Many 1000's of unpaid hours have gone into developing this and the other applications 
available for free from Web Wiz Guide.

If you like using this application then please help support the development and update of 
this and future applications.

If you would like to remove the powered by logo from the application then you must purchase 
a link removal license key from Web Wiz Guide.


Payments can be made securely on-line using your credit or debit card through WorldPay or 
PayPall more information on this can be found at: -

	http://www.webwizguide.info/purchase

===========================================================================================






Donations
===========================================================================================

Many 1000's of unpaid hours have gone into developing this and the other applications 
available for free from Web Wiz Guide.

If you like using this application then please help support the development and update of 
this and future applications.

Donations can be made securely on-line using your credit or debit card through WorldPay or 
PayPall more information on this can be found at: -

	http://www.webwizguide.info/donations



Alternatively you can send donations to: -

	Bruce Corkhill
	PO Box 4982
	Bournemouth
	BH8 8XP
	United Kingdom

Please make personal checks or International money orders payable to: - Bruce Corkhill
(Sorry, I can't cash anything made payable to Web Wiz Guide) 

Please don't send a foreign check drawn on a non-UK bank, as the fees usually exceed the 
value of the donation.



For more info on donations and how Web Wiz Guide can bring professional applications for free
please see the following page: -


	http://www.webwizguide.info/donations


===========================================================================================





Windows 2003 ASP Web Hosting
===========================================================================================

If you are having problems running this application on your own web space then you can have
this application pre-installed for you when purchasing hosting from Web Wiz Hosts.

For more information on web hosting from Web Wiz Guide please see: -

http://www.webwizhosts.net 

===========================================================================================





Other ASP Applications
===========================================================================================

The following ASP Appliacations are available for FREE from http://www.webwizguide.info 

	Web Wiz Forums (award winning bulletin board system)
	Web Wiz Mailing List (full newsletter management system)
	Web Wiz Guestbook
	Web Wiz Rich Text Editor (Free replacement WYSIWYG Editor for text areas)
	Site Search Engine
	Web Wiz Polls
	Web Wiz Site News
	Web Wiz Journal
	Internet Search Engine
	Graphical Hit Counter
	Graphical Session Hit Counter
	Database Hidden Hit Counter
	Active Users Counter
	Email Form's (CDONTS)
	Email Form's (w3 JMail)
	Database Login Page
	Whois Lookup

===========================================================================================




If I have missed anything out or any bugs then please let me know by emailing me at: -

asp@webwizguide.info
