README.md aktualisiert
This commit is contained in:
711
README.md
711
README.md
@@ -1,499 +1,290 @@
|
|||||||
# 💬 WP Business Forum
|
# WP Business Forum - Anwender README
|
||||||
|
|
||||||
**Ein vollständiges, eigenständiges Forum-Plugin für WordPress** — mit eigenem Login-System, dynamischen Rollen, Privatnachrichten, BBCode, Level-System, Moderations-Tools und vielem mehr.
|
WP Business Forum bringt ein modernes, eigenständiges Community-Forum direkt in deine WordPress-Website.
|
||||||
|
Statt auf externe Plattformen auszuweichen, bleiben Diskussionen, Support-Anfragen und Mitgliederaktivität
|
||||||
|
zentral auf deiner eigenen Seite - inklusive voller Kontrolle über Inhalte, Rollen und Moderation.
|
||||||
|
|
||||||
> **Version 2.0.0** · Getestet mit WordPress 6.x · PHP 8.0+ · MySQL 5.7+
|
Diese Dokumentation richtet sich an Betreiber, Moderatoren und Community-Manager, die das Forum
|
||||||
|
schnell einrichten, sicher betreiben und im Alltag effizient verwalten möchten. Von der ersten
|
||||||
|
Installation bis zum Live-Betrieb findest du hier alle wichtigen Schritte und Funktionen kompakt erklärt.
|
||||||
|
|
||||||
---
|
Wenn du eine professionelle Community mit klaren Rechten, direkter Nutzerkommunikation und
|
||||||
|
strukturierter Moderation aufbauen willst, ist WP Business Forum dafür ausgelegt.
|
||||||
|
|
||||||
## 📋 Inhaltsverzeichnis
|
## Inhalt
|
||||||
|
1. Über das Plugin
|
||||||
|
2. Funktionsübersicht
|
||||||
|
3. Voraussetzungen
|
||||||
|
4. Installation
|
||||||
|
5. Ersteinrichtung (Setup-Wizard)
|
||||||
|
6. Forum-Seite einbinden
|
||||||
|
7. Bedienung im Frontend (Mitglieder)
|
||||||
|
8. Moderation und Verwaltung
|
||||||
|
9. Einstellungen im Detail
|
||||||
|
10. Export, Import und Deinstallation
|
||||||
|
11. FAQ / Troubleshooting
|
||||||
|
|
||||||
- [Features](#-features)
|
## 1) Über das Plugin
|
||||||
- [Installation](#-installation)
|
WP Business Forum ist ein eigenständiges Foren-System für WordPress mit:
|
||||||
- [Erster Start — Setup-Wizard](#-erster-start--setup-wizard)
|
- eigenem Forum-Login (unabhängig vom WP-Login)
|
||||||
- [Shortcode](#-shortcode)
|
- Rollen- und Rechteverwaltung
|
||||||
- [Admin-Bereich](#-admin-bereich)
|
- Kategorien mit Hierarchie
|
||||||
- [Rollen & Berechtigungen](#-rollen--berechtigungen)
|
- Moderationswerkzeugen
|
||||||
- [Level-System](#-level-system)
|
- Direktnachrichten, Benachrichtigungen, Meldesystem
|
||||||
- [BBCode-Referenz](#-bbcode-referenz)
|
- Umfragen, Tags, Reaktionen, Lesezeichen
|
||||||
- [Dateistruktur](#-dateistruktur)
|
|
||||||
- [Datenbank-Tabellen](#-datenbank-tabellen)
|
|
||||||
- [Export & Import](#-export--import)
|
|
||||||
- [FAQ](#-faq)
|
|
||||||
|
|
||||||
---
|
Das Forum wird per Shortcode in eine WordPress-Seite eingebunden.
|
||||||
|
|
||||||
## ✨ Features
|
## 2) Funktionsübersicht
|
||||||
|
### Für Mitglieder
|
||||||
|
- Registrieren / Einloggen / Logout
|
||||||
|
- Passwort vergessen und Reset per E-Mail
|
||||||
|
- Threads erstellen, antworten, bearbeiten
|
||||||
|
- Likes und Emoji-Reaktionen
|
||||||
|
- Tags und Thread-Präfixe
|
||||||
|
- Umfragen erstellen und abstimmen
|
||||||
|
- Lesezeichen setzen
|
||||||
|
- Nutzer erwähnen mit @mention
|
||||||
|
- Private Nachrichten (DM)
|
||||||
|
- Profil mit Avatar, Bio, Signatur und eigenen Profilfeldern
|
||||||
|
- Mitgliederliste und Suchfunktion
|
||||||
|
|
||||||
### 🔐 Eigenes Login-System
|
### Für Moderation / Admin
|
||||||
- Komplett unabhängig vom WordPress-Backend — Forum-Nutzer brauchen keinen WP-Account
|
- Threads pinnen, schließen, archivieren, verschieben, löschen
|
||||||
- Registrierung direkt im Forum-Frontend
|
- Beiträge löschen
|
||||||
- **Remember-Me** Cookie (30 Tage)
|
- Meldungen (Reports) bearbeiten
|
||||||
- **Passwort vergessen** mit sicherem Reset-Link per E-Mail (1 Stunde gültig)
|
- Kategorien und Rollen verwalten
|
||||||
- **Auto-Logout** bei Inaktivität (einstellbar: 5 Min. bis 8 Std.)
|
- Einladungssystem für Registrierung
|
||||||
- Groß-/Kleinschreibung beim Login egal
|
- Wartungsmodus
|
||||||
|
- Wortfilter
|
||||||
|
- Statistiken
|
||||||
|
- Papierkorb / Wiederherstellung
|
||||||
|
- Export / Import
|
||||||
|
|
||||||
### 📁 Kategorien & Threads
|
## 3) Voraussetzungen
|
||||||
- **Eltern-Kind-Hierarchie** — unbegrenzte Verschachtelung
|
- Laufende WordPress-Installation
|
||||||
- Threads erstellen, bearbeiten (Titel + Inhalt), löschen
|
- Schreibrechte für WordPress-Uploads (für Avatar-/Bild-Uploads)
|
||||||
- **Pinnen** und **Schließen** von Threads (Moderatoren+)
|
- Funktionierende E-Mail-Zustellung in WordPress (für Passwort-Reset und Benachrichtigungen)
|
||||||
- **Thread-Tags** für bessere Auffindbarkeit
|
|
||||||
- **Views-Counter** pro Thread
|
|
||||||
- **Breadcrumb-Navigation** durch die gesamte Hierarchie
|
|
||||||
- **Kategorie-Zugangsbeschränkung** per Mindest-Rolle
|
|
||||||
|
|
||||||
### 💬 Posts & Interaktion
|
Hinweis: Das Plugin nutzt eigene Datenbanktabellen (Präfix `wp_forum_*` bzw. mit deinem Tabellenpräfix).
|
||||||
- Antworten mit **Live-Vorschau** (kein Seitenreload)
|
|
||||||
- **Like-System** für Threads und Posts
|
|
||||||
- **Emoji-Reaktionen** (👍 ❤️ 😂 😮 😢 🔥)
|
|
||||||
- **Zitieren** mit automatischem `[quote=Name]`-BBCode
|
|
||||||
- **@Erwähnungen** — klickbare Profil-Links
|
|
||||||
- **Beiträge melden** mit Begründung
|
|
||||||
- Posts und Thread-Titel nachträglich bearbeiten
|
|
||||||
|
|
||||||
### 🛡️ Rollen-System
|
## 4) Installation
|
||||||
6 Standard-Rollen + beliebig viele eigene Rollen:
|
1. Plugin-Ordner `wp-business-forum` in `wp-content/plugins/` kopieren.
|
||||||
|
2. Im WordPress-Backend unter Plugins aktivieren.
|
||||||
|
3. Nach der Aktivierung startet einmalig der Setup-Wizard.
|
||||||
|
|
||||||
| Rolle | Level | Besonderheit |
|
## 5) Ersteinrichtung (Setup-Wizard)
|
||||||
|---|---|---|
|
Nach Aktivierung führt der Wizard durch 3 Schritte:
|
||||||
| 👑 Superadmin | 100 | Automatisch an WP-Administrator gebunden — unveränderlich |
|
|
||||||
| 🔴 Admin | 80 | Vollständige Verwaltung |
|
|
||||||
| 🟡 Moderator | 50 | Moderation von Threads & Posts |
|
|
||||||
| 🔵 VIP | 20 | Eigenes Badge |
|
|
||||||
| ⚪ Member | 10 | Standard für neue Nutzer |
|
|
||||||
| ⛔ Gesperrt | -1 | Kein Forum-Zugang |
|
|
||||||
|
|
||||||
Jede Rolle ist vollständig anpassbar: Label, Level, Farbe, Icon (FontAwesome), Permissions.
|
1. Superadmin-Konto erstellen oder bestehendes Forum-Konto hochstufen
|
||||||
|
2. Optional automatisch eine Forum-Seite erzeugen
|
||||||
|
3. Abschluss
|
||||||
|
|
||||||
### ⭐ Level-System
|
Wichtig:
|
||||||
Automatisches Level basierend auf Beitragsanzahl (kann deaktiviert werden):
|
- Der Superadmin ist fest mit dem WordPress-Admin verknüpft.
|
||||||
|
- Wenn noch kein Superadmin existiert, erscheint im Backend ein Hinweisbanner.
|
||||||
|
|
||||||
| Level | Ab Beiträgen | Icon |
|
## 6) Forum-Seite einbinden
|
||||||
|---|---|---|
|
Das Forum wird mit folgendem Shortcode auf einer WordPress-Seite angezeigt:
|
||||||
| 🌱 Neuling | 0 | `fas fa-seedling` |
|
|
||||||
| 🪶 Schreiberling | 10 | `fas fa-feather` |
|
|
||||||
| 🔥 Erfahrener | 50 | `fas fa-fire` |
|
|
||||||
| 🛡️ Veteran | 150 | `fas fa-shield-halved` |
|
|
||||||
| 👑 Legende | 500 | `fas fa-crown` |
|
|
||||||
|
|
||||||
Levels sind im Admin vollständig anpassbar — Bezeichnung, Schwellenwert, Icon, Farbe.
|
```text
|
||||||
|
|
||||||
### 👤 Profile
|
|
||||||
- Eigenes Avatar-Bild (Upload oder Gravatar)
|
|
||||||
- Anzeigename, Bio und **Signatur** (max. 300 Zeichen, erscheint unter jedem Beitrag)
|
|
||||||
- Profil-Seite mit Beitragsübersicht und Fortschrittsbalken
|
|
||||||
- **Mitgliederliste** (nur für eingeloggte Nutzer) mit Suche und Sortierung
|
|
||||||
|
|
||||||
### ✉️ Privatnachrichten
|
|
||||||
- Direktnachrichten zwischen Nutzern
|
|
||||||
- **Posteingang** mit Konversations-Übersicht
|
|
||||||
- Ungelesene Nachrichten werden im Topbar angezeigt
|
|
||||||
- **Ältere Nachrichten laden** (Pagination)
|
|
||||||
- Nachrichten löschen
|
|
||||||
|
|
||||||
### 🔔 Benachrichtigungen
|
|
||||||
- In-App-Glocke in der Topbar mit Badge
|
|
||||||
- E-Mail-Benachrichtigungen bei:
|
|
||||||
- Antwort auf eigenen Thread
|
|
||||||
- @Erwähnung
|
|
||||||
- Neue Privatnachricht
|
|
||||||
- Benachrichtigungen als gelesen markieren
|
|
||||||
|
|
||||||
### 🔍 Suche
|
|
||||||
- Volltextsuche in Threads und Posts
|
|
||||||
- Live-Vorschläge bei der Eingabe
|
|
||||||
- Ergebnisse mit Kategorie und Datum
|
|
||||||
|
|
||||||
### 🔧 Moderations-Tools
|
|
||||||
- Thread pinnen / entpinnen
|
|
||||||
- Thread schließen / öffnen
|
|
||||||
- Thread in andere Kategorie verschieben
|
|
||||||
- Posts und Threads löschen
|
|
||||||
- Meldungs-System mit Admin-Dashboard
|
|
||||||
- Nutzer sperren mit Sperrgrund (wird beim Login angezeigt)
|
|
||||||
|
|
||||||
### ⚙️ Admin-Backend
|
|
||||||
- **Übersicht** mit Echtzeit-Statistiken
|
|
||||||
- **Kategorien** verwalten (Hierarchie, Icons, Min-Rolle)
|
|
||||||
- **Rollen** erstellen, bearbeiten, löschen
|
|
||||||
- **Level** konfigurieren
|
|
||||||
- **Mitglieder** verwalten — Rolle, E-Mail, Passwort, Anzeigename ändern
|
|
||||||
- **Meldungen** bearbeiten (offen / erledigt / verworfen)
|
|
||||||
- **Einstellungen** — alle Forum-Texte anpassbar, kein Code nötig
|
|
||||||
- **Export / Import** — vollständige Datensicherung
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 Installation
|
|
||||||
|
|
||||||
### Methode 1 — ZIP hochladen (empfohlen)
|
|
||||||
1. Lade das Repository als `.zip` herunter
|
|
||||||
2. WordPress-Admin → **Plugins** → **Installieren** → **Plugin hochladen**
|
|
||||||
3. ZIP auswählen und installieren
|
|
||||||
4. Plugin **aktivieren**
|
|
||||||
|
|
||||||
### Methode 2 — FTP / Dateimanager
|
|
||||||
1. Lade den Ordner `wp-business-forum` auf deinen Server hoch
|
|
||||||
2. Zielverzeichnis: `/wp-content/plugins/wp-business-forum/`
|
|
||||||
3. WordPress-Admin → Plugins → **WP Business Forum** aktivieren
|
|
||||||
|
|
||||||
### Voraussetzungen
|
|
||||||
- WordPress **6.0+**
|
|
||||||
- PHP **8.0+**
|
|
||||||
- MySQL **5.7+** oder MariaDB **10.3+**
|
|
||||||
- `wp_mail()` für E-Mail-Benachrichtigungen (Standard-WP-Mailer)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🧙 Erster Start — Setup-Wizard
|
|
||||||
|
|
||||||
Nach der Aktivierung wirst du automatisch zum **Setup-Wizard** weitergeleitet:
|
|
||||||
|
|
||||||
**Schritt 1 — Superadmin-Konto erstellen**
|
|
||||||
- Dein Name und deine WP-Admin-E-Mail sind bereits vorausgefüllt
|
|
||||||
- Gib ein Passwort für dein Forum-Konto ein
|
|
||||||
- Das Konto wird automatisch dauerhaft mit dem Superadmin-Status verknüpft
|
|
||||||
|
|
||||||
**Schritt 2 — Forum-Seite erstellen**
|
|
||||||
- Optional: Eine WordPress-Seite mit dem Shortcode wird automatisch angelegt
|
|
||||||
- Du kannst auch eine eigene Seite manuell erstellen
|
|
||||||
|
|
||||||
**Schritt 3 — Fertig!**
|
|
||||||
- Direktlink zur Forum-Seite
|
|
||||||
- Link zum Admin-Dashboard
|
|
||||||
|
|
||||||
> ⚠️ **Wichtig:** Verwende beim Superadmin-Konto dieselbe E-Mail wie dein WordPress-Administratorkonto. Das Plugin verknüpft sie automatisch und stellt bei jedem Login sicher, dass dein Account immer Superadmin-Rechte hat.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📌 Shortcode
|
|
||||||
|
|
||||||
Füge diesen Shortcode auf einer beliebigen WordPress-Seite ein:
|
|
||||||
|
|
||||||
```
|
|
||||||
[business_forum]
|
[business_forum]
|
||||||
```
|
```
|
||||||
|
|
||||||
Das Plugin erkennt automatisch den aktuellen URL-Parameter und zeigt die passende Ansicht:
|
Empfohlen:
|
||||||
|
- Eine eigene Seite (z. B. "Forum") anlegen
|
||||||
|
- Nur diesen Shortcode als Seiteninhalt verwenden
|
||||||
|
|
||||||
| URL-Parameter | Ansicht |
|
## 7) Bedienung im Frontend (Mitglieder)
|
||||||
|---|---|
|
### 7.1 Registrierung und Login
|
||||||
| *(kein Parameter)* | Forum-Startseite |
|
- Registrierung kann offen, nur per Einladung oder deaktiviert sein.
|
||||||
| `?forum_cat=slug` | Kategorie-Ansicht |
|
- Optional müssen Nutzer die Forum-Regeln akzeptieren.
|
||||||
| `?forum_thread=123` | Thread-Ansicht |
|
- Spam-Schutz bei Registrierung:
|
||||||
| `?forum_profile=123` | Profil-Seite |
|
- Honeypot-Feld
|
||||||
| `?forum_members=1` | Mitgliederliste |
|
- Mindestzeit bis Formular-Absenden
|
||||||
| `?forum_search=Begriff` | Suchergebnisse |
|
- Login unterstützt "Angemeldet bleiben" (Remember-Me Cookie).
|
||||||
| `?forum_tag=tagname` | Tag-Übersicht |
|
|
||||||
| `?forum_dm=1` | Privatnachrichten |
|
|
||||||
| `?wbf_do_logout=1` | Logout (serverseitig) |
|
|
||||||
| `?wbf_reset_token=…` | Passwort zurücksetzen |
|
|
||||||
|
|
||||||
---
|
### 7.2 Kategorien und Threads
|
||||||
|
- Kategorien können verschachtelt sein (Hauptkategorie + Unterkategorien).
|
||||||
|
- Sichtbarkeit kann rollenbasiert sein.
|
||||||
|
- Threads können folgende Zustände haben:
|
||||||
|
- offen
|
||||||
|
- geschlossen
|
||||||
|
- archiviert
|
||||||
|
- gepinnt
|
||||||
|
|
||||||
## 🛠️ Admin-Bereich
|
### 7.3 Thread erstellen
|
||||||
|
- Mindestlänge Titel: 5 Zeichen
|
||||||
|
- Mindestlänge Inhalt: 10 Zeichen (bei normalem Thread)
|
||||||
|
- Tags können vergeben werden
|
||||||
|
- Optional kann ein Thread-Präfix gesetzt werden
|
||||||
|
- Optional kann direkt eine Umfrage erstellt werden
|
||||||
|
|
||||||
Erreichbar unter **WP-Admin → Business Forum**
|
### 7.4 Antworten und Bearbeiten
|
||||||
|
- Antworten mit BBCode-Unterstützung
|
||||||
|
- Flood-Control: konfigurierbare Wartezeit zwischen Posts
|
||||||
|
- Eigene Posts nur innerhalb des eingestellten Bearbeitungsfensters (z. B. 30 Minuten)
|
||||||
|
- Moderation kann unabhängig davon eingreifen
|
||||||
|
|
||||||
### Übersicht
|
### 7.5 Umfragen
|
||||||
- Echtzeit-Statistiken: Threads, Beiträge, Mitglieder, Tags, Meldungen
|
- Umfrage direkt beim Thread-Erstellen oder nachträglich im Thread
|
||||||
- Schnellzugriff auf alle Unterbereiche
|
- 2 bis 10 Antwortoptionen
|
||||||
- Rollensystem-Übersicht
|
- Optional Mehrfachauswahl
|
||||||
|
- Optional Enddatum
|
||||||
|
- Nach Abstimmung werden Ergebnisse direkt angezeigt
|
||||||
|
|
||||||
### Kategorien
|
### 7.6 Reaktionen, Likes, Lesezeichen
|
||||||
- Kategorien erstellen und bearbeiten
|
- Likes auf Thread/Beitrag
|
||||||
- **Eltern-Kind-Hierarchie** per Dropdown
|
- Emoji-Reaktionen (adminseitig konfigurierbar)
|
||||||
- Icon (FontAwesome-Klasse), Beschreibung, Sortierreihenfolge
|
- Lesezeichen für Threads (im Profil einsehbar)
|
||||||
- **Mindest-Rolle** zum Posten (z.B. nur Moderatoren können in "Ankündigungen" posten)
|
|
||||||
|
|
||||||
### Rollen
|
### 7.7 Private Nachrichten (DM)
|
||||||
- Eigene Rollen mit individuellem Label, Level (1–99), Farbe, Icon und Permissions erstellen
|
- 1:1 Nachrichten zwischen Mitgliedern
|
||||||
- Rollen löschen (Nutzer werden automatisch auf "Member" gesetzt)
|
- Inbox-Ansicht und Konversation
|
||||||
- Superadmin ist gesperrt und kann nicht verändert werden
|
- Ungelesene Nachrichten werden gezählt
|
||||||
|
- Optional E-Mail-Hinweis bei neuer Nachricht
|
||||||
|
|
||||||
**Verfügbare Permissions:**
|
### 7.8 Benachrichtigungen
|
||||||
|
Benachrichtigungen bei:
|
||||||
|
- Antworten auf abonnierte / relevante Threads
|
||||||
|
- @Erwähnungen
|
||||||
|
- neuen privaten Nachrichten
|
||||||
|
|
||||||
| Permission | Beschreibung |
|
### 7.9 Profil
|
||||||
|---|---|
|
Mitglieder können:
|
||||||
| `post` | Beiträge schreiben |
|
- Anzeigenamen, Bio und Signatur pflegen
|
||||||
| `create_thread` | Threads erstellen |
|
- Avatar hochladen
|
||||||
| `like` | Beiträge liken |
|
- Passwort ändern
|
||||||
| `pin_thread` | Threads pinnen |
|
- eigene Profil-Sichtbarkeit umschalten
|
||||||
| `close_thread` | Threads schließen |
|
- benutzerdefinierte Profilfelder ausfüllen (falls aktiviert)
|
||||||
| `delete_post` | Posts löschen |
|
|
||||||
| `delete_thread` | Threads löschen |
|
|
||||||
| `manage_users` | Nutzer verwalten |
|
|
||||||
| `manage_cats` | Kategorien verwalten |
|
|
||||||
| `post_announcement` | In eingeschränkte Kategorien posten |
|
|
||||||
|
|
||||||
### Level
|
Upload-Limits:
|
||||||
- Level-Bezeichnung, Mindest-Beitragsanzahl, Icon und Farbe anpassen
|
- Avatar: max. 2 MB (JPG/PNG/GIF/WebP)
|
||||||
- Neues Level hinzufügen oder bestehende löschen
|
- Bild im Beitrag: max. 5 MB (JPG/PNG/GIF/WebP)
|
||||||
- Level-System global aktivieren/deaktivieren
|
|
||||||
- Zurücksetzen auf Standard-Konfiguration
|
|
||||||
|
|
||||||
### Mitglieder
|
### 7.10 Passwort vergessen
|
||||||
- Alle Forum-Nutzer mit Rolle, Beitragsanzahl und Registrierungsdatum
|
- Über "Passwort vergessen" kann ein Reset-Link per E-Mail angefordert werden.
|
||||||
- **Rolle ändern** direkt in der Tabelle (inkl. Sperrgrund bei "Gesperrt")
|
- Das Zurücksetzen erfolgt über einen zeitlich gültigen Token.
|
||||||
- **Profil bearbeiten**: Anzeigename, E-Mail, Passwort
|
|
||||||
- Superadmin-Konten sind schreibgeschützt
|
|
||||||
|
|
||||||
### Meldungen
|
## 8) Moderation und Verwaltung
|
||||||
- Gemeldete Beiträge mit Begründung und Melder
|
Im WordPress-Backend gibt es den Menüpunkt "Business Forum" mit Unterseiten:
|
||||||
- Status: Offen · Erledigt · Verworfen
|
|
||||||
- Direktlink zum gemeldeten Beitrag
|
|
||||||
|
|
||||||
### Einstellungen
|
- Übersicht: Dashboard mit Kennzahlen und Aktivitäten
|
||||||
Alle sichtbaren Texte des Forums ohne Code ändern:
|
- Kategorien: Struktur und Sichtbarkeit verwalten
|
||||||
- Hero-Bereich (Titel, Untertitel)
|
- Rollen: Rollen/Permissions anpassen
|
||||||
- Topbar (Forum-Name, Button-Beschriftungen)
|
- Level: Beitragsbasierte Rangstufen
|
||||||
- Statistik-Labels
|
- Mitglieder: Nutzer verwalten
|
||||||
- Abschnittsüberschriften
|
- Meldungen: gemeldete Inhalte bearbeiten
|
||||||
|
- Profilfelder: eigene Felder definieren
|
||||||
|
- Einstellungen: Texte, Sicherheit, Registrierung, Regeln, Wartung
|
||||||
|
- Reaktionen: erlaubte Emoji-Reaktionen
|
||||||
|
- Einladungen: Invite-Codes erstellen und verwalten
|
||||||
|
- Statistiken: Forum-Auswertung
|
||||||
|
- Papierkorb: gelöschte Inhalte wiederherstellen
|
||||||
|
- Thread-Präfixe: Label für Threads verwalten
|
||||||
|
- Wortfilter: unerwünschte Begriffe ersetzen/filtern
|
||||||
|
- Export / Import: Backup und Wiederherstellung
|
||||||
|
- Deinstallieren: komplette Löschung des Plugins inkl. Daten
|
||||||
|
|
||||||
|
## 9) Einstellungen im Detail
|
||||||
|
Unter Business Forum > Einstellungen:
|
||||||
|
|
||||||
|
### 9.1 Texte und UI
|
||||||
|
- Hero-Titel/Untertitel
|
||||||
|
- Topbar-Brand
|
||||||
|
- Label für Statistik
|
||||||
|
- Abschnittstitel
|
||||||
|
- Buttontexte
|
||||||
- Sidebar-Titel
|
- Sidebar-Titel
|
||||||
- **Auto-Logout** nach Inaktivität (0 = deaktiviert, bis 8 Stunden)
|
|
||||||
|
|
||||||
### Export / Import
|
### 9.2 Sicherheit
|
||||||
Vollständige Datensicherung aller Forum-Daten als `.json`-Datei:
|
- Auto-Logout nach Inaktivität (0 = deaktiviert)
|
||||||
|
- Post-Bearbeitungslimit
|
||||||
|
- Spam-Mindestzeit bei Registrierung
|
||||||
|
- Flood-Control Intervall
|
||||||
|
- Profil-Sichtbarkeit (Standard)
|
||||||
|
|
||||||
| Bereich | Inhalt |
|
### 9.3 Registrierung
|
||||||
|---|---|
|
- Modus:
|
||||||
| ⚙️ Einstellungen | Forum-Texte, Labels, Auto-Logout |
|
- offen
|
||||||
| 🛡️ Rollen | Alle Rollen mit Permissions & Design |
|
- nur Einladung
|
||||||
| ⭐ Level | Level-Konfiguration & Status |
|
- deaktiviert
|
||||||
| 📂 Kategorien | Kategoriestruktur inkl. Hierarchie |
|
- Freitext-Hinweis für Einladungsmode
|
||||||
| 👥 Benutzer | Accounts inkl. Passwort-Hashes |
|
|
||||||
| 💬 Threads & Posts | Alle Inhalte inkl. Tags |
|
### 9.4 Wartungsmodus
|
||||||
| ❤️ Likes & Reaktionen | Likes, Reaktionen, Benachrichtigungen |
|
- Forum für normale Nutzer sperren
|
||||||
| ✉️ Privatnachrichten | Alle DM-Konversationen |
|
- Moderation/Admin behalten Zugriff
|
||||||
| 🚩 Meldungen | Gemeldete Beiträge inkl. Status |
|
- Eigener Wartungs-Titel und Hinweistext
|
||||||
|
|
||||||
|
### 9.5 Forum-Regeln / Nutzungsbedingungen
|
||||||
|
- Regelseite aktivieren/deaktivieren
|
||||||
|
- Akzeptierung bei Registrierung optional verpflichtend
|
||||||
|
- Titel und Inhalt frei editierbar
|
||||||
|
|
||||||
|
## 10) Export, Import und Deinstallation
|
||||||
|
### 10.1 Export / Import
|
||||||
|
Exportierbare Bereiche (je nach Auswahl):
|
||||||
|
- Einstellungen
|
||||||
|
- Rollen und Level
|
||||||
|
- Kategorien
|
||||||
|
- Nutzer und User-Meta
|
||||||
|
- Threads und Posts
|
||||||
|
- Interaktionen (Likes/Reaktionen/Benachrichtigungen)
|
||||||
|
- Nachrichten
|
||||||
|
- Meldungen
|
||||||
|
- Einladungen
|
||||||
|
|
||||||
|
Empfehlung:
|
||||||
|
- Vor großen Änderungen immer einen Voll-Export speichern.
|
||||||
|
|
||||||
|
### 10.2 Deinstallation (wichtig)
|
||||||
|
Beim Löschen des Plugins werden komplett entfernt:
|
||||||
|
- alle Forum-Datenbanktabellen
|
||||||
|
- relevante Plugin-Optionen
|
||||||
|
- Transients
|
||||||
|
- geplanter Cron-Job
|
||||||
|
- automatisch erstellte Forum-Seite
|
||||||
|
- zugehörige Upload-Unterverzeichnisse
|
||||||
|
|
||||||
|
Das ist eine echte Datenlöschung. Vorher immer Backup erstellen.
|
||||||
|
|
||||||
|
## 11) FAQ / Troubleshooting
|
||||||
|
### Login funktioniert nicht
|
||||||
|
- Prüfen, ob das Konto gesperrt ist
|
||||||
|
- Bei zeitlicher Sperre Ablaufzeit abwarten
|
||||||
|
- Bei Registrierung "Nur Einladung" gültigen Invite-Code nutzen
|
||||||
|
|
||||||
|
### Registrierung nicht sichtbar
|
||||||
|
- In Einstellungen den Registrierungsmodus prüfen
|
||||||
|
- Bei deaktiviertem Modus ist keine Selbstregistrierung möglich
|
||||||
|
|
||||||
|
### Keine E-Mails kommen an
|
||||||
|
- WordPress-Mailversand prüfen (SMTP Plugin empfohlen)
|
||||||
|
- Admin-E-Mail in WordPress kontrollieren
|
||||||
|
|
||||||
|
### Upload von Bildern/Avatar scheitert
|
||||||
|
- Dateityp prüfen (nur JPG/PNG/GIF/WebP)
|
||||||
|
- Dateigröße prüfen (Avatar 2 MB, Beitrag 5 MB)
|
||||||
|
- Schreibrechte in Uploads prüfen
|
||||||
|
|
||||||
|
### Benutzer werden automatisch ausgeloggt
|
||||||
|
- Auto-Logout in den Forum-Einstellungen prüfen
|
||||||
|
|
||||||
|
### Forum ist plötzlich "offline"
|
||||||
|
- Wartungsmodus in den Einstellungen deaktivieren
|
||||||
|
|
||||||
|
### Suche liefert keine Ergebnisse
|
||||||
|
- Suchbegriff muss mindestens 2 Zeichen haben
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🎨 Rollen & Berechtigungen
|
## Kurz-Checkliste für den Live-Betrieb
|
||||||
|
1. Setup-Wizard abschließen
|
||||||
|
2. Forum-Seite mit `[business_forum]` bereitstellen
|
||||||
|
3. Rollen und Kategorien final konfigurieren
|
||||||
|
4. Registrierungsmodus festlegen
|
||||||
|
5. Regeln/Nutzungsbedingungen hinterlegen
|
||||||
|
6. E-Mail-Versand testen
|
||||||
|
7. Backup-Export erstellen
|
||||||
|
|
||||||
### Superadmin — Sonderfall
|
Viel Erfolg mit deinem Forum!
|
||||||
Der Superadmin ist **immer** an den WordPress-Administrator gebunden:
|
|
||||||
- Wird bei jedem Seitenaufruf automatisch synchronisiert
|
|
||||||
- Kann nicht manuell vergeben oder entzogen werden
|
|
||||||
- Hat Zugriff auf alle Funktionen ohne Einschränkung
|
|
||||||
- Kann im Admin-Panel nicht gelöscht oder bearbeitet werden
|
|
||||||
|
|
||||||
### Rollen-Hierarchie
|
|
||||||
Höherer `level`-Wert = mehr Rechte. Wenn eine Kategorie eine Mindest-Rolle hat, müssen Nutzer mindestens dieses Level haben um dort zu posten.
|
|
||||||
|
|
||||||
### Eigene Rollen erstellen
|
|
||||||
1. WP-Admin → Business Forum → **Rollen** → **+ Neue Rolle**
|
|
||||||
2. Rollen-Schlüssel vergeben (z.B. `trusted_member`) — kann nicht geändert werden
|
|
||||||
3. Anzeigename, Level (zwischen `member` = 10 und `admin` = 80), Farbe, Icon, Permissions
|
|
||||||
4. Speichern
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📊 Level-System
|
|
||||||
|
|
||||||
Das Level-System ist optional und kann jederzeit ein- oder ausgeschaltet werden. Es basiert ausschließlich auf der Anzahl der Beiträge eines Nutzers.
|
|
||||||
|
|
||||||
### Level-Badge
|
|
||||||
Wird auf der Profil-Seite, in Posts und auf der Mitgliederliste angezeigt.
|
|
||||||
|
|
||||||
### Fortschrittsbalken
|
|
||||||
Auf der eigenen Profil-Seite wird angezeigt:
|
|
||||||
- Aktuelles Level mit Badge
|
|
||||||
- Anzahl der benötigten Beiträge bis zum nächsten Level
|
|
||||||
- Fortschrittsbalken in der Levelfarbe
|
|
||||||
|
|
||||||
### Konfiguration
|
|
||||||
WP-Admin → Business Forum → **Level** → Neue Einträge hinzufügen oder bestehende bearbeiten.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🏷️ BBCode-Referenz
|
|
||||||
|
|
||||||
Nutzer können in Threads und Posts folgende Formatierungen verwenden:
|
|
||||||
|
|
||||||
### Text-Formatierung
|
|
||||||
```
|
|
||||||
[b]Fett[/b]
|
|
||||||
[i]Kursiv[/i]
|
|
||||||
[u]Unterstrichen[/u]
|
|
||||||
[s]Durchgestrichen[/s]
|
|
||||||
[h2]Überschrift 2[/h2]
|
|
||||||
[h3]Überschrift 3[/h3]
|
|
||||||
```
|
|
||||||
|
|
||||||
### Farbe & Größe
|
|
||||||
```
|
|
||||||
[color=red]Roter Text[/color]
|
|
||||||
[color=#00b4d8]Hex-Farbe[/color]
|
|
||||||
[size=small]Kleiner Text[/size]
|
|
||||||
[size=large]Großer Text[/size]
|
|
||||||
[size=xlarge]Sehr großer Text[/size]
|
|
||||||
```
|
|
||||||
|
|
||||||
Erlaubte Farbnamen: `red`, `blue`, `green`, `orange`, `yellow`, `purple`, `pink`, `cyan`, `white`, `gray`, `black`, `gold`, `silver`, `lime`, `teal`, `navy`
|
|
||||||
|
|
||||||
### Links & Medien
|
|
||||||
```
|
|
||||||
[url=https://beispiel.de]Link-Text[/url]
|
|
||||||
[url]https://beispiel.de[/url]
|
|
||||||
[img]https://beispiel.de/bild.jpg[/img]
|
|
||||||
```
|
|
||||||
|
|
||||||
### Code
|
|
||||||
```
|
|
||||||
[code]
|
|
||||||
function helloWorld() {
|
|
||||||
echo "Hallo Welt!";
|
|
||||||
}
|
|
||||||
[/code]
|
|
||||||
|
|
||||||
Inline: [icode]$variable[/icode]
|
|
||||||
```
|
|
||||||
|
|
||||||
### Zitat
|
|
||||||
```
|
|
||||||
[quote]Allgemeines Zitat[/quote]
|
|
||||||
[quote=M_Viper]Zitat von M_Viper[/quote]
|
|
||||||
```
|
|
||||||
|
|
||||||
### Spoiler
|
|
||||||
```
|
|
||||||
[spoiler]Versteckter Inhalt[/spoiler]
|
|
||||||
[spoiler=Titel]Inhalt mit Titel[/spoiler]
|
|
||||||
```
|
|
||||||
|
|
||||||
### Listen
|
|
||||||
```
|
|
||||||
[list]
|
|
||||||
[*] Erstes Element
|
|
||||||
[*] Zweites Element
|
|
||||||
[/list]
|
|
||||||
|
|
||||||
[list=1]
|
|
||||||
[*] Nummeriert
|
|
||||||
[*] Liste
|
|
||||||
[/list]
|
|
||||||
```
|
|
||||||
|
|
||||||
### Ausrichtung & Trennlinie
|
|
||||||
```
|
|
||||||
[center]Zentrierter Text[/center]
|
|
||||||
[right]Rechtsbündiger Text[/right]
|
|
||||||
[hr]
|
|
||||||
```
|
|
||||||
|
|
||||||
### @Erwähnungen
|
|
||||||
```
|
|
||||||
@Benutzername
|
|
||||||
```
|
|
||||||
Wird automatisch zu einem klickbaren Profil-Link und sendet eine Benachrichtigung.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📁 Dateistruktur
|
|
||||||
|
|
||||||
```
|
|
||||||
wp-business-forum/
|
|
||||||
├── wp-business-forum.php # Plugin-Hauptdatei
|
|
||||||
├── includes/
|
|
||||||
│ ├── class-forum-db.php # Datenbankschicht (alle Abfragen)
|
|
||||||
│ ├── class-forum-auth.php # Login, Register, Session, Remember-Me
|
|
||||||
│ ├── class-forum-roles.php # Dynamisches Rollensystem
|
|
||||||
│ ├── class-forum-levels.php # Level-System
|
|
||||||
│ ├── class-forum-bbcode.php # BBCode → HTML Parser
|
|
||||||
│ ├── class-forum-shortcodes.php # Frontend-Rendering (alle Ansichten)
|
|
||||||
│ └── class-forum-ajax.php # AJAX-Handler (alle Aktionen)
|
|
||||||
├── admin/
|
|
||||||
│ ├── forum-admin.php # Admin-Panel (alle Unterseiten)
|
|
||||||
│ ├── forum-settings.php # Einstellungsseite & wbf_get_settings()
|
|
||||||
│ └── forum-setup.php # Einrichtungs-Wizard
|
|
||||||
└── assets/
|
|
||||||
├── css/
|
|
||||||
│ └── forum-style.css # Komplettes Dark-Theme (Minecraft Modern)
|
|
||||||
└── js/
|
|
||||||
└── forum-script.js # Alle Frontend-Interaktionen (jQuery)
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🗄️ Datenbank-Tabellen
|
|
||||||
|
|
||||||
Alle Tabellen werden bei der Plugin-Aktivierung automatisch erstellt. Bestehende Tabellen werden beim Update automatisch um neue Spalten erweitert (via `ALTER TABLE`).
|
|
||||||
|
|
||||||
| Tabelle | Inhalt |
|
|
||||||
|---|---|
|
|
||||||
| `{prefix}forum_users` | Forum-Accounts (unabhängig von WP-Usern) |
|
|
||||||
| `{prefix}forum_categories` | Kategorien mit Eltern-Kind-Hierarchie |
|
|
||||||
| `{prefix}forum_threads` | Hauptthreads |
|
|
||||||
| `{prefix}forum_posts` | Antworten auf Threads |
|
|
||||||
| `{prefix}forum_likes` | Likes auf Threads und Posts |
|
|
||||||
| `{prefix}forum_tags` | Tag-Bibliothek |
|
|
||||||
| `{prefix}forum_thread_tags` | Verknüpfung Thread ↔ Tags |
|
|
||||||
| `{prefix}forum_messages` | Privatnachrichten |
|
|
||||||
| `{prefix}forum_reactions` | Emoji-Reaktionen auf Posts |
|
|
||||||
| `{prefix}forum_reports` | Gemeldete Beiträge |
|
|
||||||
| `{prefix}forum_notifications` | In-App-Benachrichtigungen |
|
|
||||||
| `{prefix}forum_remember_tokens` | Remember-Me-Tokens |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 💾 Export & Import
|
|
||||||
|
|
||||||
### Export
|
|
||||||
1. WP-Admin → Business Forum → **Export / Import**
|
|
||||||
2. Gewünschte Bereiche anwählen (alle standardmäßig aktiviert)
|
|
||||||
3. **Als JSON exportieren** klicken
|
|
||||||
4. Die Datei wird sofort heruntergeladen (`wbf-backup-DATUM.json`)
|
|
||||||
|
|
||||||
### Import
|
|
||||||
1. WP-Admin → Business Forum → **Export / Import**
|
|
||||||
2. Backup-Datei auswählen (`.json`)
|
|
||||||
3. Überschreiben-Optionen nach Bedarf aktivieren
|
|
||||||
4. **Importieren** klicken
|
|
||||||
|
|
||||||
> ⚠️ **Hinweis:** Der Import von Nutzern enthält Passwort-Hashes und funktioniert für Migrationen zwischen WordPress-Sites. Superadmin-Status wird beim Import nie übertragen — nur der WP-Administrator erhält automatisch Superadmin-Rechte.
|
|
||||||
|
|
||||||
### Überschreiben-Optionen
|
|
||||||
|
|
||||||
| Option | Effekt |
|
|
||||||
|---|---|
|
|
||||||
| Kategorien überschreiben | Löscht alle bestehenden Kategorien vor dem Import |
|
|
||||||
| Benutzer aktualisieren | Aktualisiert vorhandene Accounts (gleicher Username) |
|
|
||||||
| Threads & Posts überschreiben | Löscht alle Threads, Posts, Likes und Reaktionen |
|
|
||||||
| Privatnachrichten überschreiben | Löscht alle DMs vor dem Import |
|
|
||||||
| Meldungen überschreiben | Löscht alle Meldungen vor dem Import |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ❓ FAQ
|
|
||||||
|
|
||||||
**Brauchen Forum-Nutzer einen WordPress-Account?**
|
|
||||||
Nein. Das Forum hat ein komplett eigenständiges Login-System. Forum-Nutzer können sich direkt im Frontend registrieren ohne Zugang zum WordPress-Backend.
|
|
||||||
|
|
||||||
**Wie werde ich Superadmin?**
|
|
||||||
Registriere dich im Forum mit derselben E-Mail-Adresse wie dein WordPress-Administratorkonto. Das Plugin erkennt dies automatisch. Falls du bereits ein Forum-Konto mit einer anderen E-Mail hast, kannst du dieses entweder im Setup-Wizard hochstufen oder direkt in der Datenbank das `role`-Feld auf `superadmin` setzen.
|
|
||||||
|
|
||||||
**Kann ich mehrere Superadmins haben?**
|
|
||||||
Nein. Der Superadmin-Status ist fest an das WordPress-Administratorkonto gebunden. Du kannst jedoch mehrere Nutzer auf die Rolle `Admin` (Level 80) setzen — diese haben nahezu dieselben Rechte.
|
|
||||||
|
|
||||||
**Funktioniert das Plugin mit Caching-Plugins?**
|
|
||||||
Ja, grundsätzlich. Der Logout-Button nutzt einen direkten Server-Link (`?wbf_do_logout=1`) statt AJAX und ist daher Caching-sicher. Falls du Probleme mit veralteten Nonces hast, deaktiviere das Caching für die Forum-Seite in deinem Caching-Plugin.
|
|
||||||
|
|
||||||
**Wie passe ich das Design an?**
|
|
||||||
Das Plugin enthält ein vollständiges Dark-Theme (`forum-style.css`) passend zum "Minecraft Modern Theme"-Stil. Für eigene Anpassungen füge dein CSS in der WordPress-Customizer oder einer Custom-CSS-Datei hinzu und verwende die CSS-Custom-Properties des Plugins (z.B. `--c-primary`, `--c-surface`).
|
|
||||||
|
|
||||||
**Welche E-Mail-Konfiguration wird benötigt?**
|
|
||||||
Das Plugin nutzt `wp_mail()` — denselben Mechanismus wie WordPress selbst. Wenn dein WordPress bereits E-Mails senden kann (z.B. für Passwort-Zurücksetzen), funktionieren auch die Forum-Benachrichtigungen. Für zuverlässige E-Mail-Zustellung empfiehlt sich ein SMTP-Plugin wie WP Mail SMTP.
|
|
||||||
|
|
||||||
**Wie lösche ich alle Forum-Daten?**
|
|
||||||
Deaktiviere und lösche das Plugin. Die Datenbanktabellen werden dabei **nicht** automatisch gelöscht (WordPress-Standard). Um die Tabellen zu entfernen, führe in phpMyAdmin oder WP-CLI folgende Abfragen aus:
|
|
||||||
```sql
|
|
||||||
DROP TABLE IF EXISTS
|
|
||||||
wp_forum_users, wp_forum_categories, wp_forum_threads, wp_forum_posts,
|
|
||||||
wp_forum_likes, wp_forum_tags, wp_forum_thread_tags, wp_forum_messages,
|
|
||||||
wp_forum_reactions, wp_forum_reports, wp_forum_notifications, wp_forum_remember_tokens;
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
*Entwickelt mit ❤️ für die WordPress-Community*
|
|
||||||
|
|||||||
Reference in New Issue
Block a user