WordPress-Site verbinden

Diese Seite behandelt den Verbindungs-Flow im Detail. Für einen 2-Minuten-Happy-Path siehe Quick-Start.

Wie die Verbindung funktioniert

Beim Verbinden tauschen Hubbee und das WordPress-Plugin einen einmaligen Onboarding-Token aus, um sich gegenseitig zu authentifizieren. Nach dem Handshake:

• Das Plugin speichert ein verschlüsseltes api_secret für HMAC-signierte Pushs
• Das Dashboard speichert die REST-Endpoint-URL und Metadaten der Site
• Ein Heartbeat-Cron-Job (Standard alle 5 Minuten) meldet den Status der Site

Der Onboarding-Token ist Einmal-Verwendung und läuft nach 1 Stunde ab. Einmal benutzt, kann er nicht wiederverwendet werden — selbst auf derselben Site nicht.

Standard-Flow (wordpress.org-Plugin)

Empfohlen für Produktiv-Sites:

1. Hubbee-Dashboard → Sites → Site hinzufügen
2. Anzeigename eintragen (nur innerhalb Hubbee sichtbar, nie auf der WP-Site)
3. Code generieren → den hb_onb_…-Token kopieren
4. WP-Admin → Plugins → Installieren → “Hubbee” suchen → Jetzt installieren → Aktivieren
5. WP-Admin → Hubbee → Einstellungen → Verbindungscode einfügen → Verbinden
6. Seite lädt neu mit Verbunden binnen 2-3 Sekunden

Manuelle ZIP-Installation (ohne Internet / Staging)

Für air-gapped Umgebungen oder Staging-Hosts ohne wordpress.org-Zugriff:

1. Im Site hinzufügen-Dialog auf Plugin-ZIP herunterladen klicken
2. WP-Admin → Plugins → Installieren → Plugin hochladen → ZIP wählen
3. Jetzt installieren → Aktivieren
4. Mit Schritten 5-6 oben weiter

Das manuelle Plugin ist identisch zur wordpress.org-Version — selber Code, selbe Auto-Update-Mechanik.

Staging-Umgebungen

Du kannst sowohl staging.example.com als auch example.com als separate Sites verbinden:

• Jede bekommt ihren eigenen Verbindungscode
• Jede behält ihr eigenes api_secret
• Push an eine ohne Auswirkung auf die andere
• Mit Bulk-Push denselben Content an beide schicken nach Staging-Review

Warnung: Klone keine verbundene Staging-Site-DB nach Produktion. Das geklonte Plugin erbt das Staging-api_secret, was Hubbee ablehnt. Immer Verbinden auf der neuen Umgebung neu durchlaufen.

WordPress-Multisite-Netzwerke

Hubbee behandelt jede Sub-Site eines Multisite als separate verbundene Site. Plugin einmal auf Netzwerk-Ebene netzwerk-aktivieren, dann den Verbinden-Flow auf jeder Sub-Site einzeln durchlaufen.

Das Plugin modifiziert nur die DB der aktiven Sub-Site — nie die Netzwerk-Meta. Du kannst 3 Sub-Sites eines 10-Site-Netzwerks verbinden, ohne die anderen 7 zu beeinflussen.

Verbindungscode funktioniert nicht

Wenn beim Einfügen “Ungültig oder abgelaufen” erscheint:

• Über eine Stunde gewartet? Tokens laufen nach 60 Minuten ab. Frischen generieren.
• Vorherigen Code kopiert? Tokens sind Einmal-Verwendung. Frischen generieren.
• Versteckte Whitespace-Zeichen? Direkt aus dem Dashboard kopieren, nicht aus E-Mail-Forwards. Whitespace vorher trimmen.

Wenn der Code frisch + ungenutzt ist und trotzdem fehlschlägt, siehe Plugin offline.

Was als Nächstes passiert

Binnen 2-3 Sekunden nach Verbinden:

• Plugin erstellt zwei DB-Tabellen: wp_bz_tokens und wp_bz_processed_requests
• Verschlüsseltes api_secret wird in wp_options gespeichert
• hubbee_heartbeat-Cron-Schedule wird registriert
• bz/v1-REST-Namespace wird für eingehende Pushs verfügbar

Du kannst jetzt deinen ersten Content-Token pushen. Für laufende Health-Checks siehe Site Health & Monitoring.