Documentation and Tutorials for your BestWebSoft products

User Guide reCaptcha Plugin

 

reCaptcha

User Guide

reCaptcha

1.64 *

WordPress

5.8 *

Contact Form

Contact Form 7

Gravity Forms

WPForms

Ninja Forms

Jetpack Contact Form

MailChimp for WordPress

Subscriber

Testimonials

WooCommerce
BuddyPress

Divi

BbPress

Forums - wpForo

Caldera Forms

  4.2.4*

5.4.2*

2.4.20*

1.6.8.1*

3.5.7*

10.0*

4.8.6*

1.4.8*

1.0.8*

 5.6.0*

9.1.1 *

 4.9.3 *

2.6.6 *

 1.9.9 *

1.9.4 *

*When using other versions some differences are possible to occur

** Screenshots were taken from a PC

Table of Contents

1. Introduction

2. Settings

2.1. General

2.1.1. reCaptcha Version

2.1.2. Site Key and Secret Key

2.1.3. Enable reCaptcha for

2.1.4. External Plugins

2.1.4.1. Contact Form

2.1.4.2. Gravity Forms

2.1.4.3. Ninja Forms

2.1.4.4. Jetpack Contact Form

2.1.4.5. MailChimp for WordPress

2.1.4.6. Subscriber by BestWebSoft

2.1.4.7. Testimonials by BestWebSoft

2.1.4.8. WPForms

2.1.4.9. Contact Form 7

2.1.4.10. Caldera Forms

2.1.4.11. WooCommerce

2.1.4.12. BuddyPress

2.1.4.13. Divi

2.1.4.14. bbPress

2.1.4.15. wpForo Forum

2.1.4.16. Ultimate Member

2.1.5. reCaptcha Domain

2.1.6. Language

2.1.7. Multilanguage

2.2. Appearance

2.2.1. Theme

2.2.2. Size

2.3. Additional Protective Measures

2.3.1. Hide reCaptcha for

2.3.2. Allow List Notification

2.3.3. Advanced Protection

2.3.4. Disabled Submit Button

3. Miscellaneous Settings

3.1. Track Usage

3.2. Default Settings

4. Custom Code

5. License Key

5.1. Pro License

5.2. Check License Key

5.3. Manage License Settings

6. Allow List

You can download reCaptcha plugin here https://bestwebsoft.com/products/wordpress/plugins/google-captcha/.

1. Introduction

Note: Сlick the “Save Changes” button in order to apply any changes.  

1.1. Open your WordPress Admin Dashboard and find the menu on the left.

1.2. Open the “reCaptcha > Settings page on the dashboard.

2. Settings

Use the options of the “Settings” page to make the global settings for the plugin. 

2.1. General

Use the options of the “General” section to make the most important settings for reCaptcha.

2.1.1. reCaptcha Version

Use the “reCaptcha Version” option to set the preferred reCaptcha version: “Version 2”, “Version 3, or “Invisible”.

Note: If the reCaptcha version will be changed after authentification keys are already generated and inserted you will need to re-generate them for the appropriate version.

2.1.2. Site Key and Secret Key

Authenticate your site by getting the “Site Key and “Secret Key from Google to authorize communication between your website and the reCaptcha server and verify the user's response. Create the  “Site Key” and “Secret Key” according to the “reCaptcha Version” option.

Note: The following example for getting the “API keys” is applicable for the “reCaptcha Version 2

2.1.2.1. Click the Get the API keys link in the General section.

2.1.2.2. The “Google reCaptcha page will open. Сlick the Plus button in the upper right corner to add a new website.

2.1.2.3.  Enter the label, choose the reCaptcha type and add your domain names.


 

2.1.2.4. Get acquainted with the Terms of Service, mark the checkbox to accept them and click the Submit button.

2.1.2.5.  A new page with the API keys will open. Copy both keys (Site Key and Secret Key).

2.1.2.6. Open the “reCaptcha Settings” page and paste the copied keys into the appropriate fields.


2.1.2.7. Complete the reCaptcha to fulfill a test verification of your keys, and click the “Test verification” button.


2.1.2.8. If the entered keys correspond to the keys prescribed to your site by Google, two green checkmark icons will appear next to the key-fields and the “The verification is successfully completed” notification.

