Großes Update für Immopress
Das eigens entwickelte Immopress Plugin für WordPress hat nun ein größeres Update mit neuen Features erhalten.
Immopress – ein von 4c media entwickeltes WordPress-Plugin, das dem Benutzer einen Immobilienimport von Immobilienscout24 ermöglicht, wurde nun auf Version 0.0.5 aktualisiert, was einige Bugfixes und Erneuerungen mit sich bringt.
Bugfixes & Features
PHP 7 Kompatibilität und Erneuerungen
Mit der lang ersehnten Kompatibilität für PHP 7 dürfte einer der lästigsten Bugs von Immopress behoben worden sein. Ebenfalls wurde ein Fehler korrigiert, der beim Immobilienimport auftaucht, sobald Immobilien einer nicht definierten Kategorie (z.B. Gewerbe) zugeordnet wurden.Mit der aktuellsten Version beinhaltet das Plugin nun eine neue Unterseite Exposégruppen und -felder. Hier hat der Benutzer die Möglichkeit, jedes Feld einer Immobilie einer bestimmten Gruppe zuzuweisen. Außerdem können Felder und deren Werte pro Exposékategorie nun eigenständig übersetzt werden. Die Ausgabe einer Immobilie geschieht weiterhin mittels Shortcode, der jedoch um zwei Parameter erweitert wurde. So kann jetzt eine gewünschte Immobilien ID, sowie eine Gruppen ID angegeben werden. Dadurch gewähren wird dem Benutzer noch mehr Flexibilität bei der Verwendung des Shortcodes innerhalb eines Templates oder Seite.
Plugininstallation
Plugin installieren
Um das Plugin zu installieren, loggen Sie sich in das Dashboard Ihrer WordPress-Seite ein und navigieren Sie zu Plugins -> Installieren. Wählen Sie nun die von Github heruntergeladene .zip-Datei aus und klicken Sie auf Installieren. Anschließend wird das Plugin automatisch auf Ihr WordPress-System gespielt. Nach Abschluss der Installation müssen Sie noch das Plugin aktivieren.
Plugin via FTP installieren:
Um das Plugin via FTP mit z.B. FileZilla zu installieren, entpacken Sie die heruntergeladene .zip-Datei. Verbinden Sie sich über das FTP-Programm mit Ihrem Server und navigieren Sie zu dem Ordner wp-content -> plugins. Laden Sie in dieses Verzeichnis den Ordner cccc_immopress. Nachdem der Upload abgeschlossen ist, loggen Sie sich in das Dashboard Ihrer WordPress-Seite und aktivieren das Plugin unter Plugins -> Installierte Plugins.
API von Immobilienscout
Immoscout-Verbindung herstellen
Damit Sie das Plugin zum Importieren von Immobilien verwenden können, müssen Sie zunächst eine Verbindung zu Immobilienscout24 herstellen.- Fordern Sie zunächst einen API-Zugang über diese Seite an.
- Sie erhalten schließlich Ihre API-Zugangsdaten, bestehend aus einem Key und einem Secret.
- Loggen Sie sich in das Dashboard Ihrer WordPress-Seite ein und navigieren Sie zu Immobilien -> Einrichten.
- Geben Sie in die dort vorgesehen Felder Ihren Key, sowie Ihr Secret ein und klicken Sie auf Authentifizieren.
- Sie werden anschließend auf die Seite von Immobilienscout weitergeleitet, wo Sie sich in Ihren Account einloggen und die Verbindung bestätigen müssen.
Immobilienimport
Immobilien importieren
Da nun Ihr API Zugriff authentifiziert wurde, können Sie beginnen Immobilien mit nur wenigen Klicks zu importieren.Suchen Sie auf Immobilienscout24.de Ihre gewünschte Immobilie aus und kopieren Sie die Expose ID. Diese finden Sie in der URL jeder Immobilie nach /expose/ (im Bild blau markiert).
Navigieren Sie in Ihrem WordPress-Dashboard zu Immobilien -> Importieren. Geben Sie dort die kopierte ID in das entsprechende Feld ein und klicken Sie auf Importieren.
Wichtig:
Jede Immobilie hat einen bestimmten Typen z.B. APARTMENT_RENT oder HOUSE_BUY. Unter Immobilien -> Kategorie werden diese Typen ebenfalls importiert und dürfen im Anschluss nicht umbenannt werden!
Gleiches gilt für die Feldbezeichnungen (linke Spalte auf dem Bild), die Sie im Dashboard auf jeder Immobilien-Seite unterhalb des Editors vorfinden.
Gruppenmanagement
Gruppen verwalten
Importierte Felder können in Gruppen gebündelt und zusammen innerhalb dieser Gruppe ausgegeben werden. Um eine solche Gruppe zu erstellen, gehen Sie im Dashboard zu Immobilien -> Exposégruppen und -felder. Dort finden Sie eine Seite mit drei verschiedenen Tabs vor.Klicken Sie auf den Reiter Gruppen. Hier haben Sie nun die Möglichkeit eine neue Gruppe mit einem bestimmten Namen zu erstellen. Ihnen wird ebenfalls eine Auflistung bereits erstellter Gruppen inkl. ihrer ID angezeigt. Sie haben dabei bei jeder die Möglichkeit diese zu löschen. Ausnahme bildet hier lediglich die Gruppe Nicht anzeigen. Diese kann nicht entfernt werden, da sie standardmäßig bei jedem Feld aktiviert ist (s. Punkt 1.5 Felder übersetzen und Gruppen zuweisen).
Felder & Gruppen
Felder übersetzen und Gruppen zuweisen
Auf der gleichen Seite (Exposégruppen und -felder) finden Sie den Tab Feldübersicht. Hier werden sämtliche Immobilientypen mit ihren Feldern in einer Tabelle angezeigt.Unter der Spalte Feldname finden Sie sämtliche Feldbezeichnung. Diesen können Sie mit dem in Frontendausgabe stehenden Textfeld für die Ausgabe ändern. In der nächste Spalte können Sie einstellen, ob dieses Feld eine Einheit wie z.B. m, €, $,... besitzt. In der letzten Spalte können Sie das Feld einer Gruppe zuordnen, die Sie selbst erstellt haben. Standardmäßig ist hier Nicht anzeigen aktiviert. Felder, die sich in der Gruppe Nicht anzeigen befinden, werden im Frontend nicht ausgegeben.
Felder
Feldwerte übersetzen
Jedes Feld besitzt einen Wert, der standardmäßig von Immobilienscout auf Englisch geliefert wird. Um diesen Wert zu übersetzen, klicken Sie auf der Seite Exposégruppen und -felder auf den Tab Feldwertübersetzungen. Hier finden Sie eine Auflistung sämtlicher Felder mit englischen Werten, denen Sie jeden einzelnen eine entsprechende Übersetzung vergeben können.Shortcode
Immobilie mit bestimmten Gruppen anzeigen
Die Ausgabe der Felder, sowie die dazugehörigen Gruppen erfolgt über einen Shortcode:[immopress_fields groupid=1 immoid=123]
Dieser Shortcode kann wie gewohnt in den Editor eingebunden werden. Hierbei ist jedoch die Angabe der ID der gewünschten Immobilie erforderlich.
Mit Hilfe von do_shortcode() kann der Shortcode auch in einem Template eingesetzt werden.
<?php echo do_shortcode('[immopress_fields groupid=1]'); ?>
Insgesamt können zwei Parameter angegeben werden:
groupid (int)
Geben Sie hier die ID der Gruppe an, die Sie angezeigt haben möchten. Eine Übersicht der Gruppen-IDs finden Sie unter dem Tab Gruppen. Eine Mehrfachangabe ist nicht möglich.
immoid (int)
Hier können Sie die ID einer bestimmten Immobilie angeben. Diese ist zwingend erforderlich, wenn Sie den Shortcode außerhalb des Loops verwenden. Eine Mehrfachangabe ist nicht möglich.
Die Ausgabe erfolgt in einem tabellarischen Format, welches mit CSS beliebig geändert werden kann.