Kickstart und OpenImmo2WP + ACF-Plugin

[Daniel Kurzeja]

Guten Tag zusammen,

ich habe mich noch nicht ausgiebig mit den Plug-Ins beschäftigt, allerdings möchte ich die unterschiedlichen Werte in ACF-Felder eintragen lassen. Gibt es hierfür eine Anleitung, die ich selbst vielleicht noch nicht gefunden habe oder gibt es hier jemanden, der das bereits umgesetzt hat?
Ich würde mich sehr über eure Unterstützung freuen.

Mit freundlichen Grüßen
Daniel

[Carsten Scheuer]

Hallo Daniel,

die OpenImmo-Daten können mit einer individuell angepassten Mapping-Tabelle beim Import relativ einfach beliebigen Custom Fields zugeordnet werden, auf die natürlich auch per ACF zugegriffen werden kann.

Ist allerdings parallel auch Kickstart im Einsatz, macht die zusätzliche Verwendung von ACF wenig Sinn. Hier bietet sich als Alternative die selektive Einbindung von Immobilien-Detail-Elementen per Shortcode an.

Der Hintergrund ist, dass bei den Kickstart-Detail-Elementen bereits von Haus aus eine praxisnahe Gruppierung der (sehr umfangreichen) OpenImmo-Angaben gegeben ist, die bei Bedarf auch noch angepasst werden kann. Es hängt natürlich vom gewünschten Umfang ab, eine Abbildung des OpenImmo-Standards allein in Form von selbst per ACF definierten Custom Fields dürfte aber in den allermeisten Fällen viel zu aufwendig sein.

[Daniel Kurzeja]

Vielen lieben Dank für die schnelle Rückmeldung. Ich bin gerade am Umdenken, ob es nicht tatsächlich Sinn machen würde auf ACF zu verzichten. Mal angenommen, ich verwende diesen Shortcode [inx-property-details elements=“prices“]. Dieser gibt mir die bereits grafische Tabelle mit Kaufpreis: 230.000 €, Hausgeld: 261 € und Courtage: 3,48 % inkl. 16% MwSt. an. Gibt es denn eine Möglichkeit auf den einzelnen Wert zuzugreifen? Also lediglich den Kaufpreis anzugeben?

[Daniel Kurzeja]

Also nochmal kurz zusammengefasst: Ich nutze das Hello-Theme von Elementor. Wichtig ist mir die maximale Gestaltungsfreiheit. Bisher wurden für Immobilien Beiträge hinzugefügt. Die Immobiliendaten wurden in ACF-Feldern eingetragen. Diese Felder wurden in Elementor an der korrekten Stelle mit der korrekten Darstellung angezeigt. Grundsätzlich möchte ich das genauso umsetzen, ob ich nun ACF dazu einsetzen muss oder nicht spielt keine Rolle. Gibt es eine Möglichkeit über Shortcodes auf die einzelnen Werte zuzugreifen? Also in dem oben genannten Beispiel auf den Kaufpreis (nur auf den Kaufpreis).

[Daniel Kurzeja]

Wichtig noch zu erwähnen: Ich benötige nicht alle Immobiliendaten, sondern nur die üblichen Daten. (Objektart, Lage, Größe, Zimmer, Baujahr, Kaufpreis, …) Der Interessent kann ein Expose anfordern, das wird allerdings unabhängig vom Webprojekt stattfinden.

[Carsten Scheuer]

Die Möglichkeit, mit Kickstart ohne Umweg einzelne OpenImmo-Detailangaben einzubinden, fehlt in der Tat noch – ist bereits auf unserer To-Do-Liste! Ein entsprechender Shortcode kann aber mit den folgenden Funktionen in der Datei functions.php des Child-Themes relativ einfach ergänzt werden.

Die Shortcodes für die Einbindung von Baujahr oder Wohnfläche würden bspw. folgendermaßen aussehen: [mysite-property-detail name="baujahr"] bzw. [mysite-property-detail name="flaechen.wohnflaeche"]

