Webtrees Handbuch/Anleitung für Webmaster/Anleitung Upgrade 20

Info

Handbuch-Abschnitt noch im Aufbau

Bitte haben Sie noch ein wenig Geduld oder bringen sich auch gern selber mit ein :-)..

Abschnitt 8.5.1.4.2 - Anleitung Upgrade 20 <-  Zu Kapitel 8 - Anleitung für Webmaster <-  Zur Kapitelübersicht

Beim Upgrade von einer webtrees Version 1.7 auf die Version 2.0 sollten Sie zuerst entscheiden, ob Sie ein Upgrade durchführen wollen oder ob Sie eine ganz neue Instanz von webtrees aufsetzen möchten. Letzteres hat den Vorteil, dass Sie alle alten Dinge loswerden, die sich ggf. im Lauf der Jahre angesammelt haben. Der Nachteil ist, dass Sie Dinge, die nicht in einer GEDCOM-Datei gespeichert werden können, verlieren bzw. dass Sie einige Informationen von Hand transferieren müssen, wenn diese beibehalten werden sollen. Dazu gehören etwa

• Geschichten
• Nachrichten
• Journal
• Neuigkeiten
• Favoriten der Benutzer und der Stammbäume
• Inhalte der html-Blöcke auf den Benutzerseiten und den Stammbaum-Startseiten
• Einstellungen, die im Modul "CSS und JS" gemacht wurden
• Einstellungen im Erweiterungsmodul "Faces" (Kennzeichnung von Personen auf Gruppenfotos)
• Einstellungen in vielen anderen Erweiterungsmodulen
• Verwaltungseinträge für die Benutzer der Webseite

noch beschreiben: wie übernimmt man diese Informationen per Datenbanktabellentransfer in eine neue Instanz

Generell erforderliche Schritte für das manuelle Upgrade

Beim manuellen Upgrade auf die Version 2 sind diverse Änderungen an den Einstellungen, der Serverkonfiguration und eventuell auch Anpassungen in den genealogischen Daten notwendig. Daher sollten Sie unbedingt auch die Hinweise in der englischsprachigen Dokumentation vor diesem Umstieg beachten. Die folgenden Schritte sind in ähnlicher Form immer bei einem manuellen Upgrade erforderlich. Sie sind im Abschnitt "Manuelles Upgrade" im Kapitel "Anleitung für Webmaster" genauer beschrieben.

• Sichern Sie sowohl alle Stammbäume als auch das Verzeichnis /data und die SQL-Datenbank.
• Erstellen Sie eine Datei /data/offline.txt.
• Laden Sie die aktuellste Version von webtrees 2.0 herunter (das ist die Version 2.0.25).
• Löschen Sie alle Ordner ihrer alten webtrees-Installation auf dem Server bis auf das Verzeichnis /data.
• Entpacken Sie die Dateien und laden Sie sie in das webtrees-Verzeichnis auf dem Webserver hoch.
• Ändern Sie ggf. die Version von PHP auf ihrem Server auf 7.4.
• Löschen Sie nun die Datei /data/offline.txt bzw. benennen Sie sie um in /data/offline.txt.disable.

Da ihre Datenbankverbindungsdaten in der Datei config.ini.php im Verzeichnis /data erhalten geblieben sind, sollte Ihre Datenbank beim nächsten Zugriff über einen Webbrowser auf eine webtrees-Seite automatisch aktualisiert werden.

Änderungen in der webtrees Version 2.0

Im Folgenden werden die wesentlichen Änderungen beschrieben, die eventuell dazu führen, dass beim Umstieg auf die Version 2.0 Anpassungen vorgenommen werden müssen.

Erweiterungsmodule

In der webtrees Version 1.7 lagen alle Erweiterungsmodule im Verzeichnis /modules_v3. Keines dieser Module ist mit der Version 2.0 von webtrees kompatibel.

Falls solche Module installiert waren, müssen nach dem Upgrade korrespondierende neue Versionen dieser Erweiterungsmodule im Ordner /modules_v4 installiert werden.

Basis-URL-Erkennung

In der Version 1.7 versucht webtrees die URL der Webseite automatisch zu ermitteln. Dies war nicht immer zuverlässig oder je nach Server-Konfiguration auch gar nicht möglich.

In der Version 2.0 muss die URL der Webseite in der Datei /data/config.ini.php explizit angeben werden. Eine Zeile mit dem folgendem Inhalt muss hinzugefügt werden:

base_url="https://www.example.com/webtrees"

Der Link muss individuell angepasst werden.

Alte URLs auf neue URLs umleiten

Die URL-Struktur hat sich geändert. Daher funktionieren Bookmarks, die Benutzer gesetzt hatten und auch Suchmaschinen-Links nicht mehr.

