README

reCAPTCHA Module
===========================
reCAPTCHA is an extension that allows the integration of the reCAPTCHA
anti-spam CAPTCHA service in your eZ publish content objects.  reCAPTCHA
provides a reCAPTCHA datatype that can be used in editing content and
information collection. reCAPTCHA provides both text and audio CAPTCHAs.

About reCAPTCHA
---------------
Over 60 million CAPTCHAs are solved every day by people around the world.
reCAPTCHA channels this human effort into helping to digitize books from the
Internet Archive. When you solve a reCAPTCHA, you help preserve literature by
deciphering a word that was not readable by computers. 

reCAPTCHA is a project of the School of Computer Science at Carnegie Mellon
University.

From: https://developers.google.com/recaptcha/

Original author: Bruce Morrison
Fork author: rb@aplia.no

Aplia Fork
----------
Modified version of the original reCAPTCHA module. Uses reCAPTCHA v2 to verify InformationCollecting content objects 


Installation
-----------------
Follow these steps to add the reCAPTCHA module to your eZ publish installation:

  1) Extract the archive into the /extension directory

  2) Edit site.ini.append in /settings/override. Add the following to the file:

       [ExtensionSettings]
       ActiveExtensions[]=ezpublish-recaptcha

     If you already have the [ExtensionSettings] block, just add the second line.

  3) Visit https://www.google.com/recaptcha/admin to signup and get your own API keys

  4) Edit project.ini and add your API keys

      [Site]
      RecaptchaSecret=your secret key
      RecaptchaSiteKey=your public key

  5) Clear Cache

Usage
----------------
To use, simply add a reCAPTCHA attribute and InformationCollection attribute to your content class and render the reCaptcha HTML by calling recaptcha_get_html() in your template.

recaptcha_get_html($key = null)

PS!
----------------
By default this extension will also require reCAPTCHA input on edits done to the object itself in eZPublish. To bypass this, you can edit which siteaccess will be allowed through without checking for reCAPTCHA.
Edit your project.ini and add the following:
    [Recaptcha]
    AllowedSiteaccess=allowed siteaccess

    or

    [Recaptcha]
    AllowedSiteaccess[]
    AllowedSiteaccess[]=first allowed
    AllowedSiteaccess[]=second allowed

License
-----------------

This file may be distributed and/or modified under the terms of the "GNU
General Public License" version 2 as published by the Free Software Foundation

This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

The "GNU General Public License" (GPL) is available at
http://www.gnu.org/copyleft/gpl.html.