M_Viper/Minecraft-Modern-Theme
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 10 Wiki Activity

README.md aktualisiert

Browse Source
This commit is contained in:
M_Viper
2026-03-19 21:14:49 +00:00
parent 1ad6eda924
commit 383328a6b6
1 changed files with 291 additions and 62 deletions
Download Patch File Download Diff File Expand all files Collapse all files

353
README.md
View File

@@ -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!
<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>
@@ -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.
Die unbefugte Vervielfältigung, Verbreitung oder Weitergabe dieses Themes ist strafbar und wird rechtlich verfolgt.