Geocode Assistant

From TNG_Wiki
Jump to navigation Jump to search
Geocode Assist
Summary Allows geocoding locations from the person page
Validation Latest mod is XHTML compliant.Valid-xhtml10.png
Mod Updated {{{mod_last_update}}}
Download link
TNG 10.0
TNG 9.0
geocode_assist_v9.0.0.0.zip
TNG 8.0
geocode_assist_v8.1.2.zip for
TNG 7.0

geocode_assist_v1.6.zip for

TNG 6.0
Download stats Veiw download stats
Author(s) Brian McFadyen
enhanced by Ken Roy
Homepage Geocode Assist Mod (this page)
Mod Support TNG Forums
Contact Developer
Latest Mod 9.0.0.0 for TNG V9
8.1.2 for TNG V8
Min TNG V 7.1.0
Max TNG V 10.0.0
Files modified
personlib.php
globe.gif
Related Mods
Notes
In TNG V9, if you install the Wiki Integration mod along with this mod, the Wiki Integration mod must be installed before the Geocode Assist Mod.


Introduction

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: 9.0

In TNG V9, 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.

Developer

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

Requirements

  • 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
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 geocode_assist.zip 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).


Visualization

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
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 9.0.0.0 9.0.3 EN, FR
Genealogy.Ravensbeak.com Bob Mueller ... 9.0.0.0 9.2.0 EN, DE
AppeltHaus Genealogy Lawrence Appelt Not a Public Site. 9.0.0.0 10.0.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
GenealogyWings John Mark Motyer Public site v9.0.0.0 v9.2.1 EN, DE, RU
Legacy Gazette: My Roots - My Legacy Melissa Watson Padilla Public Site 9.0.0.0 TNG 9.2.1 EN
... ... ... ... ... ...