Funktionen / API

Sie haben die Möglichkeit Fahrzeuge und alle dazugehörige Daten abzufragen um sie mit ihrem eigenen Layout (eigenes HTML und CSS) darzustellen.


Abfragen von Fahrzeugdaten

Die folgenden Funktionen geben ihnen Zugriff auf bestimmte Fahrzeugdaten, welche sie dann beispielsweise als eigene HTML Ausgabe weiterverarbeiten können

Alle Fahrzeuge aus der Datenbank anfragen

dxim_get_all_vehicles(array $args)
Parameter $args = alle möglichen WP_Query Parameter


Fahrzeug anhand seiner ID aus der Datenbank abfragen

dxim_get_vehicle_by_id($vehicle_id)
Parameter $vehicle_id = die Fahrzeug-, bzw. Post ID
Rückgabe: WP_Post $vehicle, enthält alle unformatierten Fahrzeugdaten direkt aus mobile.de unter $vehicle->dxim_meta


Daten des aktuell angezeigten Fahrzeugs abfragen

dxim_get_vehicle();
Parameter: keine

Info: Diese Funktion ist vor allem zur Verwendung in Shortcodes der Fahrzeug Einzelansicht gedacht.
Sie liefert das aktuelle Fahrzeug, nach dem es initialisiert wurde, daher sollte sie erst nach dem wp-Hook und nur für Fahrzeug-Einzelansichten eingesetzt werden


Custom Fields des aktuellen Fahrzeugs abfragen

dxim_get_vehicle_cf_value();
Parameter: $key (Bezeichnung des Feldes)

Info: Diese Funktion ist vor allem zur Verwendung in Shortcodes der Fahrzeug Einzelansicht gedacht. Sie liefert ein Custom Field zum aktuellen Fahrzeug, nach dem dieses initialisiert wurde, daher sollte sie erst nach dem wp-Hook und nur für Fahrzeug-Einzelansichten eingesetzt werden


Daten eines Fahrzeugs für die Archiv-Ansicht

dxim_get_vehicle_archive(int|WP_Post $vehicle)

// Beispiel archive-vehicle.php
get_header();

... some html ...
if (have_posts()) :
    while (have_posts()) : the_post();
        global $post;

        $data = dxim_get_vehicle_archive($post);
        // ... Verarbeitung und Ausgabe der in $data erhaltenen Werte

    endwhile;
else :
    print "Keine Fahrzeuge gefunden"
endif;

... some html ...

get_footer();

Daten eines Fahrzeugs für Einzel-Ansicht

dxim_get_vehicle_single(int|WP_Post $vehicle);


Ausstattungsmerkmale eines Fahrzeuges

dxim_get_vehicle_features(\WP_Post $vehicle)
Parameter $vehicle = WP_Post object


Technische Daten eines Fahrzeugs (Fahrzeug Archiv)

dxim_get_vehicle_fields_archive(\WP_Post $vehicle)
liefert alle Felder die in den Plugin-Einstellungen für die Archivansicht deklariert wurden
Parameter $vehicle = WP_Post object


Technische Daten eines Fahrzeugs (Fahrzeug Einzelansicht)

dxim_get_vehicle_fields_single(\WP_Post $vehicle)
liefert alle Felder die in den Plugin-Einstellungen für die Einzelansicht deklariert wurden
Parameter $vehicle = WP_Post object


Kontaktdaten eines Fahrzeugs

dxim_get_vehicle_location(int|WP_Post $vehicle);

// Beispielhaftes Ergebnis
Array
(
    [company-name] = Muster GmbH
    [street] = Muster-Strasse 2a
    [zipcode] = 10115
    [city] = Berlin
    [email] = info@mustergmbh.de
    [phone] = 0000 / 123456
)

Preisinformationen eines Fahrzeugs

dxim_get_vehicle_price(int|WP_Post $vehicle);

// Beispielhaftes Ergebnis
Array
(
    [price] = 10490.00
    [price_netto] = 8815.13
    [vat_rate] = 0.1900
    [vatable] = 1
    [price_type] = FIXED
)