From a06320d61e6621f6537fca8737f88f2e4092cd6d Mon Sep 17 00:00:00 2001
From: M_Viper <admin@m-viper.de>
Date: Wed, 10 Dec 2025 09:29:22 +0000
Subject: [PATCH] README.md aktualisiert

---
 README.md | 114 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 113 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 0e4d94c..66687f0 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,114 @@
-# Festive-Seasons-Pro
+# 🎉 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.
+
+---