Admin Places Geocode

From TNG_Wiki
Revision as of 19:46, 29 September 2018 by Rmcrae (talk | contribs) (Added my TNGv22 cust_text.php upgrade template)
Jump to navigation Jump to search

Template:RobinV12 cust text update

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.3.zip
TNG 12.0

TNG 11.0
TNG 10.1.0
v10.1.0.3.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 v10.1.0.3 & v12.0.0.3
Min TNG V 10.1
Max TNG V at least 12.0
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

  • Creates a new Placelevel of -1 for "Don't Geocode"
  • Defines a TNG system parameter that establishes the number of desired decimal digits in Geocodes and rounds all Geocodes calculated from maps,
  • 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.
  • In Admin>>Places>>Search and Admin>>Places>>Edit, Geocodes are rounded automatically.
  • A new Admin program can round all Geocodes in the database. 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 with other Mods

    This mod is compatible with Places Subject to Deletion, Tree ID Mod, Admin Places Search, TreeID-One Column, Placename Format, which also affect the Admin >> Places program.

    Other 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.
    Note that the change to display descriptive values in Admin Places Search does not take into account changes made by the following mods which add additional place levels to TNG
    which results in incorrect descriptive values being displayed. --KenRoy (talk) 11:44, 18 May 2017 (CDT)
    • 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.
    • 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

    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.

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

        • The latest version of the mod is at the top of this table ***
    Mod Version TNG Version Date Note
    12.0.0.3 12.0+ 4 May 2018 No functional changes; made compatible with TNGv12.
    10.1.0.3 10.1 10 Nov 2017 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 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 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