Webtrees Handbuch/Anleitung für Webmaster/Erweiterungsmodule/Sammelbehälter

Info

Handbuch Im Aufbau...

Bitte haben Sie noch ein wenig Geduld..

Abschnitt 8.10.1 - Sammelbehälter <-  Zu Abschnitt 8.10 - Erweiterungsmodule <-  Zu Kapitel 8 - Anleitung für Webmaster <-  Zur Kapitelübersicht

Der Standard-Sammelbehälter wird durch ein erweitertes Modul ersetzt, 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

• 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"

Beschreibung

---

Systemarchitektur des erweiterten Sammelbehälters

Dieses benutzerdefinierte Modul ersetzt das ursprüngliche Modul „Sammelbehälter“ (engl. "clippings cart"). Das Systemkonzept des erweiterten Sammelbehälters ist in der nebenstehenden 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 derzeitige Modul „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)
• 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

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")
• die ganz normale webtrees-Suche (auch mit einem neuen Button "in den Sammelbehälter legen"), so dass man nach ganz beliebigen Dingen frei suchen könnte inklusive der Möglichkeit alle bereits derzeit angebotenen Filterfunktionen auf die Suchergebnisse zu nutzen
• 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 könnte
• 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 können gruppiert nach ihrem Typ aufgelistet werden. 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 neue Erweiterungsmodule, die diese Daten visualisieren oder statistisch auswerten. Verfügbar sind hier die Erweiterungsmodule TAM (Topographic Attribute Map) und Lineage. Diese Erweiterungsmodule müssen separat in webtrees installiert werden.

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

---

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

Hauptmenü

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

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

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 fünf 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ü in der übernä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
  • 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 auch alle Personen, 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-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 oder alle Ahnenkreise im Stammbaum (siehe unten)
• 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 einem weiteren Modul (siehe unten)

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.

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.

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).

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.

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).

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.

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 Erweiterungsmodule übertragen. Nach einem Klick auf "... in neuem Tab starten" öffnet sich ein weiteres Browserfenster mit der gewählten Visualisierungsanwendung.

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 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

• Ahnenkreise
• Partnerketten.

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

Ahnenkreise in einem Stammbaum (visualisiert mit TAM)

---

• 

  Ahnenkreise (ohne Hintergrund)

• 

  Ahnenkreise (mit einem temporalen Feld als Hintergrund)

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)

---

• 

  Partnerketten (ohne Hintergrund)

• 

  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)

---

H-Diagramm

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

Familiennamengruppen bei den Bewohnern eines Dorfes (visualisiert mit Lineage)

---

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

---

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.

Installation

---

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

---

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 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

---

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

---

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

• © 2022 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.