HTML::F...CAPTCHA(3)

HTML::FormFu::Element::reCAPTCHA 💖

okay bestie, so this page is the manual for HTML::FormFu::Element::reCAPTCHA, and honestly? its whole job is answering the eternal question: are you human 👀✨

---

✨ NAME ✨

HTML::FormFu::Element::reCAPTCHA — the "Are you human" tester! 🧚💅

---

🌸 SYNOPSIS 🌸

---
elements:
  - type: reCAPTCHA
    name: recaptcha
    public_key: $recaptcha_net_public_key
    private_key: $recaptcha_net_private_key

---

💜 DESCRIPTION 💜

So basically this is a lil wrapper around Captcha::reCAPTCHA. 🫶

Here's the tea tho: the reCAPTCHA fields aren't added to the form as "real" FormFu fields — so the values are never available via params, etc. no cap. 🙈

You can still check that the reCAPTCHA verified correctly, using 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 — and bestie, you should never add it yourself. it's giving "i got this, don't touch it". 💀

And even though this is a subclass of HTML::FormFu::Element::Multi, you should not call element() or elements() to try to add other fields — think of the reCAPTCHA element as a total black box. 🎁 main character energy, closed set, no guests. ✨

---

👑 METHODS 👑

💅 name

Required. Even though it's not visibly used for anything, you must give this field a name for the reCAPTCHA constraint to work correctly. fr fr, don't skip it. 😭

💅 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. auto-pilot, slay. 🦋

💅 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::Role::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. periodt. 💅

---

and that's a wrap, bestie 🫶 this page came from perl v5.42.0, dated 2025-07-25, and you found it under HTML::F...CAPTCHA(3) — go forth and verify some humans ✨🎀