# Adventskalender | Cover72 (pkg_cover72advent) 1.0.2

Joomla-Paket mit Komponente (com_cover72advent) und Modul (mod_cover72advent) für Joomla **4.4+/5/6** (PHP 8.1+). Eigenentwicklung von cover72, Lizenz GPL-2.0-or-later.

## Installation

`pkg_cover72advent-1.0.2.zip` unter **System → Erweiterungen → Installieren** hochladen (Updates einfach darüber installieren, Inhalte bleiben erhalten). Danach im Backend unter **Komponenten → Adventskalender**:

- **Dashboard** – Übersicht je Kalender: Status, alle Türchen als Mini-Raster (befüllt/leer/offen/heute), Aufrufzahlen, Warnung vor leeren Türchen kurz vor dem Öffnen, Vorschau für ein beliebiges Datum.
- **Kalender** – Kalender anlegen und einstellen.
- **Türchen** – Inhalte pflegen (Bild, Text, optional Link-Knopf).

## Einrichten

1. **Kalender → Neu**: Titel, Startdatum (Türchen 1), Anzahl Türchen (24). Beim Speichern werden die Türchen automatisch angelegt.
2. **Darstellung**: Hintergrundbild, Spaltenzahl Desktop/Tablet/Handy, Seitenverhältnis der Türchen.
3. **Türchen**: Zahlen (automatisch) oder eigene Bilder (door_1.png … door_24.png aus einem Ordner in images/).
4. **Öffnen**: Uhrzeit der Öffnung, ob ältere Türchen offen bleiben, Verhalten bei Klick auf ein gesperrtes Türchen.
5. **Popup**: Überschrift (Datum/Türchen-Nummer/Titel), Animation, Farbschema, Breite.
6. Türchen befüllen, z. B. mit Bild und Text.

## Türchen per Excel befüllen

**Türchen → Excel-Import/-Export**: Vorlage herunterladen (enthält alle aktuellen Inhalte), Spalten Tag/Titel/Text/Bild/Bild-Alternativtext/Link/Linktext/Veröffentlicht/Türchen-Bild ausfüllen (nur „Tag" ist Pflicht), Bilder vorher in der Medienverwaltung hochladen, Datei (.xlsx oder .csv) wieder hochladen. Leere Zellen lassen bestehende Inhalte unverändert.

## Auf die Website bringen

Im SP Page Builder: Modul „Adventskalender | Cover72" anlegen (Inhalt → Site-Module → Neu), Kalender wählen, im Page Builder mit dem Addon „Modul" einbinden. Alternativ als Menüpunkt (Menütyp Adventskalender → Kalender).

## Testen vor dem Start

Im Dashboard beim Kalender ein Datum wählen und Vorschau klicken – zeigt den Kalender, als wäre dieser Tag schon erreicht. Vorschau-Link ist signiert, zeitlich begrenzt gültig und zählt nicht in die Statistik.

## Sicherheit & Datenschutz

Inhalte gesperrter Türchen stehen nicht im Seitenquelltext, sondern werden erst beim Klick vom Server geholt und serverseitig geprüft. Keine Cookies, keine externen Dienste. Unveröffentlichte Kalender sind nur über den Vorschau-Link sichtbar.