2.1.2.9. Click the “Save Changes” button after successful verification.


2.1.2.10. If the entered keys correspond to the other domain, the “Error for site owner: Invalid domain for site key” error occurred.

2.1.2.11. You need to verify that the keys are correct here and if they are, click the “Test verification” button. “The verification is successfully completed” notification shall occur.

2.1.2.12. If after testing verification some other errors occur (such as “User Response is Missing”), please check that you have generated the keys exactly for the reCaptcha type you want to use.   

2.1.2.13. Regenerate the keys here and click the “Test verification” button. “The verification is successfully completed” notification shall occur.

2.1.2.14. To enable the usage of the “reCaptcha Version 3, get the new API keys from Google by clicking the link ”Get the API Keys” in the “General” section.

2.1.2.15. On the page of your site’s registration choose the “reCaptcha v3 option.

2.1.2.16. A new page with the API keys will open. Copy both keys (Site Key and Secret Key).

2.1.2.17. Open the “reCaptcha Settings” page and paste the copied keys into the appropriate fields.

2.1.2.18. After saving changes the “Registration form” with “reCaptcha v3” will look as follows.


2.1.2.19. To enable the usage of the “Invisible” version, get the new API keys from Google by clicking the link ”Get the API Keys” in the “Authentication” section.

2.1.2.20. Get acquainted with the Terms of Service and mark the checkbox to accept them. Click the “Submit” button.

2.1.2.21. On the page of your site’s registration choose the “reCaptcha v2 > “Invisible reCaptcha” option.

2.1.2.22. Get acquainted with the Terms of Service and mark the checkbox to accept them. Click the “Submit” button.

2.1.2.23. A new page with the API keys will open. Copy both keys (Site Key and Secret Key).

2.1.2.24. Open the “reCaptcha Settings” page and paste the copied keys into the appropriate fields.



2.1.2.25.
 After saving changes the “Registration form” with “Invisible” reCaptcha will look as follows.

2.1.3. Enable reCaptcha for

Use the “Enable reCaptcha for” option to show reCaptcha for WordPress and custom forms generated by external plugins.


2.1.3.1. The WordPress “Login Form with reCaptcha will look on a page as follows.


2.1.3.2. The WordPress “Registration Form” with reCaptcha will look on a page as follows.

2.1.3.3. The WordPress “Reset Password Form” with reCaptcha will look on a page as follows.

2.1.3.4. The WordPress “Comments Form” with reCaptcha will look on a page as follows.

2.1.4. External Plugins

reCaptcha by Bestwebsoft can be combined with external plugins. The compatible plugins can be chosen and installed in the “External Plugins” section.

2.1.4.1. Contact Form

reCaptcha by BestWebSoft is compatible with “Contact Form by BestWebSoft”. Download and install the plugin by clicking the Install Now link in the External Plugins section.

You can download the Contact Form plugin here

https://bestwebsoft.com/products/wordpress/plugins/contact-form/

2.1.4.1.1. After a successful download and activation of the Contact Form” plugin enable reCaptcha for “Contact Form”.

2.1.4.1.2. After saving changes the “Contact Form” with reCaptcha will look as follows.

2.1.4.2. Gravity Forms

reCaptcha by BestWebSoft is compatible with the “Gravity Forms” plugin. Download the plugin by clicking the “Install Now” link in the “External Plugins” section.

2.1.4.2.1. After a successful download and activation of the “Gravity Forms” plugin enable reCaptcha for “Gravity Forms”.

2.1.4.2.2. Open the “Forms” > “Forms” page.

2.1.4.2.3. Click the “Add New” button to create a new form or click the “Edit button” to add reCaptcha to the form created before.

2.1.4.2.4. Click the “BWS reCaptcha” badge on the “Standard Fields” section to add reCaptcha to the form.

2.1.4.2.5. The reCaptcha field will appear at the chosen place. Click the “Update” button to save changes.

2.1.4.2.6. After saving changes “Gravity Form” with reCaptcha may look on a page as follows.

2.1.4.3. Ninja Forms

reCaptcha by BestWebSoft is compatible with the “Ninja Forms” plugin. Download the plugin by clicking the “Install Now” link in the “External Plugins” section.

