Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter: Unterschied zwischen den Versionen

aus wiki, dem genealogischen Lexikon zum Mitmachen.
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „Description This custom module replaces the original 'Clippings Cart' module. The design concept for the enhanced clippings cart is shown in the following diag…“)
 
 
(95 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Description
{{WT-Seitenkopf|prefix=Abschnitt 8.10.1|info=1}}{{WT-Inhaltsverzeichnis|Kapitel 8|E|Abschnitt 8.10|Abschnitt 8.10.1}}
This custom module replaces the original 'Clippings Cart' module. The design concept for the enhanced clippings cart is shown in the following diagram:


new concept for enhanced clippings cart
Der Standard-[[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]] von {{WT-Name}} kann durch ein Erweiterungsmodul ersetzt werden, das die Datensätze im Sammelbehälter nicht nur als GEDCOM herunterladen kann, sondern diese auch visualisieren lassen kann. Zusätzlich zu den Vorfahren und Nachkommen einer Person und anderen einzelnen Datensätzen können globale Datensatzsammlungen dem [[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]] hinzugefügt werden, etwa alle [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/Sammelbehälter#Partnerketten_(visualisiert_mit_TAM)|Partnerketten]] oder alle [[Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/Sammelbehälter#Ahnenkreise_in_einem_Stammbaum_(visualisiert_mit_TAM)|Ahnenkreise]] in einen Stammbaum.


Various functions can collect records in the clippings cart and these records could then be passed on to various evaluation / export / visualization functions. The user of the module can decide which records should be sent to the clippings cart and which action should be executed on these records.
== Steckbrief ==
* Modulname: huhwt-cce (clippings cart enhanced)
* Autor: huhwt (EW.H); Hermann Hartenthaler hat das Konzept für dieses Erweiterungsmodul und die erste Beta-Version erstellt.
* Passende webtrees-Versionen: 2.1 (oder 2.0)
* Speicherort
** für webtrees 2.1: [https://github.com/huhwt/huhwt-cce GitHub]
** für webtrees 2.0: [https://github.com/huhwt/huhwt-cce20 GitHub] (nicht mehr gepflegt)
* Modulkategorie: Genealogie
* Modulfunktion: Menü "[[Webtrees_Handbuch/Anleitung_für_Mitglieder#Sammelbeh.C3.A4lter|Sammelbehälter]]"
{{Infobox|
Beschreibung bezieht sich auf die Version 2.1.18 ff<br>
Einige Funktionen sind erst ab dieser Version verfügbar - und diese Version setzt PHP 8.2 für den Server zwingend voraus. Bezüge auf solche Funktionen sind mit ︕ ab v2.1.18. ︕ markiert.<br>
Einige weitere Funktionen sind erst ab Version 2.1.20 ff verfügbar - Bezüge sind mit ! ab v2.1.20. ! markiert.}}


As input functions there are
== Beschreibung ==
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Systemarchitektur.png|alternativtext=Systemarchitektur des erweiterten Sammelbehälters|mini|800x800px|Systemarchitektur des erweiterten Sammelbehälters|links]]
{{WT-ToDo|Grafik aktualisieren: GVExport ergänzen; Heiratsketten in Partnerketten umbenennen; TSM (tagging service manager) einbauen; Bestehende Listen ist teilweise grün statt blau; "Multi Treeview" (Admin-Funktion "Doppelte Datensätze suchen") und "Treeview Extended" aufnehmen}}
Dieses benutzerdefinierte Modul ersetzt das ursprüngliche Modul „Sammelbehälter“ (engl. "clippings cart"). Das Systemkonzept des erweiterten Sammelbehälters ist in vorstehenden Grafik dargestellt.


the functions of the current module "clippings cart" or the existing custom Vesta clippings cart module, which offer the possibility to put records in the clippings cart for a person or another GEDCOM object like a source or a note. This includes for a person for example their ancestors or descendants, possibly with their families. For a location it includes for example all persons with reference to this place.
Verschiedene Module können GEDCOM-Datensätze im Sammelbehälter ablegen und diese können dann an verschiedene Auswertungs-, Export- oder Visualisierungsmodule weitergegeben werden. Der Benutzer des Moduls kann entscheiden, welche Datensätze an den Sammelbehälter gesendet werden sollen und welche Aktionen mit diesen Datensätzen ausgeführt werden sollen. Der Sammelbehälter ist also während einer Browser-Sitzung eine Art Datendrehscheibe für einen Stammbaum.  
the search in the control panel for unconnected persons in a tree (with a new button "send to clippings cart") (tbd)
the normal webtrees search (also with a button "send to clippings cart"), so that you can search for anything you want and with the option of using all the filter functions that are currently offered (tbd)
the list display modules "Families" and "Family branches", so that you can send all persons with the same family name or all persons from a clan to the clippings cart (tbd)
new functions in this module searching for marriage chains or ancestor circles in the tree.
The user can then delete selected records or groups of records of the same type in the clippings cart or delete the clippings cart completely.


An action initiated by the user then takes place on the records in the clippings cart, such as
Als Quellen kommen für den Sammelbehälter in Frage


the export to a GEDCOM zip file, as in the actual clippings cart module
* das Standardmodul „Sammelbehälter", das zu einer Person oder einem anderen Datensatz die Möglichkeit bietet, diesen und eventuell auch weitere Datensätze in den Sammelbehälter einzustellen (etwa eine Person und ihre Vorfahren oder Nachkommen, ggf. mit deren Familien); das Standardmodul kann aber auch deaktiviert werden, da alle seine Funktionen auch im Erweiterungsmodul enthalten sind.
the display of the objects in list form with the possibility of sorting and filtering this list (tbd)
* die [[Webtrees_Handbuch/Anleitung_für_Besucher#Listen|Listenanzeige]]-Funktionen "Familien" und "Familienzweige", so dass man etwa alle Personen mit gleichem Familiennamen oder alle Personen aus einem Clan in den Sammelbehälter einstellen kann ︕ ab v2.1.18. ︕.
the transfer of the records in the clippings cart to new functions that visualize this data or analyze it statistically. Such a function could be for example a link-node-diagram like TAM (Topographic Attribute Map) or Lineage.
* die Erweiterungsmodule "Multi Treeview" (Admin-Funktion "Doppelte Datensätze suchen" - für jede als Doublette angenommene Person wird ein eigenes kleines Sanduhrdiagramm angezeigt) und "Treeview Extended" (das interaktive Sanduhrdiagramm mit erweiterten Funktionen - so kann man stufenweise erweitern, Teilbäume aus- und einblenden, die Ansicht als PNG exportieren und mit einer Namenliste in der Ansicht navigieren). Beide Module bieten jetzt die Option, die in der Ansicht gezeigten Personen in den Sammelbehälter zu übernehmen︕ ab v2.1.18. ︕.
* dieses Erweiterungsmodul, das, zusätzlich zu den genannten Funktionen des herkömmlichen Moduls, nun auch [[#Partnerketten_(visualisiert_mit_TAM)|Partnerketten]] oder [[#Ahnenkreise_in_einem_Stammbaum_(visualisiert_mit_TAM)|Ahnenkreise]] in einem Stammbaum sucht und die zugehörigen Datensätze in den Sammelbehälter schieben kann
* das Erweiterungsmodul Vesta-Sammelbehälter, das Ortsdatensätze (_LOC) oder auch alle Personen mit Bezug zu einem geteilten Ort in den Sammelbehälter legen kann
* die [[Webtrees_Handbuch/Anleitung_für_Besucher#Suchen|Suchfunktionen]] 'Allgemeine Suche' und 'Erweiterte Suche' - die Suchergebnisse können wie angezeigt oder ergänzt nach verschiedenen Beziehungen in den Sammelbehälter übernommen werden ! ab v2.1.20 !.


Screenshots
Derzeit noch nicht realisiert, aber denkbar wären auch
Screenshots of menus
Screenshot of the new menu
Screenshot of main menu


Screenshot of menu to add global sets of records for a tree
* die Suche in der Systemsteuerung nach [[Webtrees_Handbuch/Anleitung_für_Verwalter#Finde_unverbundene_Personen|unverbundenen Personen]] in einem Stammbaum (mit einem neuen Button „in den Sammelbehälter legen")
Screenshot of menu to add global sets of records
* bestehende Erweiterungsmodule, wie das Modul „[[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Großfamilie|Großfamilie]]“, das eine komplette Großfamilie mit allen zugehörigen Datensätzen in den Sammelbehälter packen könnte.


Screenshot of new menu to delete records in the clippings cart
Die Datensätze werden gruppiert nach ihrem Typ. Diese Gruppen kann man durch Klick auf die Gruppenüberschrift ein- und ausklappen. Der Benutzer kann ausgewählte Datensätze oder Gruppen von Datensätzen des gleichen Typs im Sammelbehälter löschen. Er kann den Sammelbehälter auch komplett löschen.
Screenshot of menu to delete records


Screenshot of new menu to execute actions on the records in the clippings cart
Der Benutzer des Moduls kann entscheiden, welche Aktion mit den Datensätzen im Sammelbehälter ausgeführt werden soll. So etwa
Screenshot of menu to execute actions
* der Export in eine GEDCOM-Datei, genau so wie im bisherigen Sammelbehälter-Modul
* die Weitergabe der Datensätze im Sammelbehälter an andere Erweiterungsmodule, die diese Daten visualisieren oder statistisch auswerten. Verfügbar sind hier die Erweiterungsmodule [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/TAM|TAM (Topographic Attribute Map)]], [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/TAM und Lineage/Lineage|Lineage]] und [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/GVExport|GVExport]]. Diese Erweiterungsmodule müssen separat in {{WT-Name}} installiert werden.
* ︕ ab v2.1.18. ︕ gibt es eine ergänzende Bearbeitungsfunktion: TSM "Tagging Service Manager". Diese erlaubt es, für die im Sammelbehälter befindlichen Datensätze 'Gemeinsame Notizen' zu bearbeiten (sofern sie ach einem definierten Muster strukturiert sind). Das Modul muss separat in {{WT-Name}} installiert sein.


Screenshots of new visualisation possibilities
Derzeit noch nicht realisiert, aber denkbar, wäre auch
The following charts are produced by an external application TAM. It is planned to integrate TAM into webtrees so that export/import is not any longer necessary.


Screenshot using TAM for a tree with more than 10.000 persons
* die Anzeige der Datensätze im Sammelbehälter mit der Standard-[[Webtrees Handbuch/Anleitung für Besucher#Listen|Listenanzeige]] von {{WT-Name}} mit der dort vorhandenen Möglichkeit, diese Liste zu sortieren und zu filtern.
Screenshot of large tree


This image was produced by exporting a complete tree from webtrees as GEDCOM file using the administrator menu. Then this file was imported to TAM. It is planned to add a new option "add all records to the clippings cart" to the "global add menu" of this module.
== Bedienoberfläche ==
Screenshot using TAM for a visualisation of all ancestor circles in this tree
Im folgenden werden die verschiedenen Menüs dieses Moduls beschrieben.
Screenshot of circles
[[Datei:WT 2.1 Erweiterungsmodul Sammelbehälter Hauptmenü -v2.1.18-.png|alternativtext=|links|mini|600x600px|Hauptmenü]]
Im Kopfmenü der Seite sieht man, dass hier drei Sammelbehälter-Module nebeneinander aktiviert sind


Screenshot of circles
* ℍ Sammelbehälter (dieses Modul hier)
* Vesta-Sammelbehälter.
* Standard-Modul


This chart was produced using the new "global add menu" selecting "add all circles". This function removes all leaves in a tree recursively. A family with two parents and her child is a trivial circle (child -> mother -> husband -> child) and is therefore not included. Circles are a result for example when cousins are married together. Such circles are responsible for pedigree collapse (in German: Ahnenschwund or Implex). Following the connections of marriage or partnership, circles can be found if two families are interconnected by more than one marriage. Maybe such circles can have a length of 30, 40, or 50 steps. They can connect several families together and it is not easy to find them. Such long distant connections in a tree are interconnecting different parts of a family. I call them therefore sometimes "ancestor Autobahn". The first Autobahn I built in my tree, many years ago, was connection to Johann Wolfgang von Goethe in more than 50 steps.
For example my parents are connected together by several such circles (beside the trivial connection by their own marriage). In webtrees you can search for such connections by using Charts / Relationships / Find all possible relationships. But up to now there was no possibility to show all such circles in a tree.


Screenshot using TAM to show a H diagram
Das Hauptmenü des erweiterten Sammelbehälters zeigt, abhängig davon, ob der Sammelbehälter bereits Datensätze enthält, verschiedene Optionen an. In der Abbildung sieht man alle sechs möglichen Menüpunkte
Screenshot of H diagram


A H diagramm is a very compact ancestor diagram showing the proband and a few generations of his ancestors. One example is the webtrees chart "compact tree". To produce such a diagram using TAM, you have to select the proband, add 3, 4, or 5 generations of his ancestors to the clippings cart. Then use the action menu and export these records using the TAM option. Then import the produced GEDCOM file to your TAM application. Now you have to place the persons and families manually to their right position by drag and drop.
* Datensätze im Sammelbehälter - hier wird immer die Anzahl der Datensätze angezeigt; wenn es Datensätze im Sammelbehälter gibt, kann man durch einen ''Klick'' die Liste der Datensätze anzeigen lassen (siehe unten)
Screenshot using TAM for a partner chain with 30 partners of partners of partners ...
* Zum Sammelbehälter hinzufügen - dieser Menüpunkt wird nur dann angezeigt, wenn man im Hauptteil der Seite gerade einen Datensatz sieht, der zum Sammelbehälter hinzugefügt werden kann; ein ''Klick'' führt zum Menü, das die Details des Hinzufügens festlegt.  Je nachdem welche Art von Datensatz dem Sammelbehälter hinzugefügt werden soll gibt es verschiedene Optionen
Screenshot of partner chains
** INDI: hier wird das sich öffnende Menü zum Hinzufügen eines Personendatensatzes in der nächsten Abbildung genauer beschrieben
** FAM: dieses Menü ist ähnlich zum Menü bei INDI; man kann die Familie hinzufügen, die Familie mit ihren Kindern oder die Familie mit allen Nachkommen
** NOTE: die Notiz kann im Sammelbehälter abgelegt werden. ︕ ab v2.1.18. ︕: Man kann Personen und Familien zu dieser Notiz hinzufügen.
** OBJE: das Medienobjekt kann dem Sammelbehälter hinzugefügt werden
** SOUR: es kann im sich öffnenden Menü entschieden werden, ob nur die Quelle selbst hinzugefügt wird oder ob auch alle Personen hinzugefügt werden, bei denen sich Ereignisse auf diese Quellen beziehen
** REPO: beim Hinzufügen eines Archivs werden immer auch alle Quellen, die sich auf dieses Archiv beziehen, hinzugefügt
** SUBM: der Übermittler-Datensatz wird hinzugefügt
** _LOC: der Datensatz mit dem gemeinsamen Ort kann in den Sammelbehälter gelegt werden; das Vesta-Sammelbehälter-Modul bietet hier zusätzlich noch zwei weitere Optionen an: zum einen den Ortsdatensatz und die Personen und Familien, die darauf verweisen, hinzuzufügen und zum anderen den Ortsdatensatz und die Einzelpersonen und Familien, die sich darauf beziehen, einschließlich der Eltern, Geschwister, Ehegatten und Kinder der einzelnen Personen hinzuzufügen.
* Globale Datensammlungen zum Sammelbehälter hinzufügen -  hier kann man Datensammlungen aus dem Stammbaum hinzufügen; zwei Kriterien sind definiert: alle [[#Partnerketten_(visualisiert_mit_TAM)|Partnerketten]] und alle [[#Ahnenkreise_in_einem_Stammbaum_(visualisiert_mit_TAM)|Ahnenkreise]] im Stammbaum (siehe unten)
* Datensätze im Sammelbehälter in Gänze löschen  ︕ ab v2.1.18. ︕ löscht die Datensätze im Sammelbehälter im Hintergrund ohne weitere Benutzer-Aktion.
* Datensätze im Sammelbehälter löschen - man kann den gesamtem Sammelbehälter leeren, man kann einzelne Datensätze in der Listenansicht löschen oder man kann alle Datensätze eines Typs (INDI, FAM, NOTE, ...) löschen (siehe unten)
* Weiterführende Aktionen mit den Datensätzen im Sammelbehälter - zwei Typen von Aktionen sind verfügbar; zum einen das Herunterladen der Datensätze im Sammelkorb als GEDCOM-Datei (genau so wie beim Standard-Sammelbehälter-Modul) und zum anderen das Visualisieren der Datensätze mit den Erweiterungsmodulen TAM oder Lineage (siehe unten); zur Visualisierung des Inhalts des Sammelbehälters mit GVExport muss dieses Modul im Hauptmenü "Diagramme" ausgewählt werden.


Screenshot of partner chains
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Personen_Familien.png|mini|600x600px|Hinzufügen von Vorfahren und Nachkommen einer Person|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Personen_Familien.png]]
Wenn man auf einer Personenseite in der Bedienoberfläche von {{WT-Name}} das Menü des erweiterten Sammelbehälters aufruft, kann man die Option "Datensatz hinzufügen" auswählen. Danach öffnet sich das nebenstehend abgebildete Menü, das verschiedene Optionen zur Übernahme in den Sammelbehälter anbietet


A partner chain is a chain of partners of partners of partners of ... If one partner of marriage was married before or later to another partner, this is a chain of three partners. Trivial chains consisting only of two partners (husband/wife) are ignored. Maybe one of the partners was married three or more times, then the chain becomes a tree of chains. There was up to now no possibility in webtrees to visualize such trees of partner chains.
* die Person selbst
* die Person mit Eltern und Geschwistern
* die Person mit Partnerinnen und Kindern
* die Person und ihre Vorfahren - hier wird auch angegeben wie viele Vorfahrengenerationen im Stammbaum existieren
* die Person und ihre Vorfahren bis zu 4 Generationen für ein H-Diagramm
* die Person und ihre Vorfahren zusammen mit derer Familien
* die Person mit ihren Partnern und deren Nachkommen
* die Partner-Ketten zu denen die Person gehört - dieser Punkt erscheint nur dann, wenn die Person Partner hatte; er erlaubt alle Partner der Person sowie deren Partner (und so weiter) in den Sammelbehälter zu legen.


Requirements
Man kann getrennt festlegen wie viele Generationen in Richtung der Vorfahren und wie viele in Richtung der Nachkommen berücksichtigt werden sollen. Die Generation 1 sind die Eltern bzw. die Kinder.{{-}}
This module requires webtrees version 2.1 or later. This module has the same requirements as webtrees#system-requirements.


This module was tested with webtrees 2.1.0-alpha.1 version and all available themes and all other custom modules. If you are using the Vesta clippings cart module: the integration is an open issue.
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_globale_Daten.png|mini|600x600px|Hinzufügen von globalen Datensatzmengen|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_globale_Daten.png]]
Wenn man die Option "Globale Datensammlungen zum Sammelbehälter hinzufügen" ausgewählt hat, öffnet sich das nebenstehende Menü das zwei Optionen anbietet: zum einen können alle [[#Partnerketten_(visualisiert_mit_TAM)|Partnerketten]] oder zum anderen können alle [[#Ahnenkreise_in_einem_Stammbaum_(visualisiert_mit_TAM)|Ahnenkreise]] in den Sammelbehälter gelegt werden (die dritte abgebildete Option ist derzeit nicht implementiert).
{{-}}


[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Löschen.png|mini|600x600px|Löschen von Datensätzen im Sammelbehälter|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Löschen.png]]
Wenn man die Option "Datensätze im Sammelbehälter löschen" auswählt, öffnet sich ein Menü das drei Optionen anbietet


Installation
* alle Datensätze löschen
This section documents installation instructions for this module.
* Datensätze eines Typs löschen - hier werden die Typen von Datensätzen im Sammelbehälter angezeigt und die Anzahl der Datensätze des jeweiligen Typs; man kann eine oder mehrere Typen komplett löschen
* Datensätze zum Löschen auswählen - hier öffnet sich das Listenmenü in dem man dann einzelne Datensätze selektiv löschen kann.
{{-}}


Download the latest release.
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Aktion.png|mini|600x600px|Weiterführende Aktionen im erweiterten Sammelbehälter|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Aktion.png]]
Unzip the package into your webtrees/modules_v4 directory of your web server.
Nach der Auswahl der Option "Weiterführende Aktionen mit den Datensätzen im Sammelbehälter" kann man unter zwei Typen von Aktionen wählen
Rename the folder to hh_clippings_cart_enhanced. It's safe to overwrite the respective directory if it already exists.
Login to webtrees as administrator, go to Control Panel/Modules/Genealogy/Menus, and find the module. It will be called "Clippings cart enhanced". Check if it has a tick for "Enabled".
Edit this entry to set the access level for each tree and to position the menu item to suit your preferences.
You can deactivate the standard module "clippings cart".
Finally, click SAVE, to complete the configuration.


Upgrade
* Datensätze herunterladen - hier hat man die gleichen Möglichkeiten wie im Standard-Sammelbehälter-Modul; die GEDCOM-Datei oder die GEDCOM-Datei mit den Mediendateien  in einem ZIP-Archiv wird auf den Rechner des Nutzers heruntergeladen
To update simply replace the hh_clippings_cart_enhanced files with the new ones from the latest release.
* Datensätze graphisch in einem Diagramm auswerten - hier kann man zwischen zwei Visualisierungsmethoden auswählen: TAM und Lineage (siehe Beispiele in den folgenden Abschnitten). Wenn die Datensätze mit GVExport visualisiert werden sollen, muss der entsprechende Punkt im Hauptmenü unter "Diagramme" ausgewählt werden (sofern dieses Erweiterungsmodul installiert ist).


Dabei kann man die verwendeten Datensätze noch an Hand der Datenschutzeinstellungen selektieren. Entsprechend der hier ausgewählten Rolle werden die Datensätze ggf. reduziert. Dabei können aber nur Rollen gewählt werden, die eine geringere Berechtigung aufweisen als die Rolle des gerade angemeldeten Nutzers.
{{-}}


Translation
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Aktion_Abschluss.png|mini|600x600px|Abschluss einer Visualisierungsaktion|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Aktion.png]]
You can help to translate this module. It uses the po/mo system. You can contribute via a pull request (if you know how) or by e-mail. Updated translations will be included in the next release of this module.
Nach der Auswahl der Option Visualisierung mit "TAM" oder mit "Lineage" werden die INDI- und FAM- Datensätze an das ausgewählte Erweiterungsmodul übertragen. Nach einem ''Klick'' auf die Schaltfläche "... in neuem Tab starten" öffnet sich ein weiteres Browserfenster mit der gewählten Visualisierungsanwendung.
{{-}}


There are now, beside English and German, no other translations available.
=== Listenansicht ===


==== Ausgangsversion ====
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Liste.png|mini|600x600px|Listenansicht der Datensätze im Sammelbehälter (gruppiert nach Typen)|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Liste.png]]
Die Listenansicht zeigt jeweils einen Datensatz pro Zeile. Die Datensätze sind nach Typen gruppiert und die Gruppen können durch einen Klick auf die Überschriftenzeile ein- und ausgeklappt werden. Jeder Datensatz wird zusätzlich durch ein Typ-Symbol gekennzeichnet Jeder einzelne Datensatz kann individuell gelöscht werden.
{{-}}


Support
==== Ab Version v2.1.18 ====
Issues: you can report errors raising an issue in this GitHub repository.
Es gibt zusätzliche Optionen, um mit dem Sammelkorb zu arbeiten
[[Datei:WT 2.1 Erweiterungsmodul Sammelbehälter Liste -v2.1.18-.png|links|mini|600x600px|Listenansicht der Datensätze im Sammelbehälter (gruppiert nach Typen) mit voranstehender 'Ansicht der Sammelaktionen' und zusätzlichen Aktions-Symbolen]]
Oberhalb der Datensatz-Gruppen gibt es die 'Auflistung der Sammelaktionen'. Jeder Sammelaktion ist nun eine eindeutige Kennung zugeordnet. Bei den einzelnen Datensätzen wird (im mittleren Bereich der Ansicht) angezeigt, welche - eine oder mehrere - Sammelaktionen diesen Datensatz in den Sammelbehälter gelegt haben.


Forum: general webtrees support can be found at the webtrees forum
Jede einzelne Sammelaktion kann für sich gelöscht werden, damit wird die Kennung bei den einzelnen Datensätzen entfernt. Hat ein einzelner Datensatz keine Zuordnung mehr zu einer Sammelaktion, wird er aus dem Sammelbehälter entfernt.


Die 'Auflistung der Sammelaktionen' führt nun auch 3 Aktions-Symbole mit. Sie stehen für:


Thank you
* Sammelbehälter exportieren in Datei
Special thanks to huhwt for testing, suggestions, and contributions.
* Import eines gespeicherten Sammelbehälter aus Datei - die darin referenzierten Datensätze werden dem vorhandenen Sammelbehälter hinzugefügt
* Sammelbehälter -Ansicht neu laden




License
This module is derived from the Vesta clippings cart module.


Copyright (C) 2021 Hermann Hartenthaler
Copyright (C) 2021 Richard Cissée. All rights reserved.
Derived from webtrees - Copyright 2021 webtrees development team.
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/.
<br>
Die Neu-Laden-Aktion ist hilfreich, wenn man den Sammelbehälter in einem eigenen Tab im Browser geöffnet hat (das kann man mit Rechtsklick auf die Sammelbehälter-Menüaktion 'Datensätze im Sammelkorb ...' (1. Eintrag im Menü) und dann 'Link in neuem Tab öffnen' bewerkstelligen). Damit hat man die Option, in dem/den anderen Tab(s) die gewünschten Sammelaktionen anzustoßen und im davon unabhängigen Sammelbehälter-Listenansicht-Tab direkt danach die Auswirkungen zu prüfen. Die einzelnen Aktionen sind jeweils unabhängig voneinander, mit der Neu-Laden-Aktion wird die Listenansicht mit dem in Hintergrund geänderten Sammelbehälter synchronisiert (Äquivalent könnte man die Browser-Aktion 'Neu laden' ausführen).
 
Die Export-Aktion öffnet ein kleines Fenster, in welchem man bei Bedarf eine eigene Korb-Kennung vergeben kann. Vorbelegt ist die Kennung mit 'Cart(YYYYMMDD_HHMM)', also einem Kürzel und dem Zeitstempel der Export-Aktion (Zeitangabe ist in UTC).
 
Die Import-Aktion öffnet ein kleines Fenster, in welchem man einen oder mehrere der abgespeicherten Sammelbehälter-Stände auswählen kann. (Import funktioniert auch bei leerem Sammelbehälter - er enthält danach die Referenzen, welche seinerzeit gespeichert worden waren).
 
Nach einem Import gibt es oberhalb der  'Auflistung Sammelaktionen' eine ergänzende Übersicht 'Aus Datei übernommene Bestände im Sammelbehälter', sie führt mit einem '::A::' (bzw. '::B::' usw.) gekennzeichnet die Informationen zu importierten Beständen auf. Die Sammelaktionen wie auch die Einträge der Datensätze werden um die mit diesem Kennbuchstaben ergänzten Aktionen auf. Importierte Bestände wie auch verbundene Sammelaktionen können ebenfalls selektiv wieder entfernt werden.
 
[[Datei:WT 2.1 Erweiterungsmodul Sammelbehälter Menüaktionen -v2.1.18-.png|links|mini|300x300px]]
Ebenfalls neu ist eine zusätzliche Aktion im Sammelbehälter-Menü: 'Übertragen an den Tagging Service'. Damit werden 'Gemeinsame Notizen' bearbeitet, welche den aktuell im Sammelbehälter befindlichen Datensätzen zugeordnet sind. Weitere Einzelheiten: TSM "Tagging Service Manager". Diese Aktion erscheint nur in der Listenansicht und nur dann, wenn der Sammelbehälter auch Daten enthält.
{{-}}
 
== Datenstrukturen und ihre Visualisierung ==
 
Die Möglichkeit zur Visualisierung der Datensätze im Sammelbehälter erlaubt ganz neue Einsichten in die Struktur der Daten in einem Stammbaum. Vergleichbare Visualisierungsmöglichkeiten gab es bislang bei {{WT-Name}} nicht. Man kann zwar mit dem Diagramm "Beziehungen" Verbindungen zwischen zwei Personen darstellen und sogar mehrere alternative Beziehungspfade anzeigen, aber für größere Beziehungsnetze ist diese Darstellung nicht ausreichend. Passend zu den Visualisierungsmöglichkeiten bringt dieses Modul auch die Ermittlung von zwei neuen Datensammlungen mit
 
* [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter#Ahnenkreise in einem Stammbaum (visualisiert mit TAM)|Ahnenkreise]]
* [[Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter#Partnerketten (visualisiert mit TAM)|Partnerketten]].
 
Diese Datenstrukturen von miteinander verbundenen Personen werden in den beiden folgenden Abschnitten näher beschrieben.
 
=== Ahnenkreise in einem Stammbaum (visualisiert mit TAM) ===
<gallery perrow="2" widths="500" heights="500">
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Ahnenkreise_ohne_Hintergrund.png|Ahnenkreise (ohne Hintergrund)
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Ahnenkreise_mit_Hintergrund.png|Ahnenkreise (mit einem temporalen Feld als Hintergrund)
</gallery>
{{WT-ToDo|In diesem Abschnitt muss der Text komplett überarbeitet (entpersönlicht) werden.}}
Dieses Diagramm wurde mit dem "globalen Hinzufügen-Menü" erstellt, indem "Alle Kreise hinzufügen" ausgewählt wurde. Diese Funktion entfernt rekursiv alle Blätter in einem Baum. Eine Familie mit zwei Elternteilen und ihrem Kind ist ein trivialer Kreis (Kind -> Mutter -> Ehemann -> Kind) und wird daher nicht erfasst. Kreise ergeben sich zum Beispiel, wenn Cousins ​​zusammen verheiratet sind. Solche Kreise sind verantwortlich für den Stammbaumkollaps (auf Deutsch: Ahnenschwund oder Implex). Nach den Verbindungen der Ehe oder Partnerschaft finden sich Kreise, wenn zwei Familien durch mehr als eine Ehe miteinander verbunden sind. Vielleicht können solche Kreise eine Länge von 30, 40 oder 50 Schritten haben. Sie können mehrere Familien miteinander verbinden und es ist nicht einfach, sie zu finden. Solche weit entfernten Verbindungen in einem Baum verbinden verschiedene Teile einer Familie. Ich nenne sie deshalb manchmal "Ahnenautobahn". Die erste Autobahn, die ich vor vielen Jahren in meinen Baum gebaut habe, war die Verbindung zu Johann Wolfgang von Goethe in mehr als 50 Stufen. Zum Beispiel sind meine Eltern durch mehrere solcher Zirkel miteinander verbunden (neben der trivialen Verbindung durch ihre eigene Ehe). In Webtrees können Sie nach solchen Verbindungen suchen, indem Sie Diagramme / Beziehungen / Alle möglichen Beziehungen finden verwenden. Aber bisher gab es keine Möglichkeit, alle diese Kreise in einem Baum darzustellen.
 
=== Partnerketten (visualisiert mit TAM) ===
<gallery perrow="2" widths="500" heights="500">
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Partnerketten_ohne_Hintergrund.png|Partnerketten (ohne Hintergrund)
Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Partnerketten_mit_Hintergrund.png|Partnerketten (mit einem temporalen Feld als Hintergrund)
</gallery>
Eine [[Partnerkette]] (oder Heiratskette) ist eine Kette von Partnern von Partnern von Partnern von ... Wenn ein Ehepartner vorher oder später mit einem anderen Partner verheiratet war, ist dies eine Kette von drei Partnern. Triviale Ketten, die nur aus zwei Partnern (Ehemann/Ehefrau) bestehen, werden hier nicht betrachtet. Falls einer der Partner dreimal oder öfter verheiratet war, wird aus der Kette ein Baum aus Ketten.
 
Bisher gab es in {{WT-Name}} keine Möglichkeit, solche Partnerkettenbäume zu visualisieren. Durch die Visualisierungsmodule TAM und Lineage kann man nun solche Ketten darstellen. Während sich Genealogie sonst meist in der Zeitachse bewegt (von einer Person zu ihren Vorfahren), bieten Heiratsketten eine Orientierung in senkrechter Richtung dazu: von einer Familie zur nächsten und zur übernächsten.
 
In der nebenstehenden Abbildung wurde ein recht komplexer Partnerkettenbaum mit TAM visualisiert. Etwas oberhalb des Zentrums erkennt man John F. Kennedy, der eine Familie mit seiner Frau Jacqueline bildet, die wiederum eine Familie mit Aristoteles Onassis bildet, der wiederum ... In der zweiten Abbildung wurde im Hintergrund ein temporales Feld eingeblendet. Die Zeit wird hier ähnlich wie Höhenlinien auf einer Geländekarte dargestellt. Besonders dunkelblaue Bereiche liegen weiter in der Vergangenheit, die hellen Bergrücken ehr in der Gegenwart. So kann man auf einen Blick die älteren Personen in den Partnerketten identifizieren.
 
=== Kompaktes H-Diagramm (visualisiert mit TAM) ===
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_H-Diagramm.png|mini|600x600px|H-Diagramm|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_H-Diagramm.png]]
 
Ein kompaktes H-Diagramm gibt es bereits in webtrees. Wenn man ...
{{-}}
 
=== Familiennamengruppen bei den Bewohnern eines Dorfes (visualisiert mit Lineage) ===
[[Datei:WT_2.1_Erweiterungsmodul_Sammelbehälter_Familiennamengruppen.png|mini|600x600px|Familiennamengruppen bei den Bewohnern eines Dorfes|links|verweis=Special:FilePath/WT_2.1_Erweiterungsmodul_Sammelbehälter_Familiennamengruppen.png]]
 
Mit dem Vesta-Sammelbehältermodul kann man alle Personen zum Sammelbehälter hinzufügen, die einen Bezug zu einem gemeinsamen Ort haben, das sind etwa alle Bewohner des Ortes. Dazu ruft man den gemeinsamen Ort auf, öffnet das Vesta-Sammelbehälter-Menü und wählt "Ortsdatensatz" hinzufügen. Danach kann man auswählen, dass man alle Personen mit Bezug zu diesem Ort dem Sammelbehälter hinzufügen möchte. Wenn man dann bei den globalen Aktionen des hier beschriebenen Erweiterungsmoduls die Visualisierung durch "Lineage" auswählt, werden die Personen des Ortes in einem zweiten Browser-Fenster angezeigt. Die Darstellung der zeitlichen Entwicklung der Gruppen von Personen mit einem gleichen oder ähnlichen Familiennamen ist besonders spannend. Man sieht etwa sehr schön, dass irgend ein Namensträger zu einem Zeitpunkt in das Dorf gezogen ist, Nachkommen bekommen hat und sich so der Familienname über die Zeit im Dorf in wachsender Anzahl verbreitet.
{{-}}
 
== Anforderungen ==
Dieses Modul erfordert die webtrees-Version 2.1 oder höher. Es gibt auch noch eine ältere, nicht mehr gepflegte Version für die Version 2.0. Dieses Erweiterungsmodul kann das bestehende Sammelbehälter-Modul ersetzen oder parallel zu diesem betrieben werden. Um die zusätzlichen Funktionen des Vesta-Sammelbehälter-Moduls zu nutzen, muss dieses parallel installiert und aktiviert sein.
 
Dieses Modul wurde mit der webtrees-Version 2.1.4 und allen verfügbaren Themen und allen anderen Erweiterungsmodulen getestet. Icons werden nur für einige der Themen bereit gestellt.
 
︕ ab v2.1.18. ︕ - einige Optionen und Aktionen stehen erst ab der Version 2.1.18 dieses Moduls zur Verfügung. Diese Version erfordert zwingend, dass auf dem Server PHP mindestens mit Version 8.2 installiert ist!
 
== Installation ==
Bitte beachten Sie die folgenden Installationsanweisungen
 
* Laden Sie die neueste Version von [https://github.com/huhwt/huhwt-cce GitHub] herunter.
* Entpacken Sie das Erweiterungsmodul in das Verzeichnis webtrees/modules_v4/huhwt-cce des Webservers. Wenn dieses Verzeichnis bereits vorhanden ist, können Sie es einfach überschreiben.
* Melden Sie sich als Administrator bei {{WT-Name}} an, gehen Sie zu Systemsteuerung/Module/Genealogie/Menüs und suchen Sie das Modul. Es heißt "ℍ&ℍwt Sammelbehälter". Überprüfen Sie, ob es ein Häkchen für "Aktiviert" hat. Bearbeiten Sie diesen Eintrag, um die Zugriffsrechte für jeden Stammbaum festzulegen und den Menüpunkt nach ihren Wünschen zu positionieren. Auf Grund der umfangreichen Möglichkeiten mit diesem Modul auf die Daten in ihrem Stammbaum zuzugreifen, sollten Sie es eher nicht für Besucher sichtbar machen.
* Sie können den Menüpunkt des Standardmoduls "Sammelbehälter" deaktivieren. Klicken Sie abschließend auf "Speichern", um die Konfiguration zu sichern.
 
== Upgrade ==
Ersetzen Sie zum Aktualisieren einfach die bestehenden Dateien durch diejenigen aus der neuesten Version.
 
== Übersetzung ==
Sie können helfen, dieses Modul zu übersetzen. Es verwendet das po/mo-System. Sie können über einen [https://github.com/huhwt/huhwt-cce/pulls Pull-Request in GitHub] (wenn Sie wissen wie das geht) oder per [mailto:git@huh-netz.de E-Mail an den Programmautor] weitere Übersetzungen beitragen. Aktualisierte Übersetzungen werden in der jeweils nächsten Version dieses Moduls enthalten sein.
 
Folgende Sprachen sind verfügbar
 
* Englisch
* Deutsch
* Niederländisch
* Russisch.
 
== Unterstützung ==
Sie können Fehler oder Wünsche für Erweiterungen auf der [https://github.com/huhwt/huhwt-cce/issues "issue"-Seite bei GitHub] melden,
 
Sie können bei Fragen auch das [https://www.webtrees.net/index.php/en/forum webtrees-Forum] mit dem Themenbereich "Customising" nutzen.
 
== Lizenz ==
Dieses Modul ist ursprünglich vom Vesta-Erweiterungsmodul "Sammelbehälter" abgeleitet worden.
 
* © 2022-2024 huhwt - EW.H
* © 2021 Hermann Hartenthaler
* © 2021 Richard Cissée
* abgeleitet von {{WT-Name}} - © 2021 webtrees-Entwicklungsteam
 
Dieses Programm ist freie Software: Sie können es unter den Bedingungen der GNU General Public License, veröffentlicht von der Free Software Foundation, entweder in Version 3 der Lizenz oder (nach Ihrer Wahl) jeder späteren Version, weitergeben und/oder modifizieren.
 
Dieses Programm wird in der Hoffnung verteilt, dass es nützlich sein wird, aber OHNE JEGLICHE GEWÄHRLEISTUNG; ohne auch nur die stillschweigende Gewährleistung der MARKTFÄHIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK. Weitere Einzelheiten finden Sie in der GNU General Public License, die Sie unter http://www.gnu.org/licenses/ finden.
 
[[Kategorie:Webtrees]]

Aktuelle Version vom 5. Oktober 2024, 22:35 Uhr

Webtrees Icon
Info
Handbuch-Abschnitt noch im Aufbau
Bitte haben Sie noch ein wenig Geduld oder bringen sich auch gern selber mit ein :-)..


Der Standard-Sammelbehälter von webtrees kann durch ein Erweiterungsmodul ersetzt werden, das die Datensätze im Sammelbehälter nicht nur als GEDCOM herunterladen kann, sondern diese auch visualisieren lassen kann. Zusätzlich zu den Vorfahren und Nachkommen einer Person und anderen einzelnen Datensätzen können globale Datensatzsammlungen dem Sammelbehälter hinzugefügt werden, etwa alle Partnerketten oder alle Ahnenkreise in einen Stammbaum.

Steckbrief[Bearbeiten]

  • Modulname: huhwt-cce (clippings cart enhanced)
  • Autor: huhwt (EW.H); Hermann Hartenthaler hat das Konzept für dieses Erweiterungsmodul und die erste Beta-Version erstellt.
  • Passende webtrees-Versionen: 2.1 (oder 2.0)
  • Speicherort
    • für webtrees 2.1: GitHub
    • für webtrees 2.0: GitHub (nicht mehr gepflegt)
  • Modulkategorie: Genealogie
  • Modulfunktion: Menü "Sammelbehälter"
Info

Beschreibung bezieht sich auf die Version 2.1.18 ff
Einige Funktionen sind erst ab dieser Version verfügbar - und diese Version setzt PHP 8.2 für den Server zwingend voraus. Bezüge auf solche Funktionen sind mit ︕ ab v2.1.18. ︕ markiert.

Einige weitere Funktionen sind erst ab Version 2.1.20 ff verfügbar - Bezüge sind mit ! ab v2.1.20. ! markiert.


Beschreibung[Bearbeiten]

Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
Systemarchitektur des erweiterten Sammelbehälters
Nuvola pen.svg Grafik aktualisieren: GVExport ergänzen; Heiratsketten in Partnerketten umbenennen; TSM (tagging service manager) einbauen; Bestehende Listen ist teilweise grün statt blau; "Multi Treeview" (Admin-Funktion "Doppelte Datensätze suchen") und "Treeview Extended" aufnehmen Nuvola pen.svg

Dieses benutzerdefinierte Modul ersetzt das ursprüngliche Modul „Sammelbehälter“ (engl. "clippings cart"). Das Systemkonzept des erweiterten Sammelbehälters ist in vorstehenden Grafik dargestellt.

Verschiedene Module können GEDCOM-Datensätze im Sammelbehälter ablegen und diese können dann an verschiedene Auswertungs-, Export- oder Visualisierungsmodule weitergegeben werden. Der Benutzer des Moduls kann entscheiden, welche Datensätze an den Sammelbehälter gesendet werden sollen und welche Aktionen mit diesen Datensätzen ausgeführt werden sollen. Der Sammelbehälter ist also während einer Browser-Sitzung eine Art Datendrehscheibe für einen Stammbaum.

Als Quellen kommen für den Sammelbehälter in Frage

  • das Standardmodul „Sammelbehälter", das zu einer Person oder einem anderen Datensatz die Möglichkeit bietet, diesen und eventuell auch weitere Datensätze in den Sammelbehälter einzustellen (etwa eine Person und ihre Vorfahren oder Nachkommen, ggf. mit deren Familien); das Standardmodul kann aber auch deaktiviert werden, da alle seine Funktionen auch im Erweiterungsmodul enthalten sind.
  • die Listenanzeige-Funktionen "Familien" und "Familienzweige", so dass man etwa alle Personen mit gleichem Familiennamen oder alle Personen aus einem Clan in den Sammelbehälter einstellen kann ︕ ab v2.1.18. ︕.
  • die Erweiterungsmodule "Multi Treeview" (Admin-Funktion "Doppelte Datensätze suchen" - für jede als Doublette angenommene Person wird ein eigenes kleines Sanduhrdiagramm angezeigt) und "Treeview Extended" (das interaktive Sanduhrdiagramm mit erweiterten Funktionen - so kann man stufenweise erweitern, Teilbäume aus- und einblenden, die Ansicht als PNG exportieren und mit einer Namenliste in der Ansicht navigieren). Beide Module bieten jetzt die Option, die in der Ansicht gezeigten Personen in den Sammelbehälter zu übernehmen︕ ab v2.1.18. ︕.
  • dieses Erweiterungsmodul, das, zusätzlich zu den genannten Funktionen des herkömmlichen Moduls, nun auch Partnerketten oder Ahnenkreise in einem Stammbaum sucht und die zugehörigen Datensätze in den Sammelbehälter schieben kann
  • das Erweiterungsmodul Vesta-Sammelbehälter, das Ortsdatensätze (_LOC) oder auch alle Personen mit Bezug zu einem geteilten Ort in den Sammelbehälter legen kann
  • die Suchfunktionen 'Allgemeine Suche' und 'Erweiterte Suche' - die Suchergebnisse können wie angezeigt oder ergänzt nach verschiedenen Beziehungen in den Sammelbehälter übernommen werden ! ab v2.1.20 !.

Derzeit noch nicht realisiert, aber denkbar wären auch

  • die Suche in der Systemsteuerung nach unverbundenen Personen in einem Stammbaum (mit einem neuen Button „in den Sammelbehälter legen")
  • bestehende Erweiterungsmodule, wie das Modul „Großfamilie“, das eine komplette Großfamilie mit allen zugehörigen Datensätzen in den Sammelbehälter packen könnte.

Die Datensätze werden gruppiert nach ihrem Typ. Diese Gruppen kann man durch Klick auf die Gruppenüberschrift ein- und ausklappen. Der Benutzer kann ausgewählte Datensätze oder Gruppen von Datensätzen des gleichen Typs im Sammelbehälter löschen. Er kann den Sammelbehälter auch komplett löschen.

Der Benutzer des Moduls kann entscheiden, welche Aktion mit den Datensätzen im Sammelbehälter ausgeführt werden soll. So etwa

  • der Export in eine GEDCOM-Datei, genau so wie im bisherigen Sammelbehälter-Modul
  • die Weitergabe der Datensätze im Sammelbehälter an andere Erweiterungsmodule, die diese Daten visualisieren oder statistisch auswerten. Verfügbar sind hier die Erweiterungsmodule TAM (Topographic Attribute Map), Lineage und GVExport. Diese Erweiterungsmodule müssen separat in webtrees installiert werden.
  • ︕ ab v2.1.18. ︕ gibt es eine ergänzende Bearbeitungsfunktion: TSM "Tagging Service Manager". Diese erlaubt es, für die im Sammelbehälter befindlichen Datensätze 'Gemeinsame Notizen' zu bearbeiten (sofern sie ach einem definierten Muster strukturiert sind). Das Modul muss separat in webtrees installiert sein.

Derzeit noch nicht realisiert, aber denkbar, wäre auch

  • die Anzeige der Datensätze im Sammelbehälter mit der Standard-Listenanzeige von webtrees mit der dort vorhandenen Möglichkeit, diese Liste zu sortieren und zu filtern.

Bedienoberfläche[Bearbeiten]

Im folgenden werden die verschiedenen Menüs dieses Moduls beschrieben.

Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
Hauptmenü

Im Kopfmenü der Seite sieht man, dass hier drei Sammelbehälter-Module nebeneinander aktiviert sind

  • ℍ Sammelbehälter (dieses Modul hier)
  • Vesta-Sammelbehälter.
  • Standard-Modul


Das Hauptmenü des erweiterten Sammelbehälters zeigt, abhängig davon, ob der Sammelbehälter bereits Datensätze enthält, verschiedene Optionen an. In der Abbildung sieht man alle sechs möglichen Menüpunkte

  • Datensätze im Sammelbehälter - hier wird immer die Anzahl der Datensätze angezeigt; wenn es Datensätze im Sammelbehälter gibt, kann man durch einen Klick die Liste der Datensätze anzeigen lassen (siehe unten)
  • Zum Sammelbehälter hinzufügen - dieser Menüpunkt wird nur dann angezeigt, wenn man im Hauptteil der Seite gerade einen Datensatz sieht, der zum Sammelbehälter hinzugefügt werden kann; ein Klick führt zum Menü, das die Details des Hinzufügens festlegt. Je nachdem welche Art von Datensatz dem Sammelbehälter hinzugefügt werden soll gibt es verschiedene Optionen
    • INDI: hier wird das sich öffnende Menü zum Hinzufügen eines Personendatensatzes in der nächsten Abbildung genauer beschrieben
    • FAM: dieses Menü ist ähnlich zum Menü bei INDI; man kann die Familie hinzufügen, die Familie mit ihren Kindern oder die Familie mit allen Nachkommen
    • NOTE: die Notiz kann im Sammelbehälter abgelegt werden. ︕ ab v2.1.18. ︕: Man kann Personen und Familien zu dieser Notiz hinzufügen.
    • OBJE: das Medienobjekt kann dem Sammelbehälter hinzugefügt werden
    • SOUR: es kann im sich öffnenden Menü entschieden werden, ob nur die Quelle selbst hinzugefügt wird oder ob auch alle Personen hinzugefügt werden, bei denen sich Ereignisse auf diese Quellen beziehen
    • REPO: beim Hinzufügen eines Archivs werden immer auch alle Quellen, die sich auf dieses Archiv beziehen, hinzugefügt
    • SUBM: der Übermittler-Datensatz wird hinzugefügt
    • _LOC: der Datensatz mit dem gemeinsamen Ort kann in den Sammelbehälter gelegt werden; das Vesta-Sammelbehälter-Modul bietet hier zusätzlich noch zwei weitere Optionen an: zum einen den Ortsdatensatz und die Personen und Familien, die darauf verweisen, hinzuzufügen und zum anderen den Ortsdatensatz und die Einzelpersonen und Familien, die sich darauf beziehen, einschließlich der Eltern, Geschwister, Ehegatten und Kinder der einzelnen Personen hinzuzufügen.
  • Globale Datensammlungen zum Sammelbehälter hinzufügen - hier kann man Datensammlungen aus dem Stammbaum hinzufügen; zwei Kriterien sind definiert: alle Partnerketten und alle Ahnenkreise im Stammbaum (siehe unten)
  • Datensätze im Sammelbehälter in Gänze löschen ︕ ab v2.1.18. ︕ löscht die Datensätze im Sammelbehälter im Hintergrund ohne weitere Benutzer-Aktion.
  • Datensätze im Sammelbehälter löschen - man kann den gesamtem Sammelbehälter leeren, man kann einzelne Datensätze in der Listenansicht löschen oder man kann alle Datensätze eines Typs (INDI, FAM, NOTE, ...) löschen (siehe unten)
  • Weiterführende Aktionen mit den Datensätzen im Sammelbehälter - zwei Typen von Aktionen sind verfügbar; zum einen das Herunterladen der Datensätze im Sammelkorb als GEDCOM-Datei (genau so wie beim Standard-Sammelbehälter-Modul) und zum anderen das Visualisieren der Datensätze mit den Erweiterungsmodulen TAM oder Lineage (siehe unten); zur Visualisierung des Inhalts des Sammelbehälters mit GVExport muss dieses Modul im Hauptmenü "Diagramme" ausgewählt werden.
Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
Hinzufügen von Vorfahren und Nachkommen einer Person

Wenn man auf einer Personenseite in der Bedienoberfläche von webtrees das Menü des erweiterten Sammelbehälters aufruft, kann man die Option "Datensatz hinzufügen" auswählen. Danach öffnet sich das nebenstehend abgebildete Menü, das verschiedene Optionen zur Übernahme in den Sammelbehälter anbietet

  • die Person selbst
  • die Person mit Eltern und Geschwistern
  • die Person mit Partnerinnen und Kindern
  • die Person und ihre Vorfahren - hier wird auch angegeben wie viele Vorfahrengenerationen im Stammbaum existieren
  • die Person und ihre Vorfahren bis zu 4 Generationen für ein H-Diagramm
  • die Person und ihre Vorfahren zusammen mit derer Familien
  • die Person mit ihren Partnern und deren Nachkommen
  • die Partner-Ketten zu denen die Person gehört - dieser Punkt erscheint nur dann, wenn die Person Partner hatte; er erlaubt alle Partner der Person sowie deren Partner (und so weiter) in den Sammelbehälter zu legen.

Man kann getrennt festlegen wie viele Generationen in Richtung der Vorfahren und wie viele in Richtung der Nachkommen berücksichtigt werden sollen. Die Generation 1 sind die Eltern bzw. die Kinder.

Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
Hinzufügen von globalen Datensatzmengen

Wenn man die Option "Globale Datensammlungen zum Sammelbehälter hinzufügen" ausgewählt hat, öffnet sich das nebenstehende Menü das zwei Optionen anbietet: zum einen können alle Partnerketten oder zum anderen können alle Ahnenkreise in den Sammelbehälter gelegt werden (die dritte abgebildete Option ist derzeit nicht implementiert).

Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
Löschen von Datensätzen im Sammelbehälter

Wenn man die Option "Datensätze im Sammelbehälter löschen" auswählt, öffnet sich ein Menü das drei Optionen anbietet

  • alle Datensätze löschen
  • Datensätze eines Typs löschen - hier werden die Typen von Datensätzen im Sammelbehälter angezeigt und die Anzahl der Datensätze des jeweiligen Typs; man kann eine oder mehrere Typen komplett löschen
  • Datensätze zum Löschen auswählen - hier öffnet sich das Listenmenü in dem man dann einzelne Datensätze selektiv löschen kann.


Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
Weiterführende Aktionen im erweiterten Sammelbehälter

Nach der Auswahl der Option "Weiterführende Aktionen mit den Datensätzen im Sammelbehälter" kann man unter zwei Typen von Aktionen wählen

  • Datensätze herunterladen - hier hat man die gleichen Möglichkeiten wie im Standard-Sammelbehälter-Modul; die GEDCOM-Datei oder die GEDCOM-Datei mit den Mediendateien in einem ZIP-Archiv wird auf den Rechner des Nutzers heruntergeladen
  • Datensätze graphisch in einem Diagramm auswerten - hier kann man zwischen zwei Visualisierungsmethoden auswählen: TAM und Lineage (siehe Beispiele in den folgenden Abschnitten). Wenn die Datensätze mit GVExport visualisiert werden sollen, muss der entsprechende Punkt im Hauptmenü unter "Diagramme" ausgewählt werden (sofern dieses Erweiterungsmodul installiert ist).

Dabei kann man die verwendeten Datensätze noch an Hand der Datenschutzeinstellungen selektieren. Entsprechend der hier ausgewählten Rolle werden die Datensätze ggf. reduziert. Dabei können aber nur Rollen gewählt werden, die eine geringere Berechtigung aufweisen als die Rolle des gerade angemeldeten Nutzers.

Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
Abschluss einer Visualisierungsaktion

Nach der Auswahl der Option Visualisierung mit "TAM" oder mit "Lineage" werden die INDI- und FAM- Datensätze an das ausgewählte Erweiterungsmodul übertragen. Nach einem Klick auf die Schaltfläche "... in neuem Tab starten" öffnet sich ein weiteres Browserfenster mit der gewählten Visualisierungsanwendung.

Listenansicht[Bearbeiten]

Ausgangsversion[Bearbeiten]

Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
Listenansicht der Datensätze im Sammelbehälter (gruppiert nach Typen)

Die Listenansicht zeigt jeweils einen Datensatz pro Zeile. Die Datensätze sind nach Typen gruppiert und die Gruppen können durch einen Klick auf die Überschriftenzeile ein- und ausgeklappt werden. Jeder Datensatz wird zusätzlich durch ein Typ-Symbol gekennzeichnet Jeder einzelne Datensatz kann individuell gelöscht werden.

Ab Version v2.1.18[Bearbeiten]

Es gibt zusätzliche Optionen, um mit dem Sammelkorb zu arbeiten

Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
Listenansicht der Datensätze im Sammelbehälter (gruppiert nach Typen) mit voranstehender 'Ansicht der Sammelaktionen' und zusätzlichen Aktions-Symbolen

Oberhalb der Datensatz-Gruppen gibt es die 'Auflistung der Sammelaktionen'. Jeder Sammelaktion ist nun eine eindeutige Kennung zugeordnet. Bei den einzelnen Datensätzen wird (im mittleren Bereich der Ansicht) angezeigt, welche - eine oder mehrere - Sammelaktionen diesen Datensatz in den Sammelbehälter gelegt haben.

Jede einzelne Sammelaktion kann für sich gelöscht werden, damit wird die Kennung bei den einzelnen Datensätzen entfernt. Hat ein einzelner Datensatz keine Zuordnung mehr zu einer Sammelaktion, wird er aus dem Sammelbehälter entfernt.

Die 'Auflistung der Sammelaktionen' führt nun auch 3 Aktions-Symbole mit. Sie stehen für:

  • Sammelbehälter exportieren in Datei
  • Import eines gespeicherten Sammelbehälter aus Datei - die darin referenzierten Datensätze werden dem vorhandenen Sammelbehälter hinzugefügt
  • Sammelbehälter -Ansicht neu laden




Die Neu-Laden-Aktion ist hilfreich, wenn man den Sammelbehälter in einem eigenen Tab im Browser geöffnet hat (das kann man mit Rechtsklick auf die Sammelbehälter-Menüaktion 'Datensätze im Sammelkorb ...' (1. Eintrag im Menü) und dann 'Link in neuem Tab öffnen' bewerkstelligen). Damit hat man die Option, in dem/den anderen Tab(s) die gewünschten Sammelaktionen anzustoßen und im davon unabhängigen Sammelbehälter-Listenansicht-Tab direkt danach die Auswirkungen zu prüfen. Die einzelnen Aktionen sind jeweils unabhängig voneinander, mit der Neu-Laden-Aktion wird die Listenansicht mit dem in Hintergrund geänderten Sammelbehälter synchronisiert (Äquivalent könnte man die Browser-Aktion 'Neu laden' ausführen).

Die Export-Aktion öffnet ein kleines Fenster, in welchem man bei Bedarf eine eigene Korb-Kennung vergeben kann. Vorbelegt ist die Kennung mit 'Cart(YYYYMMDD_HHMM)', also einem Kürzel und dem Zeitstempel der Export-Aktion (Zeitangabe ist in UTC).

Die Import-Aktion öffnet ein kleines Fenster, in welchem man einen oder mehrere der abgespeicherten Sammelbehälter-Stände auswählen kann. (Import funktioniert auch bei leerem Sammelbehälter - er enthält danach die Referenzen, welche seinerzeit gespeichert worden waren).

Nach einem Import gibt es oberhalb der 'Auflistung Sammelaktionen' eine ergänzende Übersicht 'Aus Datei übernommene Bestände im Sammelbehälter', sie führt mit einem '::A::' (bzw. '::B::' usw.) gekennzeichnet die Informationen zu importierten Beständen auf. Die Sammelaktionen wie auch die Einträge der Datensätze werden um die mit diesem Kennbuchstaben ergänzten Aktionen auf. Importierte Bestände wie auch verbundene Sammelaktionen können ebenfalls selektiv wieder entfernt werden.

Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden

Ebenfalls neu ist eine zusätzliche Aktion im Sammelbehälter-Menü: 'Übertragen an den Tagging Service'. Damit werden 'Gemeinsame Notizen' bearbeitet, welche den aktuell im Sammelbehälter befindlichen Datensätzen zugeordnet sind. Weitere Einzelheiten: TSM "Tagging Service Manager". Diese Aktion erscheint nur in der Listenansicht und nur dann, wenn der Sammelbehälter auch Daten enthält.

Datenstrukturen und ihre Visualisierung[Bearbeiten]

Die Möglichkeit zur Visualisierung der Datensätze im Sammelbehälter erlaubt ganz neue Einsichten in die Struktur der Daten in einem Stammbaum. Vergleichbare Visualisierungsmöglichkeiten gab es bislang bei webtrees nicht. Man kann zwar mit dem Diagramm "Beziehungen" Verbindungen zwischen zwei Personen darstellen und sogar mehrere alternative Beziehungspfade anzeigen, aber für größere Beziehungsnetze ist diese Darstellung nicht ausreichend. Passend zu den Visualisierungsmöglichkeiten bringt dieses Modul auch die Ermittlung von zwei neuen Datensammlungen mit

Diese Datenstrukturen von miteinander verbundenen Personen werden in den beiden folgenden Abschnitten näher beschrieben.

Ahnenkreise in einem Stammbaum (visualisiert mit TAM)[Bearbeiten]

  • Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden

    Ahnenkreise (ohne Hintergrund)

  • Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden

    Ahnenkreise (mit einem temporalen Feld als Hintergrund)

Nuvola pen.svg In diesem Abschnitt muss der Text komplett überarbeitet (entpersönlicht) werden. Nuvola pen.svg

Dieses Diagramm wurde mit dem "globalen Hinzufügen-Menü" erstellt, indem "Alle Kreise hinzufügen" ausgewählt wurde. Diese Funktion entfernt rekursiv alle Blätter in einem Baum. Eine Familie mit zwei Elternteilen und ihrem Kind ist ein trivialer Kreis (Kind -> Mutter -> Ehemann -> Kind) und wird daher nicht erfasst. Kreise ergeben sich zum Beispiel, wenn Cousins ​​zusammen verheiratet sind. Solche Kreise sind verantwortlich für den Stammbaumkollaps (auf Deutsch: Ahnenschwund oder Implex). Nach den Verbindungen der Ehe oder Partnerschaft finden sich Kreise, wenn zwei Familien durch mehr als eine Ehe miteinander verbunden sind. Vielleicht können solche Kreise eine Länge von 30, 40 oder 50 Schritten haben. Sie können mehrere Familien miteinander verbinden und es ist nicht einfach, sie zu finden. Solche weit entfernten Verbindungen in einem Baum verbinden verschiedene Teile einer Familie. Ich nenne sie deshalb manchmal "Ahnenautobahn". Die erste Autobahn, die ich vor vielen Jahren in meinen Baum gebaut habe, war die Verbindung zu Johann Wolfgang von Goethe in mehr als 50 Stufen. Zum Beispiel sind meine Eltern durch mehrere solcher Zirkel miteinander verbunden (neben der trivialen Verbindung durch ihre eigene Ehe). In Webtrees können Sie nach solchen Verbindungen suchen, indem Sie Diagramme / Beziehungen / Alle möglichen Beziehungen finden verwenden. Aber bisher gab es keine Möglichkeit, alle diese Kreise in einem Baum darzustellen.

Partnerketten (visualisiert mit TAM)[Bearbeiten]

  • Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden

    Partnerketten (ohne Hintergrund)

  • Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden

    Partnerketten (mit einem temporalen Feld als Hintergrund)

Eine Partnerkette (oder Heiratskette) ist eine Kette von Partnern von Partnern von Partnern von ... Wenn ein Ehepartner vorher oder später mit einem anderen Partner verheiratet war, ist dies eine Kette von drei Partnern. Triviale Ketten, die nur aus zwei Partnern (Ehemann/Ehefrau) bestehen, werden hier nicht betrachtet. Falls einer der Partner dreimal oder öfter verheiratet war, wird aus der Kette ein Baum aus Ketten.

Bisher gab es in webtrees keine Möglichkeit, solche Partnerkettenbäume zu visualisieren. Durch die Visualisierungsmodule TAM und Lineage kann man nun solche Ketten darstellen. Während sich Genealogie sonst meist in der Zeitachse bewegt (von einer Person zu ihren Vorfahren), bieten Heiratsketten eine Orientierung in senkrechter Richtung dazu: von einer Familie zur nächsten und zur übernächsten.

In der nebenstehenden Abbildung wurde ein recht komplexer Partnerkettenbaum mit TAM visualisiert. Etwas oberhalb des Zentrums erkennt man John F. Kennedy, der eine Familie mit seiner Frau Jacqueline bildet, die wiederum eine Familie mit Aristoteles Onassis bildet, der wiederum ... In der zweiten Abbildung wurde im Hintergrund ein temporales Feld eingeblendet. Die Zeit wird hier ähnlich wie Höhenlinien auf einer Geländekarte dargestellt. Besonders dunkelblaue Bereiche liegen weiter in der Vergangenheit, die hellen Bergrücken ehr in der Gegenwart. So kann man auf einen Blick die älteren Personen in den Partnerketten identifizieren.

Kompaktes H-Diagramm (visualisiert mit TAM)[Bearbeiten]

Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
H-Diagramm

Ein kompaktes H-Diagramm gibt es bereits in webtrees. Wenn man ...

Familiennamengruppen bei den Bewohnern eines Dorfes (visualisiert mit Lineage)[Bearbeiten]

Fehler beim Erstellen des Vorschaubildes: Datei nicht vorhanden
Familiennamengruppen bei den Bewohnern eines Dorfes

Mit dem Vesta-Sammelbehältermodul kann man alle Personen zum Sammelbehälter hinzufügen, die einen Bezug zu einem gemeinsamen Ort haben, das sind etwa alle Bewohner des Ortes. Dazu ruft man den gemeinsamen Ort auf, öffnet das Vesta-Sammelbehälter-Menü und wählt "Ortsdatensatz" hinzufügen. Danach kann man auswählen, dass man alle Personen mit Bezug zu diesem Ort dem Sammelbehälter hinzufügen möchte. Wenn man dann bei den globalen Aktionen des hier beschriebenen Erweiterungsmoduls die Visualisierung durch "Lineage" auswählt, werden die Personen des Ortes in einem zweiten Browser-Fenster angezeigt. Die Darstellung der zeitlichen Entwicklung der Gruppen von Personen mit einem gleichen oder ähnlichen Familiennamen ist besonders spannend. Man sieht etwa sehr schön, dass irgend ein Namensträger zu einem Zeitpunkt in das Dorf gezogen ist, Nachkommen bekommen hat und sich so der Familienname über die Zeit im Dorf in wachsender Anzahl verbreitet.

Anforderungen[Bearbeiten]

Dieses Modul erfordert die webtrees-Version 2.1 oder höher. Es gibt auch noch eine ältere, nicht mehr gepflegte Version für die Version 2.0. Dieses Erweiterungsmodul kann das bestehende Sammelbehälter-Modul ersetzen oder parallel zu diesem betrieben werden. Um die zusätzlichen Funktionen des Vesta-Sammelbehälter-Moduls zu nutzen, muss dieses parallel installiert und aktiviert sein.

Dieses Modul wurde mit der webtrees-Version 2.1.4 und allen verfügbaren Themen und allen anderen Erweiterungsmodulen getestet. Icons werden nur für einige der Themen bereit gestellt.

︕ ab v2.1.18. ︕ - einige Optionen und Aktionen stehen erst ab der Version 2.1.18 dieses Moduls zur Verfügung. Diese Version erfordert zwingend, dass auf dem Server PHP mindestens mit Version 8.2 installiert ist!

Installation[Bearbeiten]

Bitte beachten Sie die folgenden Installationsanweisungen

  • Laden Sie die neueste Version von GitHub herunter.
  • Entpacken Sie das Erweiterungsmodul in das Verzeichnis webtrees/modules_v4/huhwt-cce des Webservers. Wenn dieses Verzeichnis bereits vorhanden ist, können Sie es einfach überschreiben.
  • Melden Sie sich als Administrator bei webtrees an, gehen Sie zu Systemsteuerung/Module/Genealogie/Menüs und suchen Sie das Modul. Es heißt "ℍ&ℍwt Sammelbehälter". Überprüfen Sie, ob es ein Häkchen für "Aktiviert" hat. Bearbeiten Sie diesen Eintrag, um die Zugriffsrechte für jeden Stammbaum festzulegen und den Menüpunkt nach ihren Wünschen zu positionieren. Auf Grund der umfangreichen Möglichkeiten mit diesem Modul auf die Daten in ihrem Stammbaum zuzugreifen, sollten Sie es eher nicht für Besucher sichtbar machen.
  • Sie können den Menüpunkt des Standardmoduls "Sammelbehälter" deaktivieren. Klicken Sie abschließend auf "Speichern", um die Konfiguration zu sichern.

Upgrade[Bearbeiten]

Ersetzen Sie zum Aktualisieren einfach die bestehenden Dateien durch diejenigen aus der neuesten Version.

Übersetzung[Bearbeiten]

Sie können helfen, dieses Modul zu übersetzen. Es verwendet das po/mo-System. Sie können über einen Pull-Request in GitHub (wenn Sie wissen wie das geht) oder per E-Mail an den Programmautor weitere Übersetzungen beitragen. Aktualisierte Übersetzungen werden in der jeweils nächsten Version dieses Moduls enthalten sein.

Folgende Sprachen sind verfügbar

  • Englisch
  • Deutsch
  • Niederländisch
  • Russisch.

Unterstützung[Bearbeiten]

Sie können Fehler oder Wünsche für Erweiterungen auf der "issue"-Seite bei GitHub melden,

Sie können bei Fragen auch das webtrees-Forum mit dem Themenbereich "Customising" nutzen.

Lizenz[Bearbeiten]

Dieses Modul ist ursprünglich vom Vesta-Erweiterungsmodul "Sammelbehälter" abgeleitet worden.

  • © 2022-2024 huhwt - EW.H
  • © 2021 Hermann Hartenthaler
  • © 2021 Richard Cissée
  • abgeleitet von webtrees - © 2021 webtrees-Entwicklungsteam

Dieses Programm ist freie Software: Sie können es unter den Bedingungen der GNU General Public License, veröffentlicht von der Free Software Foundation, entweder in Version 3 der Lizenz oder (nach Ihrer Wahl) jeder späteren Version, weitergeben und/oder modifizieren.

Dieses Programm wird in der Hoffnung verteilt, dass es nützlich sein wird, aber OHNE JEGLICHE GEWÄHRLEISTUNG; ohne auch nur die stillschweigende Gewährleistung der MARKTFÄHIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK. Weitere Einzelheiten finden Sie in der GNU General Public License, die Sie unter http://www.gnu.org/licenses/ finden.

Abgerufen von „http://genwiki39.genealogy.net/index.php?title=Webtrees_Handbuch/Anleitung_für_Webmaster/Erweiterungsmodule/Sammelbehälter&oldid=2587921“