Contao 5.6.0 veröffentlicht

Moderne Seitenlayouts basierend auf Twig

Bereits in Contao 4.13 konntest du Twig-Templates nutzen. Mit dem Update auf Contao 5.0 wurden alle Inhaltselemente auf Twig umgestellt. Contao 5.6 führt diesen Weg konsequent weiter und bietet erstmals ein neues Twig-Seitenlayout an.

Du kannst nun parallel zum bisherigen HTML5-Seitenlayout (fe_page) das neue Twig-Layout mit Slots verwenden. Das alte HTML5-Seitenlayout steht auf jeden Fall noch für alle Contao 5 Minor-Versionen zur Verfügung.

Auf den ersten Blick fällt auf, dass nach dem Aktivieren des Twig-Seitenlayouts fast alle bisherigen Einstellungen im Layout verschwinden. Künftig erfolgt nämlich die gesamte Konfiguration im Template. Das ist flexibler und daher zukunftssicherer und erlaubt u. a. auch die Versionierung von Templates mit VCS wie git und Co. Am besten nutzt du dafür das neue Template-Studio.

Im Template layout/default selbst definierst du mit {% slot %} die einzelnen Sektionen zu denen dann Artikel oder Inhaltselemente hinzugefügt werden können. Es können also auch nur noch die Slots ausgewählt werden, die das Template wirklich zur Verfügung stellt. Stylesheets, JavaScript-Dateien und weitere Assets fügst du zukünftig ebenfalls direkt über das Twig-Template und entsprechende Twig-Funktionen ein.

Inhaltselemente direkt im Layout hinzufügen

Du kannst nun Inhaltselemente direkt im Theme verwalten und in die verschiedenen Layoutbereiche bzw. Slots einbinden.

Ausserdem kannst du bei jedem Inhaltselement einen optionalen Titel eingeben. Dieser dient ausschliesslich der Übersichtlichkeit im Backend und wird nicht im Frontend angezeigt.

Dieses Feature klingt auf den ersten Blick nicht spektakulär, bildet jedoch die technische und konzeptionelle Grundlage für den geplanten Wegfall der bisherigen Frontend-Module. Warum Frontend-Module wegfallen sollen, liest du im Rückblick zum Entwicklertreffen von Yanick.

Job-Framework

Für die Verwaltung und Darstellung von Aufträgen (Jobs) wurde ein neues Framework geschaffen. Dadurch kannst du Abläufe die im Hintergrund geschehen (wie etwa das Neuaufbauen des Suchindexes) besser nachvollziehen und künftig Fehler oder Fortschritte dieser Prozesse direkt im Backend einsehen.

Die neue Architektur ist flexibel und unabhängig von Symfony Messenger, sodass verschiedene Arten von Jobs unterstützt werden.

Aktuell enthält die neue Job-Anzeige im Backend noch wenige Einträge, doch das wird sich in Zukunft ändern. Es handelt sich um eine wichtige Basis für ein Feature mit grossem Potenzial – nicht nur für den Core sondern auch für alle Contao-Erweiterungen.

Passkeys im Frontend

Unter Contao 5.5 wurden Passkeys für das Backend eingeführt. Nun steht diese Funktion auch im Frontend zur Verfügung.

Im Hinblick auf die Ablösung der Frontend-Module wurde die Funktion bereits als reines Inhaltselement umgesetzt. Um Passkeys zu nutzen, gibt es die neuen Inhaltselemente vom Typ «Login-Formular» und «Passkeys verwalten».

Suchindexer unabhängig vom Robots-Tag

In den Seiteneinstellungen kannst du nun unabhängig vom Meta-Robots-Tag festlegen, ob der Suchindexer eine Seite immer oder nie indizieren soll. Bisher konntest du bereits eine Seite von der Contao-Suche ausschliessen, aber für öffentliche Suchmaschinen freigeben. Neu ist auch der umgekehrte Fall möglich!

Seitentyp für Kalender-Feeds

Analog zum Seitentyp für News-Feeds gibt es jetzt auch einen Seitentyp für Kalender-Feeds. Das bedeutet, dass du den Feed nicht mehr über das Events-Archiv konfigurieren musst, sondern einen eigenen Seitentyp verwenden kannst. Bestehende Feeds werden automatisch migriert.

Formulareingaben nur bei Bedarf in Session speichern

In Contao wurden Formulardaten bisher immer kurzzeitig in der Session gespeichert, um beispielsweise per {{form_session_data::*}}-Inserttag auf die eingegebenen Daten zugreifen zu können.

Das Problem: Auch wenn dieser Zugriff nicht benötigt wurde, wurden die Daten trotzdem in der Session abgelegt und so ein CSRF-Cookie erzeugt, was den HTTP-Cache für eine kurze Zeit deaktiviert.

Eine neue Einstellung bei den Formularen sorgt nun dafür, dass die Speicherung nur noch erfolgt, wenn sie wirklich erforderlich ist. So kannst du in vielen Fällen ganz auf eine Session und damit auf das CSRF-Cookie im Frontend verzichten.

Für alle bestehenden Formulare wird die Option automatisch aktiviert, um die Rückwärtskompatibilität zu gewährleisten.

Accessibility/Barrierefreiheit

Auch in Contao 5.6 sind wieder zahlreiche Optimierungen in Sachen Zugänglichkeit eingeflossen.

Zum Inhalt springen

Um die Tastaturnavigation zu vereinfachen, gibt es nun auch im Quellcode des Backends einen «Zum Inhalt springen»-Link.

Hilfetexte für Formularfelder

