Die hier angegebene Anleitung ist unvollständig. Die initiale Konfiguration für die Umstellung sollte in jedem Fall in enger Absprache mit Alkacon erfolgen. Ansonsten kann es passieren, das Apollo-Inhalte beschädigt werden oder verloren gehen.
Umstellung Apollo > Mercury
Mit Version 24-09 ist die automatische Template-Umstellung von Apollo nach Mercury verfügbar.
Damit ist es möglich, Websites oder einzelne Unterbereiche von Apollo nach Mercury umzustellen. Die Seiten werden dabei automatisch vorbefüllt. Während der Umstellung ist es weiterhin möglich, Änderungen an den Apollo Webseiten durchzuführen und zu veröffentlichen.
Warnung
Vorbereitung für die Umstellung
Wenn eine Apollo Wesite nach Mercury umgestellt werden soll, so stellen Sie bitte zunächst folgenden sicher:
- Alle Inhalte der Apollo Website sind veröffentlicht, es gibt also keine neuen oder geänderten Dateien mehr in der Website.
Sitemap-Konfiguration für die Umstellung
Zunächst müssen Sie die Sitemap-Konfiguration der Website anpassen. Öffnen Sie dafür die Datei /.content/.config in der umzustellenden Website. Entfernen Sie unter Inhaltselemente alle Einträge unter Master-Konfiguration uns stellen Sie statt dessen folgendes ein:
/system/modules/alkacon.mercury.bistuemer.apollo/transformer/configuration/standard.mainz.xml oder/system/modules/alkacon.mercury.bistuemer.apollo/transformer/configuration/standard.aachen.xml
Stellen Sie außerdem sicher, dass unter Inhaltselemente folgende Punkte deaktiviert (grau) sind:
- Alle deaktivieren
- Sortierung der Inhaltselemente gemäß Zahl in 'Anzeige-Reihenfolge'
- 'Inhalte hinzufügen' Menü
- Inhaltselement-Konfiguration
Stellen Sie außerdem sicher, dass in den Reitern Formatter und Dynamische Funktionen ALLE Punkte deaktiviert sind.
Beachten Sie für die Transformation von Sub-Sites (Unterbereichen einer Site) die am Ende aufgeführten zusätzlichen Anpassungen.
Template und CSS für die Umstellung einstellen
Öffnen Sie im Explorer am Start-Ordner der Website den Dialog Eigenschaften.
Tragen Sie unter der Eigenschaft template folgendes ein:
provider=org.opencms.loader.CmsTransformerTemplateProvider,config=/system/modules/org.opencms.apollo.template.transformer/configuration/transformer.apollo.mercury.config.json
Außerdem müssen Sie die Eigenschaft mercury.theme auf eine vorhandene Mercury Themen-CSS-Datei setzen. Dies ist notwendig für die Umstellung, kann aber später noch geändert werden. Sie sollten für einen Träger also zunächst ein Standard-CSS verwenden und dieses später durch ein spezielles, mit den Themen-Generator erzeugtes, CSS ersetzen.
Kopieren der Vorlage für Mercury-Seiten
Für die nach Mercury umzustellenden Webseiten muss eine Vorlage mit speziellen "Transformations-Markern" hinterlegt werden, diese enthält auch Standard-Elemente wie Kopfbreich, Fußbereich.
Diese Vorlage ist unter /system/modules/org.opencms.apollo.template.transformer/vorlage hinterlegt.
Das Verzeichnis muss mit der Option Kopiere Dateien und passe interne Links an direkt in die zu transformierende Site kopiert werden.
Testen der Konfiguration
Nachdem alle Einstellungen vorgenommen sind, können Sie testen, ob die Transformation korrekt eingerichtet ist:
- Öffnen Sie eine zu transformierende Seite.
- Prüfen Sie, ob Sie im Kontext-Menü unter Template zwischen Apollo und Mercury wechseln können.
- Prüfen Sie, ob im Kontext-Menü unter Template der Eintrag Seite vorbefüllen sichtbar wird, wenn sie auf Mercury gewechselt haben.
- Möchten Sie eine einzelne Seite testweise transformieren, nutzen Sie den Eintrag Seite vorbefüllen nun einmal manuell.
Automatische Transformation
Veröffentlichen Sie Ihre zu transformierende (Sub-)Site erneut, so dass auch die aktuellen Änderungen veröffentlicht sind. Nur dann wird die automatische Transformation möglich.
Öffnen Sie das Transformations-Skript unter /system/modules/org.opencms.apollo.template.transformer/scripts/transform.jsp (mittels der Option Anzeigen im Kontext-Menü) und befolgen Sie die Anweisungen im Skript.
Es wird erst ein Check der Vorbedingungen ausgeführt. Danach erfolgt die Transformation. Warten Sie bis die Tranformation abgeschlossen ist.
Nachbereitung und finale Umstellung der Site
Ist die automatische Transformation abgeschlossen, können Sie das Tranformationsergebnis prüfen und ggf. noch manuell nacharbeiten.
Die in der Vorlage enthaltenen Gruppen für Kopf- und Fußbereich, sowie ggf. angelegte Gruppen in der Seitenspalte müssen manuell mit Inhalten gefüllt werden.
Zusätzlich sind Detailseiten für Mercury-Inhalte zu konfigurieren und ggf. Listenkonfigurationen anzupassen. Diese können die gleichen Detail-Seiten sein, wie die der entsprechenden Apollo-Inhalte.
Sind Sie mit den Anpassungen fertig, tragen Sie an der Start-Ordner die Eigenschaft template auf /system/modules/alkacon.mercury.template/templates/mercury.jsp.
Ändern Sie in der Sitemap-Konfiguration die Master-Konfiguration auf
/system/modules/alkacon.mercury.bistuemer.mainz/configuration/mainz.standard.master.xml
oder/system/modules/alkacon.mercury.bistuemer.aachen/configuration/aachen.standard.master.xml.
Abschließend empfiehlt es sich die Vorlage aufzuräumen. Verschieben Sie dafür die Inhalte unter vorlage/.content/ in die entsprechenden Verzeichnisse unter .content/. Ggf. müssen Sie Umbenennungen durchführen. Löschen Sie danach den Ordner vorlage.
Testen Sie nun, ob die Site Offline wie gewünscht funktioniert. Falls ja, dann veröffentlichen Sie die gesamte (Sub-)Site.
Damit ist die Transformation abgeschlossen.
Zusatzinformationen für die Umstellung einzelner Unterbereiche
Soll nicht die ganze Site, sondern nur ein Unterbereich transformiert werden, sind zusätzliche Schritte notwendig.
Generell ist es nur möglich einen kompletten Unterbereich zu transformieren. D.h. es kann immer nur erst der Unterbereich und dann der Bereich darüber transformiert werden.
Wenn Sie einen Unterbereich, z.B. unterbereich/ transformieren wollen, setzen Sie in der Sitemap-Konfiguration bei der Vorbereitung das Attribut template.prefill.subsite auf den Unterbereich unterbereich/.
Entfernen Sie dieses Attribut wieder bei der finalen Umstellung des Bereichs auf Mercury.