JustImmo WordPress-Plugin: Immobilien automatisch importieren
WP-ImmoMakler ist das WordPress-Plugin für JustImmo: Es überträgt Ihre Immobilien per OpenImmo-Schnittstelle automatisch von JustImmo auf Ihre WordPress-Website.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- Ein JustImmo-Zugang mit aktivierbarem OpenImmo-Export (Portalschnittstelle)
- Die FTP- oder SFTP-Zugangsdaten Ihres Webservers — diese erhalten Sie von Ihrem Webhoster
- Eine WordPress-Website mit installiertem WP-ImmoMakler; das Übergabeverzeichnis
/openimmo/legt das Plugin automatisch an
OpenImmo-Export in JustImmo einrichten
Abschnitt betitelt „OpenImmo-Export in JustImmo einrichten“Die Verbindung zwischen JustImmo und WP-ImmoMakler erfolgt über den OpenImmo-Export. Richten Sie in JustImmo eine neue Portalschnittstelle ein und tragen Sie die FTP- oder SFTP-Zugangsdaten zu Ihrem Webserver ein.
Konfigurieren Sie dabei folgende Felder:
- Portalname: Ein aussagekräftiger Name, z. B. “Website”, “Homepage” oder “WP-ImmoMakler”
- Anbieter-Nummer: Eine beliebige Zahl — in der Regel “1”, wenn Sie der einzige Anbieter sind
- FTP-Ordner: Standardmäßig
/openimmo/im WordPress-Rootverzeichnis. Wenn WordPress in einem Unterverzeichnis installiert ist, geben Sie den vollständigen Pfad vom FTP-Root an, z. B./clickandbuilds/app/wordpress_1/openimmo/ - FTP-Port: Port 21 für FTP, FTPS oder FTP/TLS; Port 22 für SFTP/SSH
- Dateinamen: Mit dem Platzhalter
%date1%können Sie einen Zeitstempel in die Dateinamen einfügen. Beispiel:openimmo_%date1%.zip - Videos: Optional aktivieren, um Videos in die Übertragung einzubeziehen
Das folgende Beispiel zeigt die Konfiguration einer SFTP-Verbindung in JustImmo:
Referenzobjekte
Abschnitt betitelt „Referenzobjekte“Um Referenzobjekte auf Ihrer Website darzustellen, lesen Sie den Artikel Referenzobjekte darstellen.
Bei Fragen zur Konfiguration wenden Sie sich gerne an den Support.
So funktioniert der automatische Import
Abschnitt betitelt „So funktioniert der automatische Import“Nach der Einrichtung überträgt JustImmo bei jedem Export eine OpenImmo-Datei in das Verzeichnis /openimmo/ Ihrer Website. Dort übernimmt WP-ImmoMakler: Das Plugin verarbeitet eingehende Dateien automatisch, legt neue Immobilien an, aktualisiert geänderte und entfernt Objekte, die in JustImmo gelöscht wurden. Für einen verlässlichen Rhythmus empfiehlt sich ein Server-Cronjob.
Fotos, Grundrisse und Dokumente aus dem Export werden automatisch in die WordPress-Mediathek importiert. Ob verarbeitete Dateien danach gelöscht werden und ob Sie über erfolgreiche Importe per E-Mail informiert werden möchten, legen Sie in den Import-Einstellungen fest.
Bauprojekte über die JustImmo-API importieren PLUS
Abschnitt betitelt „Bauprojekte über die JustImmo-API importieren “Der OpenImmo-Export überträgt nur die einzelnen Einheiten eines Bauprojekts, nicht das Bauprojekt selbst. Damit die Projektseite mit Beschreibung, Bildern und Grundrissen nicht von Hand gepflegt werden muss, holt WP-ImmoMakler die Bauprojekte direkt über die JustImmo-API.
Beides greift ineinander: Die Einheiten kommen weiterhin über den OpenImmo-Export, das Bauprojekt über die API. WP-ImmoMakler verbindet die beiden automatisch, sodass die Einheiten auf der Projektseite in der Übersichtstabelle erscheinen.
JustImmo-API-Zugangsdaten
Abschnitt betitelt „JustImmo-API-Zugangsdaten“Die API-Zugangsdaten sind nicht Ihre JustImmo-Login-Daten. Sie werden in JustImmo separat erzeugt:
- Öffnen Sie in JustImmo mehr → Exporte → Eigene Exporte.
- Aktivieren Sie dort die API. JustImmo erzeugt daraufhin einen Benutzernamen und ein Passwort.
- Buchen Sie Ihre Bauprojekte und die dazugehörigen Objekte in den API-Export ein — genau wie bei jedem anderen JustImmo-Export. Objekte, die nicht eingebucht sind, kann die Schnittstelle nicht sehen.
Für Schritt 1 und 2 benötigen Sie Administratorrechte in JustImmo.
Einrichtung in WordPress
Abschnitt betitelt „Einrichtung in WordPress“Tragen Sie die Zugangsdaten im Backend Ihrer Website (wp-admin) unter WP-ImmoMakler → Software/Portale → JustImmo ein und aktivieren Sie die Option Bauprojekte automatisch importieren.
Folgende Einstellungen stehen zur Verfügung:
- Importintervall in Stunden: Wie oft die Bauprojekte abgeglichen werden. Bauprojekte ändern sich selten, einmal täglich genügt in der Regel.
- Bildgröße: Größe, in der die Projektbilder abgerufen werden. Ohne Angabe liefert JustImmo verhältnismäßig kleine Bilder.
- Sprache: Sprachkürzel, in dem die Projektdaten abgerufen werden.
Ob die Verbindung steht, sehen Sie am farbigen Punkt neben dem Reiter “JustImmo” sowie an der Statusmeldung im Reiter selbst.
Was passiert bei einem Fehler?
Abschnitt betitelt „Was passiert bei einem Fehler?“Zwei Ursachen sehen von außen ähnlich aus, erfordern aber unterschiedliche Schritte — WP-ImmoMakler unterscheidet sie deshalb in der Meldung:
- Zugangsdaten abgelehnt: In der Regel wurden die JustImmo-Login-Daten statt der API-Zugangsdaten eingetragen. Erzeugen Sie die Zugangsdaten wie oben beschrieben.
- Keine Bauprojekte erreichbar: Die Zugangsdaten stimmen, es ist aber nichts in den API-Export eingebucht. Buchen Sie Ihre Projekte in JustImmo in den API-Export ein.
Häufige Fragen zu JustImmo und WordPress
Abschnitt betitelt „Häufige Fragen zu JustImmo und WordPress“Wie geht WP-ImmoMakler mit JustImmo-Objektstatus um?
Abschnitt betitelt „Wie geht WP-ImmoMakler mit JustImmo-Objektstatus um?“Objekte mit dem Status “verkauft” oder “vermietet” werden als vermittelt erkannt und — bei aktivierter Referenz-Option — automatisch als Referenz markiert. Objekte im Status “Entwurf” werden nicht automatisch veröffentlicht, sondern auch in WordPress als Entwurf gespeichert.
Werden Bilder, Grundrisse und Dokumente übernommen?
Abschnitt betitelt „Werden Bilder, Grundrisse und Dokumente übernommen?“Ja. Alle Anhänge aus dem OpenImmo-Export — Fotos, Grundrisse, PDF-Dokumente — werden automatisch in die WordPress-Mediathek importiert. Die Bildqualität lässt sich unter Einstellungen: Import anpassen; ab WP-ImmoMakler PLUS können Bilder zusätzlich automatisch in das platzsparende AVIF-Format umgewandelt werden.
Was passiert, wenn ich ein Objekt in JustImmo lösche?
Abschnitt betitelt „Was passiert, wenn ich ein Objekt in JustImmo lösche?“Überträgt JustImmo einen Löschbefehl oder einen Vollabgleich ohne das Objekt, wird es auch von Ihrer Website entfernt. Referenzobjekte können Sie davon ausnehmen — mit der Option “Löschbefehle für Referenzobjekte ignorieren” unter Einstellungen: Import.
Muss ich nach der Einrichtung noch etwas tun?
Abschnitt betitelt „Muss ich nach der Einrichtung noch etwas tun?“Nein. Stoßen Sie einmalig einen Vollexport in JustImmo an, damit der komplette Bestand übertragen wird — danach läuft die Synchronisierung automatisch. Sie müssen sich dafür nicht in WordPress einloggen.
Warum erscheinen meine Bauprojekte nicht auf der Website?
Abschnitt betitelt „Warum erscheinen meine Bauprojekte nicht auf der Website?“Prüfen Sie zuerst, ob die Projekte in JustImmo unter mehr → Exporte → Eigene Exporte in den API-Export eingebucht sind — ohne diese Buchung sind sie für die Schnittstelle nicht sichtbar. Steht die Verbindung, erscheint im Reiter “JustImmo” eine Statusmeldung mit der Anzahl der übertragenen Projekte.
Die Einheiten eines Projekts erscheinen erst dann in der Übersichtstabelle, wenn sie über den OpenImmo-Export importiert wurden. Bauprojekt und Einheiten kommen aus zwei verschiedenen Quellen und treffen sich auf der Projektseite.