# 🎉 Festive Seasons Pro

Verleihe deiner WordPress-Website das ganze Jahr über festliche Magie!  
Mit diesem Plugin werden deine Besucher automatisch von saisonalen Animationen und Effekten überrascht, die genau zum passenden Zeitpunkt erscheinen.

---

## ✨ Funktionen

### 🎯 Magie zur richtigen Zeit: Automatische saisonale Effekte  
Das Plugin erkennt das aktuelle Datum und aktiviert automatisch die passenden grafischen Effekte:

- **Adventszeit & Weihnachten**  
  Sanfter Schneefall, funkelnde goldene Sterne, fliegender Santa Claus und optional stimmungsvolle Weihnachtsmusik

- **Silvester**  
  Spektakuläres Feuerwerk mit aufsteigenden und explodierenden Raketen

- **Halloween**  
  Gruselige Animationen mit fallenden Spinnen

- **Ostern**  
  Bunte, fallende Ostereier

### 🎈 Persönliche Feste: Individuelle Ereignisse  
Füge beliebig viele eigene Ereignisse hinzu – z. B. Geburtstage oder Jubiläen – die mit bunten Ballons und Konfetti gefeiert werden.

---

## ⚙️ Benutzerfreundlich & Flexibel

- **Musik-Einwilligung**  
  Besucher werden freundlich gefragt, bevor die Weihnachtsmusik abgespielt wird. Kann im Backend deaktiviert werden.

- **Shortcode & Widget**  
  Zeige den aktuellen Fest-Anlass überall auf deiner Seite an.

- **Einfache Konfiguration**  
  Alle Feste und individuellen Ereignisse lassen sich im WordPress-Backend bequem aktivieren und deaktivieren.

---

## 📦 Installation

1. **Plugin herunterladen:** Lade das Plugin-Verzeichnis `festive-seasons-pro` herunter.  
2. **Hochladen per FTP:** Lade den Ordner in `wp-content/plugins/`.  
3. **Aktivieren:** Gehe im WordPress-Dashboard zu **Plugins** und aktiviere *Festive Seasons Pro*.

---

## 🔧 Konfiguration

Alle Einstellungen findest du unter:

**Einstellungen → Festive Seasons Pro**

- **Allgemeine Einstellungen:** Musik-Einwilligung aktivieren/deaktivieren  
- **Feste Feiertage:** Saisonale Effekte auswählen  
- **Geburtstage & Jubiläen:** Eigene Ereignisse hinzufügen

---

## 🚀 Nutzung

### Shortcode

Füge folgenden Shortcode in Beiträge, Seiten oder ein Text-Widget ein:

```shortcode
[festive_event]
```

---

## 🧩 Widget

1. Gehe zu **Design → Widgets**
2. Ziehe das Widget **Festive Seasons Anlass** in eine Sidebar
3. Optional: Passe den Titel des Widgets an

---

## 🎄 Alles inklusive – Keine zusätzlichen Assets nötig!

Das Plugin ist vollständig **Plug & Play**.  
Alle Bilder, Sounds und Skripte sind bereits enthalten – ganz ohne zusätzliche Downloads oder externe Dateien.

---

## ❓ Häufige Fragen (FAQ)

### 🎵 Problem: Die Weihnachtsmusik startet nicht

**Lösung:**  
Moderne Browser blockieren das automatische Abspielen von Musik.  
Das Plugin zeigt daher eine Einwilligungsbox an.  
Klicke auf **„Ja“**, um die Musik zu starten.  
Falls dein Browser es trotzdem verhindert, erscheint automatisch ein kleines Bedienfeld zum manuellen Starten der Musik.

---

### ⭐ Problem: Effekte werden nicht angezeigt

**Lösung:**  
In den meisten Fällen liegt es an einem Caching-Problem.

**Browser-Cache leeren:**  
- **Windows:** `Ctrl + F5`  
- **Mac:** `Cmd + Shift + R`

**Caching-Plugin im Einsatz?**  
➡️ Bitte auch dort den Cache löschen.

---