NAME¶
HTML::FormFu::Element::reCAPTCHA - "Are you human" tester!
SYNOPSIS¶
---
elements:
- type: reCAPTCHA
name: recaptcha
public_key: $recaptcha_net_public_key
private_key: $recaptcha_net_private_key
DESCRIPTION¶
A wrapper around Captcha::reCAPTCHA. The reCAPTCHA fields aren't added to the
form as "real" FormFu fields - so the values are never available via
params, etc. You can check that the reCAPTCHA verified correctly, by the usual
methods: "submitted_and_valid" in HTML::FormFu or
"has_errors" in HTML::FormFu
This element automatically adds HTML::FormFu::Constraint::reCAPTCHA to itself -
you should never add it yourself.
Although this is a subclass of HTML::FormFu::Element::Multi, you should not call
"element()" or "elements()" to try to add other fields -
consider the reCAPTCHA element a black box.
METHODS¶
name¶
Required. Although not visibly used for anything, you must give this field a
name for the reCAPTCHA constraint to work correctly.
public_key¶
Arguments: $public_key
Required. Obtained from <
http://recaptcha.net>.
private_key¶
Arguments: $private_key
Required. Obtained from <
http://recaptcha.net>.
ssl¶
Default Value: 'auto'.
Valid Values: '1', '0' or 'auto'
Whether to load the recaptcha.net files via "http" or
"https".
If set to "auto", it will use "https" urls if the current
page is running under ssl, otherwise it will use "http" urls.
recaptcha_options¶
Arguments: \%options
See the recaptcha.net API for details of valid options.
recaptcha_options:
lang: de
theme: white
constraint_args¶
Arguments: \%constraint_args
Options that will be passed to the HTML::FormFu::Constraint::reCAPTCHA that is
automatically added for you.
---
elements:
- type: reCAPTCHA
name: recaptcha
constraint_args:
message: 'custom error message'
SEE ALSO¶
Is a sub-class of, and inherits methods from HTML::FormFu::Element::_Field,
HTML::FormFu::Element::Multi, HTML::FormFu::Element::Block,
HTML::FormFu::Element
HTML::FormFu
AUTHOR¶
Carl Franks, "cfranks@cpan.org"
LICENSE¶
This library is free software, you can redistribute it and/or modify it under
the same terms as Perl itself.