Admin Place Utilities

From TNG_Wiki
Jump to: navigation, search
Admin Place Utilities
Summary Adds four tabs to the Administrative Places inner menu to support setting place levels, and copying geocodes and placelevels from one database to another.
Validation
Mod Updated {{{mod_last_update}}}
Download link For
TNG 10.1.0
Admin_place_utilities_v10.1.0.1.zip
Admin_place_utilities_v10.0.0.1.zip
TNG 10.0
TNG 9.2
Download stats
Author(s) Robin Richmond
Homepage Robin Richmond's Genealogy Database
Mod Support TNG Community Forums
Contact Developer My Mod Support form
Latest Mod 10.1.0.1 for TNG v10.1
10.0.0.1 for v10.0 thru v10.0.3
Min TNG V 10.0
Max TNG V 10.1
Files modified
Modifies the tab menu of admin_places.php, admin_newplace.php, admin_mergeplaces.php, admin_geocodeform.php
Modifies languages/English/cust_text.php &languages/English-UTF8/cust_text.php
Installs admin_placeutilslevel.php, admin_placeutilsload.php, admin_placeutilssave.php, admin_placeutilsoptions.php, admin_placeutilssavefile.php, languages/English/placeutilities_help.php, extensions/placeformatconfig-placedistrib.php
Related Mods
Notes


Purpose of the Mod

To help administrators

  1. Set the Place Level field in the place level database,
  2. Copy Place Levels and Geocodes from one database to another (particularly from a production database to a test databasee)

by creating four utilities available through tabs on the Administrative >> Places menu.

Setting Place Levels

The Place Level field in the Places database indicates the specificity of the place name; e.g.
Placelevel = 0 for Unknown or undefined level
Placelevel = 1 for Address
Placelevel = 2 for Location (a facility, cemetery, or other location within a town or county), e.g. Laurel Land Cemetery, Dallas, Dallas, Texas, USA.
Placelevel = 3 for City/Town, e.g. Houston, Harris, Texas, USA, or Houston, Texas.
Placelevel = 4 for County/Shire, e.g. Harris County, Texas.
Placelevel = 5 for State/Province, e.g. Texas (and see notes for "pseudo-states" below)
Placelevel = 6 for Country, e.g. USA or America or Germany.

This mod only can compute the placelevel for USA places and other country names (but not places within other countries). To compute a placelevel, this mod uses several Place Format Options, which are described in detail in the Place Utilities Help File.

The Place Utilities Help File

The purpose and functionality of the utilities installed by this mod are described in the help file that is shared by the four utilities. It can be viewed at the mod author's web site.

Requirements

  • A working TNG installation.
  • An installed current version of the Mod Manager.

Conflicts

No known conflicts.

Automated 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. Upload and Extract to the mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install.

In the event of a problem

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

Visualizations

After The new tabs on the Places options - The first 3 tabs are from the TNG distribution; the last 4 tabs are added by the mod.
Admin place utilities-tabs.png
After The new Place Levels utility
Note that you can see a list of the places without a Place Level, and you have 3 options for setting the place level.
Admin place utilities-level.png
After The new Read File utility
The contents of the file determine whether Geocode data and/or Place Levels will be uploaded, but you have the option of restricting the process to replaces only values that are not already defined.
Admin place utilities-load.png
After The new Save File utility
All you can do is pick a tree, select whether to save geocode data and/or place levels, and restrict the output to places with placeleve=0. The filename is constant, and equal to placedata.csv.
Admin place utilities-save.png
After Setting the Place Format Options
These options control how place levels are set, and are described in detail in the help file (the link labeled "Help for this area").
Admin place utilities-options.png

Mod Change History

Mod Version TNG Version Date Note
10.0.0.1 & 10.1.0.1 10.0 - 10.1 4 Mar 2015 Initial release.

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 10.0.0.1 10.0.3 English