NAME

Mojolicious::Plugin::Captcha::reCAPTCHA - use Captcha::reCAPTCHA in Mojolicious apps

VERSION

version 0.04

SYNOPSIS

Provides a Captcha::reCAPTCHA object in your Mojolicious app.

    use Mojolicious::Plugin::Captcha::reCAPTCHA;

    sub startup {
        my $self = shift;

        $self->plugin('Captcha::reCAPTCHA', { 
            private_key => 'the_public_key',
            public_key  => 'your_private_key',
            use_ssl     => 1,
            options     => { theme => 'white' },
        });
    }

private_key and public_key are mandatory, while use_ssl and options are optional. Unless you have a specific reason to set a certain global value for use_ssl you should probably just let the plugin decide when to use HTTPS requests.

In your mojolicious controller you can control everything by yourself by directly invoking the get_html() method of the Captcha::reCAPTCHA object:

    $self->stash(
        recaptcha_html => $self->recaptcha->get_html( $public_key [, $error [, $use_ssl [, $options ] ] ] ),
    );

Following the same pattern you can also directly invoke check_answer():

    my $result = $self->recaptcha->check_answer(
        $private_key,
        $ip,
        $value_of_challenge_field,
        $value_of_response_field,
    );

Or you can use the new helpers.

NAME

Mojolicious::Plugin::Captcha::reCAPTCHA - use Captcha::reCAPTCHA in Mojolicious apps

VERSION

version 0.04

METHODS/HELPERS

recaptcha

A helper named 'recaptcha' is created that can be used to access the Captcha::reCAPTCHA object.

  my $recaptcha_obj = $self->recaptcha;

use_recaptcha

This helper sets the key recaptcha_html in the stash and uses the HTML as the value.

  $self->use_recaptcha;

It automatically uses the public key and the other configuration options you passed in when registering the plugin.

You may explicitly pass in values for error, use_ssl, and options. If you do, these params will take precedence over the configuration values. Pass undef for positional params you either don't want to set or where you don't want to override the config values:

  $self->use_recaptcha( undef, undef, { theme => 'red' } );

Unless explicitly passed in or set in the configuration, the correct value for use_ssl is automatically determined based on the current request (by looking at $self-\req-\>url-\>base-\>scheme>).

recaptcha_html

This helper works like use_recaptcha but returns the HTML instead of setting a stash value. Also accepts the same params as use_recaptcha().

Intended to be used in templates.

validate_recaptcha

Handles the validation of the recaptcha. If an error occurs, the stash variable "recaptcha_error" is set.

  $self->validate_recaptcha( $params );

$params is a hashref with parameters of the HTTP request. Returns "true" (1) if validation was successful and "false" (0) otherwise.

AUTHORS

• Renee Baecker <module@renee-baecker.de>

• Heiko Jansen <jansen@hbz-nrw.de>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2012 by Hochschulbibliothekszentrum NRW (hbz).

This is free software, licensed under:

  The GNU General Public License, Version 3, June 2007

AUTHORS

• Renee Baecker <module@renee-baecker.de>

• Heiko Jansen <jansen@hbz-nrw.de>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2012 by Hochschulbibliothekszentrum NRW (hbz).

This is free software, licensed under:

  The GNU General Public License, Version 3, June 2007

cpanm Mojolicious::Plugin::Captcha::reCAPTCHA

perl -MCPAN -e shell
install Mojolicious::Plugin::Captcha::reCAPTCHA