Das WOHNO-WordPress-Plugin im Detail: Inserate nativ einbinden – Funktion, Vorteile, Grenzen & Einrichtung

Du pflegst deine Inserate in WOHNO und möchtest sie auf deiner eigenen WordPress-Seite zeigen – aktuell, ansprechend und ohne doppelte Datenpflege. Genau dafür gibt es das WOHNO-WordPress-Plugin. Dieser Artikel erklärt ausführlich, wie es funktioniert, was es technisch und konzeptionell besonders macht, wo seine Grenzen liegen und wie du es in wenigen Minuten einrichtest – inklusive Shortcode-Referenz und Tipps zur Fehlersuche.

Was das Plugin macht – in einem Satz#

Das Plugin holt deine Inserate über die WOHNO-API und rendert sie als natives, SEO-freundliches HTML direkt auf deiner WordPress-Seite. Ein Klick öffnet die Detailansicht; die Bewerbung läuft first-party auf wohno.de – inklusive Bewerbermappe, persönlicher Daten und DSGVO-Verantwortung. So zeigst du ein hochwertiges Schaufenster auf deiner Domain, ohne dass Bewerberdaten auf deinem Server entstehen.

Die Idee dahinter: Schaufenster auf deiner Domain, Mappe bei WOHNO#

Klassische Immobilien-Plugins gehen einen von zwei Wegen: Entweder laden sie ein iFrame (schlecht für SEO), oder sie verlangen, dass du Objekte und Bewerbungen selbst hostest (viel DSGVO-Verantwortung). Das WOHNO-Plugin trennt beides sauber:

• Die Übersicht wird als echtes Theme-HTML auf deiner Domain gerendert – Google indexiert sie, deine Seite gewinnt an Inhalt und Reichweite.
• Die Detailseite und die Bewerbung liegen kanonisch auf wohno.de. Dort läuft der gesamte sensible Teil: Login, Bewerbermappe, Einkommensnachweise, Einwilligung, DSGVO.

Wie das Plugin technisch funktioniert#

Unter der Haube arbeitet das Plugin server-zu-server: Dein WordPress-Server ruft die WOHNO-API auf, nicht der Browser deiner Besucher. Das hat drei wichtige Konsequenzen.

1. 1

   Serverseitiger Abruf

   Der API-Key wird ausschließlich serverseitig verwendet und nie an den Browser ausgeliefert. Die Inserate kommen als fertiges HTML in die Seite – Suchmaschinen sehen echten Inhalt, nicht ein leeres iFrame.

2. 2

   Nicht-blockierendes Rendering mit Caching

   Jede Abfrage hat ein „Fresh“-Fenster (rund fünf Minuten) und ein längeres „Retain“-Fenster (rund ein Tag). Frische Treffer kommen sofort aus dem Cache; veraltete liefern den Cache und stoßen im Hintergrund eine Aktualisierung an. Nur der allererste Aufruf einer Abfrage holt synchron. So wartet deine Seite nie auf die API.

3. 3

   Hintergrund-Prewarm

   Ein Hintergrundjob (WP-Cron, alle fünf Minuten) hält bekannte Abfragen warm. Die Aktualisierung ist ETag-validiert – hat sich nichts geändert, kostet das kein API-Kontingent.

Praktisch heißt das: Auch bei vielen Besuchern bleibt die Seite schnell, und dein API-Kontingent wird geschont. Der einzige Kompromiss: Neue oder geänderte Inserate erscheinen durch das Caching leicht verzögert.

Funktionsumfang im Überblick#

• Vier Darstellungen: Raster, große Karten, Liste und eine interaktive Karte (Leaflet + OpenStreetMap, ohne API-Key).
• Drei Wege zum Einbinden: Gutenberg-Block „Wohno – Inserate“, klassisches Widget und der Shortcode [wohno_listings] – plus fertige Block-Patterns.
• Bildergalerie & Detail-Modal: Jede Karte zeigt alle Fotos; ein Klick öffnet eine In-Page-Detailansicht mit Beschreibung, Eckdaten und Kostenaufschlüsselung (Kalt-, Neben-, Heizkosten, Warmmiete, Kaution).
• Frontend-Suche: eine optionale Filterleiste (Stadt, Zimmer, Miete, Typ, WBS, Freitext) – serverseitig und SEO-freundlich.
• „Mehr laden“: Cursor-basierte Pagination für lange Listen.
• Einzelnes Inserat: [wohno_listing id="…"] bindet genau ein Inserat ein.
• Branding: Akzentfarbe und Ecken-Rundung in den Einstellungen anpassbar; das Karten-Template lässt sich im Theme überschreiben.
• Mehrsprachig: Das Plugin folgt der Sprache deiner Seite (Deutsch/Englisch).

Die vier Layouts im Detail#

