Filter: inx_get_property_detail_item

Dieser Filter dient dem Abrufen eines Detail-Elements einer Immobilie anhand von Namen und Gruppenbezeichnungen, die in der für den OpenImmo-Import verwendeten Mapping-Tabelle hinterlegt sind.

?> Der Filter wird typischerweise in Add-ons oder anderen Plugins/Themes anstelle von direkten Funktionsaufrufen eingesetzt, bei denen ansonsten immer die Verfügbarkeit des Kickstart-Basisplugins geprüft werden müsste.

Parameter

Name
$item (array|bool)
$post_id (int|string)
$args (array)
name (string) → Mapping-Name des gewünschten Elements (obligatorisch)
group (string) → Mapping-Gruppe des Elements
value_only (bool) → true (nur Wert zurückliefern; Standard) oder false (Array mit Wert und Import-Metadaten)

Rückgabewert

Wert des angegebenen Elements (sofern verfügbar) oder Array mit Elementdaten (bei value_only = false)

Code-Beispiele

/**
 * Energieausweistyp des aktuellen Immobilien-Beitrags abrufen
 */
// nur Wert
$epass_type = apply_filters(
    'inx_get_property_detail_item',
    false,
    get_the_ID(),
    [
        'name' => 'zustand_angaben.energiepass.epart',
        'group' => 'epass'
    ]
);
// $epass_type
Bedarf
// Wert und Import-Metadaten
$epass_type = apply_filters(
    'inx_get_property_detail_item',
    false,
    get_the_ID(),
    [
        'name' => 'zustand_angaben.energiepass.epart',
        'group' => 'epass',
        'value_only' => false
    ]
);
// $epass_type
[
    'group' => 'epass',
    'title' => 'Energieausweis-Art',
    'name' => 'zustand_angaben.energiepass.epart',
    'value' => 'Bedarf',
    'meta_json' => '{"mapping_source":"zustand_angaben->energiepass->epart","value_before_filter":"BEDARF"}'
]