Grundlage hierfür sind die Namen der OpenImmo-Angaben, die in der Kickstart-Mapping-Tabelle in der zweiten Spalte hinterlegt sind. (Die Quelldatei im OpenDocument-Format ist im Unterordner „mappings“ des Plugin-Ordners enthalten und kann mit LibreOffice/OpenOffice oder Google Tabellen bearbeitet werden.)

Da die primären Flächen- und Preisangaben sowie die Anzahl der Zimmer/Räume je nach Objekt- und Vermarktungsart unterschiedlich sind, können diese mit den folgenden Bezeichnungen abgerufen bzw. eingebunden werden:

• primaerflaeche
• primaeranzahl_zimmer
• primaerpreis

Alternativ ist auch ein Zugriff über die jeweiligen Custom Fields möglich:

• _inx_primary_area
• _inx_primary_rooms
• _inx_primary_price

Objektart und -ort sowie bestimmte Ausstattungsmerkmale und der Vermarktungsstatus (zu verkaufen/zu vermieten) sind wiederum in den folgenden Taxonomien gespeichert, die sich per Elementor-Widget sicherlich ebenso einfach einbinden lassen:

• inx_type_of_use (Nutzungsart)
• inx_property_type (Objektart)
• inx_location (Ort/Lage)
• inx_feature (Ausstattung)
• inx_marketing_type (Vermarktungsart)
• inx_label (Labels, z. B. „verkauft“)

Hier die Shortcode-Funktion(en):

/** * immonex Kickstart: Shortcode zum Einbinden einzelner Detailangaben. * Beispiel: [mysite-property-detail name="flaechen.wohnflaeche"] */ add_action( 'after_setup_theme', 'mysite_register_property_detail_shortcode' ); function mysite_register_property_detail_shortcode() { add_shortcode( 'mysite-property-detail', 'mysite_shortcode_property_detail' ); } // mysite_register_property_detail_shortcode function mysite_shortcode_property_detail( $atts ) { if ( empty( $atts['name'] ) ) { return ''; } $name = sanitize_key( $atts['name'] ); $property_id = apply_filters( 'inx_current_property_post_id', false ); $args = [ 'name' => $name, 'value_only' => true, ]; if ( ! empty( $atts['group'] ) ) { $args['group'] = sanitize_key( $atts['group'] ); } // OpenImmo-Angabe anhand des Namens in der Mapping-Tabelle abrufen. $value = apply_filters( 'inx_get_property_detail_item', false, $property_id, $args ); if ( ! $value ) { // Alternativ: Wert eines Kickstart-spezifischen Custom Fields abrufen. $value = get_post_meta( $property_id, "_inx_{$name}", true ); } if ( ! $value ) { // Alternativ: Wert eines allgemeinen Custom Fields abrufen. $value = get_post_meta( $property_id, $name, true ); } return $value; } // mysite_shortcode_property_details

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47

/** * immonex Kickstart: Shortcode zum Einbinden einzelner Detailangaben. * Beispiel: [mysite-property-detail name="flaechen.wohnflaeche"] */   add_action( 'after_setup_theme', 'mysite_register_property_detail_shortcode' );   function mysite_register_property_detail_shortcode() { add_shortcode( 'mysite-property-detail', 'mysite_shortcode_property_detail' ); } // mysite_register_property_detail_shortcode   function mysite_shortcode_property_detail( $atts ) { if ( empty( $atts['name'] ) ) { return ''; }   $name        = sanitize_key( $atts['name'] ); $property_id = apply_filters( 'inx_current_property_post_id', false ); $args        = [ 'name'       => $name, 'value_only' => true, ];   if ( ! empty( $atts['group'] ) ) { $args['group'] = sanitize_key( $atts['group'] ); }   // OpenImmo-Angabe anhand des Namens in der Mapping-Tabelle abrufen. $value = apply_filters( 'inx_get_property_detail_item', false, $property_id, $args );   if ( ! $value ) { // Alternativ: Wert eines Kickstart-spezifischen Custom Fields abrufen. $value = get_post_meta( $property_id, "_inx_{$name}", true ); }   if ( ! $value ) { // Alternativ: Wert eines allgemeinen Custom Fields abrufen. $value = get_post_meta( $property_id, $name, true ); }   return $value; } // mysite_shortcode_property_details

