ReCaptcha Integration for WordPress
weDevs By weDevs

June 02, 2022

ReCaptcha Integration for WordPress Plugin

reCaptcha for login, signup, comment forms, Ninja Forms and woocommerce.

Integrate reCaptcha in your blog. Supports no Captcha as well as old style recaptcha.
Provides of the box integration for signup, login, comment formsand Ninja Forms as well
as a plugin API for your own integrations.

Features:

  • Secures login, signup und comments with a recaptcha.
  • Supports old as well as new reCaptcha.
  • Works together with

    • WP Multisite
    • bbPress
    • BuddyPress
    • AwesomeSupport (thanks to Julien Liabeuf )
    • WooCommerce (Only checkout, registration and login form. Not password reset)
    • Ninja Forms
    • cformsII
  • For integration in your self-coded forms see this wiki article for details.

Localizations

Latest Files on GitHub: https://github.com/tareq1988/wp-recaptcha-integration

Compatibility

On a WP Multisite you can either activate the plugin network wide or on a single site.

Activated on a single site everything works as usual.

With network activation entering the API key and setting up where a captcha is required
is up to the network admin. A blog admin can override the API key e.g. when his blog is
running under his/her own domain name.

Known Limitations

  • You can’t have more than one old style reCaptcha on a page. This is a limitiation of
    reCaptcha itself. If that’s an issue for you, you should use the no Captcha Form.

  • A No Captcha definitely requires client side JavaScript enabled. That’s how it does its
    sophisticated bot detection magic. There is no fallback. If your visitor does not have
    JS enabled the captcha test will not let him through.

  • On a Contact Form 7 when the reCaptcha is disabled (e.g. for logged in users) the field
    label will be still visible. This is due to CF7 Shortcode architecture, and can’t be fixed.

    To handle this there is a filter recaptcha_disabled_html. You can return a message for your logged-in
    users here. Check out the GitHub Repo for details.

  • As of version 4.3 CF7 comes with its own recaptcha. Both are supposed to work together.
    I you want to keep the WP ReCaptcha functionality, e.g. if you want to hide the captcha
    from known users, leave the integration in the CF7 settings unconfigured.

  • Old style reCaptcha does not work together with WooCommerce.

  • In WooCommerce the reset password form can not be protected by a captcha. Woocommerce does
    not fire any action in the lost password form, so there is no way for the plugin to hook in.
    Take a look at this thread for a workaround.

  • Due to a lack of filters there is no (and as far as one can see, there will never be)
    support for the MailPoet subscription form.

Plugin API

The plugin offers some filters to allow themes and other plugins to hook in.

See GitHub-Repo for details.

Installation

First follow the standard WordPress plugin installation procedere.

Then go to the Google Recaptcha Site, register your site and enter your API-Keys on the configuration page.

Screenshots

  1. Plugin Settings (v 1.1.4)

    Plugin Settings (v 1.1.4)

  2. Ninja Form Integration

    Ninja Form Integration

  3. Contact Form 7 Integration

    Contact Form 7 Integration

FAQ

The login captcha says ‘ERROR: (something somthing)’. What can I do?

If it says ‘Invalid sitekey’ and you checked the ‘Prevent lockout’ option on the plugin
settings (it’s on by default) you can log in with an administrator account and ignore the
captcha. If the keys are really invalid, the plugin will let you in, so you can set up a
new keypair.

When you see “Invalid domain for site key”, then the key is okay in general, but not for
your domain. The server can not test this case, so an effective lockout prevention is not
possible.

You will either need one of the following:
– access to the settings for your sitekey on reCaptcha API key administration
– access to your WordPress installation (via SSH or FTP) or database access
– database access

With API key admin

  1. Look at source code of the login page.

  2. Find the part saying data-sitekey="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
    (The XXX-part should be your sitekey.)

  3. Go to the Google reCaptcha API key administration

  4. Find the list entry with the sitekey from step 2

  5. If lockout prevention is enabled you can simply delete the key set up a new one.
    If not enter your domain name at “Domains” in a new line and wait up to 30 minutes.

With FTP Access:

  1. Add this line of Code somewhere at the end of your theme functions.php:
    add_filter(‘wp_recaptcha_required’,’__return_false’);

    This will disable the chaptcha everywhere.

  2. Set up a new keypair and test it.

  3. Remove the line above from your theme functions.php.

If you have Database access

  1. Execute the following SQL-Commands in your Database:
    DELETE FROM wp_options WHERE option_name = ‘recaptcha_publickey’;
    DELETE FROM wp_options WHERE option_name = ‘recaptcha_privatekey’;

    (Please note that wp_options might have a different prefix in your installation.)

  2. After the login you will see a message asking you to set up the API keys.

  3. Set up a new keypair on Google and test it.

