Initial commit - Help Service for Coolify

content/popup-neuigkeiten.md

@@ -0,0 +1,136 @@
+---
+id: popup-neuigkeiten
+title: Pop-up Neuigkeiten
+icon: megaphone
+description: Kurse und Angebote im Pop-up bewerben
+section: Marketing
+tags: [Popup, Marketing, Werbung, Neuigkeiten]
+related: [modules, features, shortcodes]
+order: 1
+---
+
+# Pop-up Neuigkeiten
+
+Bewerben Sie Ihre Kurse mit einem ansprechenden Pop-up auf der Website.
+
+## Modul aktivieren
+
+1. Gehen Sie zu **Kurs Booking > Einstellungen > Module**
+2. Aktivieren Sie **Pop-up Neuigkeiten**
+3. Speichern Sie die Einstellungen
+
+Nach der Aktivierung erscheint im Admin-Menue der neue Punkt **Neuigkeiten**.
+
+## Neuigkeit erstellen
+
+### Schritt 1: Neue Neuigkeit anlegen
+
+1. Klicken Sie auf **Neuigkeiten > Neu hinzufuegen**
+2. Geben Sie einen internen Titel ein (wird nicht im Frontend angezeigt)
+3. Waehlen Sie das **Beitragsbild** - dieses erscheint im Pop-up
+
+### Schritt 2: Pop-up Inhalt
+
+| Feld | Beschreibung |
+|------|--------------|
+| **Ueberschrift** | Titel im Pop-up (z.B. "Neuer Kurs!") |
+| **Beschreibung** | Kurzer Werbetext (2-3 Saetze) |
+| **Button-Text** | Text des CTA-Buttons (Standard: "Mehr erfahren") |
+| **Button-Link** | Optionale URL (siehe unten) |
+
+### Button-Link Verhalten
+
+| Einstellung | Wohin fuehrt der Button? |
+|-------------|--------------------------|
+| **Leer lassen** | Automatisch zur Kurs-Seite des angezeigten Kurses |
+| **URL eintragen** | Zur eingetragenen URL (z.B. Uebersichtsseite) |
+
+> **Tipp:** Lassen Sie das Feld leer, wenn der Button direkt zum beworbenen Kurs fuehren soll. Tragen Sie eine URL ein, wenn Sie auf eine Uebersichtsseite (z.B. alle Webinare) verlinken moechten.
+
+### Schritt 3: Kurse auswaehlen
+
+Es gibt **4 Auswahlmodi**:
+
+| Modus | Beschreibung |
+|-------|--------------|
+| **Einzelne Kurse** | Manuell bestimmte Kurse auswaehlen |
+| **Nach Kategorien** | Alle Kurse einer Kategorie |
+| **Nach Produktarten** | Alle Kurse einer Produktart (z.B. Webinare) |
+| **Alle Kurse** | Zufaellig aus allen Kursen |
+
+> **Tipp:** Bei mehreren Kursen wird bei jedem Seitenaufruf ein **zufaelliger Kurs** angezeigt.
+
+### Was wird zum Kurs angezeigt?
+
+Das Pop-up zeigt automatisch diese Informationen zum gewaehlten Kurs:
+
+| Information | Anzeige |
+|-------------|---------|
+| **Kurs-Titel** | Name des Kurses |
+| **Startdatum** | z.B. "15.01.2025" (falls vorhanden) |
+| **Preis** | z.B. "ab 150 EUR" (falls vorhanden) |
+| **Bild** | Beitragsbild des Kurses (falls kein Neuigkeits-Bild) |
+
+### Schritt 4: Zeitsteuerung
+
+| Option | Beschreibung |
+|--------|--------------|
+| **Startdatum** | Ab wann das Pop-up erscheint |
+| **Enddatum** | Bis wann das Pop-up erscheint |
+
+Lassen Sie beide Felder leer fuer unbegrenzte Anzeige.
+
+## Einstellungen
+
+Im Modul-Tab finden Sie weitere Optionen:
+
+| Einstellung | Beschreibung | Standard |
+|-------------|--------------|----------|
+| **Verzoegerung** | Sekunden bis Pop-up erscheint | 3 Sekunden |
+| **Cookie-Dauer** | Tage bis Pop-up erneut erscheint | 1 Tag |
+
+## Statistiken
+
+Jede Neuigkeit zeigt Statistiken:
+
+| Statistik | Beschreibung |
+|-----------|--------------|
+| **Aufrufe** | Wie oft das Pop-up angezeigt wurde |
+| **Klicks** | Wie oft auf den Button geklickt wurde |
+| **Geschlossen** | Wie oft das X geklickt wurde |
+| **Klickrate** | Prozent der Klicks pro Aufruf |
+
+## Design
+
+Das Pop-up passt sich automatisch an Ihr Theme an:
+
+- **Desktop:** Zentriertes Pop-up mit Overlay
+- **Mobil:** Vollbild-Ansicht fuer beste Lesbarkeit
+- **Schliessen:** X-Button oder Klick auf Overlay
+
+## Mehrere Neuigkeiten
+
+Sie koennen mehrere Neuigkeiten gleichzeitig aktiv haben. Das System zeigt automatisch eine **zufaellige aktive Neuigkeit** pro Besucher.
+
+## Beispiel-Workflow
+
+1. **Neuer Kurs:** Erstellen Sie eine Neuigkeit fuer den neuen Kurs
+2. **Saisonales Angebot:** Zeitlich begrenzte Neuigkeit (z.B. Fruehbucher)
+3. **Kategorie-Werbung:** Alle Webinare bewerben
+
+## Haeufige Fragen
+
+### Pop-up erscheint nicht?
+
+- Pruefen Sie ob das **Modul aktiviert** ist
+- Pruefen Sie das **Start-/Enddatum**
+- Pruefen Sie ob mindestens ein **Kurs ausgewaehlt** ist
+- Loeschen Sie Ihre **Browser-Cookies** (Cookie-Sperre)
+
+### Pop-up erscheint zu oft?
+
+Erhoehen Sie die **Cookie-Dauer** in den Einstellungen.
+
+### Anderes Design gewuenscht?
+
+Das Pop-up verwendet die CSS-Klasse `.kb-news-popup`. Fuer Anpassungen fuegen Sie Custom CSS in Ihrem Theme hinzu.