Module DoliGenweb DE: Difference between revisions

Jump to navigation Jump to search
no edit summary
(Created page with "=Inhaltsverzeichnis= Category:Zusatzmodule {{TemplateDocDev}} {{TemplateDocUtil}} =Informationen= {{TemplateModuleInfo |modulename=DoliGenweb |editor=File:Logo atoonet.j...")
Tag: 2017 source edit
 
No edit summary
Tag: 2017 source edit
 
Line 1: Line 1:
=Inhaltsverzeichnis=
[[Category:Zusatzmodule]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Informationen=
{{TemplateModuleInfo
|modulename=DoliGenweb
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=doligenweb}}
|status=stable
|prerequisites=PHP 7.2 mindestens - PHP-Erweiterung calendar empfohlen
|minversion=24.0.x
|note=
''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''
}}
=Funktionen=
DoliGenweb ergänzt Dolibarr um die '''Genealogie''': Personen, Familien, Abstammung, Orte, Quellen und Lebensereignisse, mit Stammbäumen, Sosa-Nummerierung, Verwandtschaftsberechnung, Statistiken, Wanderungskarten, Zeitleiste, historischem Kontext und '''GEDCOM'''-Import/Export. Alle Daten bleiben in Ihrem Dolibarr und folgen seiner gewohnten Bedienung (filterbare Listen, Karten mit Registerkarten, Notizen, Dokumente, ergänzende Attribute, Rechte pro Benutzer).
Die folgenden Bildschirmfotos wurden mit einer Demonstrations-Genealogie des Hauses Bourbon erstellt (Ludwig XVI., Marie-Antoinette und ihre Vorfahren).
[[File:Doligenweb-v24-home-de.png|center|thumb|800px|Übersicht des Moduls: Zähler und zuletzt geänderte Datensätze]]
===Sechs genealogische Objekte===
*'''Personen''': Vornamen, Namenspartikel, Nachname, Suffix, Titel, Spitzname, Ehename, Geschlecht, Beruf (Wörterbuch), Foto, Verknüpfung mit einem Dolibarr-Kontakt.
*'''Familien''': Verbindung zweier Personen vom Typ Ehe, Verbindung, eingetragene Partnerschaft oder freie Verbindung, mit Datum, Ort, Auflösungsdatum und Trauzeugen.
*'''Beziehungen''': Eltern-Kind-Verknüpfung (Vater oder Mutter) und Rang des Kindes unter den Geschwistern.
*'''Orte''': Gemeinde, Postleitzahl, Departement, Land, Typ und GPS-Koordinaten, mit einer Registerkarte '''Karte'''.
*'''Quellen''': Urkunden und Dokumente (Typ, Autor, Archiv, Signatur, URL, Text, angehängte Dateien), zitiert bei Personen, Ereignissen und Familien mit Seite, Qualität und Transkription.
*'''Sosa-Bäume''': Arbeitsgenealogie mit einer Ausgangsperson (dem ''de cujus''), die die '''Sosa-Stradonitz'''-Nummerierung aktiviert.
[[File:Doligenweb-v24-sosa-tree-de.png|center|thumb|800px|Sosa-Baum mit Louis-Charles, Sohn Ludwigs XVI., als Ausgangsperson]]
===Personenkarte===
Die Karte einer Person vereint ihre Identität (mit den Namensbestandteilen: Partikel, Suffix, Titel, Spitzname), Eltern, Ehepartner, Kinder, ihre Rollen als Zeuge oder Pate und ihre '''Lebensereignisse''': Geburt, Taufe, Tod, Bestattung, Heirat, Beruf, Wohnort, Volkszählung, Militärdienst, Testament, Auswanderung, Einbürgerung… Jedes Ereignis hat ein Datum, einen Ort, Quellenzitate und eine '''Datumsgenauigkeit''' (Genau, Etwa, Vor, Nach, Zwischen, Unbekannt). Jedes Feld hat eine Hilfe.
Schaltflächen legen '''Vater''', '''Mutter''', ein '''Kind''' oder einen '''Ehepartner''' direkt von der Karte aus an und speichern die Verknüpfung in einem Schritt.
Registerkarten der Person: Person, Stammbäume, Verwandtschaft, Statistiken, Recherchen, Wanderungen, Zeitleiste, Konsistenz, Dubletten, Galerie, Quellen, Historische Ereignisse sowie je nach Einstellung Kontakte, Notizen, Dokumente und Terminplanung.
[[File:Doligenweb-v24-individual-card-de.png|center|thumb|800px|Karte Ludwigs XVI.: Identität, Namensbestandteile, Eltern, Verbindungen und Kinder]]
===Stammbäume===
*Modi '''Vorfahren''', '''Nachkommen''' und '''Sanduhr''' (Vorfahren oben, Nachkommen unten).
*Ansicht als '''Kästchen''', '''Ahnenrad''' oder '''Nachkommenfächer'''.
*Farbe und Anzeige des Geburts-, Heirats- oder Sterbeorts, Filter auf einen Ort oder ausgeblendete Orte.
*Erzeugung des Stammbaums als '''PDF''', vom Format A4 bis A0 für große Ausdrucke.
*PDF-Berichte der Person: Sosa-Ahnenliste, Nachkommenliste nach d'Aboville, Familienblatt und Familienbuch.
[[File:Doligenweb-v24-tree-de.png|center|thumb|800px|Vorfahren von Louis-Charles über 4 Generationen, nach Geburtsort eingefärbt]]
[[File:Doligenweb-v24-tree-wheel-de.png|center|thumb|800px|Ahnenrad über 5 Generationen]]
[[File:Doligenweb-v24-tree-hourglass-de.png|center|thumb|800px|Sanduhr-Stammbaum Ludwigs XVI.]]
===Verwandtschaft===
Die Registerkarte '''Verwandtschaft''' benennt die Beziehung zwischen zwei Personen in den 5 Sprachen (Halbgeschwister, Cousins zweiten Grades, Generationsverschiebungen, Verschwägerte), gibt den Grad nach Zivilrecht, die nächsten gemeinsamen Vorfahren und die Verwandtschaftswege an.
[[File:Doligenweb-v24-kinship-de.png|center|thumb|800px|Marie-Antoinette ist die Cousine zweiten Grades Ludwigs XVI., um eine Generation verschoben]]
===Statistiken und Register===
*'''Statistiken''' der gesamten Genealogie: Anzahl und Erfassungsquoten, Sterbealter, Alter bei der ersten Verbindung und der Eltern bei der Geburt, Geburten pro Jahrhundert, Kinder pro Paar, häufigste Nachnamen, Vornamen, Orte und Berufe.
*Registerkarte '''Statistiken''' der Person: Vollständigkeit der Ahnenreihe und Ahnenschwund pro Generation.
*'''Namensregister''' und '''Ortsregister''' mit Buchstabenleiste und Schnellfilter; jeder Eintrag öffnet die genealogische Suche.
*'''Genealogische Suche''' nach Nachname, Vornamen, Ehepartner, Eltern, Ort und Ereignissen, mit Platzhaltern und phonetischen Varianten, auch über die globale Suche von Dolibarr.
[[File:Doligenweb-v24-statistics-de.png|center|thumb|800px|Statistiken der Genealogie]]
[[File:Doligenweb-v24-surname-index-de.png|center|thumb|800px|Namensregister]]
[[File:Doligenweb-v24-place-index-de.png|center|thumb|800px|Ortsregister]]
===Offene Recherchen und Konsistenz===
*Registerkarte '''Recherchen''': fehlende Sosa-Vorfahren und fehlende Urkunden (Geburt, Heirat, Tod) pro Generation, mit der zu verfolgenden Spur; jede Recherche kann zu einer Aufgabe der Terminplanung werden, die mit der Person verknüpft ist.
*'''Konsistenzprüfungen''': unmögliche oder unwahrscheinliche Daten, Alter der Eltern und Ehepartner, doppelte oder zirkuläre Abstammung, mit einstellbaren Schwellenwerten.
*'''Dubletten''': Erkennung wahrscheinlicher Dubletten (phonetischer Name, ähnlicher Vorname, vereinbare Daten, gemeinsame Eltern oder Ehepartner), Vergleich nebeneinander und Zusammenführung.
[[File:Doligenweb-v24-research-de.png|center|thumb|800px|Offene Recherchen in der Ahnenreihe Ludwigs XVI.]]
[[File:Doligenweb-v24-consistency-de.png|center|thumb|800px|Konsistenzprüfungen]]
===Wanderungen und geolokalisierte Orte===
*Registerkarte '''Wanderungen''': Geburtsorte der Sosa-Vorfahren auf einer Karte, Generation für Generation animiert, mit Filter auf die väterliche oder mütterliche Linie, Ortswechseln zwischen den Generationen und Entfernungen pro Generation.
*Registerkarte '''Karte''' des Ortes und Wahl der Hintergrundkarte: '''OpenStreetMap''', '''IGN-Karte''', '''Cassini-Karte''' oder '''État-major-Karte'''.
*'''Geokodierung''' eines Ortes oder aller Orte auf einmal über die Konfiguration, mit '''OpenStreetMap Nominatim'''.
[[File:Doligenweb-v24-migration-de.png|center|thumb|800px|Wanderungen der Vorfahren von Louis-Charles über 6 Generationen]]
[[File:Doligenweb-v24-place-map-de.png|center|thumb|800px|Registerkarte Karte des Ortes Versailles]]
===Zeitleiste und historischer Kontext===
*Die Registerkarte '''Historische Ereignisse''' importiert aus '''Wikidata''' und '''Wikipedia''' die Ereignisse während des Lebens der Person und die '''Staatsoberhäupter''' der Zeit, für Frankreich, die Schweiz, Deutschland, das Vereinigte Königreich, Belgien, Italien und Spanien.
*Die Registerkarte '''Zeitleiste''' zeigt auf einem Lebensbalken und in einer chronologischen Tabelle die Ereignisse der Person, ihrer nahen Familie und diesen historischen Kontext, mit dem Alter bei jedem Ereignis.
[[File:Doligenweb-v24-timeline-de.png|center|thumb|800px|Zeitleiste Ludwigs XVI. mit historischem Kontext]]
[[File:Doligenweb-v24-historical-events-de.png|center|thumb|800px|Aus Wikidata importierte historische Ereignisse]]
===Quellen und Zitate===
Die Registerkarte '''Quellen''' der Person listet die Zitate ihrer Ereignisse und Verbindungen auf. Die Karte einer Quelle zeigt den Block '''Zitiert von''' und eine Registerkarte '''Transkription''', in der das Bild der Urkunde neben dem Text steht, mit einem optionalen Transkriptionsvorschlag durch ein lokales '''Ollama'''-Bildmodell.
[[File:Doligenweb-v24-sources-de.png|center|thumb|800px|Auf der Karte Ludwigs XVI. zitierte Quellen]]
===Teilen mit der Familie, Jahrestage und Kontakte===
*'''Schutz lebender Personen''' (DSGVO): lebende Personen oder solche, die vor weniger als N Jahren geboren wurden, werden Benutzern ohne das Recht '''Lebende Personen lesen''' verborgen; eine Schaltfläche legt die Gruppe „Genealogie - Familie (nur Lesen)" an.
*'''Jahrestage''' und Gedenktage des Tages und der nächsten 7 Tage auf der Startseite und in der Terminplanung.
*Verknüpfung mit den '''Dolibarr-Kontakten''' und E-Mailing-Auswahl der Familienmitglieder.
*'''Galerie''' der Person mit Anmerkungen zu den Fotos und Kennzeichnung der Personen.
===GEDCOM-Import und -Export===
*'''Import''': Ziehen und Ablegen der <code>.ged</code>-Datei, Hochladen in Teilen von 512 KB, Fortschrittsbalken, Fortsetzen eines unterbrochenen Imports und Importverlauf. Die Namensbestandteile (<code>GIVN</code>, <code>SPFX</code>, <code>SURN</code>, <code>NSFX</code>, <code>NPFX</code>, <code>NICK</code>) und der Titel (<code>TITL</code>) werden gelesen; eine Option trennt die im Nachnamen geschriebene Partikel ab, wenn die Datei keine <code>SPFX</code>-Angabe hat (wie bei Heredis).
*'''Export''': Datei im Format '''GEDCOM 5.5.1''' in '''UTF-8''', filterbar nach Anfang des Nachnamens und nach Geschlecht, mit optionalem Ausblenden lebender Personen.
*Ebenfalls ausgetauscht werden Quellen, Archive und Zitate (<code>SOUR</code>, <code>REPO</code>, <code>PAGE</code>, <code>QUAY</code>), Zeugen (<code>ASSO</code>, <code>_WITN</code>) und die Datumsgenauigkeit (<code>ABT</code>, <code>BEF</code>, <code>AFT</code>, <code>BET</code>, <code>FROM</code>/<code>TO</code>).
[[File:Doligenweb-v24-gedcom-import-de.png|center|thumb|800px|Import einer GEDCOM-Datei per Ziehen und Ablegen]]
===Kalenderumrechner===
Die Konfiguration bietet einen Datumsumrechner zwischen dem '''gregorianischen''', '''julianischen''', '''französischen Revolutions-''', '''hebräischen''' und '''islamischen''' Kalender, mit julianischem Tag und Mondalter, um alte Urkunden zu übertragen.
===Integriertes Benutzerhandbuch===
Ein vollständiges Handbuch auf '''Französisch, Englisch, Deutsch, Spanisch und Italienisch''' ist direkt in der Konfiguration des Moduls, Registerkarte '''Benutzerhandbuch''', in der Sprache der Oberfläche abrufbar.
[[File:Doligenweb-v24-guide-de.png|center|thumb|800px|Integriertes Benutzerhandbuch]]
''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''
==Voraussetzungen==
'''Dolibarr:''' unterstützte Versionen:
*'''24.x'''
'''PHP:''' Version 7.2 mindestens, getestet bis PHP 8.5.
'''PHP-Erweiterung:''' <code>calendar</code> empfohlen (Revolutions-, hebräischer und islamischer Kalender des Umrechners).
'''Internetzugang des Servers:''' erforderlich für den historischen Kontext (Wikidata, Wikipedia) und die Geokodierung der Orte (OpenStreetMap Nominatim). Der Rest des Moduls funktioniert offline.
=⚙️ Installationsanleitung=
===⚙️ Methode 1: Installation über die Dolibarr-Oberfläche===
# Öffnen Sie '''Start''' > '''Einstellungen''' > '''Module/Anwendungen'''.
# Gehen Sie zur Registerkarte '''Externes Modul bereitstellen/installieren'''.
# Klicken Sie auf '''Datei auswählen''' und wählen Sie die .zip-Datei des Moduls.
# Klicken Sie auf '''Datei hochladen''', um die Installation zu starten.
# Aktivieren Sie das Modul nach Abschluss der Installation.
Lehnt Dolibarr die Datei ab („Die Datei ist zu groß"), erhöhen Sie die Grenze '''MAIN_UPLOAD_DOC''' unter '''Start > Einstellungen > Sicherheit''', Registerkarte '''Dateien''', oder die PHP-Parameter <code>upload_max_filesize</code> und <code>post_max_size</code>, oder verwenden Sie Methode 2.
===⚙️ Methode 2: manuelle Installation auf dem Server===
Das Zip enthält einen Ordner <code>htdocs/doligenweb/</code>; der Ordner <code>doligenweb</code> muss im Verzeichnis <code>custom</code> von Dolibarr landen.
# '''Entpacken''': <code>unzip module_doligenweb-X.Y.Z.zip -d /tmp/doligenweb_zip</code>
# '''Kopieren''': <code>cp -r /tmp/doligenweb_zip/htdocs/doligenweb /pfad/zu/dolibarr/htdocs/custom/</code>
# '''Rechte vergeben''' an den Webserver, falls nötig: <code>chown -R www-data:www-data /pfad/zu/dolibarr/htdocs/custom/doligenweb</code>
# '''Prüfen''', dass der Ort <code>htdocs/custom/doligenweb</code> ist (und nicht <code>htdocs/custom/htdocs/doligenweb</code>).
# '''Aktivieren''' Sie das Modul in Dolibarr.
''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''
=Einrichtung=
Zugang: '''Start > Einstellungen > Module/Anwendungen''', Einstellungssymbol von DoliGenweb.
{| class="wikitable"
! Registerkarte !! Inhalt
=Inhaltsverzeichnis=
=Inhaltsverzeichnis=
[[Category:Zusatzmodule]]
[[Category:Zusatzmodule]]

Navigation menu