2.1.4.3.1. After a successful download and activation of the “Ninja Forms” plugin enable reCaptcha for “Ninja Forms”.

2.1.4.3.2. Open the “Ninja Forms” > “Dashboard” page.

2.1.4.3.3. Click the “Add New” button to create a new form or click the “Edit button” (Gear Button) to add reCaptcha to the form created before.

2.1.4.3.4. On the form edit page click the “Add New Field” button.

2.1.4.3.5. Drag and drop the “BWS reCaptcha” badge to the necessary place of the form and click the “Done” button.

2.1.4.3.6. After saving changes “Ninja Contact Form” with reCaptcha will look as follows.


2.1.4.4. Jetpack Contact Form

reCaptcha by BestWebSoft is compatible with the “Jetpack Contact Form” plugin. Download the plugin by clicking the “Install Now” link in the “External Plugins” section.

2.1.4.4.1. After a successful download and activation of the plugin enable reCaptcha for the “Jetpack Contact Form”.

2.1.4.4.2. Open your post or page and click the “Add block” button, select the “Form” block.

2.1.4.4.3. Enter the “Email address”, the “Email subject line” and click the “Add form” button.

2.1.4.4.4. The “Contact Form” will appear in the chosen place.

2.1.4.4.5. Click the “Add block” button at the contact form area and select the “Shortcode” block.

2.1.4.4.6. Insert the “reCaptcha Shortcode” into the “Shortcode” field.

2.1.4.4.7. After saving changes “Jetpack Contact Form with reCaptcha will look as follows.

2.1.4.5. MailChimp for WordPress

reCaptcha by BestWebSoft is compatible with the “MailChimp for WordPress” plugin. Download the plugin by clicking the “Install Now” link in the "External Plugins" section.

2.1.4.5.1. After a successful download and activation of the plugin enable reCaptcha for “MailChimp for WordPress”.

2.1.4.5.2. After saving changes “MailChimp form with reCaptcha will look as follows.

2.1.4.6. Subscriber by BestWebSoft

reCaptcha by BestWebSoft is compatible with the “Subscriber by BestWebSoft” plugin. Download the plugin by clicking the “Install Now” link in the “External Plugins” section.

You can download the Subscriber Plugin here

https://bestwebsoft.com/products/wordpress/plugins/subscriber/

2.1.4.6.1. After a successful download, activation and configuration of the “Subscriber” plugin enable reCaptcha for “Subscriber”.

2.1.4.6.2. After making the necessary settings the “Subscriber” form with reCaptcha will look as follows.

2.1.4.7. Testimonials by BestWebSoft

reCaptcha by BestWebSoft is compatible with Testimonials by BestWebSoft” plugin. Download the plugin by clicking the “Install Now” link in the “External Plugins” section.

You can download the Testimonials plugin here

https://bestwebsoft.com/products/wordpress/plugins/testimonials/

2.1.4.7.1. After a successful download and activation of the “Testimonialsplugin enable reCaptcha for Testimonials.

2.1.4.7.2. Open the “Testimonials > “Settings page and enable the “Google Captcha” option.

2.1.4.7.3. After saving changes the “Testimonials” form with reCaptcha will look as follows.

2.1.4.8. WPForms

reCaptcha by BestWebSoft is compatible with the “WPForms” plugin. Download the plugin by clicking the “Install Now” link in the "External Plugins" section.

2.1.4.8.1. After a successful download and activation of the plugin enable reCaptcha for “WPForms”.

2.1.4.8.2. Open the “WPForms” > “All Forms page. Click the “Add New” button to create a new form or click the “Edit” button to add reCaptcha to the form created before.

2.1.4.8.3. On the form edit page, drag and drop the “BWS reCaptcha” badge to the necessary place of the form, and click the “Save” button.

2.1.4.8.4. After saving changes “WPForms” with reCaptcha will look as follows.

2.1.4.9. Contact Form 7

reCaptcha by BestWebSoft is compatible with the “Contact Form 7 plugin. Download the plugin by clicking the “Install Now” link in the “External Plugins” section.

2.1.4.9.1. After a successful download and activation of “Contact Form 7” plugin enable reCaptcha for “Contact Form 7”.

