vBulletin Mods

The Official vBulletin Modifications Site

reCAPTCHA v2 Human Verification
by kh99
11 Dec 2014 14:32

3 Attachment(s)
(Note: This mod was renamed. The original name was "New reCAPTCHA Human Verification")

What is it?
This mod adds reCAPTCHA v2 as an option in the Human Verification Manager.

Note: The original reCAPTCHA used default keys if you didn't enter your own, so you could leave the key fields blank. This version requires you to have your own keys for your domain. To create them, go to this page (click on the "Get reCAPTCHA" button). It may take a short time after creating the keys before they will work, so if you get "ERROR: Invalid domain for site key", wait a while and try again.

vb3 version is here: http://www.vbulletin.org/forum/showthread.php?t=315964

1) Upload the file in the "upload" folder to your server.

2) Import the product XML file from the Product Manager.

3) If you don't already have keys, go to this page and create keys for your domain. (If you already have keys you can get them from that page as well).

4) Go to Settings > Human Verification Manager, select "New reCAPTCHA" for the Verification Library, and click Save.

5) Enter your keys on the options page, and select the light or dark widget as desired (apparently white and black are the only options at this time). You could select "Audio" to default to audio instead of image for the challenge, but the widget seems to have a bug in it at the moment so I recommend leaving it set to "image". Click Save when you're done selecting options.

6) You can check the configuration and do a test by clicking on "Click here to test connection" which appears under the description in the Human Verification Manager.

7) Do a test registration (or other action that requires hv) to test that your keys are entered correctly and everything is working.

8) If you are upgrading from version 0.9, you can remove the file includes/class_humanverify_newrecaptcha.php (the one without the third underscore) from your server.

1.0 (Feb 22, 2015)
  • Cached template (required renaming the uploaded file from
    class_humanverify_newrecaptcha.php to class_humanverify_new_recaptcha.php)
  • Removed default keys (which didn't work anyway)
  • Removed trademark symbols
  • Changed execution order of plugins from 5 to 4, to make sure this product
    works with another HV add-on that has a bug.
  • If "New reCAPTCHA" is selected when this mod is uninstalled, the hv library
    is switched to 'disabled'.
  • Added a test option to print out more information about verification failures

0.9 (Dec 11, 2014)
  • Initial Release

z3r0 11 Dec 2014 14:38

The zip is missing the upload folder.

kh99 11 Dec 2014 14:40


Originally Posted by z3r0 (Post 2526749)
The zip is missing the upload folder.

Yeah, sorry, I just replaced the zip.

z3r0 11 Dec 2014 14:49

Just tested and it seems to be working fine.


ozzy47 11 Dec 2014 15:25

Nice job Kevin, I'll have to check this out later today. :)

Firyou 11 Dec 2014 17:56

I was hoping we would get access to those spiffy new recaptchas on vbulletin. Thanks for this :)

bridge2heyday 11 Dec 2014 18:11

Thanks for the mod , I was going to start it :D

Skyrider 11 Dec 2014 19:02

Will install this! Though an offtopic question. When I wish to register on google reCAPTCHA page on:

It's showing up the page in german. While I'm dutch and the windows language is set to English. Gmail shows up in English just fine. Any idea what's up with that?

CAG CheechDogg 11 Dec 2014 21:14

Good stuff kh99 ... thank you ! works great !!!!!

Phillip 12 Dec 2014 05:44

Awesome work, kh99. :) Also installed "Marked as Installed" as well.

tanzeelniazi 12 Dec 2014 10:55

any idea using recaptcha for login ???
why not for login use

kh99 12 Dec 2014 11:22

I don't know why they decided not to make "login" one of the actions you could select for human verification. I could see requiring it after one or more "strikes", so that it would make it more difficult to guess passwords. In any case I'm not planning to add it to this mod.

ozzy47 12 Dec 2014 11:25

If I had to do a recaptcha every time I logged into a site, I would leave. :p

CAG CheechDogg 12 Dec 2014 12:50

That would suck lol ... oh Man I can only imagine that lol hahaha !!!

kh99 12 Dec 2014 13:32

As usual, I think it depends on circumstances. If this site decided to implement reCaptcha on login to fight the password guessing attacks that we get periodically, it wouldn't bother me at all. The fact is that I log in using my password so infrequently that remembering my password is much harder than an image verification. And the content here is valuable so I'd deal with it. I'm not sure that it would be important enough for the average site to have, but maybe some admins have their reasons.

All times are GMT. The time now is 00:44.

Powered by vBulletin® Version 3.8.11
Copyright ©2000 - 2017, vBulletin Solutions Inc.
Copyright ©2001 - , vbulletin.org. All rights reserved.