Add GOV-ID Mod

From TNG_Wiki
Revision as of 09:02, 15 October 2019 by Geraldomeier (talk | contribs) (TNG User sites using this mod)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Add GOV-ID Mod
Summary Adding of the GOV-ID to the places
Validation
Mod Updated 4 Jul 2018
Download link
TNG 12.0
add_gov_id_12.0.2.0.zip

TNG 12.0
add_gov_id_12.0.1.1.zip

TNG 12.0
add_gov_id_12.0.1.0.zip

TNG 11.1.1
add_gov_id_11.1.2.7.zip

TNG 11.0
add_gov_id_11.0.2.07.zip


TNG 10.1.0
add_gov_id_10.1.0.7.zip

TNG 10.0.2
add_gov_id_10.0.2.3.zip

TNG 10.0
add_gov_id_10.0.0.2.zip

TNG 9.0
add_gov_id_9.2.2.1.zip
Download stats TNG V9/V10.0 View download statistics
Author(s) Written by Ulli Heist. Modified by Martin Pannier. Modified by Carlos Heuser.
Homepage Add GOV-ID Mod (This page)
Mod Support -
Contact Developer -
Latest Mod -
Min TNG V 9.2.2 (versions below not tested)
Max TNG V 12.0.2
Files modified
admin_places.php, admin_addplace.php, admin_editplace.php, admin_newplace.php, admin_updateplace.php, admin_mergeplaces.php, placesearch.php, admin_gedcom2.php, gedimport_misc.php, German-UTF8/cust_text.php, English-UTF8/cust_text.php, English/cust_text.php, PortugueseBR, PortugueseBR-UTF8
Related Mods
Notes
The needed database table is created in UTF8 - the mod works with UTF8!
It is possible that even lower TNG versions can work with this modification.


Purpose of the mod

This modification establishes a link with Gov, the German Historical Gazetteer. Gov contains data about around one million places located mainly in Central Europe. In this Gazetteer each place is identified by a so called GOV-ID.

The modification allows to search for Gov-IDs and store them in the TNG database. If a place is associated to a GOV-ID, its page will display links to the corresponding pages in the Gazetteer, as well as links to related entries in the Wikipedia.

Additional information about the Gazetteer may be found in TNG-Wiki and in [1], the German Genealogy Wiki (currently only in German).

Warning: This mod changes the structure of the "Places" table in the TNG database. If you do not feel comfortable with this, please do not install this modification.

Author

This modification was developed by Ulli Heist. There were additions by Martin Pannier. v11 and v12 versions are by Carlos Heuser.

Supported languages (cust_text.php)

  • English
  • English-UTF8
  • German (with %fileoptional:%)
  • German-UTF8 (with %fileoptional:%)
  • PortugueseBR (with %fileoptional:%)
  • PortugueseBR-UTF8 (with %fileoptional:%)

Visualization of this mod

Since v12, the layout of the place page has been modified. An example can be seen here.

(1) Administration >> Places (2) Administration >> Places >> Add New
Gov backendplaces.png
Gov addnewplace.png
(3) Link to the Genealogical Gazetteer >> Copy the GOV-ID (4) Administration >> Places >> Edit
Gov berlin.png
Gov editplace.png
(5) Place page with data displayed by the mod (6) Gedcom export with _GOV tag
Gov frontendplaces.png
Gov export.png

Links included in the place page

This modification changes the place page (placesearch.php) as follows (see example in the picture below):

  • For each part of the place name a link to the corresponding entry in the Wikipedia is generated. As usual in TNG, the comma is considered to be the separator of the parts of a place name. For example, if the place name is "Berlin, Brandenburg, Preußen, Deutschland", links to the entries "Berlin", "Brandenburg", "Preußen", and "Deutschland" will be created. These links point to the German, English or Portuguese Wikipedia, depending on the language the user has selected.
  • A link to the corresponding entry in the GOV Gazetteer (in German) will be displayed. For the example this leads to a page like this one.
  • A link to the corresponding entry in the German Genealogy Wiki (in German) will be displayed. For the example this leads to a page like this one.

If a place does not contain any notes, has no GOV-ID and has not been geo-referenced (has no latitude and longitude), these links are not displayed.

Example of a place page containing the links created by the modification:

Add gov place.jpeg

Customization of the Wikipedia language

Regarding to the Wikipedia language, the modification allows the definition of exceptions for places that belong to specific countries. For this purpose the last part of the place name is considered to be the country name. For example, in the place name "Berlin, Brandenburg, Preußen, Deutschland", "Deutschland" is regarded as the country.

For a specific country, one may want to use the Wikipedia of that country, instead of the Wikipedia defined by the language that the user has selected for navigation.

In this case, an entry for the country must be created in the exceptions table that appears in the Mod configuration file:

