html::formhandler::traitfor::captcha(3pm) [debian man page]

HTML::FormHandler::TraitFor::Captcha(3pm)		User Contributed Perl Documentation		 HTML::FormHandler::TraitFor::Captcha(3pm)

NAME

       HTML::FormHandler::TraitFor::Captcha - generate and validate captchas

VERSION

       version 0.40013

SYNOPSIS

       A role to use in a form to implement a captcha field.

	  package MyApp::Form;
	  use HTML::FormHandler::Moose;
	  with 'HTML::FormHandler::TraitFor::Captcha';

       or

	  my $form = MyApp::Form->new( traits => ['HTML::FormHandler::TraitFor::Captcha'],
	      ctx => $c );

       Needs a context object set in the form's 'ctx' attribute which has a session hashref in which to store a 'captcha' hashref, such as is
       provided by Catalyst session plugin.

METHODS

   get_captcha
       Get a captcha stored in "$form->ctx->{session}"

set_captcha
       Set a captcha in "$self->ctx->{session}"

   captcha_image_url
       Default is '/captcha/image'. Override in a form to change.

	  sub captcha_image_url { '/my/image/url/' }

       Example of a Catalyst action to handle the image:

	   sub image : Local {
	       my ( $self, $c ) = @_;
	       my $captcha = $c->session->{captcha};
	       $c->response->body($captcha->{image});
	       $c->response->content_type('image/'. $captcha->{type});
	       $c->res->headers->expires( time() );
	       $c->res->headers->header( 'Last-Modified' => HTTP::Date::time2str );
	       $c->res->headers->header( 'Pragma'	 => 'no-cache' );
	       $c->res->headers->header( 'Cache-Control' => 'no-cache' );
	   }

AUTHOR

       FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Gerda Shank.

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

perl v5.14.2							    2012-06-25				 HTML::FormHandler::TraitFor::Captcha(3pm)

HTML::FormHandler::Manual(3pm)				User Contributed Perl Documentation			    HTML::FormHandler::Manual(3pm)

NAME

       HTML::FormHandler::Manual - index of the manual

VERSION

       version 0.40013

DESCRIPTION

       This is the HTML::FormHandler users manual. HTML::FormHandler is an HTML form handling class written in Moose. It provides facilities to
       write classes that represent HTML forms, and retrieves and loads data from the database.

SECTIONS

   HTML::FormHandler::Manual::Intro
       Creating FormHandler forms and interfacing them with your controllers.

   HTML::FormHandler::Manual::Fields
       Organized list of FormHandler fields, with links to specific documentation.

   HTML::FormHandler::Manual::Defaults
       Description of the various ways of setting defaults.

   HTML::FormHandler::Manual::InflationDeflation
       Inflation and deflation of fields

   HTML::FormHandler::Manual::Validation
       Validation of fields

   HTML::FormHandler::Manual::Errors
       Errors: setting them, getting them.

   HTML::FormHandler::Manual::Rendering
       Rendering options, particularly rendering with widgets

   HTML::FormHandler::Manual::Database
       Issues and setup for database forms.

   HTML::FormHandler::Manual::Tutorial
       Builds on the Catalyst tutorial. Step-by-step guide.

   HTML::FormHandler::Manual::Testing
       Test your forms

   HTML::FormHandler::Manual::Cookbook
       'Howto' recipes

   HTML::FormHandler::Manual::Templates
       Cut-and-paste examples of templates to use with FormHandler

   HTML::FormHandler::Manual::Catalyst
       Catalyst specific documentation

   HTML::FormHandler::Manual::Reference
       Quick reference of FormHandler interface

   HTML::FormHandler::Manual::FromDFV
       Info on converting from Data::FormValidator

   HTML::FormHandler::Manual::FromFF
       Info on converting from HTML::FormFu

SUPPORT

       IRC:

	  Join #formhandler on irc.perl.org

       Mailing list:

	 http://groups.google.com/group/formhandler

AUTHOR

       gshank: Gerda Shank <gshank@cpan.org>

AUTHOR

       FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Gerda Shank.

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

perl v5.14.2							    2012-06-25					    HTML::FormHandler::Manual(3pm)