green-pixelbox/gp-full-background-images

Zeigt vollflächige Hintergrundbilder (mit optionalem Fade-Slider) auf Contao-Seiten an. Bildauswahl und Einstellungen (Vererbung, Overwrite, Timing, Navigation) werden pro Seite/Seitenbaum konfiguriert. Modernisierte Bundle-Neufassung von oneup/contao-full-background-images.

Maintainers

Package info

github.com/green-pixelbox/gp-full-background-images

Homepage

Type:contao-bundle

pkg:composer/green-pixelbox/gp-full-background-images

Transparency log

Statistics

Installs: 4

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.0.1 2026-08-23 14:43 UTC

Requires

LGPL-3.0-or-later d3cbd3bdf6f4f116bf3950af32385627a3bc822a

  • Peter Friedhoff <info.woop@green-pixelbox.de>

backgroundimagesslidercontaofullhintergrundbild

Published on Packagist.org on 2026-08-23 14:44 UTC

This package is auto-updated.

Last update: 2026-08-23 14:44:30 UTC

README

Zeigt vollflächige Hintergrundbilder auf Contao-Seiten an, optional als Fade-Slider mit mehreren Bildern. Die Ausgabe erfolgt als echtes Contao-<picture>-Element (WebP + Fallback, srcset, width/height) mit reinem CSS/object-fit: cover für die vollflächige, zentrierbare Darstellung – keine jQuery-/JS-Bibliothek nötig, das Crossfade zwischen mehreren Bildern läuft über eine kleine eigene Vanilla-JS-Datei. Die Bildauswahl und alle Einstellungen (Timing, Sortierung, Bildgröße) werden direkt am Seitenbaum (tl_page) konfiguriert und können von Unterseiten geerbt oder überschrieben werden.

Modernisierte Neufassung von oneup/contao-full-background-images als Contao-5-Bundle (#[AsHook('generatePage')] statt $GLOBALS['TL_HOOKS'], Studio-Image-API statt Controller::addImageToTemplate()).

Konfiguration

Am Seitenbaum unter der Legende "Contao Full Background Images Funktion":

  • Funktionsmodus (pam / pam_root): Vererbung von übergeordneter Seite, individuelle Bildauswahl oder Deaktivieren.
  • Bildposition (paPositionX, paPositionY, jeweils in % für CSS object-position): auf jeder Seite direkt einstellbar, unabhängig vom Funktionsmodus. Leer = Vererbung von der übergeordneten Seite (Standard, wenn nirgends im Baum gesetzt: 50/50 = mittig).
  • Quelldateien (paSRC): Bilder oder Ordner aus der Dateiübersicht.
  • Auf der Root-Seite zusätzlich: Sortierung, Bildmodus, Bildgröße und Timing als Vorgabe für den gesamten Seitenbaum.
  • Auf normalen Seiten können diese Vorgaben über "Einstellungen überschreiben" (paOverwrite) individuell übersteuert werden.

Abhängigkeiten

Keine – die Ausgabe kommt ohne jQuery oder externe JS-Bibliotheken aus.