[Daniel Kurzeja]

Danke für die sehr schnelle und ausführliche Rückmeldung. Das hilft mir weiter. Ich habe den Code soeben eingefügt und mit dem Shortcode [mysite-property-detail name="baujahr"] erhalte ich allerdings diesen Wert: _inx_build_year. Wie kann ich diesen nun in den korrekten Wert (1992) umwandeln?

[Daniel Kurzeja]

Update: Ich hab’s. Mit [mysite-property-detail name=“_inx_build_year“] hat es geklappt

[Daniel Kurzeja]

Wenn ich jetzt noch herausfinde, wie ich die Bilder der Bildergalerie einfügen kann, dann bin ich komplett zufrieden mit 👍

[Carsten Scheuer]

In der folgenden aktualisierten Version der Shortcode-Funktionen wurde noch eine Ergänzung für Fälle vorgenommen, in denen der Custom-Field-Name anstatt des eigentlichen Wertes zurückgeliefert wird.

Bzgl. der Bilder hatte ich verbummelt auf einen Punkt hinzuweisen, der auch andere Inhalte (Taxonomien oder Custom Fields) betrifft, wenn diese mit einem regulären WP- oder Elementor-Widget o. ä. eingebunden werden sollen: Bei diesen wird standardmäßig die ID der Seite (Vorlage) als Basis für den Abruf der zugehörigen Daten verwendet. Diese ID entspricht aber nicht der der eigentlichen Immobilie, die hierüber dargestellt wird. (Die ID des Immobilien-Beitrags kann via Hook inx_current_property_post_id (siehe unten) oder direkt über die GET-Variable inx-property-id ermittelt werden.)

Auch hier ist eine Option, mit individuell angepassten „Meta-Shortcodes“ zu arbeiten: Anbei eine Beispielfunktion, mit der der Standard-Galerie-Shortcode [gallery] durch die erweiterte Variante [mysite-property-gallery] ergänzt wird. Bei letzterer wird einfach der reguläre Gallery-Shortcode um ein Attribut mit der ID des Immobilien-Beitrags erweitert und der Inhalt entsprechend zurückgeliefert.

/** * immonex Kickstart: Shortcode zum Einbinden einzelner Detailangaben. * Beispiel: [mysite-property-detail name="flaechen.wohnflaeche"] */ add_action( 'after_setup_theme', 'mysite_register_property_shortcodes' ); function mysite_register_property_shortcodes() { add_shortcode( 'mysite-property-detail', 'mysite_shortcode_property_detail' ); add_shortcode( 'mysite-property-gallery', 'mysite_shortcode_property_gallery' ); } // mysite_register_property_shortcodes function mysite_shortcode_property_detail( $atts ) { if ( empty( $atts['name'] ) ) { return ''; } $name = sanitize_key( $atts['name'] ); $property_id = apply_filters( 'inx_current_property_post_id', false ); $args = [ 'name' => $name, 'value_only' => true, ]; if ( ! empty( $atts['group'] ) ) { $args['group'] = sanitize_key( $atts['group'] ); } // OpenImmo-Angabe anhand des Namens in der Mapping-Tabelle abrufen. $value = apply_filters( 'inx_get_property_detail_item', false, $property_id, $args ); if ( ! $value ) { // Alternativ: Wert eines Kickstart-spezifischen Custom Fields abrufen. $value = get_post_meta( $property_id, "_inx_{$name}", true ); } if ( ! $value ) { // Alternativ: Wert eines allgemeinen Custom Fields abrufen. $value = get_post_meta( $property_id, $name, true ); if ( $value && '_inx_' === substr( $value, 0, 5 ) ) { // Eigentlichen Wert aus ermitteltem Custom Field abrufen. $value = get_post_meta( $property_id, $value, true ); } } if ( $value && ! empty( $atts['format'] ) ) { $format = explode( ',', $atts['format'] ); foreach ( $format as $key ) { $key = trim( strtolower( $key ) ); switch ( $key ) { case 'number' : if ( is_numeric( $value ) ) { $value = number_format( $value, 2, ',', '.' ); } break; case 'currency' : if ( is_numeric( $value ) ) { $value = number_format( $value, 2, ',', '.' ) . ' €'; } break; // Bei Bedarf weitere Formatierungsmöglichkeiten hier ergänzen... } } } return $value; } // mysite_shortcode_property_details function mysite_shortcode_property_gallery( $atts ) { $property_id = apply_filters( 'inx_current_property_post_id', false ); $atts_string = ''; if ( ! empty( $atts ) ) { foreach ( $atts as $key => $value ) { $atts_string .= wp_sprintf( '%s="%s" ', $key, $value ); } $atts_string = trim( $atts_string ); } $shortcode = wp_sprintf( '[gallery id="%s"%s]', $property_id, $atts_string ? ' ' . $atts_string : '' ); return do_shortcode( $shortcode ); } // mysite_shortcode_property_gallery

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96

