Systemupdate von 3.2.x auf 3.3.0
Vorbereitung
Grundlegend erfolgt das Update einer Kajona Version auf 3.3.0 wie die bisherigen Updates.
Hierzu gehört, dass das neue System heruntergeladen werden sollte. Um bisherige Änderungen beizubehalten sollten die Templates, die config.php, die global_includes.php sowie ggf. vorhandene Bilder und Downloads gesichert werden.
Zusätzlich sollten dann folgende Schritte vorgenommen werden:
- Sicherung des gesamten Systems anlegen (auch der Datenbank!)
- Wenn aktiviert, gzip-Kompression der Ausgaben im Modul System -> Systemeinstellungen deaktivieren
- Während des Updates sollte das Modul System als erstes aktualisiert werden.
Allgemeine Hinweise
In Kajona 3.3 unterstützen noch mehr Elemente Templates.
Dies hat den großen Vorteil, dass in Zukunft keine PHP-Klassen mehr berührt werden müssen um das Layout einzelner Element anzupassen.
In Konsequenz bedeutet das aber auch, dass bisherige Anpassungen an Element-Portal-Klassen einmalig in die Templates überführt werden müssen.
Konkret betrifft dies folgende Elemente:
- Paragraph (ehemals Absatz)
- Image (ehemals Bild)
- Row (ehemals Zeile)
- Imagelightbox
All diese Elemente steuern ihr aussehen nun über ein frei gestaltbares Template.
Updatevorgang
In Kajona 3.3 werden Teile der Datenbankstruktur neu aufgebaut. Dies ist notwendig, da die interne Hierarchie nun strikter aufgebaut wird.
Von daher überprüft das Update des System-Moduls während des Vorgangs, ob andere Module noch inkonsistente Datensätze in der Datenbank vorhalten. Ist dies der Fall, so bricht das Update mit der Meldung
Please upgrade other modules before.
Aborting update!
ab. Darüber wird eine Liste der IDs ausgegeben, die noch nicht korrekt zugeordnet wurden.
Um diese Datensätze anzupassen sollten nun die restlichen Module aktualisiert werden. Ist dies erfolgt, kann das Update des System-Moduls fortgesetzt werden.
Hinweis: In seltenen Fällen kann es sein, dass das Update auch nach der Aktualisierung mit der obigen Fehlermeldung abbricht. Dies deute auf verwaiste Datensätze in der Systemtabelle hin, die keinen Modul mehr zugeordnet sind. In diesem Fall hilft das Debug-Skript "systemtablevisualizer" aus dem Debug-Paket den entsprechenden Datensatz zu finden. Alternativ steht auch das Forum mit Rat und Tat zur Verfügung.
global_includes.php
Da ab Kajona 3.3 in eigenen JavaScript-Dateien bereits auf die JS-Konstante KAJONA_WEBPATH zugegriffen werden kann muss diese definiert werden, bevor die weiteren JS-Dateien geladen werden. Sollten im Projekt Änderungen an der Datei /portal/global_includes.php getätigt worden sein, muss diese Datei auf den Stand des 3.3er Releases aktualisiert werden.
Templates
Da sich Änderungen an den Templates nicht vollkommen vermeiden ließen, ist es unter Umständen möglich, dass die genutzten Templates auf den neusten Stand aktualisiert bzw. eigene Templates mit den Beispieltemplates abgeglichen werden müssen. Dies betrifft vor allem das Modul postacomment.