2.1.4.9.2. Open the “Contact” > “Contact Forms” page.

2.1.4.9.3. Select the form to add reCaptcha and open it in the “Edit” mode.

2.1.4.9.4. Click the “BWS reCaptcha” button.

2.1.4.9.5. The “Form-tag Generator” window will open. Click the “Insert Tag” button to add the reCaptcha to your form.

2.1.4.9.6. After the shortcode is added to the form click the “Save button.

2.1.4.9.7. After saving changes the “Contact Form 7” with reCaptcha will look as follows.

2.1.4.10. Caldera Forms

reCaptcha by BestWebSoft is compatible with the “Caldera Forms plugin. Download the plugin by clicking the “Install Now” link in the “External Plugins” section.

2.1.4.10.1. After a successful download and activation of “Caldera Forms” plugin enable reCaptcha for “Caldera Forms”.

2.1.4.10.2. Open the “Caldera Forms” > “Forms” page.

2.1.4.10.3. Click the “New Form” button to create a new form or click the “Edit” button to add reCaptcha to the form created before.

2.1.4.10.3. Select any block for creating a form (for example, a “Contact Form”).

2.1.4.10.4. Name the form and click the “Create Form” button.

2.1.4.10.5. Click the “+” button in the “Comments/Questions” block.

2.1.4.10.6. Go to the “Special” tab, select “BWS reCaptcha” and click the “Set Field” button.

2.1.4.10.7. The reCaptcha field will appear at the chosen place. Click the “Save Form” button to save form.

2.1.4.10.8. After saving changes “Caldera Forms” with reCaptcha may look on a page as follows.

2.1.4.11. WooCommerce

reCaptcha by BestWebSoft is compatible with the “WooCommerce” plugin. You can download the plugin by clicking the “Install Now” link in the "WooCommerce" section.

2.1.4.11.1. After a successful download, activation and configuration of WooCommerce enable reCaptcha for the necessary forms.

 

2.1.4.11.2. The “WooCommerce Login and Registration Form with reCaptcha will look as follows.

2.1.4.11.3. The WooCommerce Reset password Form with reCaptcha will look as follows.

2.1.4.11.4. The “WooCommerce Checkout Form with reCaptcha will look as follows.

2.1.4.12. BuddyPress

reCaptcha by BestWebSoft is compatible with the BuddyPress” plugin. Download the plugin by clicking the “Install Now” link in the "BuddyPress" section.

2.1.4.12.1. After a successful download, activation and configuration of the “BuddyPressplugin enable reCaptcha for the necessary forms.

 

2.1.4.12.2. After saving changes the “BuddyPress Registration Form with reCaptcha will look as follows.

2.1.4.12.3. The “BuddyPress Comments Form with reCaptcha will look as follows.

2.1.4.12.4. The “BuddyPress Add New Group Form with reCaptcha will look as follows.

2.1.4.13. Divi

reCaptcha by BestWebSoft is compatible with the Divi theme. You can download the  “Divi theme by clicking the “Install Now” link found in the “Divi” section.



2.1.4.13.1. After a successful download, activation and configuration of the “Divi” theme enable reCaptcha for the necessary forms.

 

2.1.4.13.2. To add “reCaptcha by BestWebSoft” to the “Divi Contact form” turn off the internal “Divi Contact form” spam protection. Edit the contact form, select the “Content” tab, open the “Spam Protection” section and disable the “Use the Spam Protection Service” and “Use Basic Captcha” options.

Note: “Spam Protection” services in the “Divi” theme not relevant to the “reCaptcha by BestWebSoft” plugin. It is necessary to turn off the “Divi” “Spam Protection” services for the normal functioning of the “reCaptcha by BestWebSoft” plugin.

2.1.4.12.3. After saving changes the “Divi Contact Form” with reCaptcha will look as follows.

2.1.4.13.3. The “Divi Login Form” with reCaptcha will look as follows.


2.1.4.14. bbPress

reCaptcha by BestWebSoft is compatible with bbPress”. You can download the plugin by clicking the “Install Now” link in the "bbPress" section.

2.1.4.14.1. After a successful download, activation and configuration of the “bbPress” plugin, enable the reCaptcha for the necessary forms.

