Skip to content
⚶ Vesta Shared Places (Webtrees 2 Custom Module)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
language
patchedWebtrees
replacedWebtrees
resources/views
EditSharedPlaceController.php
README.md
SharedPlaceController.php
SharedPlacesListController.php
SharedPlacesModule.php
SharedPlacesModuleTrait.php
autoload.php
event.png
module.php
place.png

README.md

⚶ Vesta Shared Places (Webtrees 2 Custom Module)

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

Contents

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 entry in the list menu.

Screenshot

  • On the (extended) facts and events tab, shared place data is displayed in addition to regular place data.

Screenshot

  • 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.
  • Location data is provided to other modules (e.g. for use in maps).

Gedcom-L agreements

The Gedcom-L agreements regarding PLAC are described here. They specify the following structure:

0 @<XREF:_LOC>@ _LOC
1 NAME <PLACE_NAME> {1:M}
2 DATE <DATE_VALUE> {0:1}
2 _NAMC <PLACE_NAME_ADDITION> {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 DATE <DATE_VALUE> {0:1}
2 <<SOURCE_CITATION>> {0:M}
1 _FPOST <FOKO_POSTCODE> {0:M}
2 DATE <DATE_VALUE> {0:1}
1 _POST <POSTAL_CODE> {0:M}
2 DATE <DATE_VALUE> {0:1}
2 <<SOURCE_CITATION>> {0:M}
1 _GOV <GOV_IDENTIFIER> {0:1}
1 _FSTAE <FOKO_TERRITORY_IDENTIFIER> {0:1}
1 _FCTRY <FOKO_STATE_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 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

Installation

  • Unzip the files and copy them to the modules_v4 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.
  • Configure the visibility of the old and the extended 'Facts and Events' tab via Control Panel -> Modules -> Tabs (usually, you'll want to use only one of them. You may just disable the oringinal 'Facts and Events' module altogether).

License

  • vesta_shared_places: a webtrees custom module
  • Copyright (C) 2019 Richard Cissée
  • Derived from webtrees - Copyright (C) 2010 to 2019 webtrees development team.
  • 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/.

You can’t perform that action at this time.