/** * immonex Kickstart: Shortcode zum Einbinden einzelner Detailangaben. * Beispiel: [mysite-property-detail name="flaechen.wohnflaeche"] */   add_action( 'after_setup_theme', 'mysite_register_property_shortcodes' );   function mysite_register_property_shortcodes() { add_shortcode( 'mysite-property-detail', 'mysite_shortcode_property_detail' ); add_shortcode( 'mysite-property-gallery', 'mysite_shortcode_property_gallery' ); } // mysite_register_property_shortcodes   function mysite_shortcode_property_detail( $atts ) { if ( empty( $atts['name'] ) ) { return ''; }   $name        = sanitize_key( $atts['name'] ); $property_id = apply_filters( 'inx_current_property_post_id', false ); $args        = [ 'name'       => $name, 'value_only' => true, ];   if ( ! empty( $atts['group'] ) ) { $args['group'] = sanitize_key( $atts['group'] ); }   // OpenImmo-Angabe anhand des Namens in der Mapping-Tabelle abrufen. $value = apply_filters( 'inx_get_property_detail_item', false, $property_id, $args );   if ( ! $value ) { // Alternativ: Wert eines Kickstart-spezifischen Custom Fields abrufen. $value = get_post_meta( $property_id, "_inx_{$name}", true ); }   if ( ! $value ) { // Alternativ: Wert eines allgemeinen Custom Fields abrufen. $value = get_post_meta( $property_id, $name, true );   if ( $value && '_inx_' === substr( $value, 0, 5 ) ) { // Eigentlichen Wert aus ermitteltem Custom Field abrufen. $value = get_post_meta( $property_id, $value, true ); } }   if ( $value && ! empty( $atts['format'] ) ) { $format = explode( ',', $atts['format'] );   foreach ( $format as $key ) { $key = trim( strtolower( $key ) );   switch ( $key ) { case 'number' : if ( is_numeric( $value ) ) { $value = number_format( $value, 2, ',', '.' ); } break; case 'currency' : if ( is_numeric( $value ) ) { $value = number_format( $value, 2, ',', '.' ) . ' €'; } break; // Bei Bedarf weitere Formatierungsmöglichkeiten hier ergänzen... } } }   return $value; } // mysite_shortcode_property_details   function mysite_shortcode_property_gallery( $atts ) { $property_id = apply_filters( 'inx_current_property_post_id', false );   $atts_string = ''; if ( ! empty( $atts ) ) { foreach ( $atts as $key => $value ) { $atts_string .= wp_sprintf( '%s="%s" ', $key, $value ); }   $atts_string = trim( $atts_string ); }   $shortcode = wp_sprintf( '[gallery id="%s"%s]', $property_id, $atts_string ? ' ' . $atts_string : '' );   return do_shortcode( $shortcode ); } // mysite_shortcode_property_gallery

[Carsten Scheuer]

Bevor ich’s vergesse: In spezielleren Funktionen/Shortcodes zur individuellen Einbindung/Darstellung des Bildmaterials kann der Filter-Hook inx_get_property_ids zum Abrufen der Anhang-IDs oder -URLs verwendet werden (Infos hierzu in der Plugin-Dokumentation).

[Autor]

Beiträge