Contao · MIT-Lizenz

Galerie für Contao.

Raster, Leiste und Lightbox aus Carousel und Sheet, mit den Bildgrößen aus Contao.

InstallierenGitHub

Version 0.1.0 vom 01.10.2026 · Contao 5.7 und 6.0 · PHP 8.3+ (Contao 5.7), 8.4+ (Contao 6)

Installation

Im Contao Manager nach nordwerk/contao-gallery-bundle suchen und das Paket installieren. Alternativ das Manager-ZIP aus den GitHub-Releases herunterladen und im Manager hochladen; anschließend die Datenbank aktualisieren.

Über Composer:

composer require nordwerk/contao-gallery-bundle
vendor/bin/contao-console contao:migrate

Installationshinweise und Voraussetzungen stehen auch im README.

Was es kann

Dateien oder Ordner in Contao auswählen, sortieren und eine Bildgröße zuweisen: Daraus entstehen ein Raster, wechselnde Formate oder eine native Bilderleiste. Responsive Bilder, Alt-Texte und Bildunterschriften kommen aus Contaos Dateiverwaltung; die Lightbox nutzt die Großansichtsgröße des Seitenlayouts.

Die Bilderleiste baut auf Carousel, die Lightbox auf Sheet auf. Beide Contao-Bundles werden automatisch mitinstalliert. Mit JavaScript kommen Pfeile, Tastaturbedienung, Wischen und Fokus-Rückgabe hinzu; ohne JavaScript bleiben Bilder und Großansichtslinks nutzbar. Vorhandene Kern-Lightboxen werden nicht global ersetzt.

Erste Schritte im Backend

Das Galerie-Bundle benötigt Carousel und Sheet; Composer und der Contao Manager installieren beide Bundles automatisch mit. Bei Manager-ZIPs müssen auch die benötigten Bundles verfügbar sein; beachte die Hinweise in den Releases.

Lege im Artikel unter Nordwerk UI → Galerie ein Inhaltselement an. Wähle Dateien oder einen Ordner, sortiere die Bilder und weise eine Contao-Bildgröße zu. Wähle Raster, wechselnde Formate oder Leiste; „Großansicht/Neues Fenster“ aktiviert die Sheet-Lightbox.

Pflege Alt-Texte und Bildunterschriften in der Dateiverwaltung. Die Lightbox verwendet die Großansichtsgröße des Seitenlayouts. Vorhandene Kern-Bilder und Lightboxen bleiben erhalten.

Twig-Integration

Die Galerie lässt sich als Twig-Include oder Embed ohne eigenes Inhaltselement verwenden; die Integrationsdokumentation enthält ein Beispiel für Produktbilder mit Lightbox. CSS und Module laden dabei einmal, für eigenes Markup stellt nw_gallery_assets() die Assets bereit.

Entwickelt im Contao-UI-Monorepo, als eigenes Composer-Paket veröffentlicht.

  • Verfügbar

    Carousel

    Beliebige Inhaltselemente als Slides, auf nativem Scroll-Snap. Kein Swiper, auch ohne JavaScript bedienbar.

    Zum Paket

  • Verfügbar

    Dialog und Sheet

    Dialoge, Bottom-Sheets und Offcanvas-Navigation auf dem nativen dialog-Element, mit Wischen und Einrastpunkten.

    Zum Paket

Häufige Fragen

Welche Contao-Versionen unterstützt die Galerie?

Contao 5.7 mit PHP ab 8.3 und Contao 6 mit PHP ab 8.4. Bilder und responsive Bildgrößen stammen aus Contaos Dateiverwaltung und Bildverarbeitung.

Brauche ich Carousel und Sheet zusätzlich?

Die Galerie hängt von nordwerk/contao-carousel-bundle und nordwerk/contao-sheet-bundle ab. Composer beziehungsweise der Contao Manager installiert beide automatisch. Bei Manager-ZIPs müssen alle benötigten Bundles verfügbar sein; beachte die Hinweise des jeweiligen Releases.

Bleiben meine Bilder ohne JavaScript erreichbar?

Ja. Raster und Bilderleiste bleiben sichtbar; große Bilder sind über normale Links erreichbar. JavaScript ergänzt die Lightbox mit Pfeilen, Tastaturbedienung, Touch-Wischen, Escape und Fokus-Rückgabe.

Ersetzt die Galerie die Contao-Kern-Lightbox?

Nein. Vorhandene Kern-Bilder behalten ihre Ausgabe. Die neue Galerie wird als eigenes Inhaltselement angelegt; ein globaler Kern-Lightbox-Ersatz ist zurückgestellt. Wechselnde Formate nutzen ein CSS-Raster mit stabiler Lese- und Tab-Reihenfolge.

Wie passe ich die Galerie an mein Theme an?

Nutze die Twig-Include- oder Embed-Bausteine und die Custom Properties von Carousel und Sheet. Alt-Texte und Bildunterschriften pflegst du in der Dateiverwaltung; die Großansichtsgröße setzt du im Seitenlayout. Prüfe Kontraste und Tastaturbedienung nach Theme-Anpassungen.

Darf ich die Galerie auf Kundenseiten verwenden?

Ja. Galerie, Carousel und Sheet stehen unter der MIT-Lizenz. Kommerzielle Nutzung und Änderungen sind erlaubt; Lizenz- und Copyright-Hinweise müssen bei Weitergabe erhalten bleiben.