Neue Releases: Contao 5.7 Support und Wrapper-Elemente für Grid & Akkordeon

von David Molineus

Die letzten Wochen waren für das Contao-Bootstrap-Projekt ausgesprochen produktiv. Alle relevanten Komponenten haben neue Releases erhalten, die die Contao 5.7 Kompatibilität herstellt. Die Grid und Accordion Komponente bieten nun auch die neu in Contao eingeführten verschachtelten Elemente. Dieser Beitrag fasst die wichtigsten Änderungen zusammen.

Contao 5.7 Support

Das wichtigste Update betrifft die Kompatibilität mit der aktuellen Contao-Version 5.7. Mit Core 3.1.0 (veröffentlicht am 2. Juni 2026) wurde die Unterstützung für den modernen Layout-Typ in Contao 5.7 hinzugefügt. Wer bereits auf Contao 5.7 umgestiegen ist oder plant, bald zu migrieren, sollte die Komponenten entsprechend aktualisieren. Die Mindestanforderungen für den Core (und damit für alle darauf aufbauenden Komponenten) liegen nun bei PHP 8.2 und Contao 5.3.

Das neue Wrapper-Element-Konzept

Das bisherige Modell, bei dem Start-, Trenn- und Stopp-Elemente separat angelegt wurden, wird schrittweise durch ein neues Wrapper-Element-Konzept abgelöst. Statt mehrerer loser Inhaltselemente, die eine Struktur einrahmen, fasst ein einzelnes Wrapper-Element alle verschachtelten Fragmente zusammen.

Diese Umstellung betrifft zwei Komponenten:

Grid: bs_grid_wrapper statt bs_gridStart / bs_gridStop / bs_gridSeparator

In Grid 3.1.0 (veröffentlicht am 5. Juni 2026) werden die bisherigen Inhaltselemente bs_gridStart, bs_gridStop und bs_gridSeparator als deprecated markiert. Sie werden in einer zukünftigen Hauptversion entfernt. Das neue Element heißt bs_grid_wrapper und nutzt das Contao-Konzept der verschachtelten Fragmente.

Wer die alten Elemente bis zur Migration weiterhin nutzen möchte, kann dies – sie bleiben standardmäßig aktiv. Wer sie bereits jetzt deaktivieren will, kann das über die Bundle-Konfiguration tun:

# config/config.yaml
contao_bootstrap_grid:
    enable_legacy_elements: false

Akkordeon: bs_accordion_wrapper statt Start/Stop-Elementen

Parallel dazu hat Accordion 3.1.0 (veröffentlicht am 29. April 2026) das gleiche Prinzip eingeführt. Die bisherigen Elemente bs_accordion_start, bs_accordion_end, bs_accordion_group_start und bs_accordion_group_end sind nun ebenfalls deprecated. Ersatz sind die neuen Elemente bs_accordion_wrapper und bs_accordion_group_wrapper.

Auch hier gilt: Die Legacy-Elemente bleiben standardmäßig aktiv und können optional über die Bundle-Konfiguration deaktiviert werden:

# config/config.yaml
contao_bootstrap_accordion:
    enable_legacy_elements: false

Optionale Migration (experimentell)

Bestehende Projekte müssen nicht manuell auf die neuen Wrapper-Elemente umstellen – für beide Komponenten gibt es eine automatische Migration, die allerdings als experimentell einzustufen ist und vor dem Einsatz auf einer Testkopie des Projekts erprobt werden sollte.

Migration für Grid

Die Migration wird über die Bundle-Konfiguration aktiviert:

#config/config.yaml
contao_bootstrap_grid:
    enable_wrapper_migration: true

Anschließend kann die Migration über den Contao Manager oder die CLI ausgeführt werden:

php bin/contao-console contao:migrate

Migration für Akkordeon

Für die Akkordeon-Komponente funktioniert es analog:

#config/config.yaml
contao_bootstrap_accordion:
    enable_wrapper_migration: true

Auch hier wird die Migration dann über contao:migrate ausgeführt.

Hinweis: Die Migration ist optional und experimentell. Sie sollte nicht ungeprüft auf Produktivsystemen eingesetzt werden. Eine vollständige Sicherung der Datenbank vor der Ausführung ist empfehlenswert.

Update-Empfehlung

Für alle, die Contao-Bootstrap aktiv einsetzen, empfiehlt sich ein zeitnahes Update auf die aktuellen Versionen. Der Umstieg auf die Wrapper-Elemente ist noch nicht zwingend erforderlich, aber es ist ratsam, neue Projekte direkt mit den neuen Elementen aufzubauen und bestehende Projekte mittelfristig zu migrieren, bevor die Legacy-Elemente in einem zukünftigen Major-Release entfernt werden.

Fragen oder Feedback? Diskussionen finden wie immer im Contao-Community-Forum und über den GitHub Issue Tracker statt.