Changes

Jump to navigation Jump to search

Admin Places Geocode (view source)

Revision as of 20:08, 2 January 2020

1,336 bytes added ,  20:08, 2 January 2020
no edit summary
Line 1: Line 1: −
{{construction
  −
|notes=The article below describes a complete, tested mod.
  −
This mod also has a new "beta" version:10.1.0.2 that can be downloaded here:
  −
[[Media:admin_places_geocode_v10.1.0.2.zip|admin_places_geocode_v10.1.0.2.zip]]
  −
<br>Here's what the new version does:
  −
  −
# Added filters that the user can select, to ignore some town names, based on PlaceLevels
  −
# DisplayModNames is now optional
  −
  −
  −
I've been using the new version for a while, but
  −
* It needs to be tested on other TNG sites,
  −
* I haven't completed the description below, and
  −
* I haven't created the visualizations this article needs
  −
  −
In truth, I have over 40 new and updated mods in this state, and I'd appreciate whatever help that anyone can offer.
  −
So it would be great if you could download the mod, test it, and let me know how it works for you.
  −
And if you're up for it, screenshots from before the mod was installed and after (annotated or not) would be a great help.
  −
Just email any updates to me.
  −
My email username is '''mail'', and my email domain is robinrichmond.com.
  −
  −
Thanks in advance.
  −
Robin Richmond 19:01, 6 May 2017 (CDT)
  −
}}
  −
   
{{TNGmod
 
{{TNGmod
 
| mod_name        =  Admin Places Geocode
 
| mod_name        =  Admin Places Geocode
−
|  mod_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.
+
|  mod_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.
 
| mod_validation  =  
 
| mod_validation  =  
−
| download_link  = For {{Tv1010}}[[Media:admin_places_geocode_v10.1.0.1.zip|admin_places_geocode_v10.1.0.1.zip]]
+
| mod_last_update = 30 Sep 2019
−
 
+
| download_link  = [[Media:admin_places_geocode_v12.0.0.4.zip|v12.0.0.4.zip]]{{Tv120}}
 
| download_stats  =
 
| download_stats  =
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
 
| mod_author      = [[User:Robinrichm|Robin Richmond]]
Line 35: Line 10:  
| mod_contact    = [http://www.robinrichmond.com/family/mod_support.php My Mod Support form]
 
| mod_contact    = [http://www.robinrichmond.com/family/mod_support.php 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 My Mod Support form] or [http://tng.community/ TNG Community Forums]
−
| mod_version    = 10.1.0.1
+
| mod_version    = v12.0.0.4
 
| min_TNG_ver    = 10.1
 
| min_TNG_ver    = 10.1
−
| max_TNG_ver    = 11.1
+
| max_TNG_ver    = 12.2
−
|  TNG_file_list  = admin_geocodeform.php, admin_geocode.php, admin_editplace.php, googlemaplib2.php, places_help.php, cust_text.php English  
+
|  TNG_file_list  = admin_geocodeform.php, admin_geocode.php, admin_editplace.php, googlemaplib2.php, places_help.php, cust_text.php English, admin_genconfig.php, admin_updateconfig.php
−
| related_mods  = [[Blue Info Button]], [[Show Mod Names]], [[Admin Places List]]
+
<br>Installs shared files: rrinnermodmenu1_include.php, rrmodoptions1.php, img/rrmodadmin_wikilogo.png
 +
| related_mods  = [[Admin Places Search]]
 
| notes    =   
 
| notes    =   
 
}}
 
}}
−
 
+
== Purpose of the Mod ==
 
{| style="margin-right:0.5 em;" align="right"  
 
{| style="margin-right:0.5 em;" align="right"  
 
| __TOC__
 
| __TOC__
−
   
|}
 
|}
 +
<ol><li>Creates a new Placelevel of -1 for "Don't Geocode"</li>
 +
<li>Defines a TNG system parameter that establishes the number of desired decimal digits in Geocodes and rounds all Geocodes calculated from maps,</li>
 +
<li>In the Admin>>Places>>Geocode 'batch' Geoding program:
 +
<ol type='a'>
 +
  <li>You can limit the Geocoding to selected Mediatypes,
 +
  <li>Geocoding results are displayed right on the Geocode form, and</li>
 +
  <li>New filters can ignore certain problematic placename components.</li>
 +
</ol></li>
 +
<li>In Admin>>Places>>Search Geocodes are rounded automatically for display.</li>
 +
<li>a new "Round" button that rounds existing geocodes to six decimal places.
 +
</ol>
   −
== 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:
  −
*# The Geocoding program rounds all new geocodes to at most six decimal places.
  −
*# Geocodes defined through the Place Editor are rounded to at most six decimal places.
  −
*# The Place Editor has a new "Round" button that rounds existing geocodes to six decimal places.
      
== Side Effects ==
 
== Side Effects ==
Line 61: Line 39:  
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.
 
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 ==
+
== Compatibility ==
−
* 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.
+
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.
   −
== Other Related Mods ==
+
The [[Geocode Assist Mod]] v10.0.0.2 will suppress the Geocode Globe is the place level is set to -1 (Do not Geocode). 
−
* 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.
+
: If you import your data, this value may not be preserved across an import.  See the [[Geocode_Assist_Mod#Do_not_Geocode|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.
 
* 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 ==
+
== Installation ==
−
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.
+
This mod uses the standard installation procedure, though it should be noted that this mod contains two mod subfolders that are shared with other mods that implement ''[https://tng.lythgoes.net/wiki/index.php?title=Mod_Settings_Blocks Mod Settings Blocks]''' Admin>>Setup forms, and '''[https://tng.lythgoes.net/wiki/index.php?title=Inner_Mod_Menus Inner_Mod_Menus]'''. Because of the shared subfolders, as you unzip or copy the mod, you might get a warning noting that a folder already exists. You can just ignore that warning.<br>{{RobinInstallationBoilerplate}}
−
 
  −
==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==
  −
# 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, and 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]].
     −
== In the event of a problem ==
  −
# Try using the [[Mod_Manager_-_Installing_Config_Files#Remove_Mod_Steps|Mod Manager Remove]] capability
  −
# Contact me through [http://www.robinrichmond.com/family/mod_support.php My Mod Support form].
     −
== Visualization of this Mod ==
+
== Visualizations ==
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="1" cellspacing="1" cellpadding="2" class="wikitable"
 
|-
 
|-
Line 117: Line 84:  
|}
 
|}
   −
