Image Captcha Mod

From TNG_Wiki
Jump to navigation Jump to search
Restricted Downloads of Image Captcha Mod are restricted to logged in users. If you do not have a user account on the TNG Wiki use the Request Account link to request a user account Restricted
Caution If you are having trouble downloading with the Google Chrome browser, try another browser Caution

Image Captcha Mod
Summary Adds a captcha using images to TNG contact pages.
Validation n/a
Mod Updated 22 Feb 2021
Download link
Download stats view statistics
Author(s) Rick Bisbee
Homepage Bisbee Family Connection
Mod Support Support for Image_Captcha_Mod
Contact Developer as above.
Latest Mod
Min TNG V 11.0.2
Max TNG V 13+
Files modified
Related Mods

Description and Use

Image Captcha differs from most, in that it requires visitors to select one of a series of images that differs from the others. There is nothing to type, so you don't have to lay the mouse down to enter impossibly obscured words. It's quick and efficient and most users will actually enjoy the exercise. Those already logged into the website as registered users will not be presented with the Captcha, but will be given direct access to the protected page.

The Image Captcha display consists of a series of 'fill' images which are all the same. A subtly different 'target' image will be arbitrarily positioned among them. You can choose from several sets of images included with the mod, or you can use your own custom images.

Prior to TNGv11 the Image Captcha Mod replaces your current TNG_captcha.php file, if any. It removes it altogether when uninstalled. Not to worry, TNG works fine without it, but if yours contains code you want to keep, please rename it so you can return to it later if you need to.

Beginning with TNGv12 Image Captcha modifies the TNG-supplied captcha file and returns it to factory spec upon removal.

Image Captcha provides language support via text files (cap_text.php) in the mod's support folder, under languages. There is no need to copy them to the TNG language folders because Image Captcha Mod uses them "in place" to prevent corruption of UTF-8 files. Other languages can be added by using these files as templates.

ImCap version only works with TNGv12. Vintage images in this mod are new and come from attractive 19th and early 20th century stock in the public domain. They are slightly larger than in previous versions, but you can set the display size up to 90 px square. If you want to retain your current image set, you can do so by identifying them as custom images in the mod's edit screen and setting the size between 60-90 pixels.

NOTE: If you've upgraded your version of Image Captcha and are not seeing the images, you've probably neglected to uninstall the older version first. Check your customconfig.php and make sure the old version number is not listed after the new one. If so, just delete the old version number from the file.


Image Captcha Mod Tested With TNG Versions
Ver 1000-1002 1003-1101 1102-1200 1200-1301 1302 + PHP 5.6/7.2 PHP 5.6/8

*green: compatible   red: not compatible   white: not tested

See Multisite Testbed for information on how this mod is tested and managed.

Revision History

Version Date Description
v12.0.0.9 24 Apr 2020
  • Removed dependence on customconfig.php. Previous versions used customconfig.php to store certain data. This was a potential problem if a previous version was not uninstalled before installing a new one.
v13.0.2.10 24 Apr 2020
  • Removed dependence on customconfig.php. Previous versions used customconfig.php to store certain data. This was a potential problem if a previous version was not uninstalled before installing a new one.
v13.0.2.9 24 Apr 2020
  • Fixed minor bugs.
v12.0.0.8 24 Sep 2020
  • Fixed minor bugs.
  • Update to same features as v13.0.2.9
v12.0.0.7 24 Apr 2020
  • Removes some test code
v12.0.0.6 5 Jul 2018
  • Corrects bad TNGWiki link
v12.0.0.5 4 Jul 2018
  • Modifies TNGv12 distributed TNG_captcha.php and restores it when mod is removed.
  • All new vintage images.
  • User option to specify image display size
  • Mod edit screen displays available image sets.
v11.0.2.3 17 May 2017
  • Recognizes mod folder path name set in config.php. This feature was introduced in TNGv11.0.2 making this version of the mod incompatible with earlier versions of TNG.
v11.0.0.2 05 Aug 2016
  • Fixed problem with uninstalling improperly
v11.0.0.1 01 Aug 2016
  • Initial release of Image Captcha Mod


Image captcha v12.0.0.5 as seen by a visitor. Clicking anywhere on an image selects it.


Image Sets

There are nine image sets provided with the mod. Each set consists of a "fill" image and a subtly different "target" image. You can also use your own custom images. Image sets are selected using the "Edit Options" button in the Mod Manager.

