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
Markierung: visualeditor
Keine Bearbeitungszusammenfassung
Markierung: visualeditor
Zeile 13: Zeile 13:
=== Informationen zu diesem Modul ===
=== Informationen zu diesem Modul ===
Der Standard-[[Webtrees Handbuch/Anleitung für Mitglieder und Moderatoren#Sammelbeh.C3.A4lter|Sammelbehälter]] wird durch ein erweitertes Modul ersetzt, das die Daten nicht nur als GEDCOM herunterladen kann, sondern diese auch visualisieren kann. Zusätzlich können globale Datensätze dem [[Webtrees Handbuch/Anleitung für Mitglieder und Moderatoren#Sammelbeh.C3.A4lter|Sammelbehälter]] hinzugefügt werden, etwa alle Heiratsketten oder alle Ahnenkreise in einen Stammbaum.
Der Standard-[[Webtrees Handbuch/Anleitung für Mitglieder und Moderatoren#Sammelbeh.C3.A4lter|Sammelbehälter]] wird durch ein erweitertes Modul ersetzt, das die Daten nicht nur als GEDCOM herunterladen kann, sondern diese auch visualisieren kann. Zusätzlich können globale Datensätze dem [[Webtrees Handbuch/Anleitung für Mitglieder und Moderatoren#Sammelbeh.C3.A4lter|Sammelbehälter]] hinzugefügt werden, etwa alle Heiratsketten oder alle Ahnenkreise in einen Stammbaum.
* Modulname: huhwt-cce
* Modulname: huhwt-cce (clippings cart enhanced)
* Autor: huhwt (EW.H und H. Hartenthaler)
* Autor: huhwt (EW.H); Hermann Hartenthaler hat das Konzept für dieses Erweiterungsmodul und die erste Beta-Version dieses Erweiterungsmoduls erstellt.
* Passende webtrees-Versionen: 2.0 oder 2.1
* Passende webtrees-Versionen: 2.0 oder 2.1
* Speicherort für webtrees 2.1: [https://github.com/huhwt/huhwt-cce GitHub]
* Speicherort
* Speicherort für webtrees 2.0: [https://github.com/huhwt/huhwt-cce20 GitHub] (nicht mehr gepflegt)
** 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
* Modulkategorie: Genealogie
* Modulfunktion: Menü "[[Webtrees Handbuch/Anleitung für Mitglieder und Moderatoren#Sammelbeh.C3.A4lter|Sammelbehälter]]"
* Modulfunktion: Menü "[[Webtrees Handbuch/Anleitung für Mitglieder und Moderatoren#Sammelbeh.C3.A4lter|Sammelbehälter]]"


=== Beschreibung ===
=== Beschreibung ===
Dieses benutzerdefinierte Modul ersetzt das ursprüngliche Modul „Sammelkorb“ (engl. "clippings cart"). Das Designkonzept des erweiterten Sammelkorbs ist in der rechts stehenden Grafik dargestellt.
Dieses benutzerdefinierte Modul ersetzt das ursprüngliche Modul „Sammelbehälter“ (engl. "clippings cart"). Das Designkonzept des erweiterten Sammelbehälters ist in der rechts stehenden Grafik dargestellt.


-> Abbildung Neues Konzept für den erweiterten Sammelkorb
-> Abbildung Neues Konzept für den erweiterten Sammelkorb


Verschiedene Funktionen können Datensätze in den Sammelkorb einfügen und diese Datensätze dann an verschiedene Auswertungs- oder Export- oder Visualisierungsfunktionen weitergeben. Der Benutzer des Moduls kann entscheiden, welche Datensätze an den Sammelkorb gesendet werden sollen und welche Aktion mit diesen Datensätzen ausgeführt werden soll.
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 Sammelkorb gesendet werden sollen und welche Aktionen mit diesen Datensätzen ausgeführt werden sollen.


Als Eingangsfunktionen gibt es
Als Quellen-Module kommen für den Sammelkorb in Frage


* die Funktionen des aktuellen Moduls "Sammelkorb" oder des bestehenden Vesta-Sammelkorb-Erweiterungsmoduls, die die Möglichkeit bieten, Datensätze für eine Person oder ein anderes GEDCOM-Objekt wie eine Quelle oder eine Notiz in den Clippings-Warenkorb zu legen. Dazu gehören bei einer Person beispielsweise ihre Vorfahren oder Nachkommen, ggf. mit ihren Familien. Bei einem Ort umfasst es beispielsweise alle Personen mit Bezug zu diesem Ort.
* das derzeitige Modul „Sammelbehälter", das zu einer Person oder einem anderen Objekt die Möglichkeit bietet Datensätze in den Sammelbehälter einzustellen (etwa eine Person und ihre Vorfahren oder Nachkommen, ggf. mit deren Familien)
* die Suche in der Systemsteuerung nach nicht verbundenen Personen in einem Baum (mit neuem Button „Zum Schnittgutkorb senden“) (tbd)
* das Erweiterungsmodul Vesta-Sammelbehälter, das Ortsdatensätze (_LOC) oder auch alle Personen mit Bezug zu einem Ort in den Sammelkorb legen kann
* die normale webtrees-Suche (ebenfalls mit einem Button "Zum Schnittgutkorb senden"), damit Sie nach Belieben suchen können und mit der Möglichkeit, alle derzeit angebotenen Filterfunktionen zu nutzen (tbd)
* dieses Erweiterungsmodul, das Heiratsketten oder Ahnenkreise in einem Stammbaum sucht
* die Listenanzeigemodule "Familien" und "Familienzweige", damit Sie alle Personen mit gleichem Familiennamen oder alle Personen aus einem Clan in den Sammelkorb schicken können (tbd)
* neue Funktionen in diesem Modul Suche nach Heiratsketten oder Ahnenkreisen im Baum.
* Der Benutzer kann dann ausgewählte Datensätze oder Gruppen von Datensätzen des gleichen Typs im Ausschnittkorb löschen oder den Ausschnittkorb vollständig löschen.


An den Datensätzen im Sammelkorb findet dann eine vom Benutzer initiierte Aktion statt, wie z
Derzeit noch nicht realisiert, aber denkbar wären auch


* den Export in eine GEDCOM-ZIP-Datei, wie im eigentlichen Sammelkorb-Modul
* die Suche in der Sytemsteuerung nach unverbundenen Personen in einem Stammbaum (mit einem neuen Button „in den Sammelkorb legen")
* die Anzeige der Objekte in Listenform mit der Möglichkeit, diese Liste zu sortieren und zu filtern (tbd)
* die ganz normale webtrees-Suche (auch mit einem Button " in den Sammelkorb legen "), so dass man nach ganz beliebigen Dingen frei suchen kann und mit der Möglichkeit alle bereits derzeit angebotenen Filterfunktionen auf die Suchergebnisse zu nutzen
* die Übergabe der Datensätze im Schnittgutwagen an neue Funktionen, die diese Daten visualisieren oder statistisch auswerten. Eine solche Funktion könnte beispielsweise ein Link-Node-Diagramm wie TAM (Topographic Attribute Map) oder Lineage sein.
* die Listenanzeigemodule "Familien" und "Familienzweige", so dass man etwa alle Personen mit gleichem Familiennamen oder alle Personen aus einem Clan in den Sammelbehälter einstellen kann
Es bietet zusätzliche Möglichkeiten, Datensätze zum Ausschnittskorb hinzuzufügen und besitzt neben der Möglichkeit, GEDCOM-Informationen zu exportieren, um die Datensätze im Ausschnittskorb anhand eines Diagramms zu visualisieren. Dieses benutzerdefinierte Modul ist hauptsächlich ein Backport des hh_clippings_cart_enhanced von Hermann Hartenthaler (<nowiki>https://github.com/hartenthaler/hh_clippings_cart_enhanced</nowiki>), das für das kommende Webtrees-2.1 entwickelt wurde. Da nicht absehbar ist, wann webtrees-2.1 produktiv sein wird, und aufgrund der besonderen Eigenschaften des Moduls, erschien es mir sinnvoll, es wieder auf webtrees-2.0 zu übertragen. Für Funktionen und Hintergrund dieses Moduls schauen Sie bitte unter dem oben angegebenen Link nach. Alle Features der Originalversion wurden übernommen. Eigene Ergänzungen erweitern die Verwaltung der im Warenkorb gesammelten Datensätze um das gezielte Löschen ganzer Untergruppen und im Anzeigebereich die Möglichkeit, Untergruppen durch Klick auf die Gruppenüberschrift ein- und auszuklappen. Eine Besonderheit ist die Möglichkeit, ausgewählte Datensätze nicht nur im Gedcom-Format – gezippt oder Klartext – zu exportieren, sondern auch direkt an Visualisierungstools zu übergeben. Aktuell ist die direkte Anbindung von TAM implementiert, weitere Tools werden folgen. TAM steht für „Topographic Attribute Maps“ und ist ein Knoten-Link-Diagramm, dem eine höhenlinienartige Darstellung zeitlicher Bezüge unterlegt ist. Das Tool wurde an der Universität Graz entwickelt, eine Demo finden Sie unter <nowiki>https://github.com/rpreiner/tam</nowiki>, der Hintergrund ist hier dokumentiert: <nowiki>https://diglib.eg.org/handle/10.1111/cgf13987</nowiki>. Das Tool ist unter <nowiki>https://github.com/huhwt/huhwt-wttam</nowiki> zu finden. Es muss separat in Webtrees installiert werden.
* bestehende Erweiterungsmodule wie das Modul „Großfamilie“, das eine komplette Großfamilie mit allen zugehörigen Datensätzen in den Sammelkorb packen kann
 
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 Sammelkorb ausgeführt werden soll. So etwa
 
* der Export in eine GEDCOM-Datei, 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 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 mit der Standard-Listenformanzeige von '''webtrees''' mit der dort vorhandenen Möglichkeit, diese Liste zu sortieren und zu filtern.


=== Abbildungen ===
=== Abbildungen ===
Zeile 83: Zeile 92:


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.
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.
=== Dank ===
Ein besonderer Dank geht an Hermann Hartenthaler, der die Konzeption für dieses Erweiterungsmodul und die erste Beta-Version dieses Moduls erstellt hat.


=== Anforderungen ===
=== Anforderungen ===

Version vom 27. Mai 2022, 06:06 Uhr

Info
Handbuch Im Aufbau...

Bitte haben Sie noch ein wenig Geduld..


Nuvola pen.svg Screenshots einfügen; Aktualisierung auf 2.1 und huh Nuvola pen.svg

Informationen zu diesem Modul

Der Standard-Sammelbehälter wird durch ein erweitertes Modul ersetzt, das die Daten nicht nur als GEDCOM herunterladen kann, sondern diese auch visualisieren kann. Zusätzlich können globale Datensätze dem Sammelbehälter hinzugefügt werden, etwa alle Heiratsketten oder alle Ahnenkreise in einen Stammbaum.

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

Beschreibung

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

-> Abbildung Neues Konzept für den erweiterten Sammelkorb

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 Sammelkorb gesendet werden sollen und welche Aktionen mit diesen Datensätzen ausgeführt werden sollen.

Als Quellen-Module kommen für den Sammelkorb in Frage

  • das derzeitige Modul „Sammelbehälter", das zu einer Person oder einem anderen Objekt die Möglichkeit bietet Datensätze in den Sammelbehälter einzustellen (etwa eine Person und ihre Vorfahren oder Nachkommen, ggf. mit deren Familien)
  • das Erweiterungsmodul Vesta-Sammelbehälter, das Ortsdatensätze (_LOC) oder auch alle Personen mit Bezug zu einem Ort in den Sammelkorb legen kann
  • dieses Erweiterungsmodul, das Heiratsketten oder Ahnenkreise in einem Stammbaum sucht

Derzeit noch nicht realisiert, aber denkbar wären auch

  • die Suche in der Sytemsteuerung nach unverbundenen Personen in einem Stammbaum (mit einem neuen Button „in den Sammelkorb legen")
  • die ganz normale webtrees-Suche (auch mit einem Button " in den Sammelkorb legen "), so dass man nach ganz beliebigen Dingen frei suchen kann und mit der Möglichkeit alle bereits derzeit angebotenen Filterfunktionen auf die Suchergebnisse zu nutzen
  • die Listenanzeigemodule "Familien" und "Familienzweige", so dass man etwa alle Personen mit gleichem Familiennamen oder alle Personen aus einem Clan in den Sammelbehälter einstellen kann
  • bestehende Erweiterungsmodule wie das Modul „Großfamilie“, das eine komplette Großfamilie mit allen zugehörigen Datensätzen in den Sammelkorb packen kann

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 Sammelkorb ausgeführt werden soll. So etwa

  • der Export in eine GEDCOM-Datei, 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 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 mit der Standard-Listenformanzeige von webtrees mit der dort vorhandenen Möglichkeit, diese Liste zu sortieren und zu filtern.

Abbildungen

Screenshots of menus Screenshot of the new menu Screenshot of main menu

Screenshot of menu to add global sets of records for a tree Screenshot of menu to add global sets of records

Screenshot of new menu to delete records in the clippings cart Screenshot of menu to delete records

Screenshot of new menu to execute actions on the records in the clippings cart Screenshot of menu to execute actions

Screenshots of new visualisation possibilities 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 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. Screenshot using TAM for a visualisation of all ancestor circles in this tree Screenshot of circles

Screenshot of circles

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 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. Screenshot using TAM for a partner chain with 30 partners of partners of partners ... Screenshot of partner chains

Screenshot of partner chains

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.

Anforderungen

Dieses Modul erfordert die webtrees-Version 2.1 oder höher. Es gibt auch noch eine ältere Version für die Version 2.0. Es kann die bestehenden Sammelkorb-Module ersetzen oder parallel zu diesen betrieben werden.

Dieses Modul wurde mit der webtrees-Version 2.1.4 und allen verfügbaren Themen und allen anderen Erweiterungsmodulen getestet.

Installation

Bitte folgen Sie den folgenden Installationsanweisungen

  • Laden Sie die neueste Version herunter.
  • Entpacken Sie das Paket in das Verzeichnis webtrees/modules_v4 des Webservers.
  • Benennen Sie den Ordner in xxx um. 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 "xxx". Überprüfen Sie, ob es ein Häkchen für "Aktiviert" hat. Bearbeiten Sie diesen Eintrag, um die Zugriffsebene für jeden Baum festzulegen und den Menüpunkt nach Ihren Wünschen zu positionieren.
  • Sie können das Standardmodul "Sammelwagen" eventuell deaktivieren. Klicken Sie abschließend auf SPEICHERN, um die Konfiguration abzuschließen.

Upgrade

Ersetzen Sie zum Aktualisieren einfach die bestehenden Dateien durch die neuen 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 (wenn Sie wissen wie) oder per E-Mail weitere Übersetzungen beitragen. Aktualisierte Übersetzungen werden in der nächsten Version dieses Moduls enthalten sein.

Folgende Sprachen sind verfügbar

  • Englisch
  • Deutsch
  • Niederländisch
  • Russisch.

Unterstützung

Probleme: Sie können Fehler melden, die ein Problem in diesem GitHub-Repository aufwerfen.

Forum: Allgemeine Unterstützung zu webtrees finden Sie im webtrees-Forum

Lizenz

Dieses Modul ist vom Vesta-Erweiterungsmodul "Sammelkorb" abgeleitet.

  • Copyright (C) 2022 huhwt - EW.H
  • Copyright (C) 2021 Hermann Hartenthaler
  • Copyright (C) 2021 Richard Cissée
  • abgeleitet von webtrees - Copyright (C) 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.