ACHTUNG: Ändern Sie die PHP-Version erst nach einem erfolgreichen Update des Themes.
Theme updaten
Vorab: Theme Updater / Care Paket im Kundenbereich aktivieren
Wenn Sie ein Update über den Theme Updater vornehmen prüfen Sie bitte vorab im Kundenbereich, ob das Care-Paket dort aktiviert ist.
Ein manuelles Update ist möglich, wird aber nicht empfohlen und nicht durch den Support begleitet. Der vorgesehene Weg ist der Theme Updater. Eine Anleitung für ein manuelles Update finden Sie hier.
Schritt 1: Aktuelle Systemanforderungen prüfen
Vor dem Update bitte sicherstellen, dass der Server die aktuellen Anforderungen erfüllt und die verwendete Contao-Version unterstützt wird:
| Contao Version | 5.3 LTS, 5.7 LTS Freigegebene Contao Versionen |
|---|---|
| PHP Version | Min. 8.2 |
| memory_limit | 512MB |
| post_max_size | 32MB |
| max_input_vars | 1000 |
| max_input_time | 60 |
| upload_max_filesize | 32MB |
| Freier Speicher | 1GB |
Schritt 2: Subdomain einrichten
Richten Sie die Subdomain "update.meinewebseite.com" auf Ihrer Domain ein. Unser Lizenzsystem erkennt diese Subdomain, so kann es zu keinen Lizenzkomplikationen kommen.
ACHTUNG: Der Theme-Updater kann nur auf der Lizenznehmerdomain oder der Subdomain "UPDATE" verwendet werden. Nicht jedoch auf einer andere Subdomain.
Schritt 3: Contao Installation kopieren
- Kopie der Datenbank erstellen (z.B. via phpMyAdmin)
- Kopie der Dateien erstellen
- 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 4: Contao-Version prüfen/updaten
- pct_-Module löschen und den Contao-Cache leeren
- Contao auf mindestens 5.3 LTS aktualisieren (Löschen Sie keine Datenbankfelder während des Updates)
- Weiter zu Schritt 5
- Contao auf mindestens 5.3 LTS aktualisieren
- Weiter zu Schritt 5
Schritt 4 nicht nötig. Weiter zu Schritt 5.
Schritt 5: Update durchführen
Das Update lässt sich komfortabel über den Theme Updater im Contao-Backend durchführen. Voraussetzung ist Contao 5.3 LTS oder 5.7 LTS.
Der Theme Updater ist ab Eclipse X 4.0 bereits im Theme enthalten und muss nicht gesondert installiert werden. Für ältere Stände lässt er sich über den Contao Manager (Paket theme_updater) oder über das GitHub-Release nachrüsten.
- Im Backend unter System > Theme Updater Lizenznummer und E-Mail-Adresse eintragen.
- Lizenz abfragen.
- Update starten.
Wenn das Update abbricht
- Prüfen, ob der Server die Anforderungen aus Schritt 1 erfüllt.
- Die Kopie aus Schritt 3 (Dateien und Datenbank) wieder einspielen.
- Den Theme Updater erneut starten.
Bleibt das Problem bestehen, gibt das Contao-Log unter var/log/ Aufschluss — der Eintrag zum Zeitpunkt des Abbruchs nennt die Ursache. Ist es leer, bitte zusätzlich das Server-Log prüfen. Für ein Support-Ticket bitte Contao-Version, PHP-Version und diesen Log-Eintrag mitschicken: Ticket erstellen.
Schritt 6: Domain auf neuen Ordner umstellen
Nach dem Update empfehlen wir, die Website gründlich zu testen. Wenn alles reibungslos funktioniert, können Sie die Domain auf den neuen Ordner umstellen.
Alternative: Manuell updaten
Ein manuelles Update ist möglich, wird aber nicht empfohlen und nicht durch den Support begleitet. Der vorgesehene Weg ist der Theme Updater.