Admin Places Geocode

From TNG_Wiki
Jump to: navigation, search

In TNGv12 and beyond, this mod uses the new guidelines for TNG v12+ cust_text.php files
If you are using TNGv12+, and any cust_text.php file in this mod is marked with a Bad Target error, you need to update your cust_text.php files before you can install this mod. [Show instructions]

If you upgraded to TNGv12+, and did not update your cust_text.php files as instructed in the upgrade readme script, then you must use the TNG Mod Manager to update them. To do so:

  1. Go to Mod Manager, and select its "Recommended Updates" tab.
    (If the "Recommended Updates" tab is not visible, then go to the Mod Manager Options tab, select "Display Settings", and turn on the "Recommended Updates" tab.)
  2. Click the "Update" button in the "Recommended Updates" tab.
    Installed mods do not interfere with the update, and if you already have (or think you may have) run this update, it will not hurt for you to run it again.

[See details in the TNGv12 Change Impacts Article][Hide the instructions]


Admin Places Geocode
Summary Creates a new Placelevel of -1 for "Don't Geocode." Establishes the number of desired decimal digits in Geocodes and rounds all Geocodes calculated from maps. Provides a filter to limit the Geocoding to selected Mediatypes and to ignore certain problematic placename components.
Validation
Mod Updated 4 May 2018
Download link v12.0.0.3a.zip
TNG 12.0
See the Revision History for older versions.
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 v12.0.0.3a
Min TNG V 12.0
Max TNG V at least 12.0.2
Files modified
admin_geocodeform.php, admin_geocode.php, admin_editplace.php, googlemaplib2.php, places_help.php, cust_text.php English
Related Mods
Notes


Purpose of the Mod

  1. Creates a new Placelevel of -1 for "Don't Geocode"
  2. Defines a TNG system parameter that establishes the number of desired decimal digits in Geocodes and rounds all Geocodes calculated from maps,
  3. In the Admin>>Places>>Geocode 'batch' Geoding program:
    1. You can limit the Geocoding to selected Mediatypes,
    2. Geocoding results are displayed right on the Geocode form, and
    3. New filters can ignore certain problematic placename components.
  4. In Admin>>Places>>Search Geocodes are rounded automatically for display.
  5. 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.

Compatibility

This mod is compatible with Places Subject to Deletion, Tree ID Mod, Admin Places Search, TreeID-One Column, Placename Format, Google Maps - More Place Levels Mod, and Google maps 15, all of which also affect Admin>>Places.

The Geocode Assist Mod v10.0.0.2 will suppress the Geocode Globe is the place level is set to -1 (Do not Geocode).

If you import your data, this value may not be preserved across an import. See the Do Not Geocode section in the Geocode Assist Mod on how to preserve the value across an import.

Related Mods

  • The Admin Places Search mod changes the Place Level column to show descriptive values ("Country", "State/Province", 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.

Installation

This mod uses the standard installation procedure. [Show Details]

Requirements

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

Procedure

  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, 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.

Problems?

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

Visualizations

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.
Admin places geocode-before.png

AFTER: The initial kickoff form

Admin places geocode-after1.png

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

Admin places geocode-after2.png

BEFORE: The Admin >> Places Editor

(It may look a little odd with the map hidden)
Admin places geocode-before-edit.png

AFTER: The Admin >> Places Editor

Admin places geocode-after-edit.png

AFTER: New text in the Places help file

Admin places geocode-help.png
This mod also adds text to the "Add New/Edit" section of the help file, but that text is not shown here.

Revision History

Mod Version TNG Version Date Note
12.0.0.3a 12.0+ 14Nov2018 Small improvements: Better error checking; deals with trailing spaces, displays the placename before trying to geocode it so that the log will more clearly show where the process crashed.
12.0.0.3 12.0+ 4May2018 No functional changes; made compatible with TNGv12.
12.0.0.3 12.0+ 4May2018 No functional changes; made compatible with TNGv12.
10.1.0.3 10.1 10Nov2017 Defines a TNG system parameter that establishes the number of desired decimal digits in Geocodes and rounds all Geocodes calculated from maps. Provides new filters can ignore certain problematic placename components.
10.1.0.1 10.1 19Apr2017 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 v12.0.0.3 12.0 English
Joseph Oran Holtz Genealogy Pages Jim Holt Not a Public Site 10.1.0.2 beta 11.1.1 English
Our Roy and Boucher Family Ken Roy 10.1.0.2 beta 11.1.1 English
Cole / Tanner Family Tree David Cole Public/Private see here see here English