Basiskonfiguration
Unter Einstellungen > OpenImmo Import können die Einstellungen vorgenommen werden.
Allgemeine Einstellungen
Mapping-Typ
Hier wird die CSV-Datei ausgewählt, die die Tabelle für die Zuordnung der OpenImmo-Importdaten zu den entsprechenden themespezifischen Feldern enthält. Die mitgelieferten Dateien sind teilweise für mehrere Themes mit gleichartigen Datenstrukturen verwendbar (z. B. wpcasa.csv für alle wpCasa-Child-Themes und brings-online.csv für Property, ImmoMobil und Immobilia). Wurden die Einstellungen noch nicht gespeichert, wird eine automatische Vorauswahl anhand des aktiven Themes getroffen.
Auto-Import aktivieren
Ist diese Option aktiviert, wird das Importverzeichnis regelmäßig auf zu verarbeitende ZIP-Archive überprüft, die XML- und Anhangdateien (Bilder, PDF) enthalten. Sind Importarchive vorhanden, werden diese entpackt und die enthaltenen Immobiliendaten importiert. Fehlerhafte ZIP-Dateien werden nach zwei Stunden automatisch gelöscht.
Das Zeitintervall für die Prüfung auf neue Importdateien liegt bei zwei Minuten. Hierfür kommt das WordPress-interne WP-Cron-System zum Einsatz. Dieses setzt für eine zeitnahe Verarbeitung der Importdaten voraus, dass die Website regelmäßig aufgerufen wird. Um dies zu gewährleisten, kann bei niedrig frequentierten Internet-Angeboten – bei Bedarf – zusätzlich ein „echter Cronjob” eingerichtet werden. Mehr dazu unter Ablauf des Imports – Automatisierter Import.
Unterordner einschließen
Import-ZIP-Archive werden im Regelfall nur dann verarbeitet, wenn sie direkt im globalen oder einem benutzerbezogenen Importordner (siehe folgende Abschnitte) enthalten sind. Mit dieser Option kann auch die Verarbeitung von Dateien in Unterordnern aktiviert werden. Das gilt für eine Ebene, d. h. Unter-Unterordner etc. werden nicht berücksichtigt. Ebenfalls nicht hiervon betroffen sind die Systemordner mappings, users und archive sowie alle weiteren, deren Name mit einem Unterstrich beginnt.
Globale Vollimporte deaktivieren
Diese Option sollte aktiviert werden, wenn mehrere Benutzer unabhängig voneinander über den globalen Importordner (wp-content/uploads/immonex-openimmo-import/) importieren, damit bei Vollimporten keine Objekte der jeweils anderen Benutzer gelöscht werden.
Im Mehrbenutzer-Umgebungen ist allerdings grundsätzlich die Nutzung von separaten, benutzerbezogenen Importordnern vorzuziehen.
Vollimport-Modus
Vollabgleiche können auf verschiedene Arten verarbeitet werden, wobei der gewünschte Modus hier eingestellt werden kann.
Importierte Immobilien prüfen
Der Beitragsstatus von neu importierten und/oder aktualisierten Immobilien wird auf „Ausstehender Review“ gesetzt, wenn die entsprechende Option aktiviert ist.
Max. Anzahl Bildanhänge
Wird hier ein Wert hinterlegt, wird die Anzahl der Fotos und sonstigen Bildanhänge pro Objekt beim Import entsprechend limitiert. (Andere Anhänge wie bspw. PDFs oder Links sind hiervon nicht betroffen.)
Import-Protokoll-Empfänger (optionale Angabe)
Ist hier eine Mailadresse hinterlegt, wird an diese nach jedem Import ein Protokoll mit Infos zu den verarbeiteten Daten gesendet. Im Regelfall wird hier die Adresse des Immobilien-Anbieters (Makler) angegeben.
Debug-Protokoll-Empfänger (optionale Angabe)
Das Debug-Protokoll enthält weitergehende Informationen zu den Importvorgängen, die bei Problemen nützliche Anhaltspunkte für die Fehlerbehebung liefern können. Empfänger sollte in diesem Fall der für die Technik zuständige Administrator der Website oder alternativ auch ein externer Entwickler sein.
Importdateien archivieren
Sofern in diesem Feld eine Anzahl von Tagen angegeben ist, bleiben verarbeitete OpenImmo-ZIP-Archive nebst zugehörigen Import-Protokollen (Debug-Version) für diesen Zeitraum im Archivordner gespeichert. Ältere Dateien werden automatisch gelöscht.
Script-Ressourcen
Länger dauernde Importvorgänge können anhand der Einstellungen in diesem Tab in mehrere Scriptläufe aufgeteilt werden. Diese Optionen sind vor allem bei Webspace-Umgebungen mit begrenzten Ressourcen relevant. Die Werte sollten bei Problemen wie bspw. bei häufigen Abbrüchen des Importvorgangs, Timeouts oder Serverfehlern (sog. „Internal Server Errors”) schrittweise verringert werden, bis ein reibungsloser Import möglich ist.
Max. Script-Ausführungszeit
Der mögliche Zeitrahmen liegt zwischen 30 und 3.600 Sekunden, 0 steht für kein Zeitlimit – das Script wird dann während eines Imports nicht unterbrochen. Diese Angabe bezieht sich nur auf automatisch via WP-Cron gestartete Importvorgänge, bei manuellen Importen liegt die maximale Script-Laufzeit generell bei 30 Sekunden. Ist serverseitig (php.ini) eine niedrigere maximale Script-Laufzeit vorgegeben, ist nur diese relevant.
Max. Anzahl Datensätze
Die maximale Anzahl an Immobilien, die pro Scriptlauf importiert wird (0 = kein Limit).
Max. Anzahl zu löschender Datensätze
Die maximale Anzahl an Immobilien, die vor der Verarbeitung eines Vollimports pro Scriptlauf gelöscht wird (0 = kein Limit).
Max. Anzahl Dateianhänge
Die meisten Probleme entstehen erfahrungsgemäß dann, wenn viel hochauflösendes Bildmaterial importiert wird. Die serverseitige Skalierung bei der Erstellung verschiedener Formate pro Bild kann hier – je nach Hosting-Anbieter – schnell den verfügbaren Rahmen in Sachen Script-Laufzeit und Hauptspeicher sprengen. In diesen Fällen kann hier eine maximale Anzahl an Dateianhängen (z. B. Bilder) eingestellt werden, die pro Scriptlauf verarbeitet wird (0 = kein Limit).
Geocodierung
Bei einigen Immobilien-Themes/Plugins ist die Geocodierung von Objektadressen beim Import erforderlich, sofern die Koordinaten nicht bereits im Exportsystem generiert und in den Transferdateien mit übertragen werden. Der bevorzugte Anbieter/Dienst kann in diesem Tab ausgewählt werden.
Das Plugin unterstützt (ab Version 4.0) die grundsätzlich freien, OpenStreetMap-basierten Dienste Nominatim (Nutzungsbedingungen) und Photon, deren Freikontingente für die meisten Websites ausreichend sind. Alternativ können die entsprechenden APIs von Google Maps oder Bing Maps genutzt werden, sofern passende API-Schlüssen hinterlegt werden.
Infos/Anforderung von API-Keys auf den folgenden Seiten:
- Google Maps: Google Developers
- Bing Maps: Bing Maps Dev Center
Eine weitere Option in diesem Tab bezieht sich auf die Nutzung der vom Exportsystem übertragenen Geo-Koordinaten (Import-XML-Datei): Die können – sofern die Option aktiviert ist – bspw. für die Positionierung von Kartenmarkern übernommen werden, auch wenn die Veröffentlichung der zugehörigen Objektadressen nicht freigegeben ist.
Lizenz
Lizenzschlüssel und Lizenzstatus
Entwicklung endet nie. Deswegen ist eine gültige und aktive Lizenz Voraussetzung für den automatisierten Bezug von Plugin-Aktualisierungen sowie die Inanspruchnahme des Supports. Der zugehörige Lizenzschlüssel wird beim Kauf übermittelt und ist für eine WordPress-Installation gültig. Die Lizenz kann in den Plugin-Einstellungen aktiviert oder deaktiviert werden (bspw. wenn der Lizenzschlüssel für eine andere Installation verwendet werden soll).
Theme-Optionen
Je nach aktivem Theme wird auf der Plugin-Konfigurationsseite ein zusätzlicher Tab angezeigt, auf dem Einstellungen vorgenommen werden können, die sich nur auf das aktuelle Theme beziehen (mehr dazu im Abschnitt „Theme-Besonderheiten”).
Bitte hier vor allem das Thema „Widget-Einbindung per Shortcode” beachten, da viele Immobilien-Details über die nachfolgend beschriebenen immonex-Widgets ausgegeben werden.