Contao aktualisieren

Wir wissen, wie wichtig es ist, Contao stets aktuell zu halten. Deswegen sind unsere Themes so aufgebaut, dass einmal installiert, ein Contao Update jederzeit möglich ist (bisher einzige Ausnahme). Wir gehen sogar noch einen Schritt weiter und rufen dazu auf, dass du Contao regelmäßig – zum Beispiel alle 4 Wochen – aktualisierst.

Eine Aktualisierung des Themes ist dafür normalerweise nicht notwendig. Möchtest du dennoch eine neue Theme-Version einspielen, hängt das Vorgehen von der Theme-Version ab.

SOLO 4, LASR 5, SIRIUS 3 und neuer

Ab diesen Versionen besteht ein Theme aus zwei Teilen, die getrennt aktualisiert werden:

• Theme-Bundle (z.B. erdmannfreunde/solo-theme-bundle) mit Templates, Inhaltselementen und Abhängigkeiten: Es wird wie jede andere Erweiterung über den Contao Manager aktualisiert – innerhalb der Hauptversion also automatisch, sobald du im Contao Manager die Pakete aktualisierst.
• Theme-Dateien (SCSS, JavaScript, Bilder und Fonts): Sie spielst du im Backend unter Theme-Toolbox » Updates ein, indem du die neue ZIP-Datei aus dem Club-Bereich hochlädst.

Beim Upload über Theme-Toolbox » Updates passiert Folgendes:

• Die Originaldateien des Themes unter layout/[theme-name] werden komplett durch die neue Version ersetzt.
• Deine Anpassungen unter layout/custom bleiben unverändert erhalten.
• Dateien aus dem Theme (z.B. unter files/demo) werden ergänzt – gleichnamige Dateien dabei überschrieben.
• Eigene Templates im Ordner templates werden nicht überschrieben.
• Vor dem Update legt die Theme Toolbox ein Backup unter var/backups/theme-updates an.

Im Theme Editor siehst du anschließend über Unterschiede anzeigen, ob sich Originaldateien geändert haben, zu denen du eigene Varianten angelegt hast. Mehr dazu findest du in der Anleitung Theme individualisieren deines Themes: SOLO 4, LASR 5, SIRIUS 3.

Ältere Theme-Versionen

Bei älteren Versionen (z.B. SOLO 3, LASR 4 oder SIRIUS 2) aktualisierst du das Theme über den Contao Manager, indem du die neue ZIP-Datei hochlädst. Das Theme ist so konfiguriert, dass ein bestehender Ordner theme in files und templates nicht überschrieben wird.

Ein Backup ist in jedem Fall zu empfehlen!

Warum gibt es dann überhaupt immer wieder neue Theme-Versionen?

Dennoch veröffentlichen wir immer wieder neue Versionen unserer Contao Themes. In der neuen Version stellen wir die Kompatibilität zur neu erschienenen Contao Version her. Dies bezieht sich vor allem auf die Demo-Daten, die in einer frischen Installation importiert werden können. Ab SOLO 4, LASR 5 und SIRIUS 3 enthalten neue Versionen außerdem Verbesserungen an SCSS und JavaScript, die du über Theme-Toolbox » Updates einspielst. Verbesserungen an Templates und Inhaltselementen erhältst du über das Theme-Bundle.

Da sich die Datenbank-Struktur von Contao häufiger ändert, muss auch die SQL-Datei angepasst werden. Dieser Import ist aber nur relevant, wenn du mit einem neuen Projekt und der neuesten Contao Version beginnen möchtest. Für bestehende Installationen spielt die SQL-Datei keine Rolle.