== Mod Change History ==
+
== Revision History ==
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
−
|-
+
! Mod Version !! TNG Version !! Date !! Note
−
! Mod Version
+
|- style="vertical-align:top;"  <!-- ############################################################## -->
−
! TNG Versions
+
| [[Media:admin_places_geocode_v12.0.0.4.zip|12.0.0.4]]
−
! Date
+
| 12.0 - 12.2+
−
! Note
+
| 30 Sep 2019
−
|-  
+
| The Mod option at Admin>>Setup>>General Settings>Miscellaneous now use an include file that is shared with other mods.
 +
|- style="vertical-align:top;"  <!-- ############################################################## -->
 +
| [[Media:admin_places_geocode_v12.0.0.3a.zip|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.
 +
|- style="vertical-align:top;"  <!-- ############################################################## -->
 +
| [[Media:admin_places_geocode_v12.0.0.3.zip|12.0.0.3]]
 +
| 12.0+
 +
| 4May2018
 +
| No functional changes; made compatible with TNGv12.
 +
|- style="vertical-align:top;"  <!-- ############################################################## -->
 +
| [[Media:admin_places_geocode_v12.0.0.3.zip|12.0.0.3]]
 +
| 12.0+
 +
| 4May2018
 +
| No functional changes; made compatible with TNGv12.
 +
|- style="vertical-align:top;"  <!-- ############################################################## -->
 +
| [[Media:admin_places_geocode_v10.1.0.3.zip|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.
 +
|- style="vertical-align:top;"  <!-- ############################################################## -->
 
| 10.1.0.1
 
| 10.1.0.1
 
| 10.1
 
| 10.1
−
| 19 Apr 2017
+
| 19Apr2017
 
| New mod.
 
| New mod.
 
|}
 
|}
Line 146: Line 134:  
| [[User:Robinrichm|Robin Richmond]]
 
| [[User:Robinrichm|Robin Richmond]]
 
| Mod developer
 
| Mod developer
−
| v10.1.0.1
+
| v12.0.0.3
−
| 11.0.2
+
| 12.0
 +
| English
 +
|-
 +
| [http://www.josephoranholtz.com/ Joseph Oran Holtz Genealogy Pages]
 +
| [[User:Stores|Jim Holt]]
 +
| Not a Public Site
 +
| 10.1.0.3
 +
| 11.1.2
 +
| English
 +
|-
 +
| [https://www.royandboucher.com/ Our Roy and Boucher Family]
 +
| [[User:KenRoy|Ken Roy]]
 +
|
 +
| 10.1.0.2 beta
 +
| 11.1.1
 +
| English
 +
|-
 +
| [http://colegenealogy.dynu.net/ Cole / Tanner Family Tree]
 +
| [[User:dlcole|David Cole]]
 +
| Public/Private
 +
| [[User:Dlcole|see here]]
 +
| [[User:Dlcole|see here]]
 
| English
 
| English
 +
|-
 +
| [https://finnholbek.dk/index.php/ Skeel, Schaffalitzky. Find navne i Danmarks Adels Aarbog]
 +
| [[User:Fholbek|Finn Holbek]]
 +
| public & private
 +
| 12.1
 +
| DA,EN,DE,CS,ES - etc.
 +
| Danish
 +
|-
 +
| [https://www.ourfamilyhistories.org Our Family Histories]
 +
| [[User:Bsl20b50|Bryan S. Larson]]
 +
| Public - T8 customized
 +
| [[User:Bsl20b50|see here]]
 +
| [[User:Bsl20b50|see here]]
 +
| EN
 
|}
 
|}
−
   
[[Category:Mods for TNG v10]]
 
[[Category:Mods for TNG v10]]
 
[[Category:Mods for TNG v11]]
 
[[Category:Mods for TNG v11]]
 +
[[Category:Mods for TNG v12]]
 
[[Category:admin_geocode.php mods]]
 
[[Category:admin_geocode.php mods]]
 
[[Category:admin_geocodeform.php mods]]
 
[[Category:admin_geocodeform.php mods]]
Line 158: Line 181:  
[[Category:googlemaplib2.php mods]]
 
[[Category:googlemaplib2.php mods]]
 
[[Category:places_help.php mods]]
 
[[Category:places_help.php mods]]
 +
[[Category:admin_genconfig.php mods]]
 +
[[Category:admin_updateconfig.php mods]]
Robinrichm
'''Experienced'''
5,069

edits

Retrieved from "https://tng.lythgoes.net/wiki/index.php/Special:MobileDiff/43381...58090"

Navigation menu