2.1.4.14.2. After saving changes the “bbPress New Topic form” with reCaptcha will look as follows.

2.1.4.14.3. The bbPress Reply form” with reCaptcha will look as follows.

2.1.4.15. wpForo Forum

reCaptcha by BestWebSoft is compatible with the “wpForo Forum” plugin. You can download the plugin by clicking the “Install Now” link in the “Forums - wpForo” section.

2.1.4.15.1. After a successful download, activation and configuration of the “wpForo Forum” plugin, enable reCaptcha for the necessary forms.

2.1.4.15.2. After saving changes the “wpForo Login Form” with reCaptcha will look as follows.

2.1.4.15.3. The “wpForo Registration Form” with reCaptcha will look as follows.

2.1.4.15.4. The “wpForo New Topic Form” with reCaptcha will look as follows.

2.1.4.15.5. The “wpForo Reply Form” with reCaptcha will look as follows.

2.1.4.16. Ultimate Member

reCaptcha by BestWebSoft is compatible with the “Ultimate Member” plugin. You can download the plugin by clicking the “Install Now” link in the “Ultimate Member” section.

2.1.4.16.1. After a successful download, activation and configuration of the “Ultimate Member” plugin, enable reCaptcha for the necessary forms.

2.1.4.16.2. To add the reCaptcha to Ultimate Member Login form open the “Ultimate Member” > “Forms” > “Default Login” form in Edit mode.

2.1.4.16.3. Click the “+” button in the “Form Builder” block.

2.1.4.16.4. Choose the “BWS Recaptcha” badge under “Predefined Fields''.

2.1.4.16.5. Click the “Update” button.

2.1.4.16.6. After saving changes the “Ultimate Member Login Form” with reCaptcha will look as follows.

2.1.4.16.7. To add the reCaptcha to Ultimate Member Registration form open the “Ultimate Member” > “Forms” > “Default Registration” form in Edit mode.

2.1.4.16.8. Click the “+” button in the “Form Builder” block.

2.1.4.16.9. Choose the “BWS Recaptcha” badge under “Predefined Fields''.

2.1.4.16.10. Click the “Update” button.

2.1.4.16.11. After saving changes the “Ultimate Member Registration Form” with reCaptcha will look as follows.

2.1.4.16.12. To add the reCaptcha to Ultimate Member Profile form open the “Ultimate Member” > “Forms” > “Default Profile” form in Edit mode.

2.1.4.16.13. Click the “+” button in the “Form Builder” block.

2.1.4.16.14. Choose the “BWS Recaptcha” badge under “Predefined Fields''.

2.1.4.16.15. Click the “Update” button.

2.1.4.16.16. After saving changes the “Ultimate Member Profile Form” with reCaptcha will look as follows.

2.1.5. reCaptcha Domain        

Use the “reCaptcha Domain        ” option to change the reCaptcha domain if Google is not accessible or blocked in your country (for example in China).

2.1.6. Language

Use the “Language” option to select the preferred language for reCaptcha from the drop-down list.

2.1.6.1. After saving changes the Login form” with reCaptcha in alternative language may look as follows.

2.1.7. Multilanguage

reCaptcha by BestWebSoft is compatible with the “Multilanguage by BestWebSoft plugin, which can translate reCaptcha automatically. Download Multilanguage plugin by clicking the “Install Now” link placed in the option description.

You can download Multilanguage plugin here

https://bestwebsoft.com/products/wordpress/plugins/multilanguage/

2.1.7.1. After a successful download, activation and configuration of the “Multilanguage” plugin enable the “Multilanguage” option in order to activate the automatic language switch for reCaptcha on a multilingual website.

2.2. Appearance

Use the options of the “Appearance” section to change the style of reCaptcha badge.

2.2.1. Theme

Use the “Theme” option select the theme color for “reCaptcha v2”: “Light” and “Dark” themes are available.

2.2.1.1. The “Light” theme of reCaptcha version 2 will look as follows.

2.2.1.2. The “Dark” theme of reCaptcha version 2 will look as follows.

2.2.2. Size

Use the “Size” option to choose the size of “reCaptcha v2” between “Normal” and “Compact” sizes.

2.2.2.1. The “Normal” size of the reCaptcha on the “Login form” will look as follows.

