ric2016/shared_places

⚶ Shared Places (Webtrees 1.x Custom Module)

Webtrees Custom Module: ⚶ Shared Places

This webtrees custom module supports shared places as level 0 GEDCOM objects, on the basis of the Gedcom-L agreements. It hooks into an extended 'Facts and Events' tab, enhancing places with data obtained from the respective shared place. The project’s website is cissee.de.

This is a webtrees 1.x module - It cannot be used with webtrees 2.x. For its webtrees 2.x counterpart, see here.

Contents

• Features
• Gedcom-L Addendum
• Download
• Installation
• License

Features

• Shared places are handled as level 0 _LOC records, containing coordinates, notes, and media objects.
• Shared places may be edited and viewed via an additional top-level menu.
• On the (extended) facts and events tab, shared place data is displayed in addition to regular place data.
• All shared place data is fully included in the gedcom exported by webtrees (and may also be imported from other sources supporting _LOC records), on the basis of the Gedcom-L agreements.
• Geodata is provided to other modules (e.g. for use in maps).

Gedcom-L Addendum

The Gedcom-L Addendum to the GEDCOM 5.5.1 specification is available here. It defines the following structure for top-level place records:

LOCATION_RECORD:= 
0 @<XREF:_LOC>@ _LOC {1:1} 
1 NAME <PLACE_NAME> {1:M} 
2 DATE <DATE_VALUE> {0:1} 
2 ABBR <ABBREVIATION_OF_NAME> {0:M} 
3 TYPE <TYPE_OF_ABBREVIATION> {0:1} 
2 LANG <LANGUAGE_ID> {0:1} 
2 <<SOURCE_CITATION>> {0:M} 
1 TYPE <TYPE_OF_LOCATION> {0:M} 
2 _GOVTYPE <GOVID_OF_TYPE> {0:1} 
2 DATE <DATE_VALUE> {0:1} 
2 <<SOURCE_CITATION>> {0:M} 
1 _POST <POSTAL_CODE> {0:M} 
2 DATE <DATE_VALUE> {0:1} 
2 <<SOURCE_CITATION>> {0:M} 
1 _GOV <GOV_IDENTIFIER> {0:1} 
1 MAP {0:1} 
2 LATI <PLACE_LATITUDE> {1:1} 
2 LONG <PLACE_LONGITUDE> {1:1} 
1 _MAIDENHEAD <MAIDENHEAD_LOCATOR> {0:1} 
1 RELI <DENOMINATION> {0:1} 
1 EVEN [<EVENT_DESCRIPTOR>|<NULL>] {0:M} 
2 <<EVENT_DETAIL>> {0:1} 
1 _LOC @<XREF:_LOC>@ {0:M} 
2 TYPE <HIERARCHICAL_RELATIONSHIP> {1:1} 
2 DATE <DATE_VALUE> {0:1} 
2 <<SOURCE_CITATION>> {0:M} 
1 _DMGD <DEMOGRAPHICAL_DATA> {0:M} 
2 DATE <DATE_VALUE> {0:1} 
2 <<SOURCE_CITATION>> {0:M} 
2 TYPE <TYPE_OF_DEMOGRAPICAL_DATA> {1:1} 
1 _AIDN <ADMINISTRATIVE_IDENTIFIER> {0:M} 
2 DATE <DATE_VALUE> {0:1} 
2 <<SOURCE_CITATION>> {0:M} 
2 TYPE <TYPE_OF_ADMINISTRATIVE_IDENTIFIER> {1:1} 
1 <<MULTIMEDIA_LINK>> {0:M} 
1 <<NOTE_STRUCTURE>> {0:M} 
1 <<SOURCE_CITATION>> {0:M} 
1 <<CHANGE_DATE>> {0:1}

Note that currently only selected parts of this structure are displayed and supported by the editor.

Download

• Current version: 1.7.16.1
• Based on and tested with webtrees 1.7.16, may also work with older 1.7.x versions.
• Requires the Hooks module ('hooks_repackaged', or the original Hooks module via webtrees-geneajaubart).
• Requires the 'vesta_common_lib' module.
• Displays data via the 'personal_facts_with_hooks' module.
• Download the zipped module, including all related modules, here.
• Support, suggestions, feature requests: [email protected]
• Issues also via https://github.com/ric2016/shared_places/issues

