Difference between revisions of "Image Captcha Mod"

From TNG_Wiki
Jump to: navigation, search
(Sites using this mod)
(Sites using this mod)
Line 368: Line 368:
| 11.1
| 11.1
| English
| English
| [http://racine-ad.fr/TNG/index.php Racine d'Alsace]
| J-Louis Valory
| Public/Private - Template 1
| 11.1.1
| French
[[Category:Mods for TNG v11]]
[[Category:Mods for TNG v11]]
[[Category:Mods for TNG v10]]
[[Category:Mods for TNG v10]]
[[Category:Other Scripts]]
[[Category:Other Scripts]]

Revision as of 11:15, 24 June 2017

This is the Mod Manager version of the Image Captcha add-on for TNG. The add-on should be uninstalled and removed before installing this mod.

Image Captcha Mod
Summary Adds a captcha using images to TNG contact pages.
Validation n/a
Mod Updated {{{mod_last_update}}}
Download link
Download stats view statistics
Author(s) Rick Bisbee
Homepage Bisbee Family Connection
Mod Support Support for Image Captcha Mod
Contact Developer Rick Bisbee
Latest Mod
Min TNG V 11.0.2
Max TNG V 11.1.1
Files modified
Related Mods
Build A16.08.05.125218


This Captcha 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 page.

The 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 add-on, or you can use your own custom images. When making a selection from the Edit Options page of the mod, a link will bring you here to remind you what they look like.

The Image Captcha Mod replaces your current TNG_captcha.php file. 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.

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.

The latest version of the mod will recognize that the mod folder has been renamed and work with it.


Image Captcha Mod Tested With TNG Versions
Ver 1000 1001 1002 1003 1010 1011 1012 1013 1100 1101 1102 1110 1111

*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
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


Default captcha as seen by a visitor. Clicking anywhere on the image selects it.


Image Sets

There are nine image sets provided with the mod. You can also use your own custom images. Image sets are selected using the "Edit Options" button in the Mod Manager.

Option 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

Custom images should be about 64 pixels square or slightly larger.

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 www.example.com/extensions/imcap/index.php, replacing "example.com" 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.

3. Open the Mod line and 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."

Setting Options

In Mod Manager click on the Image Captcha Mod line to open it. Click on "Edit Options."

Ic opts1.jpg

Options let you choose how many total images to show in the captcha. Default is 8.

You can select the image set you prefer, or use a custom set by setting this option to 0 (zero).

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. Recommend you place your custom images into TNG's img folder so they won't be lost in an upgrade.

Change the options as you wish, saving each one as you change it. There is a button to allow you to restore the default values if you want.

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 11.0.1 EN
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
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 Danke für die einfache Installation 9.2.2 D
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 10.1.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
Roots & Relatives Remembered Ron Krzmarzick Public & Private 11.1.1 EN,ES,CS,DE
Atherton One Name Study Derek Atherton 11.1 English
Racine d'Alsace J-Louis Valory Public/Private - Template 1 11.1.1 French