335 lines
11 KiB
Markdown
335 lines
11 KiB
Markdown
# 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. |