This field is used to add an hCaptcha to your form. An hCaptcha detects whether the user of a site is human. Filling out an hCaptcha is similar to filling out a reCAPTCHA.
WS Form Pro supports all current versions of hCaptcha, including:
Register Your Website with hCaptcha
In order to use hCaptcha, you first need to create an hCaptcha account.
Once you have registered, you will be provided with two keys:
- Site key
- Secret key
Submissions Using Enterprise Accounts
When a submission is successfully made on your website and you have an Enterprise hCaptcha on the page, hCaptcha provides a spam score. The spam score is stored against your submissions and is represented as a colored circle on the submissions page. If you hover your mouse cursor over the colored circle, you can see the percentage score WS Form has given a submission in terms of spam scoring. The scoring ranges from 0% (not spam, shown in green) to 100% (blatant spam, shown in red).
Add hCaptcha to Your Form
To learn how to add, edit, clone, move, resize, offset, or delete a hCaptcha field, please click here.
To edit the settings for this field type, click the settings icon on the field itself. Click the ‘Save & Close’ or ‘Save’ button to save your changes. If you do not want to save your changes, you can click the ‘Cancel’ button or click any other form element to close the field settings sidebar.
The basic tab contains settings that the majority of WS Form users will need to control a field. The settings are as follows:
This is the label shown alongside the field. As well as entering a label into this field, you can also double click the label of the field in the editor. You should enter an easy-to-understand label for your field, for example, ‘First Name’ or ‘Email’.
If enabled the label will be shown on your form. If you do not want the label to appear for a particular field, uncheck this box.
Select the appropriate hCaptcha version from the select pulldown. Depending on which version you choose, you will then be prompted to provide the following information:
Enter the site key provided when you registered your website. You can also enter a global site key to use for all you hCaptcha fields in global settings.
Enter the secret key provided when you registered your website. You can also enter a global secret key to use for all you hCaptcha fields in global settings.
You can choose default or invisible for your hCaptcha type.
Visible hCaptchas are available in a dark or light theme. Choose a theme that suits your website design.
As well as the normal-sized reCAPTHCA, a compact version can also be selected.
The help text setting enables you to add smaller text under the field to assist the website visitor in completing that field.
As well as inserting plain text into this field, WS Form also provides extensive functionality for adding character and word count information. Click here to learn more about this functionality.
WS Form variables can be entered into this field.
The advanced tab contains additional settings that provide further control over how a field is rendered.
Use the ‘Styles’ settings to change the design of the text field.
The vertical alignment option allows you to choose how this field will be vertically aligned in relation to fields in the same row. The options are:
For developers WS Form allows you to add your own classes to fields.
The wrapper CSS class setting enables you to add a class (or classes) to a field wrapper. Field wrappers are sections of HTML added around a field to position them on the page. To add multiple classes, add a space between the class names.
Choose from one of the options to filter which user status can see this field:
- Is Logged In
- Is Logged Out
- Has User Role or Capability
If you choose ‘Has User Role or Capability’, additional settings will appear that enable you to choose one or more roles or capabilities.
Choose the desired language for the hCaptcha.
Show Invalid Feedback
Invalid feedback text is shown when a form is saved or submitted, and the field has not been completed according to the field settings you have configured. For example, if the minimum character count is 10 and you enter 5 characters and then submit the form, the field will be deemed invalid. If this setting is checked, invalid feedback is shown under the field.
Invalid Feedback Text
WS Form automatically builds invalid feedback text for all of your fields. If no text is entered into this field, the value shown in the field in light gray text will be shown. If you would like to specify alternative invalid feedback text, you can enter it within this setting.
WS Form variables can be entered into this field.
The breakpoint settings define the width of a field and also what the offset (how many columns from the left-hand side of the form or the previous field) of a field is for each breakpoint. For more information about the breakpoint settings and capabilities of WS Form, click here.