WP Business Forum — Anwender-Dokumentation

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.

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.


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

1) Über das Plugin

WP Business Forum ist ein eigenständiges Foren-System für WordPress mit:

  • eigenem Forum-Login (unabhängig vom WP-Login)
  • Rollen- und Rechteverwaltung
  • Kategorien mit Hierarchie
  • Moderationswerkzeugen
  • Direktnachrichten, Benachrichtigungen, Meldesystem
  • Umfragen, Tags, Reaktionen, Lesezeichen
  • Level-System (beitragsbasierte Rangstufen)
  • Vollständigem Export / Import mit automatischer ID-Zuordnung

Das Forum wird per Shortcode in eine WordPress-Seite eingebunden.


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
  • Andere Nutzer ignorieren / blockieren

Für Moderation / Admin

  • Threads pinnen, schließen, archivieren, verschieben, löschen
  • Beiträge löschen und wiederherstellen (Papierkorb)
  • Meldungen (Reports) bearbeiten
  • Kategorien und Rollen verwalten
  • Mitglieder verwalten: Rolle ändern, Profil bearbeiten, Sperren, Löschen
  • Einladungssystem für Registrierung
  • Wartungsmodus
  • Wortfilter / Zensurliste
  • Statistiken und Aktivitäts-Dashboard
  • Export / Import (vollständiges Backup mit Wortfilter, Ignore-Liste, Präfixen u. v. m.)

3) Voraussetzungen

  • Laufende WordPress-Installation (empfohlen: aktuelle Version)
  • PHP 7.4 oder höher (empfohlen: PHP 8.0+)
  • MySQL 5.7 / MariaDB 10.3 oder höher
  • Schreibrechte für WordPress-Uploads (für Avatar- und Bild-Uploads)
  • Funktionierende E-Mail-Zustellung in WordPress (für Passwort-Reset und Benachrichtigungen)

Das Plugin nutzt eigene Datenbanktabellen mit dem Präfix wp_forum_* (bzw. deinem konfigurierten Tabellenpräfix).


4) Installation

  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.

5) Ersteinrichtung (Setup-Wizard)

Nach der Aktivierung führt der Wizard durch drei Schritte:

  1. Superadmin-Konto erstellen oder bestehendes Forum-Konto verknüpfen
  2. Optional automatisch eine Forum-Seite erzeugen
  3. Abschluss und Weiterleitung ins Dashboard

Wichtig:

  • Der Superadmin ist fest mit dem WordPress-Administrator verknüpft und kann nicht über den Import überschrieben werden.
  • Wenn noch kein Superadmin existiert, erscheint im Backend ein Hinweisbanner.

6) Forum-Seite einbinden

Das Forum wird mit folgendem Shortcode auf einer WordPress-Seite angezeigt:

[business_forum]

Empfehlung:

  • Eine eigene Seite (z. B. „Forum") anlegen
  • Nur diesen Shortcode als Seiteninhalt verwenden
  • Die Seite in der WordPress-Navigation verlinken

7) Bedienung im Frontend (Mitglieder)

7.1 Registrierung und Login

  • Die Registrierung kann offen, nur per Einladung oder deaktiviert sein.
  • Optional müssen Nutzer die Forum-Regeln akzeptieren.
  • Spam-Schutz bei der Registrierung:
    • Honeypot-Feld
    • Mindestzeit bis zum Formular-Absenden
  • Login unterstützt „Angemeldet bleiben" (Remember-Me Cookie, 30 Tage).

7.2 Kategorien und Threads

  • Kategorien können verschachtelt sein (Hauptkategorie + Unterkategorien).
  • Die Sichtbarkeit kann rollenbasiert eingeschränkt werden.
  • Threads können folgende Zustände haben: offen · geschlossen · archiviert · gepinnt

7.3 Thread erstellen

  • Mindestlänge Titel: 5 Zeichen
  • Mindestlänge Inhalt: 10 Zeichen
  • Tags können vergeben werden
  • Optional kann ein Thread-Präfix gesetzt werden
  • Optional kann direkt eine Umfrage erstellt werden

