Contao 5.6 - von allem noch mehr

Mit Contao 5.6 wird unser beliebtestes Webseiten-Werkzeug noch moderner und benutzerfreundlicher. Das Release bringt zahlreiche Verbesserungen im Backend, ebnet den Weg zu zukunftssicheren Seitenlayouts und erweitert die Möglichkeiten im Frontend. Außerdem ist einiges an Arbeit in Dinge geflossen, die du auf den ersten Blick vielleicht nicht siehst. Dazu später mehr.

Das Core-Team und viele andere Entwickler:innen haben wieder über 200 Pull Requests verarbeitet.

Contao 5.6 wird bis Februar 2026 mit Updates versorgt und mündet dann direkt in die folgende LTS-Version Contao 5.7. Auch die Version 5.3 erhält als LTS-Version weiterhin Updates.

Welche Contao-Versionen aktuell unterstützt werden, kannst du im Contao Release-Plan nachlesen.

Moderne Seitenlayouts mit Twig-Slots

Mit Contao 5.6 halten moderne Seitenlayouts auf Basis von Twig-Templates mit Slots Einzug. Diese ermöglichen eine flexible, modulare Gestaltung der Ausgabe. Die bisherigen HTML5-Seitenlayouts bleiben noch im gesamten Contao 5.x-Zweig erhalten, sodass du den Umstieg in Ruhe planen kannst.

Du bist in Zukunft wesentlich freier in der Gestaltung deines Seitenlayouts und kannst, wie von Twig gewohnt, leichter Varianten erstellen. Außerdem lassen sich die Templates per Git versionieren und schnell von einem Projekt in ein anderes übertragen.

Um dies zu erreichen, werden viele Einstellungen aus dem Backend nun direkt ins Template verlagert. Das erfolgt, sobald du als Art des Layouts "Twig-Layout mit Slots" auswählst. Wir werden uns in einem separaten Artikel mal ausführlich anschauen, wie man die Einstellungen in das neue Twig-Template überführt.

Das neue Standard Template für Seiten heißt nun layout/default und die Layout-Bereiche werden mit slots befüllt und an die gewünschte Stelle gebracht.

Pull Requests: #8006

Inhaltselemente im Seitenlayout

Yanick hatte es bereits in seinem Artikel über das Entwicklertreffen im Februar angekündigt: Langfristig sollen neue Inhaltselement die alten Module ersetzen. Der erste Schritt dafür ist, dass du nun Inhaltselemente im Seitenlayout verwenden kannst.

Im Theme gibt es dafür nun einen eigenen Bereich mit eigenem Icon. Hier kannst du beliebig viele Inhaltselemente anlegen. Du kannst jetzt jedem Inhaltselement einen Titel geben. Aktuell wird das nur im Seitenlayout verwendet, damit du siehst, welches Inhaltselement du auswählst. Es gibt schon Ideen, wofür der Titel außerdem noch verwendet werden kann.

Zum Beispiel kannst du in Zukunft für ein Logo ein Inhaltselement Bild verwenden und dieses direkt einem Layoutbereich zuweisen.

Pull Requests: #7999

Passkeys im Frontend

In Contao 5.5 wurden Passkeys für das Backend eingeführt, nun kannst du sie auch im Frontend verwenden.

Hier kommt auch die eben erwähnte Funktion Inhaltselemente im Seitenlayout zum Einsatz. Die neuen Inhaltselemente Login-Formular und Passkeys verwalten stellen dir bzw. den Webseiten-Besuchern die Möglichkeiten von Passkeys beim Login in geschützte Bereiche zur Verfügung.

Pull Request: #8011

Kontextmenü

Die Kontextmenüs im Backend sind jetzt übersichtlicher: Klare Labels und ein visueller Trenner sorgen für eine bessere Orientierung. Außerdem funktioniert es nun auch für globale Operationen.

Pull Requests: #8411, #8400, #8346, #8437, #8372, #8434

Verbesserungen am Suchindexer

Du kannst nun unabhängig vom Robots-Tag pro Seite entscheiden, wie der interne Suchindexer mit der Seite verfahren soll. Wählst du nichts aus, orientiert sich das Verhalten weiterhin am Robots-Tag. Du kannst aber jetzt auch festlegen, dass du die Seite lokal immer indizieren oder nie indizieren lassen möchtest.