Set 1 Expand to view TNGv11 Captcha Images
Image set 1 Ic001.jpg
Image set 2 Ic002.jpg
Image set 3 Ic003.jpg
Image set 4 Ic004.jpg
Image set 5
Image set 6 Ic006.jpg
Image set 7 Ic007.jpg
Image set 8 Ic008.jpg
Image set 9 Ic009.jpg
Custom Ic000.jpg

TNGv12 vintage images come from the public domain. Like family history, they represent times gone by.

Set 2 Expand to view TNGv12 Vintage Images
Image set 1


Image set 2

Cigar bands

Image set 3

Frog goes a wooing

Image set 4

Sea creatures

Image set 5


Image set 6

Fashion hats

Image set 7


Image set 8


Image set 9



Custom images should be about 90 pixels square or slightly larger for version 12.

Upgrading From an Add-on

It is important that the Image Captcha add-on be completely uninstalled before installing this mod with Mod Manager.

Open the setup page for your Image Captcha add-on, usually found at, replacing "" with your own domain name.


Click on the Uninstall button at the bottom of the Setup page. After Setup uninstalls the add-on, remove the "imcap" folder from "extensions" and remove the Setup links from any pages or menus you may have created.

Note that if you are still using the v9.0.0.8 of the Add-on, you will need to

  1. download the latest version of the add-on
  2. extract it on your local computer
  3. copy the index.php from the extracted imcap directory
  4. overlay the existing index.php in your extensions/imcap folder

in order to uninstall the add-on on TNG v10.1 and above

Upgrading From an Earlier Mod

Log in as administrator and go to the Mod Manager listing.

Click on the line for the mod you wish to remove and, when it opens, click on "Uninstall."

Installing the Mod

Image Captcha is installed just like any other TNG Mod using the administrator's Mod Manager.

1. Download and unzip the mod package and place the contents in your "mods" folder.

2. Open Mod Manager and find the Mod in the listing.

Note: The first time you list Image Captcha v11, the Mod Manager may show the mod to be Partially Installed because the factory file - TNG_captcha.php - is already in place. Cleaning up the mod will remove it. Installing the mod will replace it with its own TNG_captcha.php file. If you uninstall this mod you should copy the factory TNG_captcha.php file back to the TNG root.

Image Captcha v12 is now available for TNGv12. It modifies the TNGv12 distributed captcha file and returns it to factory spec upon removal. If you have already removed or modified the TNG file, you will need to restore the original from the TNG distro package before you can install Image Captcha v12.

3. Open the Mod line, Click on Clean Up and then click on "Install."

4. If you want to change the default values, open the Mod line and click on "Edit Options."

Review each option and change it where desired, remembering to save each one as you change it.

To use your own images -

1. Create two similar images, one as a filler, the other to serve as the target. Make sure they are the same size and about 64 pixels square.

2. Put them in the TNG "img" folder (or anywhere else you like).

3. Open the Mod Manager, click on the Image Captca Mod line, and click "Edit Options."

4. Select Image Set 0 and save it.

5. Image paths are always relative to the TNG root folder. In the appropriate box enter and save the path for the fill image - for example: img/myfill.jpg (do not surround with quotes.)

6. In the other box enter and save the path for the target image - for example: img/mytarget.jpg (do not surround with quotes.)

To test the captcha, log out of the site, go to the home page and under the "Info" dropdown menu select "Contact us."

Image Captcha Options

  • In Mod Manager click on the Image Captcha Mod line to open it. Click on "Edit Options.
  • The first option lets you choose how many total images to show in the captcha. Default is 8.
  • You can set the size of the images in Image Captcha v12 between 60-90 pixels or so. Version 11 is fixed at 60px square.
  • You can select the image set you prefer, or use a custom set by setting the image set option to 0 (zero).
  • In TNGv12, you will see the target and fill images to help you select an image set if your mods are in the TNG standard 'mods' directory. If your mods are somewhere else you will see the image set names.
  • If you choose to use a custom image set (Option 0), you must enter a TNG root-relative path to both a fill image and a target image. We recommend you place your custom images in TNG's 'img' folder so they won't be lost in a TNG or mod upgrade.
  • Change the options as you wish, saving each one as you change it. Each value has a button to allow you to restore the default values if you want.
Expand to view TNGv11 Captcha Options
Ic opts1.jpg
Expand to view TNGv12 Captcha Options
Nic 021.png

Nic 022.png

Uninstall Image Captcha

To uninstall the Image Captcha, log in as administrator, go to the Mod Manager, open the line for the mod in the listing and click "Uninstall."

