Clear all

[Closed] hCaptcha and wpForo v2+ [ SOLUTION ]

5 Posts
3 Users
2 Reactions
Posts: 14
Topic starter
Eminent Member
Joined: 2 years ago

I really wish the option to use either reCAPTCHA or hCaptcha was built into wpForo, but since wpForo is hardcoded for Google's reCAPTCHA, it was necessary for me to edit the plugin itself. Below is my recorded account of the process for making this happen.

  • Accurate as of wpForo v2.0.2
  • WordPress Plugin File Editor was use to make (most of) the edits, because the changes were immediately live on the site and for this situation I did not use a staging area. If you edit the files locally, simply upload them to your server.
  • Always backup your files or work on copies. That way if something goes sideways, you can always revert back and try again.






  1. Locate (on line 809): 

    Replace it with: 


  2. Locate:

    There were two instances: one at line 857 and the other at 859
    Replace them both with:



  3. Locate on line 859: 


    Replace it with: 


In wpForo's settings area in the WP dashboard, enter your hCaptcha site key and secret key in the same fields as is done with reCAPTCHA. Then press "Save Options" button. 

Now go back to your browser and reload your wpForo login/register page. The hCaptcha function should now be visible and active.

If you don't care that everything still says "reCAPTCHA" within wpForo, then you can stop here as there is nothing more that you need to do to get hCaptcha working. However, if you are OCD challenged like me, proceed on to Part 2.


Replace ONLY strings. For any search hits you get that are not strings - leave them as is. Do not change them. If you are not sure about a line, don't change itLook for verbiage such as "Google reCAPTCHA" or "reCAPTCHA".

Search inside these files, I have included code lines for some of them:


Go to lines 72 & 73 and add a line for hCaptcha. I added mine alphabetically, so I moved line 73 down to line 74, and then I added hCaptcha to line 73.



Update lines 413, 414, 594



Update miscellaneous strings found on lines 862, 871, 874, 957



There are various strings scattered within this file. Some are identified below:

  • Replace reCAPTCHA image with hCaptcha (line 2297). You can use a link for this if you wish. I used a base64 image to embed it directly within the code. I also colored the image so that it matches with the rest of the wpForo theme.
  • Update and reword the descriptions (lines 2298, 2299) then work your way down.
  • Replace hCaptcha site link (line 2311)
  • Update the reCAPTCHA theme label (lines 2334, 2335)



Update strings found on lines 2575, 2602



Update strings found on lines 108, 167, 899-900



(This file is not editable inside WP Plugin File Editor)
Update strings found on lines 4140-4141, 4194, 4199, 4202, 4206, 4215, 4224, 5900, 6154, 8110


I only looked at English language files. If you want an international experience, you will have to edit the language files as well. If you edited any files locally, upload them to your server.



4 Replies
Posts: 3650
Famed Member
Joined: 3 years ago

Thank you @ktalos, Such a good guide.

Posts: 14
Topic starter
Eminent Member
Joined: 2 years ago

v2.0.5 - Only minor line changes. Otherwise the same. 


  • Update lines 2181, 2182
  • Replace "Google reCAPTCHA" lines 2297, 2298
  • Replace reCAPTCHA image with hCaptcha (line 2299)
  • Update and reword the descriptions (lines 2300, 2301)
  • Update Labels (lines 2311, 2312)
  • Reword text and replace link with hCaptcha site link (line 2313)
  • Update the reCAPTCHA theme label (lines 2336, 2337)



  • Update string and link found on line 2590
  • Update string line 2617
2 Replies
Joined: 8 years ago

Support Team
Posts: 10526


is there a way to use hCaptcha without editing wpForo files?

We can add all necessary hooks to let hCaptcha to be integrated.

Joined: 2 years ago

Eminent Member
Posts: 14


I'm sure that is possible, but I haven't explored that particular avenue as of yet.

I think for the core it shouldn't be too difficult to setup an if, then, variable framework for an option in settings. It is possible that the adding of new strings will be the most time consuming part. However, that will help keep things clean and tidy, but also this would make it much easier to add another option for validation should the need arise in the future. 

However, that does mean more work right up front.

But to only add hCaptcha as another built-in feature should be painless because it literally is a drop-in replacement for reCAPTCHA. The biggest pain would be the strings.