Pull Requests: #8252

Das neue Job-Framework

Manchmal ist es ja toll, anderen bei der Arbeit zuzuschauen. Nun gibt es in der Statuszeile ein eigenes Icon, welches dich zur Übersicht aller aktiven und gerade abgearbeiteten Jobs führt.

Dieses fantastische neue Feature ist nur der Anfang für eine Reihe von Möglichkeiten von Background-Tasks, die du manuell oder automatisch angestoßen hast und deren Status du live verfolgen kannst. Du bekommst auch immer ein optisches Feedback, wenn etwas abgeschlossen wurde.

Das Framework kann auch von Erweiterungen genutzt werden und schafft so Möglichkeiten in Projekten die Background-Tasks sauber im Blick zu behalten. Wir sind schon gespannt, wie verschiedene Erweiterungen das in Zukunft nutzen werden (ZIP-Downloads, PDF-Generierung, große Exporte oder Importe, etc.)?

Pull Requests: #8066

Barrierefreie Navigation

Contao 5.6 liefert dir ab sofort out-of-the-box eine barrierefreie Navigation mit, die sich mobil automatisch in ein Burger-Menü verwandelt. Dazu muss lediglich im Navigations-Modul das Template mod_navigation_accessible.html5 ausgewählt werden.

Das Styling des Menüs kann sehr gut über custom properties angepasst werden.

Pull Requests: #8012

Kleiner Tipp: Solltest du in manchen deiner Installationen noch Contao 5.3 einsetzen, kannst du die Erweiterung von Sebastian nutzen, die dir einiges an Accessibility als Backport zur Verfügung stellt.

Zum Inhalt springen

Wenn du das Contao-Backend mit der Tastatur bedienst, hast du nun gleich zu Beginn eine Sprungmarke zum Inhalt.

Pull Request: #8000

Hilfetexte in Formularen

Formularfelder können nun um einen Hilfetext ergänzt werden, der standardmäßig unterhalb des Feldes angezeigt wird.

Pull Request: #7825

Seitentyp für Kalender-Feeds

Wenn du einen XML-Feed für Kalender auf deiner Webseiten anbieten möchtest, steht dir dafür ab jetzt ein eigener Seitentyp zur Verfügung.

Pull Request: #8390

Formulareingaben speichern

Contao speichert ab sofort nicht mehr automatisch alle Formulareingaben in der Session. Das macht die Verarbeitung schneller und es wird kein Cookie mehr erzeugt.

Willst du weiterhin die Daten per Inserttag nach dem Absenden ausgeben, kannst du das mittels der Checkbox Eingaben in der Session speichern tun.

Deine alten Formulare erhalten bei einem Update automatisch die Checkbox gesetzt, damit erstmal alles funktioniert.

Pull Request: #8245

Zwei-Faktor-Authentifizierung bearbeitbar

Du kannst jetzt per Bearbeiten-Button die Setup-Informationen erneut anzeigen lassen, um zusätzliche 2FA-Apps einzurichten – ohne die bestehende Konfiguration zurücksetzen zu müssen.

Pull Request: #8007

Datei-Metadaten besser zusammenführen

Du pflegst vermutlich die meisten Metadaten deiner Dateien direkt in der Dateiverwaltung. Manchmal will man aber direkt im Inhaltselement bei einem Bild an einer bestimmten Stelle von den Metadaten der Datei abweichen.

Hast du bisher beim Überschreiben der Metadaten den Bildtitel leer gelassen, wurde automatisch der aus der Dateiverwaltung genutzt. Mit dem neuen Inserttag {{empty}} kannst du in jedem Feld bewusst auf die Ausgabe eines Textes verzichten.

Pull Request: #8002

Sprungmarken bei „Mehrere bearbeiten“

Wählst du mehrere Element zum Bearbeiten aus, hast du jetzt für jedes Feld eine Sprungmarke oberhalb der aufgelisteten Felder.

Pull Request: #8480

Backup auswählen

