From 383328a6b6095ec722e7e5572a147f05821bf922 Mon Sep 17 00:00:00 2001 From: M_Viper Date: Thu, 19 Mar 2026 21:14:49 +0000 Subject: [PATCH] README.md aktualisiert --- README.md | 353 ++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 291 insertions(+), 62 deletions(-) diff --git a/README.md b/README.md index 5803481..3887fd4 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,6 @@ Ein modernes und flexibles WordPress-Theme, perfekt für Minecraft-Server, Gaming-Communities und Gamer-Blogs. Passe deine Seite mit wenigen Klicks ganz nach deinem Stil an! -
Theme Screenshot
@@ -11,96 +10,326 @@ Ein modernes und flexibles WordPress-Theme, perfekt für Minecraft-Server, Gamin ## 🚀 Hauptfunktionen -- **🎨 Dynamischer Header-Slider:** Zeige bis zu 5 beeindruckende Banner mit individuellem Text, Effekten und Animationen. -- **🌙 Dark & Light Mode:** Lass deine Besucher zwischen einem dunklen und einem hellen Design wählen. -- **🎨 Komplette Farbanpassung:** Wähle deine eigene Akzentfarbe und Hintergrundfarbe, um dein Branding perfekt abzubilden. -- **🌐 Social Media Integration:** Verlinke einfach all deine Kanäle (Discord, YouTube, Twitter, TikTok und viele mehr). -- **📄 Eigenes FAQ-System:** Erstelle und verwalte eine eigene FAQ-Seite direkt im WordPress-Menü, ohne zusätzliche Plugins. -- **🔐 Angepasste Login-Seite:** Gestalte die Login-Seite mit deinem eigenen Logo, Hintergrund und einem coolen Minecraft-Avatar-Slider. -- **⬆️ "Nach oben"-Button:** Ein praktischer Button, der deinen Besuchern das Scrollen erleichtert. +### Design & Layout +- **🎨 Dynamischer Header-Slider** – Bis zu 5 Banner mit individuellem Text, Effekten und Animationen +- **🌙 Dark & Light Mode** – Besucher wählen zwischen dunklem und hellem Design +- **🎨 Komplette Farbanpassung** – Eigene Akzent- und Hintergrundfarbe +- **📱 Responsive Design** – Optimiert für Desktop, Tablet und Smartphone +- **⬆️ „Nach oben"-Button** – Ein- und ausschaltbar im Customizer +- **🔤 4 Menü-Layouts** – Classic, Zentriert, Sidebar, Mega-Menü (wählbar im Customizer) +- **🌐 Social Media Integration** – Discord, YouTube, Twitter, TikTok, Twitch, Steam, GitHub und mehr + +### Inhalts-Module +- **❓ FAQ-System** – Eigene FAQ-Seite mit Kategorien und Tab-Navigation, ohne Plugin +- **👥 Team-Manager** – Teammitglieder mit Minecraft-Avatar (UUID), Rang, Bio und Banner-Bild verwalten +- **🎬 Video-Galerie** – Videos von YouTube, Vimeo, Twitch und MP4-Dateien einbinden; Lightbox-Player, Kategorie-Filter +- **📋 Bewerbungsformular** – Spieler können sich direkt auf der Website bewerben; Einreichungen im Admin-Backend mit Statusverwaltung + +### Header & Navigation +- **📢 Announcement Bar** – Auffällige Leiste oberhalb oder unterhalb des Headers mit individuellem Text, Farbe, Schrift und optionalem Countdown-Timer +- **🔍 Suche im Header** – Suchfeld direkt im Header per Toggle-Button +- **📌 Beitrag Sidebar** – Sidebar auf Einzelbeitrags-Seiten mit Positions- und Inhaltseinstellungen +- **🍞 Breadcrumb** – Ein- und ausschaltbar auf Einzelbeitrags-Seiten + +### DSGVO & Datenschutz +- **🍪 Cookie-Banner (DSGVO)** – 4 Design-Varianten (Schmale Bar, Zweispaltig, Slide-In, Stepper) mit 3 Kategorien (Notwendig, Statistik, Marketing), automatischer iframe-Blockierung und optionaler Google Analytics Integration +- **📄 Shortcode `[cookie_settings]`** – Link zum erneuten Öffnen der Cookie-Einstellungen + +### Login +- **🔐 Angepasste Login-Seite** – Eigenes Logo, Hintergrundbild und Minecraft-Avatar-Slider +- **👤 Avatar-Slider** – Bis zu 5 Minecraft-Avatare per UUID + +### Technisches +- **📦 Import / Export** – Alle Theme-Einstellungen, Widgets, FAQs, Team und Custom CSS exportieren und importieren +- **🔄 Automatische Theme-Updates** – Über Gitea-Repository +- **♿ Barrierefreiheit** – ARIA-Labels, Keyboard-Navigation, Focus-States --- -## 📦 Installation (in 3 einfachen Schritten) +## 📦 Installation -1. **Lade das Theme herunter:** Lade die `minecraft-modern.zip`-Datei herunter. -2. **Lade es in WordPress hoch:** - * Gehe in deinem WordPress-Adminbereich zu **Design > Themes > Installieren**. - * Klicke auf den Button **Theme hochladen**. - * Wähle die heruntergeladene `minecraft-modern.zip`-Datei aus und installiere sie. -3. **Aktiviere das Theme:** Klicke nach der Installation auf **Aktivieren**. Fertig! +1. **Lade das Theme herunter** – `minecraft-modern.zip` herunterladen +2. **In WordPress hochladen** – Dashboard → Design → Themes → Installieren → Theme hochladen +3. **Aktivieren** – Nach der Installation auf „Aktivieren" klicken --- -## 👶 Wichtig: Nutze das Child Theme! +## 👶 Child Theme verwenden -Wenn du planst, Anpassungen vorzunehmen (z.B. Farben per Code ändern oder PHP-Dateien bearbeiten), solltest du unbedingt das mitgelieferte **Child Theme** verwenden. +Für eigene Code-Anpassungen unbedingt das mitgelieferte **Child Theme** verwenden, damit Änderungen bei Updates nicht überschrieben werden. -**Warum?** Damit deine persönlichen Anpassungen bei einem Theme-Update nicht überschrieben werden! - -### Installation des Child Themes (Der einfache Weg) - -1. **Lade das Child Theme herunter:** Lade die `minecraft-modern-child.zip`-Datei herunter. -2. **Lade es in WordPress hoch:** - * Gehe zu **Design > Themes > Installieren**. - * Klicke auf **Theme hochladen**. - * Wähle die `minecraft-modern-child.zip`-Datei aus und installiere sie. -3. **Aktiviere das Child Theme:** Klicke auf **Aktivieren**. - -**Wichtig:** Das Haupt-Theme (Minecraft Modern) muss weiterhin installiert bleiben, darf aber nicht aktiviert sein. WordPress erkennt dies automatisch. +1. `minecraft-modern-child.zip` hochladen und installieren +2. Child Theme aktivieren +3. Das Haupt-Theme bleibt installiert, darf aber nicht aktiviert sein --- -## ⚙️ So passt du dein Theme an +## ⚙️ Einstellungen im Customizer -Gehe in deinem WordPress-Dashboard zu **Design > Anpassen**, um in die Einstellungen zu gelangen. +Alle Einstellungen unter **Design → Anpassen**. -### 1. Header-Slider einrichten +### Header Slider +- Slider aktivieren/deaktivieren +- Bis zu 5 Bilder, Titel, Untertitel +- Schriftart, -größe, -farbe +- Übergangseffekt (Überblenden, Würfel, …) +- Pfeile und Punkte ausblenden -Unter dem Punkt **Header Slider** kannst du: -- Den Slider mit einem Haken aktivieren. -- Bis zu 5 **Bilder, Titel und Untertitel** hochladen. -- Die **Schriftart, -größe und -farbe** anpassen. -- Einen **Effekt** auswählen (z.B. Überblenden oder Würfel). -- Die **Pfeile** oder **Punkte** zur Navigation ausblenden. +### Farben & Darstellung +- Akzentfarbe (Buttons, Links, Highlights) +- Hintergrundfarbe +- Standard Dark / Light Mode -### 2. Farben & Design auswählen +### Menü-Design +- **Classic** – Logo links, Menü Mitte, Icons rechts +- **Zentriert** – Logo oben, Menü darunter +- **Sidebar** – Vertikale Menüleiste +- **Mega-Menü** – Breite Dropdown-Spalten +- Logo-/Titel-Position: Links, Mitte, Rechts -Unter **Farben & Darstellung** findest du: -- **Akzentfarbe:** Die Hauptfarbe deines Themes (wird für Buttons, Links etc. verwendet). -- **Hintergrundfarbe:** Die Farbe des Seitenhintergrunds. -- **Standard-Theme-Modus:** Entscheide, ob deine Seite standardmäßig im Dark- oder Light-Mode starten soll. +### Social Media Links +Discord, YouTube, Twitter/X, Facebook, Instagram, TikTok, Twitch, Steam, GitHub, LinkedIn, Pinterest, Reddit, TeamSpeak, Spotify -### 3. Social-Media-Links hinzufügen +### Footer-Einstellungen +- Copyright-Text +- Impressum- und Datenschutz-URLs +- „Erstellt von"-Verweis ausblenden -Im Menüpunkt **Social Media Links** kannst du bei den jeweiligen Plattformen einfach deine URL eintragen. Die Icons erscheinen dann automatisch an der vorgesehenen Stelle. +### FAQ Einstellungen +- FAQ-System aktivieren/deaktivieren +- Automatische Seitenerstellung -### 4. Footer anpassen +### Team Einstellungen +- Team-Modul aktivieren/deaktivieren +- Automatische Seitenerstellung -Unter **Footer-Einstellungen** kannst du: -- Den **Copyright-Text** ändern. -- Die URLs für dein **Impressum** und die **Datenschutz**-Seite einfügen. -- Den "Erstellt von"-Verweis am Ende der Seite ausblenden. +### Login-Einstellungen +- Hintergrundbild und Logo +- Bis zu 5 Avatar-UUIDs +- Slider-Geschwindigkeit -### 5. FAQs erstellen +### Beitrag Sidebar +- Sidebar ein-/ausschalten +- Position: Links oder Rechts +- **Breadcrumb** ein-/ausschalten +- **Ähnliche Beiträge** ein-/ausschalten -1. Gehe zu **FAQ Einstellungen** und setze einen Haken bei "FAQ System aktivieren". -2. Das Theme erstellt automatisch eine neue Seite namens "FAQ" und einen neuen Menüpunkt **FAQs** in deinem WordPress-Dashboard. -3. Unter **FAQs > Neue FAQ hinzufügen** kannst du jetzt deine Fragen und Antworten erstellen. Du kannst sie sogar in Kategorien sortieren! +### Cookie-Banner (DSGVO) +- Aktivieren/Deaktivieren +- **4 Design-Varianten:** + - Variante 1 – Schmale Bar (volle Breite) + - Variante 2 – Zweispaltig (3A) + - Variante 3 – Slide-In von rechts (3B) + - Variante 4 – Kompakt-Center mit Stepper (3C) +- Banner-Text +- URL zur Datenschutzerklärung +- Beschreibungen für alle 3 Cookie-Kategorien +- Google Analytics ID (wird nur nach Zustimmung geladen) +- Cookie-Laufzeit in Tagen +- Live-Vorschau direkt im Customizer -### 6. Login-Seite gestalten - -Unter **Login-Einstellungen** kannst du: -- Ein **Hintergrundbild** und ein **Logo** für die Login-Seite hochladen. -- Bis zu 5 **Minecraft-Avatar-UUIDs** eintragen, um einen dynamischen Avatar-Slider zu erzeugen. (Eine UUID findest du z.B. auf [minotar.net](https://minotar.net/)). -- Die **Geschwindigkeit** des Avatar-Wechsels einstellen. +### Bewerbungsformular +- Aktivieren/Deaktivieren +- Seitentitel und Beschreibungstext +- Erfolgsmeldung nach dem Absenden +- Mindestalter einstellen --- -Viel Spaß mit deinem neuen Theme! 🎮✨ +## 📢 Announcement Bar (Admin-Menü) + +Eigener Menüpunkt **„Ankündigung"** im WordPress-Admin. + +- Text mit HTML und Icons +- Hintergrund- und Textfarbe +- Schriftfamilie und -größe (30+ Google Fonts) +- Position: Über oder unter dem Header +- **Countdown-Timer** – Zieldatum und Ablauf-Nachricht einstellbar +- Live-Vorschau direkt auf der Admin-Seite + +--- + +## 👥 Team Manager (Admin-Menü) + +Eigener Menüpunkt **„Team Manager"** im WordPress-Admin. + +- Mitglieder hinzufügen, bearbeiten, löschen +- **Minecraft UUID** → Avatar wird automatisch geladen +- Alternativ: eigenes Avatar-Bild hochladen +- Banner-Bild pro Mitglied +- Sortierung per Drag & Drop (▲▼) +- Rang/Position, Bio, alle Felder inline editierbar + +--- + +## 🎬 Video-System + +### Verwaltung +Menüpunkt **„Videos"** im WordPress-Admin. + +- Titel, Vorschaubild, Beschreibung +- Video-URL einfügen (normale Seiten-URL reicht) +- Shortcode wird automatisch angezeigt und kann kopiert werden +- Kategorie zum Filtern + +### Unterstützte Plattformen +| Plattform | Beispiel-URL | +|-----------|-------------| +| YouTube | `https://www.youtube.com/watch?v=…` | +| YouTube Shorts | `https://youtube.com/shorts/…` | +| Vimeo | `https://vimeo.com/123456` | +| Twitch VOD | `https://twitch.tv/videos/123456` | +| Twitch Stream | `https://twitch.tv/kanalname` | +| Direkte MP4 | `https://example.com/video.mp4` | + +### Galerie-Seite +Automatisch unter `deine-seite.de/videos/` erreichbar. +- Grid-Layout mit Thumbnail (YouTube-Thumbnail automatisch) +- Lightbox-Player beim Klick +- Kategorie-Filter-Tabs +- Plattform-Badge je Video + +### Shortcode +``` +[mm_video url="https://www.youtube.com/watch?v=VIDEOID"] +``` + +--- + +## 📋 Bewerbungsformular + +### Formular-Felder +- Minecraft Username (mit Live-Avatar-Vorschau) +- Discord Username +- Alter (mit Mindestalter-Prüfung) +- Warum möchtest du mitspielen? (mit Zeichenzähler) +- Erfahrung & Vorstellung (mit Zeichenzähler) + +### Admin-Backend +Menüpunkt **„Bewerbungen"** im WordPress-Admin. + +- Übersichtstabelle mit Avatar, MC-Name, Discord, Alter, Status +- Detailansicht mit allen Antworten +- **Status pro Bewerbung:** Neu / In Prüfung / Angenommen / Abgelehnt +- Interne Notiz pro Bewerbung +- Doppelbewerbungsschutz (gleicher MC-Name: 30 Tage Sperre) + +### Aktivierung +Customizer → „Bewerbungsformular" → Checkbox aktivieren +→ Seite `deine-seite.de/bewerbung/` wird automatisch angelegt + +--- + +## 🍪 Cookie-Banner (DSGVO) + +### 3 Kategorien +| Kategorie | Beschreibung | +|-----------|-------------| +| Notwendige | Immer aktiv, nicht deaktivierbar | +| Statistik | Google Analytics (wird nach Zustimmung geladen) | +| Marketing | YouTube, Vimeo, Twitch, Facebook, Instagram u.v.m. | + +### Automatische iframe-Blockierung +Folgende Embeds werden automatisch blockiert bis Marketing akzeptiert wird: +YouTube, Vimeo, Google Maps, Facebook, Twitter, TikTok, Instagram, Spotify, Twitch + +### PHP-Hilfsfunktionen +```php +// Prüfen ob Kategorie akzeptiert wurde +if ( mm_cookie_accepted('statistics') ) { /* Analytics-Code */ } +if ( mm_cookie_accepted('marketing') ) { /* Marketing-Code */ } +``` + +### Shortcode für Datenschutzseite +``` +[cookie_settings text="Cookie-Einstellungen ändern"] +``` + +--- + +## 📄 Verfügbare Template-Dateien + +| Datei | Beschreibung | +|-------|-------------| +| `front-page.php` | Startseite mit Slider und Sidebar | +| `single.php` | Einzelbeitrag mit Breadcrumb, Related Posts, Sidebar | +| `archive.php` | Kategorie- und Tag-Archive | +| `archive-team.php` | Team-Übersicht | +| `archive-faq.php` | FAQ-Seite mit Tabs | +| `archive-video.php` | Video-Galerie | +| `page-bewerbung.php` | Bewerbungsformular | +| `page-login.php` | Angepasste WordPress-Login-Seite | +| `search.php` | Suchergebnisse | +| `404.php` | Fehlerseite im Minecraft-Stil | +| `comments.php` | Kommentarbereich | + +--- + +## 🔧 Shortcode-Übersicht + +| Shortcode | Beschreibung | +|-----------|-------------| +| `[mm_video url="URL"]` | Video einbetten (YouTube, Vimeo, Twitch, MP4) | +| `[cookie_settings]` | Link zum Öffnen der Cookie-Einstellungen | +| `[cookie_settings text="…"]` | Mit eigenem Linktext | + +--- + +## 📥 Import / Export + +Unter **Design → Anpassen → Import/Export** kannst du alle Theme-Einstellungen sichern: + +**Enthält:** +- Alle Customizer-Einstellungen +- Announcement Bar Einstellungen +- Widget-Konfigurationen +- Team-Mitglieder +- FAQ-Einträge +- Custom CSS +- Menü-Positionen + +--- + +## 🗂️ Verzeichnisstruktur + +``` +minecraft-modern/ +├── inc/ +│ ├── customizer.php – Customizer-Einstellungen +│ └── theme-updater.php – Automatische Updates via Gitea +├── js/ +│ ├── header-scroll.js – Header-Scroll-Effekt + Suche-Toggle +│ ├── navigation.js – Menü-Toggle + Dropdown +│ ├── slider-init.js – Swiper.js Initialisierung +│ ├── theme-toggle.js – Dark/Light Mode +│ ├── announcement.js – Announcement Bar + Countdown +│ ├── login-slider.js – Avatar-Slider auf Login-Seite +│ ├── faq-accordion.js – FAQ Accordion +│ └── scroll-to-top.js – Nach-oben-Button +├── css/ +│ ├── announcement.css – Announcement Bar Styles +│ └── login-style.css – Login-Seite Styles +├── functions.php – Haupt-Funktionsdatei +├── style.css – Haupt-Stylesheet +└── screenshot.PNG – Theme-Vorschaubild +``` + +--- + +## 📜 Changelog + +### Version aktuell +- ✅ Cookie-Banner mit 4 Design-Varianten und DSGVO-Konformität +- ✅ Video-System mit YouTube, Vimeo, Twitch, MP4 +- ✅ Bewerbungsformular mit Admin-Backend +- ✅ Breadcrumb und Ähnliche Beiträge (ein-/ausschaltbar) +- ✅ 4 Menü-Layout-Varianten +- ✅ Announcement Bar mit Countdown +- ✅ Team Manager mit UUID-Avatar +- ✅ Import/Export komplett --- **Copyright © 2026 - M_Viper - Alle Rechte vorbehalten** -Die unbefugte Vervielfältigung, Verbreitung oder Weitergabe dieses Plugins ist strafbar und wird rechtlich verfolgt. \ No newline at end of file +Die unbefugte Vervielfältigung, Verbreitung oder Weitergabe dieses Themes ist strafbar und wird rechtlich verfolgt. \ No newline at end of file