# reCAPTCHA
- [Installation](#installation)
- [Initialization](#initialization)
- [Usage](#usage)
- [Customization](#customization)
- [Theme](#theme)
- [Language](#language)
- [Type](#type)
- [Full example](#full-example)
## Installation
With Composer, add this line to your *require* section :
"phelium/recaptcha": "dev-master"
Then run `composer update`.
## Initilization
require 'vendor/autoload.php';
use Phelium\Component\reCAPTCHA;
To initialize reCAPTCHA, you must provide your site key and your secret key.
There is two possible ways :
$reCAPTCHA = new reCAPTCHA('your site key', 'your secret key');
or
$reCAPTCHA = new reCAPTCHA();
$reCAPTCHA->setSiteKey('your site key');
$reCAPTCHA->setSecretKey('your secret key');
## Usage
To generate the *script* tag, use :
$reCAPTCHA->getScript();
To generate the HTML block, use in your form :
$reCAPTCHA->getHtml();
Checking the server side, in your form validation script :
if ($reCAPTCHA->isValid($_POST['g-recaptcha-response']))
{
// do whatever you want, the captcha is valid
}
else
{
// Show errors
var_dump($reCAPTCHA->getErrorCodes());
}
## Customization
### Theme
Several themes are available : light (default) or dark.
$reCAPTCHA->setTheme('dark');
### Language
You can change the language of reCAPTCHA. Check [https://developers.google.com/recaptcha/docs/language](https://developers.google.com/recaptcha/docs/language) for more information.
By default, the language is automatically detected.
$reCAPTCHA->setLanguage('it');
### Type
Several types are available : image (default) or audio.
$reCAPTCHA->setType('audio');
### Size
Two sizes are available : normal (default) or compact.
$reCAPTCHA->setType('compact');
## Full example
Here is an example :
reCAPTCHA example
getScript(); ?>
isValid($_POST['g-recaptcha-response']))
{
echo '
-- Captcha OK ! --
';
}
}
?>