Wenn du über die Konsole ein Backup wiederherstellen lassen willst, erhältst du nach Eingabe von contao:backup:restore eine Liste, in der du das gewünschte Backup bequem auswählen kannst.

Pull Request: #8465

Optisches Feedback beim Kopieren von Vorschau-Links

Die Funktion „In die Zwischenablage kopieren“ gibt nun visuelles Feedback, sobald der Kopiervorgang erfolgreich war.

Pull Request: #8204

ISO-3166-2

Contao unterstützt jetzt auch ISO-3166-2-Ländercodes wie z. B. AT-9 für Wien.

Pull Request: #8462

Geschützte Elemente indizieren

Geschützte Inhalte werden nun zusätzlich mit <!-- indexer::protected --> ausgezeichnet. Beim Aufruf von Document::getSearchableContent() kann nun ein optionaler Parameter übergeben werden, um solche geschützten Elemente ebenfalls in deinen Index aufzunehmen.

Pull Request: #8395

Zeit für Mitglieder-Registrierung verlängert

Die Zeit, die ein neues Mitglied hat, um seine Registrierung im Frontend zu bestätigen, wurde von 24 Stunden auf 14 Tage erhöht. Bei Bedarf kann der Zeitraum außerdem in der Konfiguration über contao.registration.expiration angepasst werden.

Pull Request: #8511

#[AsMessage]

Das neue #[AsMessage]-Attribut ersetzt die bisherigen Messenger-Priority-Interfaces.

Pull Request: #8331

Palette-Helper

Die neue Palette-Klasse vereinfacht die Manipulation von Paletten und ermöglicht es insbesondere auch, abzufragen, ob Felder bereits existieren.

Pull Request: #8302

HtmlHeadBag-Shortcut

Der AbstractController hat nun eine Methode getHtmlHeadBag().

Pull Request: #8393

Contao Date-Formate in Twig

Die Contao Date-Formate sind jetzt global in Twig z. B. als contao.date_format verfügbar.

Pull Request: #8472

Fleißarbeit, die niemand sieht

Du kennst das vermutlich auch aus Projekten bei Upgrades oder dem Wechsel des CSS-Frameworks: Es muss immer mal wieder viel Arbeit in ein Projekt fließen, ohne dass man nach außen hin etwas davon sieht.

So ist auch dieses Mal wieder viel Arbeit in das Update geflossen, die nicht direkt in Features sichtbar wird. Allein die Umstellung auf PHPUnit 11 hat mehrere Entwickler fast das ganze Entwicklertreffen lang beschäftigt.

• Upgrade to PHPUnit 11, Pull Request: #8010
• Add the Countable interface to the FilesystemItemIterator, Pull Request: #8184
• Add a directory filter VFS decorator, Pull Request: #8052
• Add a count() helper  method to the FilesystemItemIterator, Pull Request: #8054
• Refactor the Turbo stream handling into a separate module, Pull Request: #8072
• Extract messages and the dialog element from the Template Studio, Pull Request: #8064
• Support reloading DCAs, Pull Request: #6955
• Rewrite the back end search to use Turbo streams, Pull Request: #8207
• Rewrite the SERP widget to a Stimulus controller, Pull Request: #8257
• Extract the building of palletes and boxes into the data container, Pull Request: #8285
• Rewrite the wizards to use Twig templates, Pull Request: #8446
• Restructure the `flexible` theme and rewrite it using PostCSS, Pull Request: #8469
• Use a voter instead of a buCon callback for the alias element, Pull Request: #8523
• Refactor the switch user operations, Pull Request: #8533
• Use security voters in the comments bundle, Pull Request: #8519
• Use a close icon instead of × or ×, Pull Request: #8094

Changelog und Video

Alle Änderungen kannst du ausführlich im Changelog nachlesen. Christian Feneberg hat auch wieder ein sehenswertes Video zu Contao 5.6 erstellt.

Kompatibilität

Contao 5.6 ist kompatibel mit

• Symfony 6.4 und 7
• PHP 8.2+
• Monolog 3
• Doctrine DBAL 3 und 4
• Doctrine ORM 2 und 3
• TinyMCE 5, 6 und 7

Siehe auch: Tickets | Versionsvergleich | Changelog