WP-Business-Forum/README.md

WP Business Forum - Anwender README

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.

Wenn du eine professionelle Community mit klaren Rechten, direkter Nutzerkommunikation und strukturierter Moderation aufbauen willst, ist WP Business Forum dafür ausgelegt.

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

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

Für Moderation / Admin

• Threads pinnen, schließen, archivieren, verschieben, löschen
• Beiträge löschen
• Meldungen (Reports) bearbeiten
• Kategorien und Rollen verwalten
• Einladungssystem für Registrierung
• Wartungsmodus
• Wortfilter
• Statistiken
• Papierkorb / Wiederherstellung
• Export / Import

3) Voraussetzungen

• Laufende WordPress-Installation
• Schreibrechte für WordPress-Uploads (für Avatar-/Bild-Uploads)
• Funktionierende E-Mail-Zustellung in WordPress (für Passwort-Reset und Benachrichtigungen)

Hinweis: Das Plugin nutzt eigene Datenbanktabellen (Präfix wp_forum_* bzw. mit deinem 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 Aktivierung führt der Wizard durch 3 Schritte:

1. Superadmin-Konto erstellen oder bestehendes Forum-Konto hochstufen
2. Optional automatisch eine Forum-Seite erzeugen
3. Abschluss

Wichtig:

• Der Superadmin ist fest mit dem WordPress-Admin verknüpft.
• 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]

Empfohlen:

• Eine eigene Seite (z. B. "Forum") anlegen
• Nur diesen Shortcode als Seiteninhalt verwenden

7) Bedienung im Frontend (Mitglieder)

7.1 Registrierung und Login

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

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

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

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

7.5 Umfragen

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

7.6 Reaktionen, Likes, Lesezeichen

• Likes auf Thread/Beitrag
• Emoji-Reaktionen (adminseitig konfigurierbar)
• Lesezeichen für Threads (im Profil einsehbar)

7.7 Private Nachrichten (DM)

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

7.8 Benachrichtigungen

Benachrichtigungen bei:

• Antworten auf abonnierte / relevante Threads
• @Erwähnungen
• neuen privaten Nachrichten

7.9 Profil

Mitglieder können:

• Anzeigenamen, Bio und Signatur pflegen
• Avatar hochladen
• Passwort ändern
• eigene Profil-Sichtbarkeit umschalten
• benutzerdefinierte Profilfelder ausfüllen (falls aktiviert)

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 gültigen Token.

8) Moderation und Verwaltung

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

• Übersicht: Dashboard mit Kennzahlen und Aktivitäten
• Kategorien: Struktur und Sichtbarkeit verwalten
• Rollen: Rollen/Permissions anpassen
• Level: Beitragsbasierte Rangstufen
• Mitglieder: Nutzer verwalten
• 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

9.2 Sicherheit

• Auto-Logout nach Inaktivität (0 = deaktiviert)
• Post-Bearbeitungslimit
• Spam-Mindestzeit bei Registrierung
• Flood-Control Intervall
• Profil-Sichtbarkeit (Standard)

9.3 Registrierung

• Modus:
  • offen
  • nur Einladung
  • deaktiviert
• Freitext-Hinweis für Einladungsmode

9.4 Wartungsmodus

• Forum für normale Nutzer sperren
• Moderation/Admin behalten Zugriff
• 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

---

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

Viel Erfolg mit deinem Forum!