If none of these works for you

That’s too bad…

I can’t get it to work with my custom comments form. Will you fix for me?

Nope. I cannot give support on your individual projects for free, no matter how many one
star reviews you will give me. Have a look at the project wiki or find a WordPress coder.

Privacy: Will the captcha send the visitors IP address to google?

Yes and no. The captcha verification process, comming into effect after the user has solved
the challenge does not require the disclosure of the visitors IP address, so it is omitted.

But everything related to the displaying of the captcha widget like the challenge image,
the JavaScripts and so on is loaded directly from Google and is very likely to be logged,
evaluated and stored forever.

In other words: Google knows which (recaptcha protected) website is accessed from which IP.

If that’s an issue for you, you better use a self hosted solution.

Will you support plugin XYZ?

If XYZ stands for a widely used free and OpenSource plugin in active development with some
100k+ downloads I will give it a try. Just ask.

If XYZ is some rarely used plugin (about 1k+ active installs or so), I will accept pull
requests on github and push it to the WP repository. Please note that in such cases I will
not feel responsible for code maintainance.

The captcha does not show up. What’s wrong?

On the plugin settings page check out if the option “Disable for known users” is activated (it is by default).
Then log out (or open your page in a private browser window) and try again.

If only the comment form is affected, it is very likely that your Theme does not use the
comment_form_defaults filter. (That‘s where I add the captcha HTML, to make it appear
right before the submit button.) You will have to use another hook, e.g. comment_form_after_fields.

