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|
|Image Captcha Mod|
|Summary||Adds a captcha using images to TNG contact pages.|
|Mod Updated||4 Jul 2018|
|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||12+|
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 18.104.22.168 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. This is a trial version. If you have any problems, please contact me and we'll work to fix them.
*green: compatible red: not compatible white: not tested
See Multisite Testbed for information on how this mod is tested and managed.
|v22.214.171.124||5 Jul 2018||
|v126.96.36.199||4 Jul 2018||
|v188.8.131.52||17 May 2017||
|v184.108.40.206||05 Aug 2016||
|v220.127.116.11||01 Aug 2016||
Image captcha v18.104.22.168 as seen by a visitor. Clicking anywhere on an image selects it.
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|
|Image set 2|
|Image set 3|
|Image set 4|
| Image set 5
|Image set 6|
|Image set 7|
|Image set 8|
|Image set 9|
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
| Image set 3
Frog goes a wooing
| Image set 4
| Image set 5
| Image set 6
| 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 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 v22.214.171.124 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 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|
|Expand to view TNGv12 Captcha Options|
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||126.96.36.199||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 v188.8.131.52 that supports renaming the mods folder||184.108.40.206||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.||220.127.116.11||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! ;).||18.104.22.168||9.1.0||NL, EN|
|Our Family Genealogy Pages||Roger Navarre||No more complaints about illegible captcha words! Thanks||22.214.171.124||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||126.96.36.199||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||188.8.131.52||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||184.108.40.206||TNG v 12.0.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||12.0.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 - T17 customized||126.96.36.199||12.0.2||FR|
|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|
|Sanderson Ancestors||Alexandra||Private Site||220.127.116.11||12.0.1||English|
|Martius Family||Hendrik Martius||Half public||18.104.22.168||12.0.1||DE, EN, FR, NL|
|Lloyd & Lucas - A Merging of Interests||Chris Lloyd||Public site||22.214.171.124||12.0.1||English|
|Current info on my user site||JPB||Public site||...||...||DE, EN,|
|Leicestershire Antills and Connected Families||[[User:TGLE|John Antill]||Public site||126.96.36.199||12.0.3||English|