Admin Places Geocode

Admin Places Geocode
Summary	Defines a new Placelevel for "Don't Geocode"; rounds new geocoordinates 6 decimal places; displays the Geocoding results and the kickoff form on the same web page.
Validation
Mod Updated	{{{mod_last_update}}}
Download link	For TNG 10.1.0 admin_places_geocode_v10.1.0.1.zip
Download stats
Author(s)	Robin Richmond
Homepage	Robin Richmond's Genealogy Database
Mod Support	My Mod Support form or TNG Community Forums
Contact Developer	My Mod Support form
Latest Mod	10.1.0.1
Min TNG V	10.1
Max TNG V	11.1
Files modified	admin_geocodeform.php, admin_geocode.php, admin_editplace.php, googlemaplib2.php, places_help.php, cust_text.php English
Related Mods	Blue Info Button, Show Mod Names, Admin Places List
Notes

Purpose of the Mod

• Avoids situations where automatic geocoding regularly fails by adding filters that can be selected in the Admin >> Places >> Geocode kickoff form. See the visualization of the new help text (shown below) for descriptions of the filters.
• Improves the geocoding workflow by displaying the geocoding results and the next kickoff form on the same web page.
• Provides a way to mark Places that shouldn't be geocoded by adding a Placelevel value (-1) and labeling it as Don't Geocode".
• Eliminates extraneous detail in geocoordinates in three ways:
  1. The Geocoding program rounds all new geocodes to at most six decimal places.
  2. Geocodes defined through the Place Editor are rounded to at most six decimal places.
  3. The Place Editor has a new "Round" button that rounds existing geocodes to six decimal places.

Side Effects

In the distributed TNG code, admin_geocodeform.php displays the kickoff form, which invokes admin_geocode.php to do the geocoding. After admin_geocode.php displays the results, it displays a link back to the kickoff form in admin_geocodeform.php. This mod moves the PHP code that does geocoding into admin_geocodeform.php so that the results can be displayed on the same web page as another kickoff form. With this change, admin_geocode.php is no longer used at all.

Mod Dependencies

• This mod depends on the Blue Info Button mod to define the style class that formats an information icon next to the Filters checkboxes on the kickoff form. It does not strictly require the Blue Info Button mod to be installed, but without that mod, the icon (shown in the visualizations below) would just look like a hyperlinked (i.e. underlined) lowercase i.

Other Related Mods

• The Admin Places Search mod changes the Place Level column to show descriptive values ("Country", "State/Provice", etc) rather than raw numbers, and displays "Do Not Geocode" for the new value of -1 that is implemented by this mod. But there is no dependency between the two mods.
• This mod saves data that can be used by the optional Show Mod Names utility mod, but it is not dependent on that mod.

Compatibility with other Mods

This mod is compatible with Places Subject to Deletion, Tree ID Mod, and Place Name Format, which also affect the Admin >> Places program. Please let me know if you encounter any incompatibilities.

Requirements

• A working TNG installation.
• An installed current version of the Mod Manager.
• You should backup files listed in the panel on the right.

Installation

1. Remove and delete previous version of this mod.
2. Backup the files updated by this mod. They are listed in the panel at the upper right.
3. Download the .zip file, and extract its .cfg file to the mods folder.
4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.

In the event of a problem

1. Try using the Mod Manager Remove capability
2. Contact me through My Mod Support form.

Visualization of this Mod

BEFORE: The Admin >> Places >> Geocode Kickoff form, and the results page Note that the "Reset" checkbox, which causes all "geoignore" flags in the selected tree to be reset, was introduced with TNGv11, but the mod also works for TNGv10.1, which does not have that checkbox.

AFTER: The initial kickoff form

AFTER: Geocoding results, with the kickoff form on same page

BEFORE: The Admin >> Places Editor (It may look a little odd with the map hidden)

AFTER: The Admin >> Places Editor

AFTER: New text in the Places help file This mod also adds text to the "Add New/Edit" section of the help file, but that text is not shown here.

Mod Change History

Mod Version	TNG Versions	Date	Note
10.1.0.1	10.1	19 Apr 2017	New mod.

Sites using this mod

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

URL	User	Note	Mod-Version	TNG-Version	User-language
Robin Richmond's Genealogy Database	Robin Richmond	Mod developer	v10.1.0.1	11.0.2	English
Joseph Oran Holtz Genealogy Pages	Jim Holt	Not a Public Site	10.1.0.2 beta	11.1.0	English
Our Roy and Boucher Family	Ken Roy	Using on a test site	10.1.0.2 beta	11.1.0	English