2.2.2.2. The “Compact” size of the reCaptcha on the Login form” will look as follows.

2.3. Additional Protective Measures

Use the options of “Additional Protective Measures” section to set the additional reCaptcha protection.

2.3.1. Hide reCaptcha for

Use the “Hide reCaptcha for” option to hide reCaptcha for particular categories of users.

2.3.2. Allow List Notification        

Use the “Allow List Notification” option to change the text displayed instead of reCaptcha for the allowed IP addresses.

2.3.2.1. After saving changes the “Login form” with the custom “Allow List Notification” will look as follows.

2.3.3. Advanced Protection

Use the “Advanced Protection” option for additional protection.

Note: Do not use this option if you see the "Failed to load Google reCaptcha" message.

2.3.4. Disabled Submit Button

Enable the “Disabled Submit Button” option to keep the Submit button disabled before a user has completed the reCaptcha test.

Note: This option is applicable only for Version 2 of reCaptcha.

3. Miscellaneous Settings

Use the options of the “Miscellaneous Settings” tab to make the settings regarding the track usage and default settings.

3.1. Track Usage

Enable the “Track Usage” option to allow tracking plugin usage anonymously.

3.2. Default Settings

Click the “Restore Settings button to reset all the settings made previously and revert them to the default ones.


3.2.1. Click the “Yes, restore all settings” button to confirm the procedure.

4. Custom Code

Use the “Custom code” tab to insert a CSS, PHP or JavaScript code. To activate a custom code, enable the “Activate custom … code” option and save changes.

5. License Key

Use the “License Key” tab to activate or check the Pro plugin license.

5.1. Pro License

After a successful plugin purchase, you will receive an email notification with a download link and a license key. Activate Pro license by pasting a license key into the “reCaptcha Pro License” field and clicking the “Save Changes” button.


5.2. Check License Key

To check the license key, click the “Check license key” button. If the entered key is correct, the notification “The license key is valid. Your license will expire on XXXX-XX-XX” will be displayed in the upper left corner of the page.

5.3. Manage License Settings

Use the “Manage License Settings” option to change your license settings. Click the “Login to Client Area” button to open your personal Client Area dashboard located on the https://bestwebsoft.com/ website. Browse and download purchased products, change the license domain and copy the license keys.

6. Allow List

Add and manage trusted IP addresses using the “Allow List” page. reCaptcha will be hidden for all the ID addresses stored in this list.

Note: This option will be useful if you manage your WordPress website via mobile application, which uses XML-PRC protocol, otherwise reCaptcha will not allow this application to connect to the site.

6.1. Open the “reCaptcha > “Allow List” page on your WordPress admin dashboard.

6.2. Click the “Add New” button to add IP addresses to the allow list.

6.3. Enter one or multiple IP addresses in the “IP to Allow List” field, enter the reason for allowing and click the “Add IP to Allow List” button.

Note:
Allowed formats: 192.168.0.1, 192.168.0., 192.168., 192., 192.168.0.1/8, 123.126.12.243-185.239.34.54

Allowed diapason: 0.0.0.0 - 255.255.255.255

Allowed separators for IPs: a comma (,), semicolon (;), ordinary space, tab, new line or carriage return.

 

6.4. To add your own IP to the allow list enable the “My IP” option and click the “Add IP to Allow list” button.

6.5. All the allowed IP’s with the additional information will be displayed in the list.

6.6. Use the “Search” field to find the previously added IP’s. Enter the request and click the “Search IP” button.

6.7. To delete the IP address from the “Allow list” hover the cursor on the necessary IP and click the “Delete” button.

6.8. To delete several IP addresses, enable them in the list select the “Delete” Bulk Action and click the “Apply” button.

Thank you!

Help & Support

Visit our Help Center if you have any questions — https://support.bestwebsoft.com/

Services

We provide additional services such as WordPress themes & plugins development,

graphic design, custom programming.

Contact us now to get a free quote — https://bestwebsoft.com/contacts/

Help & Support

support.bestwebsoft.com

 of


Notice: ob_end_flush(): failed to send buffer of zlib output compression (0) in /home/bws/public_html/dev/wp-includes/functions.php on line 5420