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 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
2.1.2. Site Key and Secret Key
2.1.4.5. MailChimp for WordPress
2.1.4.6. Subscriber by BestWebSoft
2.1.4.7. Testimonials by BestWebSoft
2.3. Additional Protective Measures
2.3.2. Allow List Notification
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 “Testimonials” plugin 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 “BuddyPress” plugin 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 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/