Files
Minecraft-Server-News/README.md
2026-05-11 07:15:21 +00:00

130 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ⛏ Minecraft Server News WordPress Plugin
> Ein WordPress Plugin speziell für Minecraft-Server-Betreiber. Veröffentliche Updates, Events und Ankündigungen direkt auf deiner Website mit modernem Dark-Design im Viper-Network-Stil.
---
## ✨ Features
- 📋 **Eigener Post-Type** „Server News" als eigener Bereich im WordPress-Admin
- 📂 **Kategorien** Update, Event, Wartung, Wichtig, Community (automatisch angelegt)
- 📌 **Anpinnen** Wichtige News bleiben immer ganz oben
- 🏷️ **Badges** NEU, WICHTIG, HOT, BETA, LIVE *(blinkt)*, BALD
- 🖥️ **Server-IP** pro News mit 1-Klick-Kopieren
- 🔍 **Live-Filter** nach Kategorie filtern ohne Seitenreload
- 📦 **Shortcode** News auf jeder beliebigen Seite einbetten
- 🗂️ **Widget** Letzte News in der Sidebar anzeigen
- 🎨 **Dark-Theme** im Cyan/Türkis-Stil passend zum Viper Network
---
## 🚀 Installation
1. Repository als ZIP herunterladen
2. In WordPress: **Plugins → Neu hinzufügen → Plugin hochladen**
3. ZIP auswählen und hochladen
4. Plugin **aktivieren**
> Beim Aktivieren werden die Standard-Kategorien und Permalink-Struktur automatisch eingerichtet.
---
## 🔧 Verwendung
### Shortcode
Füge den Shortcode auf einer beliebigen WordPress-Seite ein:
```
[server_news]
```
**Optionale Parameter:**
| Parameter | Standard | Beschreibung |
|-----------|----------|-------------|
| `anzahl` | `10` | Anzahl der angezeigten News |
| `kategorie` | | Slug(s) filtern, z.B. `update,event` |
| `layout` | `grid` | `grid` oder `list` |
**Beispiele:**
```
[server_news anzahl="6"]
[server_news kategorie="update,event" layout="grid"]
[server_news layout="list" anzahl="5"]
```
---
## 📂 Dateistruktur
```
minecraft-server-news/
├── minecraft-server-news.php # Haupt-Plugin-Datei
├── includes/
│ ├── post-type.php # Custom Post Type Registrierung
│ ├── taxonomy.php # Kategorien (Taxonomie)
│ ├── metaboxes.php # Pinnen, Badge, Server-IP
│ ├── shortcode.php # [server_news] Shortcode
│ ├── widget.php # Sidebar-Widget
│ ├── assets.php # CSS/JS einbinden
│ └── admin-columns.php # Extra-Spalten im Admin
└── assets/
├── css/
│ ├── mcn-style.css # Frontend Dark-Theme
│ └── mcn-admin.css # Admin-Bereich Styles
└── js/
└── mcn-script.js # Filter & IP-Kopieren
```
---
## 🏷️ Kategorien
Folgende Kategorien werden beim Aktivieren automatisch erstellt:
| Emoji | Kategorie |
|-------|-----------|
| 🔄 | Update |
| 🎉 | Event |
| 🔧 | Wartung |
| ⚠️ | Wichtig |
| 👥 | Community |
Eigene Kategorien können unter **Server News → Kategorien** hinzugefügt werden.
---
## ⚙️ News erstellen
1. Im WordPress-Admin auf **⛏ Server News → Neu** klicken
2. Titel und Inhalt verfassen
3. In der rechten Sidebar:
- Kategorie auswählen
- Optional: **Anpinnen** aktivieren
- Optional: **Badge** wählen (NEU, WICHTIG, HOT …)
- Optional: **Server-IP** eintragen
4. Beitragsbild hochladen
5. Veröffentlichen
---
## 🛠️ Anforderungen
| | Mindestversion |
|---|---|
| WordPress | 5.8+ |
| PHP | 7.4+ |
---
## 📄 Lizenz
Dieses Plugin wurde für das **Viper Network** entwickelt und ist für den privaten Gebrauch auf der eigenen WordPress-Installation bestimmt.
---
<div align="center">
<sub>Entwickelt für den Viper Network Minecraft-Server</sub>
</div>