 Kopie des alten Systems
|
|
Dies ist eine alte Kopie des GenWiki und spiegelt den Stand vom 8. Mai 2022 wider. This is an old copy of the GenWiki and reflects the status as of May 8, 2022. Please visit us at wiki.genealogy.net |
Webtrees Handbuch/Anleitung für Webmaster/Anleitung Upgrade 20
aus GenWiki, dem genealogischen Lexikon zum Mitmachen.
- Handbuch Im Aufbau...
Bitte haben Sie noch ein wenig Geduld..
Manuelles Upgrade von webtrees Version 1.7 auf 2.0
|
Zuerst sollten Sie 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 sie beibehalten werden sollen. Das sind etwa folgende Dinge
| |||
|
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 sollte Sie sich unbedingt auch die Hinweise in der englischsprachigen Dokumentation vor diesem Umstieg ansehen. 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 MySQL-Datenbank.
- Erstellen Sie eine Datei "/data/offline.txt".
- Laden Sie die aktuellste Version von webtrees 2.0 herunter (das ist die Version 2.0.22).
- 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.
Wenn Sie also solche Module installiert hatten, dann müssen sie nun eine jeweils korrespondierende neue Versionen dieser Erweiterungsmodule finden und diese dann im Ordner "/modules_v4" installieren.
Basis-URL-Erkennung
In der Version 1.7 versuchte 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 müssen Sie die URL der Webseite in der Datei "/data/config.ini.php" explizit angeben. Fügen Sie daher eine Zeile mit dem folgenden Inhalt hinzu:
base_url="https://www.example.com/webtrees"
wobei Sie den Link natürlich passend ändern.
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, dann 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, dann 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, dann 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 erneut bekannt machen.
| 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 die Geburt und durch eine 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.
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, dann wird das Bild als Miniaturansicht verwendet.
"Primäres" Foto
Webtrees muss ein Foto für eine Person auswählen, um dieses 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 der Person zugeordnet ist und ein Bild enthält. Es gibt eine neue Bearbeitungsoption, um die Medienobjekte einer Person zu sortieren.
Es kommt häufig vor, dass Bilder mit einer Person verknüpft sind, wenn diese eigentlich mit einem Fakt oder einem Ereignis verknüpft sein sollen. 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 leicht 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 etwa 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, aber sie wurde von vielen 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 gab auch die Möglichkeit, die XREF-Präfixe für jeden Stammbaum gezielt 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 Änderung bei der Vergabe der XREF nicht gewünscht wird, kann man das Vesta-Erweiterungsmodul "classic look and feel" aktivieren, so dass dann die alten Präfixe weiterhin verwendet werden.
