# Popup Banner | Cover72 (mod_popupbanner) 1.0.0

Joomla-Site-Modul: frei konfigurierbares Popup-Banner mit wählbarem Auslöser, Steuerung
nach Seite/Gerät/Häufigkeit/Kampagnenzeitraum und einem Baukasten aus Inhalts-Bausteinen.

Kompatibel: Joomla 5 und 6. Update per erneuter ZIP-Installation, Einstellungen bleiben
dabei erhalten.

## Installation

1. `mod_popupbanner-1.0.0.zip` unter **System → Erweiterungen installieren** hochladen.
2. **Inhalt → Website-Module → Neu → Popup Banner**.
3. Auslöser, Inhalt und Design einstellen (siehe unten), Menüzuweisung setzen,
   veröffentlichen.

## Auslöser (Reiter „Auslöser")

Ein Auslöser pro Modulexemplar. Für mehrere Anlässe (z. B. Exit Intent *und* nach 30
Sekunden) einfach ein zweites Modulexemplar an derselben Position mit eigenen Einstellungen
anlegen – beide arbeiten unabhängig voneinander.

| Auslöser | Wirkung |
| --- | --- |
| Sofort beim Laden | Popup erscheint ohne Verzögerung |
| Nach einer bestimmten Zeit | X Sekunden nach dem Laden |
| Scroll-Prozentsatz | sobald X % der Seite gescrollt sind |
| Element erreicht | sobald ein bestimmtes Element in den sichtbaren Bereich scrollt |
| Klick auf Element | bei Klick auf ein bestimmtes Element |
| Exit Intent | wenn die Maus den oberen Fensterrand verlässt (nur Desktop/Maus); auf
  Touch-Geräten optional ein Zeit-Fallback |

## Anzeige-Steuerung (Reiter „Anzeige-Steuerung")

- **Seiten**: alle / nur diese / außer diesen, eine Regel pro Zeile (`/pfad`, `/pfad/*`
  mit Platzhalter, oder `Itemid:NN`).
- **Gerät**: getrennte Schalter für Desktop/Tablet/Smartphone plus zwei Breakpoints.
- **Anzeigehäufigkeit**: immer / einmal pro Sitzung / einmal pro Tag / alle X Stunden /
  nur einmal überhaupt.
- **Kampagnenzeitraum**: Start- und Enddatum, außerhalb des Zeitraums erscheint kein
  Popup.

## Inhalt (Reiter „Inhalt")

Eine Liste von Bausteinen, per Drag-Griff sortierbar, einzeln aktivierbar/deaktivierbar.
Bausteine: Überschrift, Text, Button/CTA, Link, Badge, Gutscheincode, Countdown, Bild,
YouTube-/Vimeo-Video, Formular, iFrame, eigenes HTML, Trennlinie/Abstand.

Besonderheiten:

- **Video**: nur YouTube und Vimeo, datenschutzfreundlich eingebunden
  (`youtube-nocookie.com`). Ohne „Automatisch abspielen" zeigt das Popup zunächst nur ein
  Vorschaubild.
- **Formular**: reines Weiterleitungsformular, ein Feld pro Zeile im Format
  `name:Beschriftung:Typ:Pflichtfeld`. Das Modul verarbeitet oder speichert nichts selbst.
- **Eigenes HTML**: wird unverändert ausgegeben, wie beim Joomla-Kernmodul „Eigenes HTML".
- **Countdown**: Zieldatum/-uhrzeit wird in der Website-Zeitzone eingegeben und im Browser
  in der jeweiligen Ortszeit des Besuchers heruntergezählt.

Ein Modulexemplar ohne aktive Bausteine wird gar nicht gerendert.

## Design (Reiter „Design")

Position (mittig/oben/unten/Leiste oben/Leiste unten/Kachel unten links/unten rechts),
Breite, Vollbild auf Smartphone, Abdunklung (Farbe + Deckkraft), Hintergrund-/Text-/
Akzentfarbe, Eckenradius, Schatten, Öffnen-Animation, Schließen-Button-Stil, Schließen
über Klick auf Abdunklung/Esc-Taste.

## Sicherheit

Freitext-Felder werden bei der Ausgabe escaped. Alle Adressfelder (Button, Link, Bild,
Formular-Ziel, iFrame, Video) sind auf `http(s)` sowie – wo sinnvoll – seiteninterne Ziele
eingeschränkt, Video-Links nur für erkannte YouTube-/Vimeo-Adressen. Einzige bewusste
Ausnahme ist der Baustein „Eigenes HTML" – funktional identisch mit Joomlas Kernmodul
„Eigenes HTML" und nur für Personen mit Zugriff auf die Moduleinstellungen gedacht.

## Updates

Das Modul meldet sich bei einem eigenen Update-Server, sodass neue Fassungen unter
**System → Aktualisieren → Erweiterungen** angeboten werden – Einstellungen bleiben dabei
erhalten. Bei einer bereits bestehenden Installation ohne diese Funktion muss die aktuelle
ZIP einmal von Hand über **System → Installieren → Erweiterungen** eingespielt werden,
danach laufen alle weiteren Updates automatisch.

Lizenz: GPL-2.0-or-later.