Quick-Start — verbinde deine erste WordPress-Site

Diese Anleitung geht davon aus, dass du einen Hubbee-Account hast (kostenlos auf hubbee.io/register) und eine WordPress-Site, die du verbinden möchtest. Gesamtdauer: ca. 2 Minuten.

Schritt 1 — Verbindungscode generieren

In deinem Hubbee-Dashboard:

1. Klick rechts oben in der Sites-Liste auf Site hinzufügen
2. Trag einen Anzeigenamen ein (z.B. kunde-foo) — nur für deine eigene Übersicht, nicht auf der WP-Site sichtbar
3. Klick Code generieren → ein einmaliger Onboarding-Token erscheint, 1 Stunde gültig
4. Kopieren drücken (der Token sieht aus wie hb_onb_… — bleibt in der Zwischenablage)

Hinweis: Onboarding-Tokens sind Einmal-Verwendung. Wenn du ihn nicht innerhalb einer Stunde einfügst, generier einen neuen.

Schritt 2 — Hubbee-Plugin installieren

Option A — über wordpress.org (empfohlen, Auto-Updates):

1. WP-Admin → Plugins → Installieren
2. Suche nach Hubbee
3. Jetzt installieren → Aktivieren

Option B — manuelle ZIP (z.B. für Staging ohne Internet):

1. Lade hubbee.zip im Dashboard-Dialog Site hinzufügen runter
2. WP-Admin → Plugins → Installieren → Plugin hochladen → ZIP wählen → Installieren → Aktivieren

Schritt 3 — Verbinden

1. Im WP-Admin in die Hubbee → Einstellungen (linke Sidebar)
2. Verbindungscode ins Feld Verbindungscode einfügen
3. Verbinden klicken

Innerhalb von 2-3 Sekunden lädt die Seite neu und zeigt Verbunden an, dazu deine site_id und den SaaS-Endpunkt. Das Plugin hat:

• Zwei Tabellen angelegt: wp_bz_tokens + wp_bz_processed_requests
• Ein verschlüsseltes api_secret für künftige HMAC-Signaturen gespeichert
• Einen hubbee_heartbeat Cron-Job gestartet (Standard: alle 5 Minuten)
• Den bz/v1 REST-Namespace für eingehende Pushs registriert

Schritt 4 — Im Dashboard prüfen

Zurück auf app.hubbee.io. Die Site sollte erscheinen:

• Status: Online (grüner Punkt)
• Letzter Heartbeat: vor wenigen Sekunden
• WP-Version, PHP-Version, Plugin-Version: ausgefüllt

Wenn der Status länger als 30 Sekunden grau bleibt → siehe Plugin offline.

Schritt 5 — Ersten Token pushen

Im Dashboard:

1. Klick deine Site an → Tab Tokens
2. + Neue Token-Definition
3. Key: hero_title (lowercase, snake_case)
4. Label: Hero Title (menschlich lesbar)
5. Feldtyp: text (oder richtext für HTML)
6. Sektion: general (organisatorische Gruppierung)
7. Definition speichern

Jetzt einen Wert setzen:

1. Token anklicken → Wert hinzufügen
2. Locale: leer lassen (oder de_DE für reines Deutsch)
3. Wert: Willkommen auf meiner Hubbee-Site!
4. Speichern & Pushen

Der Push läuft sofort. Im Activity-Stream siehst du das Ergebnis:

• Site: kunde-foo
• Result: processed: 1, skipped: 0, errors: []
• Latenz: meist <1 Sekunde

Schritt 6 — Token auf der WordPress-Site rendern

In Elementor (oder jedem Theme mit Shortcode-Support):

[bz_text key="hero_title"]

Oder als Elementor Dynamic Tag: Hubbee → Text Token wählen und hero_title auswählen.

Der Token rendert den zuletzt gepushten Wert im Frontend. Jeder neue Push aktualisiert die Anzeige binnen Sekunden (Cache erlaubend — siehe Cache-Konflikte).

Wie geht’s weiter?

• Mehr Sites: wiederhol Schritte 1-3 für jede Site. Jede bekommt ihren eigenen Verbindungscode + api_secret.
• Bulk-Push: mehrere Sites im Dashboard auswählen → An ausgewählte pushen. Eine Quelle, viele Sites.
• Multi-Locale: Per-Locale-Werte (z.B. de_DE, en_US) — das Plugin wählt zur Render-Zeit basierend auf get_locale().
• Rich Text + Komponenten: siehe Token Management Best Practices.
• Multi-Workspace für Agenturen: siehe Multi-Workspace (Agency-Plan).

Probleme?

• Plugin lässt sich nicht aktivieren: PHP < 7.4? PHP updaten.
• Verbindungscode abgelehnt: Token abgelaufen oder bereits benutzt. Neuen generieren.
• Site erscheint nicht im Dashboard: siehe Plugin offline.
• Push-Fehler: siehe Push fehlgeschlagen.

Hängengeblieben? support@hubbee.io.