Geocode Assistant

From TNG_Wiki
Jump to navigation Jump to search
Restricted Downloads of Geocode Assistant 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 using try right-click and select Open in new Window, then F5, or use another browser Caution
Geocode Assist
Summary Allows geocoding locations from the person page
Validation Latest mod is XHTML compliant.Valid-xhtml10.png
Mod Updated 5 Jun 2021
Download link for
TNG 13.0.4
TNG 13.0
TNG 12.0
TNG 11.0

TNG 10.1.0
excludes Don't Geocode locations
TNG 10.0
TNG 9.0
TNG 8.0 for
TNG 7.0 for

TNG 6.0
Download stats View download stats
Author(s) Brian McFadyen
maintainted by Ken Roy
Homepage Geocode Assist Mod (this page)
Mod Support TNG Community Forums
Contact Developer
Latest Mod for TNG 13.0.4+ for TNG 13+ for TNG 11 and up for TNG 10.1 and up for TNG V9
8.1.2 for TNG V8
Min TNG V 7.1.0
Max TNG V 12+
Files modified
globabllib.php - v11.0.0.1 and later
personlib.php - v10.1.0.2 and previous
Related Mods
In TNG V9 through TNG 10.0.3, if you install the Wiki Integration mod along with this mod, the Wiki Integration mod must be installed before the Geocode Assist Mod.


This mod provides an easy way to geocode locations. A small globe icon is added on the person page to the location that has not yet been geocoded. You must have Admin privileges to use this mod.

Geocoding is the process of coding a latitude and longitude for a location that allows the display of the location in the Google Maps section of the TNG page. In TNG, it also includes setting the Place Level and Zoom values. The small globe icon will only be shown when you are logged in with Admin privileges and only for locations that currently do not have latitude and longitude information.

The geocode_assistant function is added to personlib.php to return the html that adds a geocode globe url link next to the location name if no latitude and longitude information exists. When you click on the globe, a new window will be opened that allows you to quickly geocode this location, since the Edit Place geocode screen form has been pre-filled you only need to click the Search button. The latitude and longitude information will be automatically added to the TNG Place record when you click the Save button.

Version 8.1.1 of the mod now closes the Edit / Update Place window when you save the geocoded location. Note that the Edit window close is incorporated into TNG V9, so the enhancement part of the mod was dropped.

Version 8.1.2 of the mod is XHTML compliant.

TNG version: 10.0.3
TNG version: 9.0

In TNG V9 throught TNG 10.0.3, while there is not mod conflict per se. If you install the Wiki Integration mod along with the the Geocode Assist Mod, the Wiki Integration mod must be installed before the Geocode Assist Mod in order to get the globe icon to display after the Place name. This conflict was resolved in TNG 10.1


This mod was developed by Brian McFadyen and enhanced by Ken Roy in version 8.1.1

V11.0.0.1 added the geocode assistant to the search results page. Code provided by Teresa Goatham.


  • A working TNG installation. The config file release was initially tested at TNG Version 7.1.0
  • A backup of your TNG personlib.php file.
  • An installed current version of the Mod Manager.

Revision History

