# 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!

<div align="center">
  <img src="https://git.viper.ipv64.net/M_Viper/Minecraft-Modern-Theme/raw/branch/main/Minecraft-Modern-Theme/screenshot.PNG" alt="Theme Screenshot" style="max-width: 500px; width: 100%; height: auto; border-radius: 8px;">
</div>

---

## 🚀 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.