### Contact Us modification to add reCaptcha security check ###

This was adapted from osCommerce. This contribution was made originally for osC by
	Author: Pietro Licata <p.licata@webmad.it>

This contribution has been rewritten to work for zen cart. This contribution uses
the override system so only 1 core file is touched. The sql statements will autoload.
Adapted for zencart by Joe McFrederick 2009/06/23
-------------------------------------------------------------

reCaptcha is a publicly available captcha with a cool feature: it helps to digitize book.
This small modification will help you to add a reCaptcha form on your Contact Us form, in order to protect you from abuses of Contact Us form.
I based my modification on OSC v2.2 RC1. Adapted to zen cart 1.3.8

-------------------------------------------------------------

##################################################
               Version History
##################################################
--------------------------------------------------
v1.1
--------------------------------------------------
Fixed some query syntax
Update native mysql queries to use $db:Factory
Fixed install/uninstall

--------------------------------------------------
v1.0
--------------------------------------------------
Intial release

--------------------------------------------------
 *** Step by step instructions ***
--------------------------------------------------

 ** Only 1 original file is overwritten (includes/modules/pages/contact_us/header_php.php)**
 ** Added validation to this file for reCAPTCHA text **
 ** !!IMPORTANT!! Backup this file ***
 
1. connect to the URL https://admin.recaptcha.net/accounts/signup and create a reCaptcha account;
2. add your web domain to your new reCaptcha account, according to instructions;
3. in this package rename \includes\templates\CUSTOM to your template directory.
4. upload all the files to your store.
5. login to your admin page in zen cart
6. recaptcha configuration will automatically load itself & sql statemtents. If you are
reinstalling, login to admin page, append &remove_recaptcha=yes to the url. Refresh the page,
and it will update the changes.
7. goto Configuration->reCAPTCHA.
8. edit the values in the configuration. You will need your public & private key given from the
	reCAPTCHA website, and choose your theme.
9. (optional) edit file /includes/languages/english/extra_definitions/contact_us_definitions.php and change any of the constants to suit you.

That's all!
--------------------------------------------------------------
Files in this package
** New Files **
\admin\includes\functions\extra_functions\recaptcha_functions.php
\admin\includes\extra_datafiles\recaptcha_filenames.php
\includes\classes\recaptchalib.php
\includes\languages\english\extra_definitions\contact_us_definitions.php
\includes\templates\CUSTOM\tpl_contact_us_default.php (added 1 block of code to default file)

** Modified core file **
\includes\modules\pages\contact_us\header_php.php