Admin Place Utilities

From TNG_Wiki
Jump to navigation Jump to 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 4 Mar 2015
Download link For
TNG 10.1.0
Admin_place_utilities_v10.1.0.1.zip
For
TNG 10.0
TNG 9.2
Admin_place_utilities_v10.0.0.1.zip
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.
  • A backup of all affected files (see the list in the summary in the upper right corner of the page)
  • An installed current version of the Mod Manager.

Conflicts

No known conflicts.

Installation

  1. Uninstall and delete previous version of this mod (if installed)
  2. Download the appropriate zip file as shown in the mod summary in the upper right corner of the page.
  3. Extract the file from the downloaded zip file into the mods folder or FTP the extracted file to your mods folder.
  4. Follow the normal automated installation for Mod Manager, as shown in the example Mod Manager - Installing Config Files to install the mod.

In the event of a problem

Uninstalling the mod

If you want to completely Remove (uninstall) this mod and any tables if created, you should

  1. click the Uninstall button to uninstall the mod
  2. click the Delete button to delete the config file from the mods folder.

Upgrade

  • Uninstall and eventually Delete the current Mod.
  • Proceed as for an installation with the new Mod.

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

Revision History

Mod Version TNG Version Date Contents
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 EN