Image Captcha Mod
|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|
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.|
|Mod Updated||see Revision History|
|Download stats||view statistics|
|Homepage||Bisbee Family Connection|
|Mod Support||Support for Image_Captcha_Mod|
|Contact Developer||as above.|
|Min TNG V||11.0.2|
|Max TNG V||11.1.1|
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.
*green: compatible red: not compatible white: not tested
See Multisite Testbed for information on how this mod is tested and managed.
|v220.127.116.11||17 May 2017||
|v18.104.22.168||05 Aug 2016||
|v22.214.171.124||01 Aug 2016||
Default captcha as seen by a visitor. Clicking anywhere on the image selects it.
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.
|Image set 1|
|Image set 2|
|Image set 3|
|Image set 4|
| Image set 5
|Image set 6|
|Image set 7|
|Image set 8|
|Image set 9|
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 v126.96.36.199 of the Add-on, you will need to
- download the latest version of the add-on
- extract it on your local computer
- copy the index.php from the extracted imcap directory
- 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 it, 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 uinstall this mod you should copy the factory TNG_captcha.php file back to the TNG root.
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."
In Mod Manager click on the Image Captcha Mod line to open it. Click on "Edit Options."
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."
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:
|Bisbee Family Connection||Rick Bisbee||Mod Developer||188.8.131.52||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 v184.108.40.206 that supports renaming the mods folder||220.127.116.11||11.1.1||EN, FR|
|Thames/Tims Family Association||Dustin Thames||After upgrading our site from v5 to v9, I added this Captcha mod.||18.104.22.168||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! ;).||22.214.171.124||9.1.0||NL, EN|
|Our Family Genealogy Pages||Roger Navarre||No more complaints about illegible captcha words! Thanks||126.96.36.199||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||188.8.131.52||9.2.1||English, Dutch, Afrikaans, German, French, Spanish, Korean, Portuguese, Italian|
|my family||(no public site)||see User:ojay||see User:ojay||D,(NL),(GB)|
|Familienforschung Scabell||Helga Scabell||Danke für die einfache Installation||184.108.40.206||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||10.1.0.11||TNG v 10.1||English|
|British 1820 Settlers to South Africa||Paul Tanner-Tremaine||10.1.0.11||TNG v 10.1.1||English|
|Schmit / Heemskerk Familie||Rudi Schmit||10.1.0.11||TNG v 10.1.3||English, Dutch, German|
|R G Strong Family Genealogy||Russell Strong||220.127.116.11||11.0.1||EN, DE, FR, NL|
|Roots & Relatives Remembered||Ron Krzmarzick||Public & Private||18.104.22.168||11.1.2||EN,ES,CS,DE|
|Atherton One Name Study||Derek Atherton||22.214.171.124||11.1||English|
|Racine d'Alsace||J-Louis Valory||Public/Private - Template 17||126.96.36.199||11.1.1||French|
|Genealogy of the Weir and Drain Families||Beverley Stimpson||Public Site||188.8.131.52||11.1.2||EN|
|The Grahams of Helensburgh||Jim Graham||Public Site||184.108.40.206||12.0||English|