Troubleshooting Plugin-Verbindung

Wenn das Dashboard deine Site als offline anzeigt, Pushs fehlschlagen oder Content nicht updated, arbeite diese Liste von oben nach unten durch. Sortiert nach Wahrscheinlichkeit.

Schneller Entscheidungsbaum

Site zeigt "Offline" im Dashboard
├── Plugin nicht installiert/aktiviert → installieren + aktivieren
├── Plugin installiert, Dashboard zeigt "Nicht verbunden" → Verbindungscode neu einfügen
├── Plugin installiert + verbunden, aber kein Heartbeat
│   ├── Heartbeat-Cron nicht geplant → siehe Abschnitt 1
│   ├── Heartbeat per Filter geblockt → siehe Abschnitt 2
│   ├── Ausgehendes Netzwerk geblockt → siehe Abschnitt 3
│   └── api_secret nicht synchron → siehe Abschnitt 4
└── Plugin verbunden + Heartbeats aber Pushs scheitern → siehe Abschnitt 5

Abschnitt 1 — Heartbeat-Cron nicht geplant

hubbee_heartbeat ist ein WordPress-Cron-Event, das das Plugin alle 5 Minuten registriert. Wenn der Schedule fehlt, gibt’s keine Heartbeats.

Check via WP-CLI:

wp cron event list | grep hubbee

Wenn hubbee_heartbeat fehlt:

wp eval 'do_action("hubbee_init_cron");'

Bei DISABLE_WP_CRON = true brauchst du einen serverseitigen Cron, der wp-cron.php alle 5 Min pingt.

Abschnitt 2 — Heartbeat per Filter geblockt

Manche Security-Plugins (Wordfence, iThemes Security mit aggressiven Settings) blocken pre_http_request für unbekannte Domains. Hubbees Heartbeats werden dann stumm verworfen.

Check Plugin-Debug-Log (WP-Admin → Hubbee → Einstellungen → Debug-Log). Wenn keine ausgehenden Versuche geloggt sind, prüf:

• Wordfence → Firewall → Whitelisted IPs/URLs → api.hubbee.io hinzufügen
• iThemes Security → Network Brute Force Protection → Allowed-Hosts → api.hubbee.io

Abschnitt 3 — Ausgehendes Netzwerk geblockt

Manche Hoster (besonders Shared Hosting) blocken ausgehende HTTPS-Requests von WP. Test vom Server:

curl -I https://api.hubbee.io/healthz

Erwartet: HTTP/2 200. Bei Timeout: Host kontaktieren und api.hubbee.io (Port 443) auf der Outbound-Firewall freigeben lassen.

Abschnitt 4 — api_secret nicht synchron

Häufige Ursache: Du hast die Produktiv-DB nach Staging geklont (oder umgekehrt). Beide Sites haben jetzt dasselbe api_secret, aber Hubbee hat nur eine registriert.

Symptom: 401 Unauthorized im Plugin-Debug-Log.

Fix: Auf der “falschen” Site (Staging) den Verbinden-Flow neu durchlaufen. Sie bekommt frischen api_secret.

Warnung: Klone nie verbundene WP-DBs zwischen Umgebungen ohne nach Klon den bz_api_secret-Option zu droppen und neu zu verbinden.

Abschnitt 5 — Pushs scheitern trotz Verbindung

Siehe Push fehlgeschlagen für die volle Per-Kategorie-Diagnose. Häufigste:

• auth_failed → siehe Abschnitt 4 oben (api_secret-Drift)
• timeout → WP-Server überlastet oder ein Plugin blockiert den REST-Endpoint
• processed_with_errors → cache_invalidation_failed → Cache-Plugin-Konflikt. Siehe Cache-Konflikte.

Erweiterte Diagnose

Manuellen Heartbeat erzwingen (WP-CLI):

wp eval 'hubbee_send_heartbeat();'

Plugin-Health-Endpoint testen:

curl -X POST https://your-site.example/wp-json/bz/v1/health -m 35

Sollte {"ok":true,"plugin_version":"x.y.z"} zurückgeben. Bei Hang/Error → WP-REST-API-Layer-Problem.

Wenn nichts hilft

support@hubbee.io mit:

• Site-URL
• Plugin-Version
• WP-Version + PHP-Version
• Letzte 20 Zeilen Plugin-Debug-Log
• Output von wp cron event list | grep hubbee