# 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!