---
name: "HTML::FormFu::Element::reCAPTCHA"
section: "3pm"
platform: "linux"
package: "libhtml-formfu-perl"
version: "0.09007-1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/HTML::FormFu::Element::reCAPTCHA"
---

# HTML::FormFu::Element::reCAPTCHA(3pm)

"Are you human" tester!

## 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.