Contao · MIT-Lizenz

Adventskalender für Contao.

24 Türchen mit Angeboten, Gutscheinen oder Geschichten. Der Server prüft das Datum, vorab lässt sich nichts ansehen.

InstallierenGitHub

Version 0.3.0 vom 06.11.2026 · Contao 5.3 und 6.0 · PHP 8.2+

Installation

Wer Version 0.2 unter dem alten Namen heike-wiese/contao-advent-calendar-bundle installiert hat, entfernt zuerst dieses Paket und installiert dann das neue. Kalender und Türchen bleiben erhalten.

Im Contao Manager nach nordwerk/contao-advent-calendar-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-advent-calendar-bundle
vendor/bin/contao-console contao:migrate

Installationshinweise und Voraussetzungen stehen auch im README.

Was es kann

Ein Kalender hat 24 Türchen, jedes mit Überschrift, Text, Bild, Preis, Gutscheincode und Button. Heute ist das Türchen hervorgehoben, vergangene bleiben auf Wunsch offen, die Reihenfolge lässt sich mischen. Ein Hintergrundbild und leichter Schneefall sind optional.

Ein Türchen kommt erst an seinem Tag vom Server, in der Zeitzone der Website. Für den Abruf gelten dieselben Regeln wie für die Seite, auch der Mitgliederschutz.

Erste Schritte im Backend

  1. Unter Inhalte → Adventskalender einen Kalender anlegen, das Jahr wählen und die Türchen eintragen. Für die ersten Schritte liegt dort schon ein Musterkalender.
  2. Bilder in einen nicht öffentlichen Ordner legen. Die Türchenliste weist auf Bilder in öffentlichen Ordnern hin.
  3. In einem Artikel das Inhaltselement Adventskalender einfügen und den Kalender auswählen.

Gestaltung

Akzentfarbe, Türchenfarbe, Rundung und Mindestgröße der Türchen stehen als CSS-Variablen auf .advent-calendar. Die Vorlagen content_element/advent_calendar.html.twig und advent_calendar/door.html.twig sind in Blöcke geteilt und lassen sich im Template Studio einzeln überschreiben.

Häufige Fragen

Welche Contao-Versionen unterstützt der Kalender?

Contao 5.3 bis 6.0 mit PHP ab 8.2. Geprüft ist jede Version mit einer frischen Installation, in der ein Besucher nur die Türchen bekommt, die schon offen sind.

Kann jemand ein Türchen vor seinem Tag öffnen?

Nein. Ein Türchen kommt erst an seinem Tag vom Server, vorher steht es weder im Quelltext noch in einer Datei der Seite. Bilder gehören dazu in einen nicht öffentlichen Ordner; die Türchenliste im Backend warnt, wenn eins öffentlich liegt.

Gilt der Mitgliederschutz auch für die Türchen?

Ja. Es gelten dieselben Regeln wie für die Seite: Ist Seite, Artikel oder Element unveröffentlicht, abgelaufen oder nur für Mitglieder, bekommen andere Besucher auch keine Türchen.

Kann ich den Kalender vor dem 1. Dezember ausprobieren?

Ja. Bei der ersten Installation legt das Paket einen Musterkalender mit 24 Beispiel-Türchen an. Der Demo-Modus öffnet bis zum 30. November alle Türchen, ab dem 1. Dezember gilt automatisch das Datum.

Wie passe ich Aussehen und Texte an?

Farben und Formen über CSS-Variablen wie --ac-accent, die Vorlagen über das Template Studio, die Texte wie jeden Contao-Text in den Sprachdateien. Deutsch und Englisch sind dabei.

Darf ich das Paket kommerziell einsetzen?

Ja. Das Bundle steht unter der MIT-Lizenz. Der Lizenz- und Copyright-Hinweis muss bei Weitergabe erhalten bleiben.