Wie update ich auf Contao 5.3 LTS?
Dieser Leitfaden umfasst das Update von Contao 4.13 LTS auf 5.3 LTS.
Wir empfehlen dringend, das Update nicht in der Live-Umgebung durchzuführen. Stattdessen sollte die Aktualisierung gemäß der Anleitung auf einer Kopie der Installation vorgenommen werden.
Schritt 1: Systemanforderungen des Servers prüfen
Vor dem Contao-Update die Serveranforderungen überprüfen:
Schritt 2: Contao Freigabe prüfen
Prüfen Sie ob die gewünschte Contao-Version für unsere Produkte freigegeben ist.
Schritt 3: Subdomain einrichten
Richten Sie die Subdomain update auf Ihrem Server ein.
Bsp.: update.meinewebseite.com
Diese Subdomain sollte auf einen neuen httpdocs/ Ordner zeigen. Bsp.: httpdocs_2/web/
Unser Lizenzsystem erkennt diese Subdomain, so kann es zu keinen Lizenzkomplikationen kommen.
Schritt 4: Contao Installation kopieren
- Kopie der Datenbank erstellen (z.B. via phpMyAdmin)
- Dateien kopieren
Kompletter Inhalt des httpdocs/ Ordner kopieren. Achten Sie darauf, dass Sie auch versteckte Dateien mit kopieren. - Neue Datenbankverbindung in der Datei config/parameters.yml eintragen
- Contao Cache leeren
- System > Systemwartung > Symlinks neu erstellen
Zum Schutz vor möglichen Duplikaten und damit die Seiten während des Updates nicht im Google-Index landen, empfehlen wir, die Subdomain mit einem htaccess-Verzeichnisschutz zu versehen.
Schritt 5: Das Theme updaten
Um sicherzustellen, dass die Theme-Dateien mit der Contao-Installation kompatibel sind, aktualisieren Sie bitte das Theme auf die neueste Version.
Folgende Möglichkeiten stehen zur Verfügung:
- Theme-Updater (Updaten per Klick im Backend)
- Manuelles Update (Per FTP)
Hinweis zu Update CustomCatalog
Im Updateprozess nicht die Tabellen löschen lassen. Ansonsten werden die CustomCatalog-Tabellen (cc_) gelöscht.
Datenbank bereinigen nach Update:
- Contao > Einstellungen > CustomCatalog-Einstellungen > „DCA-Cache deaktivieren“ aktivieren
- Contao-Manager: Datenbank Update und Tabellen löschen lassen die nicht verwendet werden
- Contao > Einstellungen > CustomCatalog-Einstellungen > „DCA-Cache deaktivieren“ deaktivieren
- Contao-Manager: Caches leeren
Schritt 6: Contao Update durchführen
Contao von 4.13 LTS auf 5.3 LTS mit dem Contao Manager updaten.
Schritt 7: Manuelle Änderungen im Backend
In Contao 5.3 wurden folgende Änderungen vorgenommen:
Nachrichtenlisten Sortierung:
Nachrichtenlisten Sortierung "date DESC" (Unbekannte Option) ändern in "order_date_desc"
Bildgrößen-Auswahlen:
Bildgrößen Einstellung "CENTER_CENTER" (Unbekannte Option) ändern in "CROP"
Akkordeon-Templates neu zuweisen:
Legacy-Elemente (Akkordeon Umschlag Anfang):
Inhaltselement-Template > ce_accordionStart
Legacy-Elemente (Akkordeon Einzelelement):
Inhaltselement-Template > ce_accordionSingle
Der Theme-Updater stellt zu div. Anpassungen in der Systemwartung ein Migrationstool bereit:
Contao > System > Systemwartung > Theme-Updater Aufgaben
Sollten Sie nicht über den Theme-Updater verfügen müssen diese Felder bei allen betroffenen Feldern manuell umgestellt werden.
Schritt 8: Hauptdomain umstellen
Nach dem Update empfehlen wir, die Website gründlich zu testen. Wenn alles reibungslos funktioniert, können Sie die Domain auf den neuen Server umstellen.
Denken Sie daran, den htaccess-Verzeichnisschutz gegebenenfalls nach dem Transfer wieder zu entfernen!