Ratgeber contao-themes-net 3 Min. Lesezeit
Contao 6 und Twig – was das für dein Contao Theme bedeutet
von Mathias Arzberger
Contao 6 setzt konsequent auf Twig: .html5-Templates werden nicht mehr unterstützt. Contao Themes, die noch eigene HTML5-Templates im PHP-Format mitbringen, müssen deshalb überarbeitet werden. Hier erfährst du, was sich ändert, welche unserer Themes bereit sind und worauf du beim Update auf Contao 6 achten solltest.
Was ändert sich mit Contao 6 und Twig?
Für Theme-Entwickler und Integratoren sind vor allem diese Punkte wichtig:
- Keine
.html5-Templates mehr: Eigene Templates müssen als Twig-Templates vorliegen, zum Beispielcontent_element/text.html.twig. - Ausgabe prüfen: Contao 6 speichert Eingaben unkodiert in der Datenbank, die Absicherung passiert bei der Ausgabe. Twig kodiert die Ausgabe automatisch. Prüfe deshalb jede Stelle mit dem Filter
|raw. - PHP 8.4: Contao 6 setzt nach aktuellem Stand mindestens PHP 8.4 voraus. Kläre rechtzeitig, ob dein Hosting das anbietet.
Unsere Contao Themes und Contao 6
Das Creuva Contao Theme wurde von Anfang an mit Twig-Templates entwickelt und läuft unter Contao 5.7 und Contao 6 identisch.
- Creuva
- Contao 5.7 und 6, durchgängig Twig
- MATE, NATURE, ODD, 0.1, CONVERT
- ab Contao 5.3, Contao 6 in Vorbereitung
Update auf Contao 6: Darauf solltest du achten
Mit dieser Reihenfolge behältst du beim Umstieg den Überblick:
- Eigene Template-Anpassungen in Twig überführen: Das gilt für alle Templates, die du selbst angepasst hast. Mit
{% extends %}übernimmst du das Original und änderst nur die nötigen Blöcke. - Erweiterungen auf Kompatibilität mit Contao 6 prüfen: Nicht jede Erweiterung ist sofort bereit. Prüfe jede installierte Erweiterung und plane Alternativen ein.
- Seitenlayouts vom Typ „Modern“ verwenden: Stelle deine Layouts rechtzeitig um, auch das testest du am besten vorab.
- Die Umstellung zuerst auf einer Stage-Umgebung testen: So bleibt die Live-Website unberührt, bis alles läuft.
Umstieg planen
Bereit für Contao 6?
Du möchtest den Umstieg nicht selbst übernehmen? Unser Contao Theme Service prüft deine Installation und übernimmt das Update.
Häufige Fragen
Nein. Contao 6 unterstützt keine .html5-Templates mehr, du brauchst stattdessen Twig-Templates. Das betrifft auch Templates, die du im Ordner templates/ selbst angepasst hast. Am einfachsten erweiterst du das Original-Template mit {% extends %} und überschreibst nur die Blöcke, die du wirklich ändern willst. So bleiben deine Anpassungen klein und übersichtlich.
Nach aktuellem Stand mindestens PHP 8.4. Prüfe am besten schon vor dem Update, ob dein Hosting diese Version anbietet und ob deine Erweiterungen damit laufen. Die aktuelle PHP-Version siehst du zum Beispiel in der Verwaltung deines Hostings oder im Contao Manager.
Ja, Creuva ist für Contao 5.7 und Contao 6 ausgelegt und von Anfang an durchgängig mit Twig-Templates entwickelt. Eigene Anpassungen und zusätzliche Erweiterungen solltest du beim Umstieg trotzdem prüfen, am besten zuerst auf einer Stage-Umgebung. Alle Details findest du auf der Seite zum Creuva Contao Theme.