Version Date Contents
V13.0.4.5 5 Jun 2021 Updated to use TNG v13.0.4 so that admin_editplace.php screen returns control to the Individual (getperson.php) page when Save+Exit or Cancel button is clicked. While the mod may install correctly on all TNG v13 versions/releases, it requires TNG 13.0.4 change in admin_editplace.php to return control to getperson.php page
V13.0.0.4 2 Nov 2020 Updated to use TNG v13 Do Not Geocode functionality and fix PHP warnings and notices for TNG v13 and later
V11.0.0.3 4 Mar 2018 Updated to add the geocode assistant to the Search results page. Code provided by Teresa Goatham. Geocode assistant function was moved from personlib.php to globallib.php. Note that this version might in fact install and work on TNG 10.1 and above but has not been tested as such.
V10.1.0.2 16 May 2017 Updated to not display the geocode globe if the placelevel is set to "-1" (Don't geocode) which can be set by the Admin Places Geocode mod
V10.1.0.1 10 January 2015 Updated for TNG V10.1 to support MySQLi
V9.0.0.0 2 February 2012 Updated for TNG V9
V8.1.2 8 February 2011 Updated to be XHTML compliant.
V8.1.1 30 October 2010 Updated to now close the Edit Place window when you save the geocoded location.
V8.1.0 May 28, 2010 Updated for TNG 8 and to conform to the Mod Manager Parameter Editing
V1.6 Dec 4, 2009 Updated config file documentation to point to TNG Wiki. This file is identical as that of V1.5 included in the Mod Manager zip file, but will soon be eliminated from the bundle.
V1.5 May 18, 2009 Initial release of config file

Automated Installation

  1. Download the appropriate distribution for your TNG version from the download links in the status area in the upper right.
  2. Extract the to your ./mod_folder (V7) or ./mods (v8 and after).
  3. Uninstall the previous version of the mod before installing the new version
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the geocode_assist.cfg.

Side effects

As with most source code modifications, these changes will likely be overwritten during your next TNG revision upgrade and will need to be re-implemented. (Using the Mod Manager greatly simplifies this process).

Do not Geocode

Version v10.1.0.2 of the mod will not display the Geocode globe if the place level is to -1 (Don't Geocode) which can be set by the Admin Places Geocode mod. If you import your data via GEDCOM, then it requires that your Places set to Don't Geocode not be deleted or replaced by the import.

As far as I know TNG only preserves the Places table entry under the following circumstances:

  • Place contains geocode (latitude/longitude) data
  • Places are shared or pooled with other trees

You can set the option to pool Places in Admin > Setup > General Settings by expanding the Miscellaneous section and changing the Assign Place records to Trees: to NO

Setting the option to No will then provide another screen to eliminate the treeID (gedcom column) from the places. Make sure you click Save in General Settings after changing this option, which was designed to Pool Places for multiple trees. Changing the option to remove the tree from the Places means you are pooling places, that is sharing them with other tree, so TNG will not delete the places table or entries within it. Pooling Places can be used even though you only have one tree, to prevent the Don't Geocode information from being deleted or replaced.

The downside of this approach means that you now need to manage (delete or merge) unused places. You can use my Places Subject to Deletion mod to help with this or the SQL Report for Maintenance - Pooled Places with no Events


The image on the right shows a visualization of the Geocode Assist Mod on the Individual page. The globe that you can click on to launch the Admin edit place screen is only shown if you have Admin privilege.
Geocode assist visualizaton.jpg

In the event of a problem with your TNG site

  1. Try using the Mod Manager to Remove the mod
  2. Copy your backup personlib.php to your base TNG directory
    • all should be well now

Sites using this mod

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

URL User Note Mod-Version TNG-Version User-language
Stegemüller Family History Hanne B. Stegemüller Public 13.0.4 EN, DE, DA
Racines luxo-hennuyeres Michel KIRSCH 13.0.3 FR/EN/NL/SP/IT
McFadyen - Parker History Brian McFadyen Mod Developer
my family Oname.gif (no public site) see User:ojay see User:ojay D,(NL),(GB)
Our Roy and Boucher Family Ken Roy Added Close Window enhancement and support for Don't Geocode 13.0.4 EN, FR

Bob Mueller

... 9.2.0 EN, DE
AppeltHaus Genealogy Lawrence Appelt Not a Public Site. 10.1.0 EN
Arsenault and Simpson families Bob Arsenault Not a Public Site V9.0.0.0 V9.0.3 EN
Kemp(e) Family History Andrew Kemp see User:Kempons see User:Kempons EN
MOTYER Family Genealogy John Mark Motyer Public site see here see here EN, DE, RU
Legacy Gazette: My Roots - My Legacy Melissa Watson Padilla Public Site TNG 9.2.1 EN
Hooley Family Links Rick Hooley Public/Private See Here See Here EN

Wortelboer Genealogy

Bernard Wortelboer Public site 11.0.0 NL, EN
Moss Family Tree Chris Moss 10.0.3 EN
The Duttons of New England Darrin Dutton Public/Private Site 13.1 EN
Brady Family Tree in Western Australia Darryl Brady Public site 10.1.1 EN, DE
Bastiaans(s)en Genealogy Jan Bastiaanssen Public site 10.1.2 EN, NL, ES
R G Strong Family Genealogy Russell G. Strong Public Site 12.0.2 EN, FR, DE, NL
Our Family History Paul Barrett Public except for living 11.1 EN
Leverette Family History Jeff Leverette 10.1.3 EN
OurLife Family History - McMullen Clan Sean Thompson Not a public site 11.1.0 English
Maesen-Beusen Pierre Maesen Not a public site 9.2.2 Dutch
Roots & Relatives Remembered Ron Krzmarzick Public & Private See Here See Here EN,DE,CS
unserer Familien-Genealogie Angelika Oberhof Not a public site 11.1.0 German, English
The Larlee Genealogy Heather Feuerhelm 11.1.0 English
Joseph Oran Holtz Genealogy Pages Jim Holt Not a Public Site 11.1.1 English
OurRoots&Relatives - genealogy pages of Anne Hegland and Kåre Kjøllesdal Kåre Kjøllesdal Not a Public Site 11.1.0 English
Rodriguez Lopez y Uribe Senior pagina de Genealogia Camilo Rodriguez Uribe Not a Public Site 11.1.0 English, Spanish
Hans and Hennes Families

Roar Dahle

Not a Public Site 11.1.0 Norwegian
Genealogy of the van Heerden Family Emile van Heerden 11.1.0 English
Mull Families Michael Ford Not a Public Site (login required) 11.0.2 English
Total Family History Scott Bennett Not a public site 11.1.1 English
unserer Familien-Genealogie Angelika Oberhof Not a public site 11.1.1 German, English
Our Family Histories Bryan S. Larson Not a public site 11.1.1 English
The Dutton's of Vermont Genealogy & History Darrin Dutton Public Site 11.1.1 English
Genealogy of the Weir and Drain Families Beverley Stimpson Public Site 11.1.2 EN
Bumbery-Wangler Bob Bumbery Public Site 11.1.2 English
Skeel, Schaffalitzky og Ahlefeldt Finn Holbek Public Site DA, DE, EN - etc.
Our Family Tree Search Jessica Senkyr-Robinette Not a public site 12.0.2 English
Woking Family Tree Project Pete Smee Public/Private v11.0.0.3 v12.1 English
Familienforschung Scabell Helga Scabell Public / Privat 13.0.1 Deutsch
Genealogy of a Dutch East-Indies Family Rob Severijns Private V13.0.4.5 V13.1 NL/EN
LookingBackwards - All Our Relations Ashleigh Mitchell Public 13.0.3 EN