# Minecraft Modern Theme
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!
---
## 🚀 Hauptfunktionen
### 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
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
---
## 👶 Child Theme verwenden
Für eigene Code-Anpassungen unbedingt das mitgelieferte **Child Theme** verwenden, damit Änderungen bei Updates nicht überschrieben werden.
1. `minecraft-modern-child.zip` hochladen und installieren
2. Child Theme aktivieren
3. Das Haupt-Theme bleibt installiert, darf aber nicht aktiviert sein
---
## ⚙️ Einstellungen im Customizer
Alle Einstellungen unter **Design → Anpassen**.
### Header Slider
- Slider aktivieren/deaktivieren
- Bis zu 5 Bilder, Titel, Untertitel
- Schriftart, -größe, -farbe
- Übergangseffekt (Überblenden, Würfel, …)
- Pfeile und Punkte ausblenden
### Farben & Darstellung
- Akzentfarbe (Buttons, Links, Highlights)
- Hintergrundfarbe
- Standard Dark / Light Mode
### 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
### Social Media Links
Discord, YouTube, Twitter/X, Facebook, Instagram, TikTok, Twitch, Steam, GitHub, LinkedIn, Pinterest, Reddit, TeamSpeak, Spotify
### Footer-Einstellungen
- Copyright-Text
- Impressum- und Datenschutz-URLs
- „Erstellt von"-Verweis ausblenden
### FAQ Einstellungen
- FAQ-System aktivieren/deaktivieren
- Automatische Seitenerstellung
### Team Einstellungen
- Team-Modul aktivieren/deaktivieren
- Automatische Seitenerstellung
### Login-Einstellungen
- Hintergrundbild und Logo
- Bis zu 5 Avatar-UUIDs
- Slider-Geschwindigkeit
### Beitrag Sidebar
- Sidebar ein-/ausschalten
- Position: Links oder Rechts
- **Breadcrumb** ein-/ausschalten
- **Ähnliche Beiträge** ein-/ausschalten
### 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
### Bewerbungsformular
- Aktivieren/Deaktivieren
- Seitentitel und Beschreibungstext
- Erfolgsmeldung nach dem Absenden
- Mindestalter einstellen
---
## 📢 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 Themes ist strafbar und wird rechtlich verfolgt.