7.4 Antworten und Bearbeiten

  • Antworten mit BBCode-Unterstützung ([b], [i], [quote], [code], [spoiler], [url], [img] u. v. m.)
  • Flood-Control: konfigurierbare Wartezeit zwischen Posts
  • Eigene Posts können nur innerhalb des konfigurierten Bearbeitungsfensters geändert werden
  • Moderation kann unabhängig davon jederzeit eingreifen

7.5 Umfragen

  • Umfrage direkt beim Thread-Erstellen oder nachträglich anfügen
  • 2 bis 10 Antwortoptionen
  • Optional Mehrfachauswahl
  • Optional Enddatum
  • Nach der Abstimmung werden Ergebnisse direkt angezeigt

7.6 Reaktionen, Likes, Lesezeichen

  • Likes auf Threads und Beiträge
  • Emoji-Reaktionen (adminseitig konfigurierbar)
  • Lesezeichen für Threads, im Profil jederzeit einsehbar

7.7 Private Nachrichten (DM)

  • 1:1 Nachrichten zwischen Mitgliedern
  • Inbox-Ansicht und Konversationsansicht
  • Ungelesene Nachrichten werden im Header gezählt
  • Optional E-Mail-Hinweis bei neuer Nachricht

7.8 Benachrichtigungen

Benachrichtigungen werden ausgelöst bei:

  • Antworten auf abonnierte Threads
  • @Erwähnungen in Beiträgen
  • Neuen privaten Nachrichten

7.9 Profil

Mitglieder können:

  • Anzeigenamen, Bio und Signatur pflegen
  • Avatar hochladen (max. 2 MB, JPG/PNG/GIF/WebP)
  • Passwort ändern
  • Profil-Sichtbarkeit umschalten
  • Benutzerdefinierte Profilfelder ausfüllen (falls vom Admin aktiviert)
  • Andere Nutzer zur Ignore-Liste hinzufügen

Upload-Limits:

  • Avatar: max. 2 MB (JPG / PNG / GIF / WebP)
  • Bild im Beitrag: max. 5 MB (JPG / PNG / GIF / WebP)

7.10 Passwort vergessen

Über „Passwort vergessen" kann ein Reset-Link per E-Mail angefordert werden. Das Zurücksetzen erfolgt über einen zeitlich begrenzten Token.


8) Moderation und Verwaltung

Im WordPress-Backend gibt es den Menüpunkt Business Forum mit folgenden Unterseiten:

Unterseite Funktion
Übersicht Dashboard mit Kennzahlen, Trends und Aktivitätsprotokoll
Kategorien Struktur, Hierarchie und Sichtbarkeit verwalten
Rollen Rollen, Permissions und Design anpassen
Level Beitragsbasierte Rangstufen konfigurieren
Mitglieder Nutzer verwalten, sperren, löschen
Meldungen Gemeldete Inhalte bearbeiten
Profilfelder Eigene Felder definieren
Einstellungen Texte, Sicherheit, Registrierung, Regeln, Wartung
Reaktionen Erlaubte Emoji-Reaktionen konfigurieren
Einladungen Invite-Codes erstellen und verwalten
Statistiken Forum-Auswertung und Trends
Papierkorb Gelöschte Inhalte einsehen und wiederherstellen
Thread-Präfixe Farbige Label für Threads verwalten
Wortfilter Unerwünschte Begriffe automatisch ersetzen
Export / Import Vollständiges Backup und Wiederherstellung
⚠️ Deinstallieren Komplette Löschung inkl. aller Daten
🔔 Updates Update-Status und Changelog

8.1 Mitglieder verwalten

In der Mitglieder-Übersicht stehen pro Nutzer drei Aktionen zur Verfügung:

Rolle ändern Rolle direkt aus dem Dropdown wählen und speichern. Bei „Gesperrt" kann zusätzlich ein Sperrgrund und ein automatisches Ablaufdatum (temporäre Sperre) gesetzt werden.