Installation

• Unzip the files and copy them to the modules_v3 folder of your webtrees installation. All related modules are included in the zip file. It's safe to overwrite the respective directories if they already exist (they are bundled with other custom modules as well), as long as other custom models using these dependencies are also upgraded to their respective latest versions.
• Enable the extended 'Facts and Events' module via Control Panel -> Modules -> Module Administration -> Facts and Events.
• Enable the main module via Control Panel -> Modules -> Module Administration -> Shared Places. After that, you may configure some options.
• Enable the Hooks module via Control Panel -> Modules -> Module Administration -> Hooks. Make sure all hooks are selected (in the preferences of the Hooks module).
• Configure the visibility of the old and the extended 'Facts and Events' tab via Control Panel -> Modules -> Tabs (they both appear as 'Facts and Events' here - usually, you'll want to use only one of them. You may just disable the old 'Facts and Events' module altogether).

License

• shared_places: a webtrees custom module
• Copyright (C) 2017 to 2020 Richard Cissée
• Derived from webtrees - Copyright (C) 2010 to 2016 webtrees development team.
• Derived from webtrees-geneajaubart - Copyright (C) 2009 to 2016 Jonathan Jaubart.
• French translations provided by Pierre Dousselin.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

shared_places's Issues

Check for errors requires adjustment

Notes in _LOC show up as error ('This type of link is not allowed here.') in
Control panel > Manage family trees > Check for errors

Webtrees 1 fix: add 'NOTE'
admin_trees_check.php line 117
'_LOC' => array('SOUR', 'OBJE', '_LOC', 'NOTE'),

Webtrees 2 fix: add 'NOTE'
AdminTreesController.php line 199

Use Long/Lat of higher level place as fallback?

• In case there is no source for Long/Lat data for the place itself, and the place name is hierarchical.

Add configuration options to avoid redundant display of data

1. Option to only display shared place data (media notes) for selected events (CHR,RESI ...).

2. Option to display only once per place in a place list.

GOV-Kennung is limited to 12 characters

Hallo Richard,

while using vesta 2.1.7.1.1, I observed that the "GOV-Kennung" seems to be limited to 12 characters. Therefore, it is not possible to enter certain values, e.g. object_276612 (California).

In the Addendum R2 specification, I found the following:
<GOV_IDENTIFIER> := {Size=1:14}

Grüße

Markus

GOV-field is not editable

If i wanna create a shared place by button, in extended facts (right to set gov-id), i see the window comes up, i see the Name, can search the GOV but can't enter them.

I can save and accept the pretend changes, under list the shared place is there and in summary the today GOV comes up, maybe cause it is defined by place?

Shared Place GEDCOM v7.1 suggestions.

I’m an advocate for augmenting GEDCOM v7.1 to include “shared places” in the standard. I’m advocating for “shared place” to have a tag name of SPLAC which would follow the already implemented “shared note” tag of SNOTE which is a change from the v5.5.1 name of NOTE.

What headache would it cause your module to change the current value of _LOC to _SPLAC for a future release? Could this be a setup parameter to select either _LOC or _SPLAC?

The GEDCOM committee likes to include functional updates that are already used and supported by programs today and this could be used to support this important change to the GEDCOM Standard in the future.

thanks for your feedback

printAddNewFact: Make types configurable

addfacts, uniquefacts, quickfacts should be configurable.
(just like for other record types)

Note: Other records type are configurable per tree - Do we want to support this as well? Seems a bit excessive (and if we do, why stop here - All custom module preferences could be made configurable per tree ...)

Option: Additionally link shared places via name

Drop this confusing option altogether?
(At least explain it better)

Report of shared places

"Schön wäre nun ein Report, der alle LOC-Records mit den enthaltenen Daten (derzeit nur Notizen und Bilder) listet"

Import data from Google Maps module

For users migrating to shared places + OSM, import data from wt_placelocation.