Custom Text

The mod comes with support for several languages in addition to English. If you want to use the Image Captcha Mod with another language, you will need to create a cap_text.php file similar to those provided for the English and English-UTF8 and place it in the mod support folder under languages. If you submit the file to the author of the mod, we will include it in future versions.


No particular problems have been encountered with this mod, but as always, use it at your own risk.

Always re-test the Image Captcha after upgrading TNG.

Sites using this mod

This is a list of sites using the Image Captcha add-on. I hope you will find the Mod a little easier to use.

If you download and install this mod, please add/update your TNG Site to the table below:

URL User Note Mod-Version TNG-Version User-language
Bisbee Family Connection Rick Bisbee Mod Developer 12.3 EN
Racines Luxo-hennuyères Michel Kirsch Too many spams ! Thx Rick ! 13.0.3 FR/EN/DU/GE
Online Genealogist Jon Grubbs After getting errors with Google's reCAPTCHA I decided to install this mod 13.0 English
Our Roy and Boucher Family Ken Roy I replaced the reCaptcha mod with the Image Captcha Add-on in TNG V8, V9, and V10 and this mod in TNG V11. Beta tested v11.0.2.3 that supports renaming the mods folder 11.1.1 EN, FR
Hooley Family Links Rick Hooley Public/Private See Here See Here EN
Thames/Tims Family Association Dustin Thames After upgrading our site from v5 to v9, I added this Captcha mod. 9.0.4 EN
Kemp(e) Family History Andrew Kemp Replaced the reCaptcha mod with this mod in TNG V9 see User:Kempons see User:Kempons EN
DLMax-Max Westen's genealogy site Max Westen Love this version. Changed the dutch language a bit though! ;). 9.1.0 NL, EN
Our Family Genealogy Pages Roger Navarre No more complaints about illegible captcha words! Thanks 9.2.0 EN
MOTYER Family Genealogy John Mark Motyer Public site see here see here EN, DE, RU
De veenkoloniale genealogieën Henny Savenije Very effective against all kind of fake registrations. Thanks 9.2.1 English, Dutch, Afrikaans, German, French, Spanish, Korean, Portuguese, Italian
my family Oname.gif (no public site) see User:ojay see User:ojay D,(NL),(GB)
Familienforschung Scabell Helga Scabell Public Private 13.0.1 Germans
MULLFAMILIES Michael 25 bot registrations one morning !! no more. Many thanks : TNG v 9.2
Roni & Jerry's Genealogy and Family History Jerry Liebowitz TNG v 10.1 English
British 1820 Settlers to South Africa Paul Tanner-Tremaine TNG v 12.0.1 English
Schmit / Heemskerk Familie Rudi Schmit TNG v 10.1.3 English, Dutch, German
R G Strong Family Genealogy Russell Strong 11.0.1 EN, DE, FR, NL
Our Acadian Family Randal Suire Great Mod 11.0.1 EN, FR
Roots & Relatives Remembered Ron Krzmarzick Public & Private See Here See Here EN,DE,CS
Atherton One Name Study Derek Atherton 11.1 English
Racine d'Alsace J-Louis Valory Public/Private - T17 customized 12.0.2 FR
Genealogy of the Weir and Drain Families Beverley Stimpson Public Site 11.1.2 EN
The Grahams of Helensburgh Jim Graham Public Site 12.0 English
Sanderson Ancestors Alexandra Private Site 12.0.1 English
Martius Family Hendrik Martius Half public 12.0.1 DE, EN, FR, NL
Lloyd & Lucas - A Merging of Interests Chris Lloyd Public site 12.0.1 English
Genealogische Datenbank JPB Public site see here see here DE, EN, FR
Leicestershire Antills and Connected Families John Antill Public site 12.0.3 English
The Shardalow name and variations John Shardalow Brilliant...thanks! 12.1 English
Barta-Joggele Online aus Mauren, Liechtenstein Gerald Meier Private 12.2 DE, EN, FR, ES, PT
Familienforschung SCABELL Helga Scabell Public/Private 13.0.1 DE
Cordes-Thomas Genealogy John Cordes Public 12.3 EN
Leverette Family History Jeff Leverette Public 12.3 EN
Descendants of John Jaffray Robert Gray Wasn't able to get the Google V2 recaptcha to work, this is fine. Thanks 12.3 EN
YourTrees Berkshire FHS/Paul Barrett Private/Synology NAS 13.0.4 English
Hangaard Genealogy David Hangard Public / Private 13.0.4 EN, NO