Profil bearbeiten Anzeigename, E-Mail, Passwort, Bio, Signatur und benutzerdefinierte Profilfelder direkt im Admin ändern.

Nutzer löschen Beim Klick auf „Löschen" öffnet sich ein Bestätigungs-Panel mit zwei Optionen:

  • DSGVO Anonymisieren (empfohlen): Der Account wird nach Art. 17 DSGVO anonymisiert — Benutzername, E-Mail und Passwort werden gelöscht, Threads und Beiträge bleiben unter „Gelöschter Nutzer" erhalten.
  • Dauerhaft löschen: Der Datensatz wird vollständig aus der Datenbank entfernt. Alle nutzerbezogenen Daten (Nachrichten, Likes, Reaktionen, Abonnements, Lesezeichen u. a.) werden gelöscht. Threads und Beiträge bleiben anonym erhalten. Dieser Vorgang ist nicht rückgängig zu machen.

Der Superadmin-Account ist in beiden Pfaden geschützt und kann nicht gelöscht werden.

8.2 Sperren von Nutzern

Statt eines vollständigen Löschens kann ein Nutzer auch gesperrt werden (Rolle „Gesperrt"):

  • Permanente Sperre: Kein Forum-Zugang, Sperrgrund wird beim Login angezeigt.
  • Temporäre Sperre: Automatische Entsperrung zum angegebenen Datum/Uhrzeit. Bei Ablauf wird die vorherige Rolle automatisch wiederhergestellt.

9) Einstellungen im Detail

Unter Business Forum Einstellungen:

9.1 Texte und UI

  • Hero-Titel und Untertitel
  • Topbar-Brand
  • Labels für Statistiken
  • Abschnittstitel und Buttontexte
  • Sidebar-Titel

9.2 Sicherheit

  • Auto-Logout nach Inaktivität (0 = deaktiviert, in Minuten)
  • Post-Bearbeitungslimit (in Minuten, 0 = unbegrenzt)
  • Spam-Mindestzeit bei Registrierung (in Sekunden)
  • Flood-Control Intervall zwischen Posts (in Sekunden, 0 = deaktiviert)
  • Standard-Profil-Sichtbarkeit für neue Mitglieder

9.3 Registrierung

  • Modus: offen · nur Einladung · deaktiviert
  • Freitext-Hinweis bei Einladungs-Modus
  • Forum-Regeln bei Registrierung verpflichtend akzeptieren

9.4 Wartungsmodus

  • Forum für normale Nutzer sperren
  • Moderation und Admins behalten vollen Zugriff
  • Eigener Wartungs-Titel und Hinweistext konfigurierbar

9.5 Forum-Regeln / Nutzungsbedingungen

  • Regelseite aktivieren / deaktivieren
  • Akzeptierung bei Registrierung optional verpflichtend
  • Titel und Inhalt frei editierbar (unterstützt einfaches Markdown)

10) Export, Import und Deinstallation

10.1 Export

Unter Business Forum Export / Import kannst du einzelne oder alle Bereiche als .json-Datei exportieren:

Bereich Enthält
Einstellungen & Wortfilter Forum-Texte, Regeln, Labels, Auto-Logout, Wortfilter, Profilfeld-Definitionen, Reaktionen-Konfiguration
Rollen Alle Rollen mit Berechtigungen und Design (Superadmin wird nie überschrieben)
Level-System Level-Namen, Schwellenwerte, Icons, Farben, An/Aus-Status
Kategorien Kategoriestruktur inkl. Eltern-Kind-Hierarchie, Icons, Min-Rolle
Benutzer & Profilfelder Accounts inkl. Passwort-Hashes, Ban-Status, Profilfeld-Werte
Threads, Posts & Abonnements Alle Inhalte inkl. Tag-Zuordnungen und Thread-Abonnements
Umfragen Alle Umfragen inkl. Abstimmungen
Lesezeichen Alle gespeicherten Thread-Lesezeichen
Thread-Präfixe Alle Präfix-Labels, Farben und Reihenfolgen
Likes & Reaktionen Likes, Emoji-Reaktionen, Benachrichtigungen
Privatnachrichten Alle DM-Konversationen
Ignore-Liste Alle gegenseitigen Nutzer-Blockierungen
Meldungen Gemeldete Beiträge inkl. Status
Einladungen Alle Einladungscodes inkl. Nutzungsanzahl und Ablaufdatum

