Difference between revisions of "Admin Places Geocode"
Robinrichm (talk | contribs) |
Robinrichm (talk | contribs) |
||
Line 9: | Line 9: | ||
| mod_author = [[User:Robinrichm|Robin Richmond]] | | mod_author = [[User:Robinrichm|Robin Richmond]] | ||
| mod_url = [http://www.robinrichmond.com/family/ Robin Richmond's Genealogy Database] | | mod_url = [http://www.robinrichmond.com/family/ Robin Richmond's Genealogy Database] | ||
− | | mod_contact = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form] | + | | mod_contact = [http://www.robinrichmond.com/family/mod_support.php?modname=Admin+Places+Geocode My Mod Support form] |
− | | mod_support = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form] or [http://tng.community/ TNG Community Forums] | + | | mod_support = [http://www.robinrichmond.com/family/mod_support.php?modname=Admin+Places+Geocode My Mod Support form] or [http://tng.community/ TNG Community Forums] |
| mod_version = v13.0.0.6 | | mod_version = v13.0.0.6 | ||
| min_TNG_ver = 10.1 | | min_TNG_ver = 10.1 |
Revision as of 19:26, 23 December 2020
Admin Places Geocode | |||
---|---|---|---|
Summary | Among other things, establishes the number of desired decimal digits in geocoordinates and rounds all geocoordinates calculated from maps. | ||
Validation | |||
Mod Updated | 21 Dec 2020 | ||
Download link | v13.0.0.6
v12.0.0.4
| ||
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 | v13.0.0.6 | ||
Min TNG V | 10.1 | ||
Max TNG V | 13.0.2 | ||
Files modified | admin_geocodeform.php, admin_geocode.php, admin_editplace.php, googlemaplib2.php, places_help.php, admin_genconfig.php, admin_updateconfig.php | ||
Related Mods | |||
Notes |
Purpose of the Mod
Defines an improved workflow for and limits on the batch geocoding process at Admin>>Places>>Geocode
- Defines a TNG system parameter that establishes the number of desired decimal digits in geocoodinates (latitude and longitude),
- Rounds all geocoodinates that originate in maps (in all TNG programs that do so),
- In the Admin>>Places>>Geocode 'batch' Geocoding program:
- In Admin>>Places>>Edit, geocoordinates are rounded automatically as they are read from the database (though users can enter and save values with more digits,
- Geocoding results are displayed right on the Geocode form, and
- New filters can ignore certain problematic placename components.
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 Options
These mod options are custom TNG settings, defined and edited in a Mod Settings Block in the form at Admin>>Setup>>General Settings, in a new subform named Mod Settings Blocks. The Mod Settings Blocks mod is a prerequisite for the installation of this mod. The only mod option is the number of decimal digits that will be saved by various program.
This mod uses its option to affect how geocoordinates are read from Google maps or OpenStretMap, and to affect how geocoordinates are read by the Places Edit page. However, the option is not applied when the Places Edit page saves the geoordinates. Thus, if you type more decimal digits than are specified by the option into the latitude and longitude fields, the longer value will be saved to the database.
Side Effects
This mod modifies TNG's google map PHP functions to round geocoordinate when any program reads geocoordinates from the map, whether that means doing a place search in the map or clicking on the map. This modification affects the Cemetery and Media edit pages without making any changes to those pages.
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 if 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 Mod Settings Blocks mod packages this mod's options into what I call a "Mod Settings Block", which is a set of form fields that formatted and labeled so that it stands out among other options in an Admin>>Setting form. Mod Settings Blocks is a prerequisite for this mod; it must be installed before this mod can be installed.
- An Inner Mod Menu, which provides handy links from TNG pages directly to mod documentation and a mod's Mods Settings Block. (Inner Mod Menus are visible only to TNG Admins; never to end users.)
- The Mods Used feature, which captures a list of mods that affected the code used to display a TNG page. (This is analogous to the Mod Manager Analyzer feature that reports which mods affect a given TNG file, but that applies at run-time.
- Admin Cemetery Edit modifies the Admin>>Cemeteries>>Edit form to use this mod's option (number of decimal digits to which the cemetery geocoordinates will be rounded) as it reads the geocoordinates from the database or writes the geocoordinates to the database.
Installation
This mod includes a typical mod subfolder, with the same base name as the mod's .cfg file. The subfolder is atypical in that no files in it are installed to working TNG folders. However, it does contain critical files that contain the mod's language strings, which the mod does not add to standard cust_text.php files. Instead, the PHP code modified by this mod loads the language strings from files in the mod's languages/ subfolder. Read more about this technique.
[Show Standard Installation Process]
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
- Remove and delete previous version of this mod.
- Backup the files updated by this mod. They are listed in the panel at the upper right.
- Download the .zip file, Extract its .cfg file to the mods folder.
- Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files.
Problems?
- Try using the Mod Manager Remove capability
- Contact me through My Mod Support form.
Visualizations
AFTER: New text in the Places help file
|
Revision History
Mod Version | TNG Version | Date | Note |
---|---|---|---|
13.0.0.6 | 13.0 - 13.0.2 | 21 Dec 2020 | Upgraded to TNGv13
|
12.0.0.4 | 12.0 - 12.2+ | 30 Sep 2019 | The Mod option at Admin>>Setup>>General Settings>Miscellaneous now use an include file that is shared with other mods. |
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 | 13.0.0.6 | 13.0.2 | English |
Joseph Oran Holtz Genealogy Pages | Jim Holt | Not a Public Site | 10.1.0.3 | 11.1.2 | 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 |
Skeel, Schaffalitzky. Find navne i Danmarks Adels Aarbog | Finn Holbek | public & private | 12.1 | DA,EN,DE,CS,ES - etc. | Danish |
Our Family Histories | Bryan S. Larson | Public - T8 customized | see here | see here | EN |