astritzeqiri/g-recaptcha

Easily add google recaptcha

, _(*1)

Google recaptcha for Laravel

Easily add google recaptcha in Laravel., _(*2)

Requirements

• PHP >=5.4
• Laravel >= 5.0
• GuzzleHttp >= 5.3

Installation

Add astritzeqiri/g-recaptcha to your composer.json file:, _(*3)

"require": {
    "astritzeqiri/g-recaptcha": "~1.0"
}

And do:, _(*4)

$ composer update

Or get composer to install the package:, _(*5)

$ composer require astritzeqiri/g-recaptcha

Configuration

Now you go and generate a new Google recaptcha on the link below:, _(*6)

Google Recaptcha Generate., _(*7)

Then you go to your .env file and set these variables, _(*8)

# If you want to disable captchas put this to false by default this is true.
GRECAPTCHA_ENABLED=true

# The google recaptcha site key
GRECAPTCHA_KEY=SITE_KEY

# The google recaptcha secret key
GRECAPTCHA_SECRET=SECRET_KEY

You can also change these variables on the config file on config/grecaptcha.php file., _(*9)

return [
    'enabled' => env("GRECAPTCHA_ENABLED", true),
    'site_key' => env("GRECAPTCHA_KEY"),
    'secret_key' => env("GRECAPTCHA_SECRET"),
];

Registering the Package

Register the service provider within the providers array found in app/config/app.php:, _(*10)

'providers' => array(
    // ...
    AstritZeqiri\GRecaptcha\GRecaptchaServiceProvider::class
)

Then you need to add GRecaptcha class within the aliases array found in app/config/app.php:, _(*11)

'aliases' => array(
    // ...
    'GRecaptcha' => AstritZeqiri\GRecaptcha\GRecaptcha::class,
)

Then you run php artisan vendor:publish to publish the start_captchas script and also the recaptcha config file., _(*12)

$ php artisan vendor:publish

Usage

First of all you need to call the grecaptcha scripts on the footer. The scripts are rendered only if you have an active captcha somewhere on you html., _(*13)

// in blade.php files
{!! \GRecaptcha::renderScripts() !!}

// or in .php files

Basic Example

Now to render a new GRecaptcha you call the render method., _(*14)

// by default it echo's it out
GRecaptcha::render();

// if you want to save the html in a variable you call 
$grecaptchaHtml = GRecaptcha::render([], false);

If you want to get a new recaptcha instance:, _(*15)

$grecaptcha = GRecaptcha::generate();

// to render it you call
$grecaptcha->renderHtml();

// if you dont want it to be rendered but store the html you call
$grecaptchaHtml = $grecaptcha->build();

Validation

When you validate a form to validate the recaptcha you use the rule grecaptcha, _(*16)

$validator = Validator::make($inputs,
    ['g-recaptcha-response' => 'required|grecaptcha']
);

License

MIT, _(*17)