Türchen & Inhalte

Was ist ein Türchen?

Ein Türchen (intern: Door) ist ein Slot auf deinem Kalender, der zu einem bestimmten Zeitpunkt „öffnet" und einen beliebigen Inhalt freigibt. Pro Kampagne werden die Türchen beim Anlegen automatisch mit fortlaufender Nummer erzeugt.

Öffnungszeit (opens_at)

Jedes Türchen hat ein opens_at-Datum. Davor ist das Türchen gesperrt (nicht klickbar), danach verfügbar.

• Bei Kampagnentyp advent: Jedes Türchen öffnet um 00:00 Uhr am jeweiligen Tag (Türchen 1 = starts_at, Türchen 2 = +1 Tag usw.).
• Bei allen anderen Typen: Die Öffnungszeiten werden linear zwischen starts_at und ends_at verteilt.

Schließzeit (closes_at, optional)

Wird ein closes_at gesetzt, verschwindet der Inhalt nach diesem Zeitpunkt wieder (Türchen-Status locked). Praktisch für zeitbegrenzte Gutscheine.

Die acht Inhaltstypen

1. Text (text)

Freier Text, bis zu 10.000 Zeichen. Ideal für Geschichten, Zitate oder Rezepte.

content_type: text
content_body: "Heute backen wir Lebkuchen — hier das Rezept …"

2. Bild (image)

Upload eines Bildes (JPG/PNG/WebP, max. 5 MB) plus optionaler Alt-Text. Gespeichert unter storage/app/public/door-images/.

3. Video (video)

Embed-URL (z. B. YouTube/Vimeo) + optionale Bildunterschrift.

embed_url: https://www.youtube.com/embed/dQw4w9WgXcQ
caption:   "Unser Jahresrückblick"

4. Gutschein (coupon)

Gutschein-Code, Überschrift und Beschreibung.

code:        XMAS25
label:       "25 % auf alles"
description: "Gültig bis 31.12., Mindestbestellwert 50 €"

5. Link (link)

Externer Link mit klickbarem Button-Label.

url:   https://shop.example.com/winterangebote
label: "Zum Angebot"

6. Formular (form)

Das Türchen zeigt das Teilnahmeformular der Kampagne. Die Feld-Definition wird zentral unter Formular gepflegt — so können mehrere Türchen dasselbe Formular teilen.

7. Quiz (quiz)

Eine Frage mit 2–6 Antwortoptionen, davon mindestens eine richtig. Nach der Auflösung erscheint optional ein Info-Text.

question:    "Wer schrieb 'Vom Winde verweht'?"
options:
  - text: "Margaret Mitchell"   correct: true
  - text: "Harper Lee"          correct: false
  - text: "Ernest Hemingway"    correct: false
reveal_text: "Margaret Mitchell, 1936 erschienen."

8. Minispiel (minigame)

Bindet eines von elf interaktiven Spielen ein — Memo, Glücksrad, Slot Machine, Quizze, Action-Spiele und mehr. Im Türchen-Editor wählst du das Spiel aus dem Dropdown und legst die lead_position fest (Formular vor, nach oder nie).

Nach dem Speichern erscheint unter dem Spiel ein grüner Link, z. B. „Glücksrad-Segmente verwalten" — dort konfigurierst du die spielspezifischen Parameter (Symbole, Fragen, Schwellwerte). Komplette Übersicht aller Spiele inkl. Tarif-Voraussetzungen im Kapitel Minispiele.

game_slug:     "wheel_of_fortune"
lead_position: after

Tür-Styling mit Fallback-Kaskade

Jedes Türchen kann eigene Hintergrundfarbe, Textfarbe (für die Nummer) und ein Cover-Bild haben. Wird ein Wert leer gelassen, greift die Kaskade:

1. Tür-eigene Werte (cover_image_path, cover_color, cover_text_color)
2. Kampagnen-Standard (door_default_image_path, door_default_color, door_default_text_color)
3. Plattform-Fallback (Emerald-Grün)

Ein Cover-Bild überdeckt immer die Hintergrundfarbe. Das Styling wirkt nur im available-Zustand — geöffnete oder gesperrte Türchen behalten einen neutralen Look.

Türchen-Zustände

„Geöffnet"-Marker im Browser

Sobald ein Besucher ein Türchen öffnet oder ein Minispiel beendet, merkt sich der Browser das im localStorage. Auf der Kalender-Übersicht bekommt das Türchen einen kleinen grünen Haken in der Ecke und ist leicht abgeblendet — so sieht der Besucher beim erneuten Besuch auf einen Blick, was er schon erkundet hat. Kein Server-State, keine Cross-Device-Synchronisation: Reset = Browser-Cache leeren.

„Alle Türchen speichern"

Auf der Türchen-Liste (Kampagne → Türchen) sitzt oben ein grüner Sticky-Balken mit dem Button „Alle Türchen speichern". Damit speicherst du sämtliche Türen sequenziell mit einem Klick — jedes Türchen bekommt einen grünen oder roten Ring als Erfolgs-/Fehler-Feedback. Bei Vollerfolg lädt die Seite automatisch neu. Praktisch, wenn du parallel an mehreren Türchen schreibst.

Übersetzungen pro Türchen

Hat deine Kampagne mehr als eine Sprache freigeschaltet, pflegst du die Inhalte der Primärsprache wie gewohnt im Türchen-Editor — die Übersetzungen in weitere Sprachen liegen auf einer separaten Seite (Kampagne → Sprachen → „Übersetzungen pflegen"). Felder, die du dort leer lässt, fallen automatisch auf den Inhalt der Primärsprache zurück. Details und Setup siehe Sprachen & Übersetzungen.

Bilder austauschen oder entfernen

Neben jedem hochgeladenen Bild (Cover, Türchen-Inhalt, Kampagnen-Hintergrund …) gibt es ein „Bild entfernen"-Häkchen. Setzt du es, wird die Datei beim Speichern aus dem Storage gelöscht und das Feld geleert. Lädst du gleichzeitig eine neue Datei hoch, gewinnt der Upload — die alte Datei wird trotzdem entfernt (sauberer Tausch).