Wenn Sie jedoch die neue Funktion "Pretty URLs" aktivieren, werden geeignete Umleitungen von den alten URLs auf die neuen URLs erzeugt und alle vorhandenen Lesezeichen funktionieren weiterhin. Beispielsweise wird die alte URL individual.php?ged=demo&pid=X123 auf die neue URL trees/demo/individual/X123 umgeleitet.

Beachten Sie, dass diese Funktion möglicherweise nicht funktioniert, wenn die alten PHP-Skripte von webtrees 1.7 noch im Ordner der obersten Ebene der webtrees-Installation vorhanden sind. Deshalb müssen dort bis auf index.php alle php-Dateien gelöscht werden.

Medienordner mit "/../"

In der Version 1.7 konnte die Pfadangabe der Medienordner /../ enthalten, um so einen Ordner außerhalb des Ordners /data anzugeben.

In webtrees 2.0 ist dies nicht mehr erlaubt. Medienordner und -dateien müssen unterhalb des Ordners /data liegen (oder unterhalb desjenigen Ordners, den Sie in der Systemverwaltung dafür angegeben haben).

Symbolische Links

In webtrees 1.7 konnte der Ordner /data symbolische Links enthalten.

In der Version 2.0 sind symbolische Links nicht erlaubt.

Senden von E-Mail

webtrees 2.0 bietet nicht mehr die Option "PHP Mail" für das Versenden von E-Mails. "PHP Mail" weist schwerwiegende Sicherheitslücken auf und wird daher von den großen Mail-Bibliotheken nicht mehr unterstützt.

Sie müssen sendmail verwenden (falls ihr Server dies anbietet) oder einen SMTP-Server konfigurieren.

robots.txt

In der Version 1.7 mußten Sie die Datei robots.txt im Wurzelverzeichnis selbst erstellen, indem Sie robots-example.txt als Muster verwenden.

Wenn Sie in webtrees 2.0 "Pretty URLs" aktivieren, wird diese Datei automatisch erzeugt.

sitemap.xml

Die URL der Datei sitemap.xml hat sich geändert.

Wenn webtrees im Wurzelverzeichnis installiert ist und "Pretty URLs" aktiviert sind, werden Suchmaschinen die neuen Dateien automatisch finden.

Wenn webtrees in einem Unterordner installiert ist oder wenn "Pretty URLs" nicht aktiviert sind, dann müssen Sie die Sitemap bei den Suchmaschinen selber bekannt geben.

Bei allen folgenden Abschnitten müssen noch Links zu den Stellen im Handbuch gesetzt werden, an denen diese Themen behandelt werden.

Sichtbarkeit und Datenschutz beim Ausblenden der Reiter Notizen, Medien oder Quellen

In webtrees 1.7 hat die Einstellung der Zugriffsberechtigung für den Reiter "Notizen" implizit auch eine Einschränkung der Privatsphäre für die Notizen selbst bedeutet. Das Ausblenden des Reiters hat auch die Notizen selbst ausgeblendet.

Wenn Sie in webtrees 2.0 den Zugriff auf die Reiter Notizen, Medien oder Quellen deaktivieren oder einschränken, werden die Informationen zu Notizen, Medien oder Quellen stattdessen auf dem Reiter "Fakten und Ereignisse" angezeigt.

Sie sollten daher nun eine explizite Datenschutzeinschränkung für Notizen, Medien oder Quellen hinzufügen, wenn Sie sich bislang auf diese Funktionalität verlassen haben.

"Primäre" Eltern

Eine Person kann mehrere Eltern haben, etwa durch Geburt und Adoption.

In der Version 1.7 wurden immer die leiblichen Eltern in Ahnentafeln, Berichten und an anderen Stellen verwendet, wenn dort nur ein Satz von Eltern angezeigt werden konnte.

In der Version 2.0 werden die erstgenannten Eltern verwendet, die im Datensatz der Person vorkommen. Es gibt eine neue Bearbeitungsoption, um die Eltern einer Person neu zu ordnen.

Status einer Ehe

In webtrees 1.7 wurde ein Paar standardmäßig als verheiratet beschrieben, es sei denn, es existiert eine Angabe durch das benutzerdefinierte GEDCOM-Tag "_NMR" (not married).

Ab der Version 2.0 wird ein Paar standardmäßig als nicht verheiratet beschrieben, es sei denn, es liegt ein Ehe-Ereignis vor. Diese Änderung ermöglicht es, unverheiratete Paare zu erstellen, ohne ein benutzerdefiniertes Tag verwenden zu müssen.

Mehrere Mediendateien in einem Medienobjekt

webtrees 2.0 erlaubt nun, dass ein Medienobjekt mehrere Mediendateien enthalten kann. Wenn Sie z.B. beide Seiten eines Dokuments scannen, dann können Sie diese zusammen in einem Medienobjekt speichern. Das gleiche gilt, wenn Sie ein Foto in der originalen und in einer bearbeiteten Version speichern möchten. Diese GEDCOM-konforme Funktionalität wird aber nur von wenigen anderen Genealogieprogrammen unterstützt.