Tipp: Mit „Alle wählen" / „Keine" lässt sich die Auswahl schnell anpassen. Die Datei wird sofort heruntergeladen.

10.2 Import

Beim Import einer zuvor exportierten .json-Datei gilt:

  • Maximale Dateigröße: 50 MB
  • Nur Dateien im WBF-Format werden akzeptiert
  • Benutzer-IDs werden beim Import automatisch gemappt — Threads, Posts, Likes, Reaktionen und alle anderen nutzerbezogenen Daten werden korrekt auf die neuen Datenbank-IDs übertragen, auch wenn sich diese von der Quelldatenbank unterscheiden
  • Nach dem Import werden alle Zähler (Beitrags-, Thread- und Reaktionszähler) automatisch neu berechnet
  • Der Superadmin kann per Import nie überschrieben werden

Über die Überschreiben-Optionen lässt sich pro Bereich steuern, ob bestehende Daten ersetzt oder Duplikate übersprungen werden sollen.

⚠️ Erstelle vor jedem Import einen aktuellen Export als Sicherung. Benutzer-Exporte enthalten Passwort-Hashes — teile diese Dateien nicht öffentlich.

10.3 Deinstallation

Unter Business Forum ⚠️ Deinstallieren oder beim Löschen des Plugins im WordPress-Backend werden vollständig entfernt:

  • Alle Forum-Datenbanktabellen (wp_forum_*)
  • Alle Plugin-Optionen in wp_options
  • Transients
  • Geplante Cron-Jobs
  • Automatisch erstellte Forum-Seite
  • Upload-Unterverzeichnis wbf-avatars

Das ist eine echte, unwiderrufliche Datenlöschung. Immer vorher einen vollständigen Export erstellen.


11) FAQ / Troubleshooting

Login funktioniert nicht Prüfen ob das Konto gesperrt ist. Bei temporärer Sperre das Ablaufdatum abwarten. Bei „Nur Einladung" einen gültigen Invite-Code verwenden.

Registrierung nicht sichtbar In den Einstellungen den Registrierungsmodus prüfen. Bei deaktiviertem Modus ist keine Selbstregistrierung möglich.

Keine E-Mails kommen an WordPress-Mailversand prüfen. Ein SMTP-Plugin wird empfohlen. Die 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 im Uploads-Verzeichnis prüfen.

Import schlägt fehl oder überschreibt falsche Daten Sicherstellen, dass die Datei aus einer WBF-Installation stammt. Überschreiben-Optionen gezielt setzen. Bei sehr großen Backups upload_max_filesize und post_max_size in der php.ini erhöhen.

Benutzer werden automatisch ausgeloggt Auto-Logout in den Forum-Einstellungen prüfen (Wert in Minuten, 0 = deaktiviert).

Forum ist plötzlich „offline" Wartungsmodus in den Einstellungen deaktivieren.

Suche liefert keine Ergebnisse Der Suchbegriff muss mindestens 2 Zeichen lang sein.

Nach dem Import stimmen Beitragszähler nicht Ab Version 1.0.2 werden Zähler nach jedem Import automatisch neu berechnet. Bei älteren Imports einmalig einen neuen Import mit der aktuellen Version durchführen.


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. Vollständigen Backup-Export erstellen

Viel Erfolg mit deinem Forum!

Description
No description provided
Readme 1.5 MiB
1.0.5 Latest
2026-03-30 18:53:40 +00:00
Languages
PHP 79.1%
CSS 11.4%
JavaScript 9.5%