$wiki_array = array(
	"Brasil"=>array("pt", "Portuguese"),
	"Portugal"=>array("pt", "Portuguese"),
	"Sweden"=>array("sv", "Swedish"),

The lines above show the beginning of an exception table (for a full example, see the distributed configuration file).

An entry like "Sweden"=>array("sv", "Swedish") specifies that if a place ends with "Sweden", the Swedish Wikipedia (indicated by "sv") will be used. The word "Swedish" is the name of the language.

This table must be created for each language supported by the modification. In the present version, English, German and Portuguese are supported. If someone needs an additional language please feel free to contact the author.

Before install

As this modification changes the Places table, a backup of this table is recommended (Admin >> Utilities >> Back up Table Data) prior to the installation.

Automatic Installation

Installation follows the usual procedure via Mod Manager (Administration >> Mod Manager), with an extra step at the end to the change the database structure:

  1. If you had a previous version of the modification installed, uninstall it.
  2. Download the add_gov_id_vX.X.X.X.zip-file
  3. After downloading the zip-file, unzip it and upload the extracted file (add_gov_id_vX.X.X.X.cfg) to the mods folder in your TNG installation.
  4. Follow the usual Mod installation procedure as described in this article: Mod Manager - Installing Config Files.
  5. After the installation you must select Administration >> Places at least once (admin_places.php). This will add the additional column to the database table 'Places' that is needed to store the GOV-ID!. If you don't do this last step, the next gedcom import will fail!

History of changes

Version Date description
V12.0.2.0 12 July 2018
  • Bug corrected - Add place was giving an error
  • Changes by Carlos Heuser
V12.0.1.1 12 July 2018
  • Choice of the wikipedia language is better handled
  • Mod documentation rewritten
  • Changes by Carlos Heuser
V12.0.1.0 4 July 2018
  • Fixed for TNG V12.0 and v12.0.1
  • Added Portuguese translation
  • Changed the place page to include a link to the corresponding page in the German GenWiki page
  • Changed the place page to include links to the corresponding pages in the German Wikipedia, one link for each part of the place name
  • Changes by Carlos Heuser
V11.1.2.7 11 October 2017
  • Fixed for TNG V11.1.1 and 11.1.2 (ron krzmarzick-no response from author)
V11.0.2.0 4 October 2016
  • Fix for TNG V11 (places.php was showing just places with level 0)
V10.1.0.7 24 November 2015
  • Fix for V10.1.3 after 02 Nov (bad target in admin_places.php)
V10.1.0.6 08 July 2015
V10.1.0.5 31 May 2015
V10.1.0.4 04 February 2015
  • Update for V10.1.0
V10.0.2.3 27 April 2014
  • Fix for V10.0.2 (bad target in gedimport_misc.php)
V10.0.0.2 16 February 2014
  • Changes for the export of single branches
  • Additional checkbox "Missing GOV-ID" on Aministration -> Places
v9.2.2.1 19.09.2013
  • Integration of the Gedcom (Re)import (Tag _GOV)
  • Additional characters for the place name shortening "[", "{", "<", "?" and "/"
  • Layout changes and supplements to the "Place" site (placesearch.php)
v9.2.2.0 02.09.2013
  • Addition of the search buttons with description
  • reduction of the place name before ",", "(" and "bei"
  • Integration of the Gedcom-Export
urh_GOV_ID 9.0.0.0 09.02.2012
  • basic version by Ulli Heist



Notes about the mod and the GOV-database

The GOV-database is a project of the German Verein für Computergenealogie e.V..
In February 2014 the GOV-project was presented by Timo Kracke at Rootstech in Salt Lake City.

TNG User sites using this mod

Please add your site if you use this modification.

URL User Note Mod-Version/TNG-Version User-language
Treichel-Familie.de A. Treichel Public & Private 12.0.2.0 / 12.2 DE, UK, FR, ES, PL
My family Oname.gif (no public site) see Oname.gif D,(NL),(GB)
g.nomi William Vincent Integrated with WordPress v9.2.2.1/v9.2.2 EN
Adler-Wien Herbert Fischer 12.0.1 DE,(GB)
Genealogy Scabell Helga Scabell CM4all 10.0.2.3/10.0.3 DE
Brazilian-German family trees Carlos Heuser 12.0.1 PT-BR, DE, EN
Familienforschung Riehl & Kröber Otto Riehl (no public site) 11.1.2.7/11.1.2 DE, EN, ES, FR, PT,
Racine d'Alsace J-Louis Valory Public/Private - T17 customized 12.0.1.1/12.0.2 FR
Barta-Joggele Online aus Mauren, Liechtenstein Gerald Meier Private 12.0.2.0/12.2 DE, EN, ES, FR, PT

Related Links

The Historical Gazetteer - GOV-project