Files
LiteBans-Manager/README.md
2026-01-10 16:29:30 +00:00

85 lines
3.5 KiB
Markdown

# LiteBans Manager ⚡
Die ultimative Lösung, um deine LiteBans Datenbank nahtlos in WordPress zu integrieren. Verwalte Bans, Mutes, Warnings und Kicks direkt im WordPress Admin-Panel und biete deinen Spielern ein modernes Frontend-Dashboard.
## Hauptfunktionen
✅ Live Dashboard mit Dark Mode
✅ Entbannungs-System (CPT-basiert)
✅ Direkter DB-Zugriff auf LiteBans (Remote & Local)
✅ Admin-Workflow mit gesperrten Notizen & Entscheidungen
## 📸 Screenshots
### Frontend Dark Mode
<img src="https://git.viper.ipv64.net/M_Viper/LiteBans-Manager/raw/branch/main/img/01.PNG" width="600">
### Frontend Light Mode
<img src="https://git.viper.ipv64.net/M_Viper/LiteBans-Manager/raw/branch/main/img/02.PNG" width="600">
### Admin Panel Übersicht
<img src="https://git.viper.ipv64.net/M_Viper/LiteBans-Manager/raw/branch/main/img/03.PNG" width="600">
### Admin Panel Antrag Bearbeitung
<img src="https://git.viper.ipv64.net/M_Viper/LiteBans-Manager/raw/branch/main/img/04.PNG" width="600">
## 🚀 Features
### Frontend (für Spieler)
* **Modernes Dashboard**: Spieler können ihre Strafhistory (Bans, Mutes, Warnings, Kicks) übersichtlich einsehen.
* **Dark/Light Mode**: Automatische oder manuelle Umschaltung des Themes.
* **Entbannungsanträge**: Spieler können direkt über das Frontend einen Antrag stellen (Grund, Begründung).
* **Shortcodes**: Einfache Integration per `[litebans_dashboard]` und `[litebans_unban]`.
### Backend (für Admins)
* **CPT Integration**: Entbannungsanträge werden als eigener Post Type in WordPress verwaltet.
* **Sicherer Workflow**:
* Statuswechsel (Ausstehend → Angenommen/Abgelehnt) sperrt die Entscheidung.
* Admin-Notizen werden final gespeichert und nach Entscheidung gesperrt.
* "Gesperrte" Einträge werden in der Listenansicht visuell hervorgehoben.
* **Datenbank Sync**:
* Beim "Annehmen" eines Antrags wird der Ban/Mute ingame direkt aufgehoben (Update der `litebans` DB).
* Verwaltung der LiteBans-Daten direkt im WP Admin (Löschen, Aufheben).
* **Tab-System**: Schnelle Navigation zwischen Bans, Mutes, Warnings und Kicks im Admin-Panel.
## 🛠️ Installation & Konfiguration
### 1. Installation
1. Lade den Ordner `litebans-manager` in dein `/wp-content/plugins/` Verzeichnis hoch.
2. Aktiviere das Plugin im WordPress Admin-Menü unter "Plugins".
### 2. Datenbank-Einrichtung
Gehe im Admin-Menü zu **LiteBans Manager > Einstellungen** und fülle die Zugangsdaten zu deiner LiteBans-Datenbank aus.
* **Host**: Meistens `localhost` (oder die IP der Remote-DB).
* **Datenbank Name**: Der Name der LiteBans DB (z.B. `litebans` oder `minecraft`).
* **User / Pass**: Ein MySQL-Benutzer mit Lese- und Schreibrechten (ReadWrite ist nötig, um Bans aufzuheben).
* **Prefix**: Normalerweise `litebans_` (wichtig, falls deine Tabellen `bans` statt `litebans_bans` heißen).
### 3. Einbindung im Frontend
Erstelle eine neue Seite in WordPress und füge folgenden Shortcode ein:
```text
[litebans_dashboard]
```
## 🧩 Shortcodes
| Shortcode | Beschreibung |
|-----------|--------------|
| `[litebans_dashboard]` | Zeigt die Sanktionen (Bans, Mutes, Warnings, Kicks) an. |
| `[litebans_unban]` | Zeigt nur das Formular für einen Entbannungsantrag an (wird automatisch beim Klick auf "Antrag" im Dashboard geladen). |
## 💻 Entwicklung
Dieses Plugin wurde entwickelt, um die Lücke zwischen Web-Präsenz (WordPress) und Server-Management (LiteBans/Minecraft) zu schließen.
---
## 🤝 Support
Bei Fragen oder Problemen erstelle bitte ein Issue im Repository.