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"}'
]