NAME

Mojolicious::Plugin::Captcha - create and validate captcha for Mojolicious framework

VERSION

0.02

SYNOPSIS

# Mojolicious
$self->plugin(
	'captcha',
	{
		session_name	=> 'captcha_string',
		out				=> {force => 'jpeg'},
		particle		=> [0,0],
		create			=> [qw/normal rect/],
		new				{
			rnd_data	=> [0...9, 'A'...'Z'],
			width		=> 80,
			height		=> 30,
			lines		=> 7,
			gd_font		=> 'giant',
		}
	}
);

package MyApp::MyController;

sub captcha {
	my $self = shift;
	$self->render( data => $self->create_captcha );
}

sub some_post : Local {
	my ($self, $c) = @_;
	if ($self->validate_captcha($c->req->param('captcha')){
	..
	} else {
	..
	}
}

DESCRIPTION

This plugin create and validate Captcha, using GD::SecurityImage

METHODS

create_captcha

Create Captcha image and output it.

validate_captcha

Validate captcha string

Accept optional second parameter to switch comparator case sensitivity (default is off, i.e. comparator make case insensivity comparing)

# case sensitivity comparing
$self->validate_captcha($self->param('captcha'), 1);

CONFIGURATION

session_name

The keyword for storing captcha string

new
create
particle
out

These parameters are passed to each GD::Security's method. Please see GD::SecurityImage for details.

SUPPORT

SEE ALSO

GD::SecurityImage, Mojolicious, Mojolicious::Plugin

COPYRIGHT & LICENSE

Copyright 2014 zar. All right reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.