Die erste Mediendatei in einem Medienobjekt, die ein Foto enthält, wird als Miniaturansicht für das Objekt verwendet. Wenn ein Medienobjekt also ein Video und ein Bild enthält, wird das Bild als Miniaturansicht verwendet.

"Primäres" Foto

Webtrees muss ein Foto für eine Person auswählen, um es in Diagrammen oder an anderen Stellen zu verwenden.

In der Version 1.7 konnte dieses Bild mit einem benutzerdefinierten GEDCOM-Tag "_PRIMARY Y" festgelegt werden.

In webtrees 2.0 wird als primäres Foto einer Person das erste Medienobjekt verwendet, das im Datensatz der Person enthalten ist. Sind mehrere Medien vorhanden, gibt es eine neue Bearbeitungsoption, um die Medienobjekte einer Person zu sortieren.

Es kommt vor, dass Bilder mit einer Person verknüpft sind, obwohl diese eigentlich mit einem Fakt oder einem Ereignis verknüpft sein sollten. Beispielsweise sollte eine Geburtsurkunde mit dem Geburtsereignis und nicht mit der Person verknüpft werden. Dies kann dazu führen, dass einige unpassende Bilder als "Primärbild" ausgewählt werden. Das Bedienfeld verfügt nun über eine Option, mit der ein solches Bild von einer Personen zu einem Ereignis verschoben werden kann.

Benutzerdefinierte Miniaturansichten

In der Version 1.7 konnte man eine benutzerdefinierte Miniaturansicht für ein Medienobjekt erstellen. Dabei konnte es sich um ein Standbild aus einem Video oder um eine zugeschnittene Version eines Gruppenfotos handeln. Dazu wurde auf dem Server eine Datei hinterlegt, die die Standard-Miniaturansicht ersetzt (dies war nie eine offiziell unterstützte Funktion, wurde aber von einigen Anwendern benutzt).

In der Version 2.0 erstellt man benutzerdefinierte Miniaturansichten, indem man eine zweite Mediendatei mit dieser Minituransicht zu einem Medienobjekt hinzufügt. Medienobjekte können ja mehrere Mediendateien enthalten. Die Miniaturansicht muss im Objekt an die erste Stelle verschoben werden.

Es gibt im Verwaltungsmenü ein Werkzeug, das das Auffinden und Importieren von benutzerdefinierten Miniaturansichten erleichtert (siehe Abschnitt "Benutzerdefinierte Vorschaubilder aus webtrees 1 importieren" im Kapitel "Anleitung für Verwalter und Administratoren").

Registrierung von Benutzern

In der Version 1.7 wurden die Registrierungsanfragen der Benutzer per E-Mail an den für einen Baum festgelegten Genealogie-Kontakt geschickt. Das bedeutete, dass sich Besucher nicht auf Webseiten registrieren konnten, auf denen alle Bäume privat sind. Die Genealogie-Kontaktperson musste dann einen Administrator bitten, den Benutzer von Hand anzulegen und die Zugriffsberechtigungen festzulegen.

In webtrees 2.0 werden Anfragen zur Benutzerregistrierung per E-Mail immer an die Administratoren geschickt, sie sind also unabhängig von einem konkreten Stammbaum.

In ähnlicher Weise werden E-Mails für Dinge, wie etwa vergessene Passwörter, jetzt mit Bezug zur Webseite gesendet und nicht mehr mit einem Bezug zu einem konkreten Stammbaum.

XREF

In webtrees 1.7 war das Präfix der Querverweisbezeichner, der eindeutigen Kennung (XREF), die jedem Datensatz bzw. Objekt in einer GEDCOM-Datei zugewiesen wird, für jeden Objekttyp unterschiedlich (etwa "I" für Einzelpersonen, "F" für Familien, "S" für Quellen usw.). Es bestand auch die Möglichkeit, die XREF-Präfixe für jeden Stammbaum individuell anzupassen.

Aufgrund der Verwechslungsgefahr (I mit 1, S mit 5, O mit 0 usw.) haben alle neuen Datensätze, die in webtrees 2.0 erstellt werden, eine XREF, die mit X beginnt, unabhängig vom Objekttyp. Alle vorhandenen Objekte in einem Stammbaum behalten ihre bisherige XREF mit dem alten Präfix, es sei denn, sie werden neu nummeriert.

Wenn diese Neuerung für die Vergabe von XREF nicht gewünscht wird, kann der Webmaster das Vesta-Erweiterungsmodul "classic look and feel" aktivieren, so dass weiter mit alten Präfixen gearbeitet werden kann.