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 23-06 ist die erste Version der Template-Umstellung von Apollo nach Mercury verfügbar.
Damit ist es möglich, Websites Seite für Seite von Apollo nach Mercury umzustellen. Die Umstellung der Seiten erfolgt dabei manuell. 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.
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/alkacon.mercury.bistuemer.apollo/transformer/configuration/transformer.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.
Anlegen einer Vorlage für Mercury-Seiten
Für neu nach Mercury umgestellte Webseiten kann eine Vorlage hinterlegt werden, damit Standard-Elemente wie Kopfbreich, Fußbereich und ggf. Seitenspalte bereits verfügbar sind.
Diese Vorlage ist in der Datei /.content/.templates/mercury_vorlage.html
zu hinterlegen.