Bei den Formularfeldern kannst du nun einen Hilfetext ergänzen, der unterhalb des jeweiligen Feldes im Formular angezeigt wird.

Barrierefreie Navigation

Contao bietet nun ein neues standardisiertes, barrierefreies Navigations-Template – inklusive ARIA-Unterstützung, Tastaturnavigation, mobiler Version und Zustandsanzeige.

Um die Navigation zu nutzen, verwendest du das neue Template (mod_navigation_accessibility). Und das Beste: es bringt die notwendige JavaScript- und CSS-Basis direkt mit.

Das Design kannst du individuell per CSS an deine Bedürfnisse anpassen. Dieses neue Template stellt somit die ultimative Komplettlösung für eine moderne, barrierefreie Navigation bereit!

User Experience (UX)

Um die Arbeit mit Contao zu erleichtern sind auch hier wieder verschiedene kleine und grosse Verbesserungen integriert worden.

Verbesserungen beim Kontextmenü

Unter Contao 5.5 wurde das Kontextmenü eingeführt. Dank zahlreichem Feedback konnte das Menü deutlich verbessert werden. Insbesondere wurde die Übersichtlichkeit durch klarere Bezeichnungen der Labels und einen visuellen Trenner optimiert.

Zusätzlich gibt es das Menü jetzt auch für globale Operationen. So sind die wichtigsten Funktionen sofort sichtbar, während der Rest erst nach einem Klick auf die drei Punkte angezeigt wird. Allein wegen des Kontextmenüs lohnt sich ein Blick ins Backend von Contao 5.6.

In die Zwischenablage kopieren

Wenn du die Funktion «In die Zwischenablage kopieren» verwendest, dann erhältst du ab sofort ein visuelles Feedback. Live sehen kannst du das beispielsweise bei den Vorschau-Links.

Jump-Targets bei «mehrere bearbeiten»

Du kennst die Sprungleiste bereits beim Bearbeiten von Inhalten. Nun wurde sie auch für die Funktion «Mehrere bearbeiten» implementiert. So kannst du ganz einfach und schnell zu einem bestimmten Datensatz springen.

Beispiel: Du bearbeitest die Metadaten mehrerer Seiten und kannst per Klick direkt zur Position der entsprechenden Seite springen.

Metadaten überschreiben

Manchmal ist es hilfreich, Metadaten, die über die Dateiverwaltung gesetzt wurden, zu entfernen. Dafür kannst du nun das neue Insert-Tag {{empty}} verwenden.

Viele weitere Verbesserungen

Zwei-Faktor-Authentifizierung: Es gibt nun einen «Bearbeiten»-Button, mit dem sich die Einrichtungsinformationen erneut anzeigen lassen. So können Nutzer:innen jederzeit weitere 2FA-Apps hinzufügen, ohne den bestehenden Schutz aufheben zu müssen.

ISO-3166-2: Contao unterstützt nun regionale Ländercodes wie z. B. AT-9 für Wien, was präzisere Geodaten ermöglicht.

Backup auswählen: Backups lassen sich im backup:restore-Befehl jetzt direkt und interaktiv auswählen.

Neue Registrierungen: Die Bestätigungsfrist für neue Benutzer wurde von 24 Stunden auf 14 Tage (336 Stunden) verlängert und ist nun flexibel konfigurierbar.

# config/config.yaml
contao:
    registration:
        # The number of days after which unconfirmed registrations expire.
        expiration: 16

Entwickler-Features

Natürlich gibt es auch hier wieder neue Funktionen und Verbesserungen.

#[AsMessage]: Das neue Attribut ersetzt die bisherigen Messenger-Priority-Interfaces und vereinfacht die Nachrichtenbehandlung.

Palette-Helper: Die neue Klasse erleichtert die Bearbeitung von Paletten und ermöglicht z. B. das Prüfen, ob bestimmte Felder existieren.

HtmlHeadBag-Shortcut: Im AbstractController steht jetzt die Methode getHtmlHeadBag() bereit, um einfacher auf den Head-Bereich zuzugreifen.

Contao Date-Formate in Twig: Datumsformate von Contao können nun direkt und global in Twig-Templates genutzt werden.

Details dazu findest du wie immer im Changelog.

Die Spitze des Eisbergs

Neben den bereits erwähnten Features wurde auch hinter den Kulissen viel getan, was nicht sofort sichtbar ist, aber dennoch viel Zeit und Hingabe erforderte. Allein die Umstellung auf PHPUnit 11 beschäftigte mehrere Entwickler fast während des gesamten Entwicklertreffens.

Nur durch diesen zusätzlichen Einsatz kann die Codebasis und die Zukunft von Contao gesichert werden.

Neben der Implementierung der neuen Features möchte ich auch noch einmal auf das grossartige Handbuch hinweisen, welches ebenfalls viele der neuen Funktion schon dokumentiert hat.

Deshalb die Bitte: Mach mit und unterstütze Contao – sei es durch Social-Media-Posts, Blogbeiträge oder finanzielle Unterstützung.

Die neue LTS-Version kommt bald!

Nach dem Release ist vor dem Release. Contao 5.6 ist die letzte Version vor der nächsten LTS-Version Contao 5.7. Es lohnt sich also, Contao 5.6 ausführlich zu prüfen und zu testen, um sich optimal auf Contao 5.7 vorzubereiten oder noch den ein oder anderen Verbesserungswunsch auf GitHub einzureichen.

Ebenfalls lesenswert ist auch der offizielle Release-Beitrag auf contao.org und sehenswert ist das YouTube-Video der Contao Academy.