Troubleshooting

Lösungen für häufige Probleme bei WBCE-Installationen.

Backend-Login funktioniert nicht

Symptom: Login schlägt fehl obwohl Zugangsdaten korrekt sind, oder "Zu viele Fehlversuche".

Ursache 1: HTTPS-Weiterleitung Wenn der Hoster automatisch auf HTTPS weiterleitet aber in der config.php noch http:// steht, schlägt die Session-Validierung fehl.

Lösung: In config.php die URL auf https:// ändern:

define('WB_URL', 'https://deine-domain.de');

Ursache 2: CAPTCHA blockiert Login Bei zu vielen Fehlversuchen kann das CAPTCHA den Login dauerhaft blockieren.

Lösung: In config.php eintragen:

define('NO_LOGIN_CAPTCHA', true);

Nach erfolgreichem Login wieder entfernen.

Ursache 3: Defektes Backend-Theme Ein fehlerhaftes oder inkompatibles Backend-Theme kann den Login verhindern.

Lösung: Backend-Theme über das Script reset_admin_theme zurücksetzen: github.com/WBCE/wbce_tools/tree/master/reset_admin_theme

Installationsfehler e22 / e20

Symptom: Installer meldet e22 (Datenbankzugriff verweigert) oder e20.

Häufige Ursachen:

  • Falscher Datenbankhost — bei manchen Hostern (z.B. Strato) nicht localhost sondern ein externer Hostname
  • Falsche Datenbankzugangsdaten
  • Datenbank existiert noch nicht — zuerst im Hoster-Backend anlegen

Lösung: Neue Datenbank im Hoster-Backend anlegen und die Zugangsdaten nochmals sorgfältig prüfen.

Installer hängt / config.php fehlt

Symptom: Installer bricht ab, keine config.php vorhanden.

Lösung: config.php.new im Wurzelverzeichnis manuell in config.php umbenennen und Installation erneut versuchen.

Weißer Bildschirm (White Screen)

Symptom: Seite zeigt nichts an, kein Fehler sichtbar.

Mögliche Ursachen:

  • PHP-Fehler der nicht angezeigt wird
  • Fehlende PHP-Extension

Lösung: PHP-Fehlerausgabe vorübergehend aktivieren — in config.php:

define('WB_DEBUG', true);

Oder in den Grundeinstellungen unter "PHP-Fehlermeldungen" auf höheren Level stellen. Nach Behebung wieder deaktivieren.

Accessfile konnte nicht angelegt werden

Symptom: Neue Seite wird angelegt aber im Frontend nicht gefunden.

Ursache: PHP hat keine Schreibrechte auf das /pages-Verzeichnis.

Lösung: Dateiberechtigungen des /pages-Verzeichnisses prüfen — muss für den PHP-Prozess beschreibbar sein (mind. 0755, ggf. 0775).