Here is some code that will fix it:

  • Go to (https://gist.github.com/tareq1988/97d7f442ee3e92b7412e)
  • Click the “Download Gist” button
  • Unpack the .tar.gz file.
  • Create a zip Archive out of the included file recaptcha-comment-form-fix.php and name it recaptcha-comment-form-fix.zip.
  • Install and activate it like any other WordPress plugin

If the problem still persist, Houston really has a problem, and you are welcome to post a support request.

Disabled submit buttons should be grey! Why aren’t they?

Very likely the Author of your Theme didn’t care that a non functinal form element should
look different than a functional one. This how you can overcome that issue:

  • Go to (https://gist.github.com/tareq1988/7cbfb0dab73eb32cb4a2)
  • Click the “Download Gist” button
  • Unpack the .tar.gz file.
  • Create a zip Archive out of the included file grey-out-disabled.php and name it grey-out-disabled.zip.
  • Install and activate it like any other WordPress plugin

I want my visitors to solve only one Captcha and then never again. Is that possible?

Yes. You can store in a session if a captcha was solved, and use the wp_recaptcha_required
filter to supress further captchas. See (https://github.com/tareq1988/wp-recaptcha-integration#real-world-example)
for a code example.

I found a bug. Where should I post it?

I personally prefer GitHub but you can post it in the forum as well. The plugin code is here: GitHub

I want to use the latest files. How can I do this?

Use the GitHub Repo rather than the WordPress Plugin. Do as follows:

  1. If you haven’t already done: Install git

  2. in the console cd into Your ‘wp-content/plugins´ directory

  3. type git clone [email protected]:tareq1988/wp-recaptcha-integration.git

  4. If you want to update to the latest files (be careful, might be untested with your WP-Version) type `git pull.

Please note that the GitHub repository is more likely to contain unstable and untested code. Urgent fixes
concerning stability or security (like crashes, vulnerabilities and alike) are more likely to be fixed in
the official WP plugin repository first.

I found a bug and fixed it. How can I contribute?

Either post it on GitHub or—if you are working on a forked repository—send me a pull request.

Will you accept translations?

Since late 2015 WordPress.org offers a plugin translation API. Just use the
“Translate this plugin” button in the right sidebar.

Changelog

v1.2.5 (11 October, 2021)

  • WordPress 5.8.1 compatibility

v1.2.4 (6 July, 2020)

  • Removed abandonment notice, plugin is no longer unmaintained.

1.2.1

  • Drop most of Contact form 7 and Ninja Forms support. (Both have their own recaptcha now)
  • Register Form compatibility with WooCommerce 3.0+ Thanks to ywatt and MrFent37
  • Fix WSOD

1.2.0

1.1.11

  • Code: Move plugin main class to include directory
  • Update: Disable 2.0 updates on PHP < 5.4

1.1.10

  • Feature: Changed Contact Form 7 support: As of version 4.3 CF7 comes with its own recaptcha. The plugin now just makes sure both captchas work together. It also keeps the API keys in sync.
  • Fix: Disable Captcha for logged in users now respects custom roles without read capability. (Thanks to @lainme)

1.1.9

  • Fix: Layout issues on recaptcha nojs fallback (thanks to nurupo)
  • Metadata: add plugin textdomain

1.1.8

  • Feature: Support AwesomeSupport
  • Feature: Support bbPress new Topics and posts
  • L10n: italian
  • Fix: Layout issue on theme twenty fifteen (recaptcha)

1.1.7

  • Fix: Compatibility with CF7 4.2 User Interface

1.1.6

  • Fix: Skip Ninja Forms required check

1.1.5

  • Feature: Noscript fallback option for noCaptcha
  • Feature: Option for WP 4.2 compatible hook on comment form.
  • Fix: Remove automatic key testing in Backend.
  • L10n: Improved de_DE (thx @quassy)
  • L10n: Updated pt_BR (thx again man)

1.1.4

  • Comments: get back to comment_form_defaults filter (was introduced in 1.1.3)
  • Fix: Get key option
  • Fix: Key testing return value

1.1.3

  • Comments: use filter comment_form_submit_button in WP >= 4.2
  • WooCommerce: Add action listener to woocommerce_lostpassword_form (probably functional in WC 2.3.8).
  • Introduce {$feature}recaptcha_html filters for custom form integration.
  • Introduce filter wp_recaptcha_cf7_shortcode_wrap.

1.1.2

  • Fix: Was not possible to uncheck lockout setting.
  • Fix: Potential JS error when ‘Disable Submit Buttons’ was enabled.

1.1.1

  • Filter: wp_recaptcha_do_scripts allow disabling recaptcha scripts on certain pages.
  • Filter: wp_recaptcha_print_login_css, allow disabling login CSS.
  • Fix: Didn’t render with Submit Button Disabling checked
  • Fix: Use add_query_arg() to generate recaptcha API URL

1.1.0

  • Feature: Prevent Lockout – Admins can still log in when the API keys are invalid
  • Feature: Customize error message on contact form 7 and ninja forms
  • Filters: add actions recaptcha_print, print_comments_recaptcha and filters recaptcha_valid, recaptcha_error for custom forms.
  • Redesign: settings page
  • Fix: woocommerce checkout form: fix unnecessary captcha test on new customer registration
  • Fix: settings: testing keys for multiple times
  • Fix: settings: key setup -> cancel button target
  • Fix: settings: test keys only with a nocaptcha

1.0.9

  • Fix: Preserve PHP 5.2 compatibility

1.0.8

  • Feature: Individually set captcha theme in CF7 and Ninja forms (NoCaptcha only, old recaptcha not supported)
  • Fix: PHP Warning in settings.
  • Fix: PHP Fatal when check a old reCaptcha.
  • Fix: js error with jQuery not present
  • Fix: woocommerce checkout
  • L10n: add Spanish

1.0.7

  • Fix: Fatal error in settings
  • Fix: messed up HTML comments
  • Code: Put NinjaForms + CF7 handling into singletons

1.0.6

  • Code: separate classes for recaptcha / nocaptcha
  • Code: Class autoloader
  • Fix: avoid double verification
  • Fix: CF7 4.1 validation

1.0.5

  • Add Language option
  • Brasilian Portuguese localization
  • Fix: conditionally load recaptcha lib.
  • Fix: js error after cf7 validation error.

1.0.4

  • Add WooCommerce Support (checkout page)
  • Multisite: protect signup form as well.
  • Reset noCaptcha after ajax calls (enhance compatibility with Comment Form Ajax plugin)
  • Fix: incorrect redirect after saving Network settings

1.0.3

  • Add BuddyPress support
  • Action hook for wp_recaptcha_checked
  • NoCaptcha: add non-js fallback.
  • Code: pass WP_Error to wp_die() when comment captcha fails.
  • Code: Rename filters recaptcha_required > wp_recaptcha_required and recaptcha_disabled_html > wp_recaptcha_disabled_html
  • Happy New Year!

1.0.2

  • Feature: option to disable submit button, until the captcha is solved
  • Rearrange comment form (put captcha above submit button)
  • Fix: NoCaptcha did not refresh after submitting invalid ninja form via ajax

1.0.1

  • Fix API Key test
  • Fix theme select

1.0.0

  • Allow more than one no Captcha per page
  • Test captcha verification in Settings
  • Multisite support.

0.9.1

  • Add testing tool for checking the api key.
  • Fixes

0.9.0

Initial Release

Details

  • Version: 1.2.5
  • Active installations: 10,000
  • WordPress Version: 3.8
  • Tested up to: 6.0.9
  • PHP Version: 5.4

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars