1HTML::FormFu::Element::UrseeCrAPCToCnHtAr(i3b)uted PerlHDToMcLu:m:eFnotramtFiuo:n:Element::reCAPTCHA(3)
2
3
4

NAME

6       HTML::FormFu::Element::reCAPTCHA - "Are you human" tester!
7

SYNOPSIS

9           ---
10           elements:
11             - type: reCAPTCHA
12               name: recaptcha
13               public_key: $recaptcha_net_public_key
14               private_key: $recaptcha_net_private_key
15

DESCRIPTION

17       A wrapper around Captcha::reCAPTCHA.  The reCAPTCHA fields aren't added
18       to the form as "real" FormFu fields - so the values are never available
19       via params, etc.  You can check that the reCAPTCHA verified correctly,
20       by the usual methods: "submitted_and_valid" in HTML::FormFu or
21       "has_errors" in HTML::FormFu
22
23       This element automatically adds HTML::FormFu::Constraint::reCAPTCHA to
24       itself - you should never add it yourself.
25
26       Although this is a subclass of HTML::FormFu::Element::Multi, you should
27       not call element() or elements() to try to add other fields - consider
28       the reCAPTCHA element a black box.
29

METHODS

31   name
32       Required. Although not visibly used for anything, you must give this
33       field a name for the reCAPTCHA constraint to work correctly.
34
35   public_key
36       Arguments: $public_key
37
38       Required. Obtained from <http://recaptcha.net>.
39
40   private_key
41       Arguments: $private_key
42
43       Required. Obtained from <http://recaptcha.net>.
44
45   ssl
46       Default Value: 'auto'.
47
48       Valid Values: '1', '0' or 'auto'
49
50       Whether to load the recaptcha.net files via "http" or "https".
51
52       If set to "auto", it will use "https" urls if the current page is
53       running under ssl, otherwise it will use "http" urls.
54
55   recaptcha_options
56       Arguments: \%options
57
58       See the recaptcha.net API for details of valid options.
59
60           recaptcha_options:
61             lang: de
62             theme: white
63
64   constraint_args
65       Arguments: \%constraint_args
66
67       Options that will be passed to the HTML::FormFu::Constraint::reCAPTCHA
68       that is automatically added for you.
69
70           ---
71           elements:
72             - type: reCAPTCHA
73               name: recaptcha
74               constraint_args:
75                 message: 'custom error message'
76

SEE ALSO

78       Is a sub-class of, and inherits methods from
79       HTML::FormFu::Role::Element::Field, HTML::FormFu::Element::Multi,
80       HTML::FormFu::Element::Block, HTML::FormFu::Element
81
82       HTML::FormFu
83

AUTHOR

85       Carl Franks, "cfranks@cpan.org"
86

LICENSE

88       This library is free software, you can redistribute it and/or modify it
89       under the same terms as Perl itself.
90
91
92
93perl v5.38.0                      2023-07-20HTML::FormFu::Element::reCAPTCHA(3)
Impressum