Was das Smoobu-WordPress-Plugin leistet
Das Plugin verbindet dein WordPress-Konto per API-Schlüssel mit Smoobu und stellt ein Buchungswidget als nativen WordPress-Block oder Shortcode bereit. Anders als bei einer reinen Iframe-Einbettung fügt sich das Widget dabei enger in dein Theme ein, da es über WordPress-eigene Mechanismen gerendert wird statt über ein eingebettetes fremdes Dokument. Verfügbarkeit, Preise und Mindestaufenthalt werden live aus Smoobu gezogen — du musst nichts doppelt pflegen.
Plugin-Name, genaue Einstellungsbezeichnungen und Funktionsumfang können sich zwischen Versionen unterscheiden — prüfe den aktuellen Eintrag im WordPress-Plugin-Verzeichnis und die Smoobu-Hilfe-Dokumentation vor der Einrichtung. Wenn dein Website-Baukasten kein WordPress ist (Wix, Squarespace, eigenes HTML) oder du lieber ohne Plugin arbeitest, ist die Iframe-Einbettung die passendere Methode.
Schritt 1 — Voraussetzungen prüfen
Bevor du das Plugin installierst, zwei Dinge sicherstellen:
Natives WordPress-Plugin
Buchungswidget als WordPress-Block oder Shortcode, verwaltet über das Plugin-Verzeichnis und automatische Updates.
- Erfordert Admin-Zugriff auf das WordPress-Dashboard
- Updates laufen über die reguläre WordPress-Plugin-Verwaltung
- Engere Theme-Integration als ein Iframe
Iframe-Einbettung
Funktioniert auf jeder Website — WordPress, Wix, Squarespace oder eigenem HTML. Siehe die separate Anleitung zur Buchungsseiten-Einbettung.
- Kein Plugin nötig, funktioniert überall
- Etwas weniger Theme-Integration
- Sinnvoll bei Page-Buildern ohne Plugin-Unterstützung
Schritt 2 — Plugin installieren und aktivieren
- Im WordPress-Dashboard: gehe zu Plugins → Installieren.
- Suche im Suchfeld nach "Smoobu". Das offizielle Plugin im WordPress-Verzeichnis prüfen (Autor, Bewertungen, letztes Update-Datum) — Name und Version können sich ändern, verifiziere den aktuellen Eintrag vor der Installation.
- Klicke auf Jetzt installieren und anschließend auf Aktivieren.
- Nach der Aktivierung erscheint ein neuer Menüpunkt "Smoobu" (oder ähnlich benannt) im WordPress-Dashboard.
Falls die Plugin-Suche keine Treffer liefert, kann das Plugin auch als ZIP-Datei von der Smoobu-Hilfe-Seite heruntergeladen und unter Plugins → Installieren → Plugin hochladen manuell installiert werden.
Schritt 3 — Mit deinem Smoobu-Konto verbinden
Das Plugin braucht Zugriff auf dein Smoobu-Konto, um Unterkünfte, Preise und Verfügbarkeit zu ziehen. Das läuft über einen API-Schlüssel.
- In Smoobu: gehe zu Einstellungen → Kanäle → API (Bezeichnung kann je nach Kontosprache leicht abweichen) und kopiere deinen persönlichen API-Schlüssel.
- In WordPress: öffne die Smoobu-Plugin-Einstellungsseite und füge den API-Schlüssel in das dafür vorgesehene Feld ein.
- Speichern. Das Plugin sollte nun deine Unterkünfte aus Smoobu auflisten. Erscheint keine Unterkunft, prüfe, ob der API-Schlüssel korrekt kopiert wurde (keine Leerzeichen am Anfang/Ende) und ob dein Smoobu-Plan API-Zugriff enthält.
- Verbindung testen: öffne die Vorschau des Widgets im Plugin-Bereich — Preise und Verfügbarkeit sollten mit deinem Smoobu-Kalender übereinstimmen.
Der API-Schlüssel gewährt Lesezugriff auf Preise und Verfügbarkeit. Behandle ihn wie ein Passwort — nicht öffentlich teilen und bei Verdacht auf Missbrauch in Smoobu neu generieren.
Schritt 4 — Buchungswidget auf einer Seite einfügen
Sobald die Verbindung steht, kannst du das Widget auf jeder beliebigen WordPress-Seite platzieren.
- Öffne die Seite, auf der das Widget erscheinen soll, im WordPress-Editor.
- Gutenberg-Editor: Block hinzufügen (+) → nach "Smoobu" suchen → den Buchungswidget-Block einfügen. Klassischer Editor: den vom Plugin bereitgestellten Shortcode (z. B. in der Form [smoobu_widget id="..."] — genaue Syntax in der Plugin-Dokumentation prüfen) in einen Text-/HTML-Block einfügen.
- Im Block-/Shortcode-Einstellungsbereich die gewünschte Unterkunft auswählen, falls du mehrere Objekte in Smoobu verwaltest.
- Anzeigeform wählen: Verfügbarkeitskalender, Suchformular mit Datumsauswahl, oder Kombination — je nach Plugin-Version stehen unterschiedliche Layouts zur Verfügung.
- Seite veröffentlichen oder aktualisieren. Das Widget zeigt live die Daten aus Smoobu, ohne dass du Preise manuell in WordPress pflegen musst.
Optional: mehrere Unterkünfte & Design anpassen
Verwaltest du mehrere Objekte in Smoobu, erlauben die meisten Plugin-Versionen entweder ein Widget pro Unterkunft (mehrere Shortcodes/Blöcke auf verschiedenen Seiten) oder ein kombiniertes Auswahl-Widget, in dem Gäste zuerst die Unterkunft wählen. Welche Variante verfügbar ist, hängt von der installierten Plugin-Version ab — prüfe die Einstellungsseite des Plugins auf eine entsprechende Option.
Für das visuelle Erscheinungsbild bieten viele Plugin-Versionen einfache Anpassungsoptionen (Akzentfarbe, Schriftgröße) direkt in den Plugin-Einstellungen. Reicht das nicht aus, kann zusätzliches CSS über Design → Customizer → Zusätzliches CSS eingefügt werden — die exakten CSS-Klassennamen des Widgets findest du über die Entwicklerkonsole des Browsers (Rechtsklick → Untersuchen).
Häufige Probleme beheben
Plugin zeigt "Nicht verbunden", obwohl der API-Schlüssel korrekt aussieht
Häufigste Ursache: ein unsichtbares Leerzeichen beim Kopieren des Schlüssels. Lösche das Feld komplett, kopiere den Schlüssel erneut direkt aus Smoobu und füge ihn ohne zusätzliche Formatierung ein. Prüfe außerdem, ob dein Smoobu-Tarif API-Zugriff beinhaltet — bei manchen Einstiegstarifen ist das eingeschränkt, aktuelle Tarifdetails auf smoobu.com/pricing prüfen.
Preise oder Verfügbarkeit im Widget stimmen nicht mit Smoobu überein
Das Widget zieht Daten meist mit einer kurzen Verzögerung (oft wenige Minuten) aus der Smoobu-API — kein Echtzeit-Push. Bei größeren Abweichungen prüfe zuerst direkt in Smoobu, ob Preise und Kalender dort korrekt gepflegt sind, und leere anschließend den WordPress-Cache (falls ein Cache-Plugin aktiv ist), da gecachte Seiten veraltete Widget-Daten anzeigen können.
Widget-Design passt nicht zum Theme
Das ist der häufigste Kompromiss bei Drittanbieter-Widgets. Prüfe zuerst die Design-Einstellungen im Plugin selbst (Akzentfarbe, Schriftart). Reicht das nicht, kann zusätzliches CSS über den WordPress-Customizer ergänzt werden. Bei sehr individuellen Themes kann die Iframe-Variante mit eigenem CSS-Wrapper mehr Kontrolle bieten.
Shortcode erscheint als reiner Text auf der veröffentlichten Seite
Das bedeutet meist, dass der Shortcode in einem klassischen Text-Block statt einem "Shortcode"-fähigen Block eingefügt wurde, oder dass das Plugin deaktiviert wurde. Prüfe unter Plugins, dass Smoobu aktiv ist, und füge den Shortcode in Gutenberg über den dedizierten "Shortcode"-Block statt einen normalen Absatz-Block ein.
Mehrere Unterkünfte sollen im selben Widget wählbar sein
Prüfe in den Plugin-Einstellungen, ob eine "Alle Unterkünfte"- oder "Mehrfachauswahl"-Option existiert — das hängt von der Plugin-Version ab. Ist das nicht verfügbar, platziere pro Unterkunft ein eigenes Widget auf der jeweiligen Objektseite und verlinke von einer zentralen Übersichtsseite dorthin.