• Raster: kompaktes Karten-Raster mit ein bis vier Spalten – der Allrounder für eine Übersichtsseite.
• Große Karten: bildbetonte Karten für eine prominente Präsentation weniger Objekte.
• Liste: platzsparende Listenansicht, ideal bei vielen Objekten.
• Interaktive Karte: Leaflet mit OpenStreetMap-Kacheln, ganz ohne API-Key. Nur Inserate mit Koordinaten werden verortet; ohne Karten-Layout findet keine Verbindung zu OpenStreetMap statt.

Sicherheit im Detail#

Sicherheit ist beim Umgang mit einem API-Key entscheidend. Das Plugin geht hier bewusst streng vor:

• Der API-Key wird nur serverseitig in wp_options gespeichert – verschlüsselt mit AES-256-GCM, sofern AUTH_KEY/SECURE_AUTH_KEY in der wp-config.php gesetzt sind (WordPress-Standard) und der Server openssl bereitstellt.
• Er wird ausschließlich über HTTPS im X-API-Key-Header gesendet, nie im Query-String, nie im Seitenquelltext und nie im Browser.
• Eine versehentliche Nicht-HTTPS-Konfiguration der API-Basis wird abgelehnt, damit der key-tragende Request nie auf Klartext herabgestuft werden kann.
• Auf deiner Website entstehen keine Bewerberdaten – der sensible Teil läuft first-party auf wohno.de.

Die Vorteile#

1. 1

   Pflege nur an einer Stelle

   Du pflegst deine Inserate genau einmal in WOHNO. Das Plugin zeigt sie automatisch synchron auf deiner Website – keine doppelte Datenhaltung, keine veralteten Exposés.

2. 2

   SEO-freundlich statt iFrame

   Die Übersicht ist echtes HTML auf deiner Domain und damit indexierbar. Du gewinnst Inhalt und Sichtbarkeit, ohne ein eigenes Portal zu bauen.

3. 3

   DSGVO bleibt bei WOHNO

   Bewerbung und Bewerbermappe laufen first-party auf wohno.de. Auf deiner Seite entstehen keine Bewerberdaten – die datenschutzrechtliche Verantwortung dafür bleibt bei WOHNO.

4. 4

   Sicher & schnell

   Der API-Key wird serverseitig verschlüsselt gespeichert und nie im Browser preisgegeben. Caching und Hintergrund-Prewarm sorgen dafür, dass das Rendering deiner Seite nie auf die API wartet.

Die Grenzen – ehrlich benannt#

Kein Tool ist für jeden Fall ideal. Diese Punkte solltest du kennen:

• Du brauchst ein WOHNO-Konto. Ohne API-Key mit dem Scope listings:read zeigt das Plugin nichts an. Das Modell lohnt sich, wenn du deine Inserate ohnehin in WOHNO pflegst (oder pflegen willst).
• Die Detailseite liegt auf wohno.de. Das ist gewollt – dort läuft die Bewerbung DSGVO-sicher. Wer die komplette Detailseite zwingend auf der eigenen Domain braucht, wählt ein anderes Modell.
• „Diskrete“ Inserate werden nicht angezeigt. Sie werden bewusst nicht über die API ausgeliefert, weil bei diskreten Objekten der Vermieter zuerst die passenden Interessenten auswählt.
• Caching bedeutet kurze Verzögerung. Neue oder geänderte Inserate erscheinen durch das rund fünfminütige Caching leicht verzögert – ein bewusster Kompromiss zugunsten von Performance und API-Kontingent.

So richtest du das Plugin ein#

1. 1

   API-Key erstellen

   Erstelle im WOHNO-Dashboard unter „API-Keys“ einen geheimen Key (sk_…) mit dem Scope listings:read.

2. 2

   Plugin installieren & verbinden

   Installiere und aktiviere das Plugin, öffne das neue „Wohno“-Menü in der WordPress-Seitenleiste, füge den Key im Reiter „Verbindung“ ein und klicke auf „Verbindung testen“.

3. 3

   Darstellung wählen

   Lege im Reiter „Darstellung“ Standard-Layout, Spalten, Akzentfarbe und Rundung fest.

4. 4

   Inserate einbinden

   Platziere den Block „Wohno – Inserate“, nutze ein Widget oder kopiere einen Shortcode aus dem Reiter „Einbinden“ (mit Live-Vorschau und Shortcode-Generator).

Ein typischer Shortcode mit Filtern sieht so aus:

[wohno_listings city="Köln" rooms_min="2" rent_max="1200" layout="grid" columns="3"]

Shortcode-Referenz (Auszug)#

Die vollständige Referenz, alle Attribute und Tipps zur Fehlersuche findest du in der Entwickler-Dokumentation zum Plugin.

Jetzt das WOHNO-Plugin einrichten

Inserate nativ und SEO-freundlich auf deiner WordPress-Seite zeigen – Bewerbung und Bewerbermappe bleiben DSGVO-sicher bei WOHNO.

Zum Plugin

FAQ – häufig gestellte Fragen#