Editing Recaptcha3 field (section)

== Description ==
Allows a Captcha using [https://developers.google.com/recaptcha/docs/v3 Google's reCAPTCHAv3 service] to be added to a form to protect it from being spammed by bots.

Add the following configuration to a file called <code>cfg/cfg.d/recaptcha3.pl</code> in your archive, if it does not already exist.
 $c->{recaptcha3}->{private_key} = "CHANGEME";
 $c->{recaptcha3}->{public_key} = "CHANGEME";
 $c->{recaptcha3}->{min_score} = 0.5;

As this field uses the Google's reCAPTCHAv3 service and renders a Captcha, (a test that humans can easily pass, but robots shouldn't be able to), you will need to use a Google account to generate a private and public key (also known by Google as a '''secret key''' and '''site key''' respectively) for the above configuration.  This can be done via Google's '''[https://www.google.com/recaptcha/admin/create Site Registration Tool]'''.  By sure to use '''Score based (v3)''' option when registering. 

If you are setting up a Recaptcha3 field for protecting request copy forms, you will need to add the following configuration to a file in your archive's <code>cfg/cfg.d/</code> directory.
 $c->add_dataset_field( "request", {
   name => "captcha",
   replace_core => 1,
   type => "recaptcha3",
 });
Also make a copy of <code>lib/workflows/request/default.xml</code> in <code>your/archive/cfg/workflows/request/default.xml</code> and uncomment <code><component surround="None"><field ref="captcha" /></component></code>

If you find you are still getting spam from the form to which you have applied a Recaptcha3 field, then try increasing <code>$c->{recaptcha3}->{min_score}</code> to a higher value such as <code>0.7</code>.