BasisCars mobile.de Plugin installieren und einrichten

Lizenzaktivierung

Um Updates und den Abgleich freizuschalten, navigiere zu den Lizenz-Einstellungen. Gib hier deinen erhaltenen Lizenzschlüssel und die Registrierungs-E-Mail ein. Eine erfolgreiche Aktivierung trägt diese Domain auf deiner Lizenz ein. Freigeschaltet bleibt das Plugin, solange die Lizenz aktiv ist. Die Tarife stehen auf der Startseite.

BasisCars → Einstellungen → Konto → Lizenzverwaltung

mobile.de API anbinden: Kundennummer und API-Passwort

Dies ist der wichtigste Schritt: Trage deine mobile.de Zugangsdaten ein. Die Händler-ID wird oft automatisch vom System erkannt. Im Tarif Profi kannst du bis zu zehn, im Tarif Enterprise unbegrenzt viele Kundennummern kommagetrennt eingeben, um Bestände zusammenzuführen.

Hintergründe zur Schnittstelle, zum Zugang und zu den Kosten stehen im Ratgeber zur mobile.de API.

BasisCars → Einstellungen → Bestand → mobile.de → API Anbindung

Automatischer Abgleich (Cronjob)

Konfiguriere das Intervall für den automatischen Abgleich (z. B. stündlich oder täglich). Du hast die Wahl, den internen WordPress-Cron zu nutzen (einfacher) oder einen echten Server-Cron (zuverlässiger bei großen Beständen).

BasisCars → Einstellungen → Übersicht → Automatische Synchronisation

Manuelle Synchronisation

Möchtest du Änderungen, die du gerade bei mobile.de vorgenommen hast, sofort live sehen? Nutze die manuelle Synchronisation, um den Abgleich sofort zu starten, ohne auf den nächsten Cronjob warten zu müssen.

BasisCars → Einstellungen → Übersicht → Manuelle Synchronisation

Sicherheits-Limit

Standardmäßig löscht das Plugin maximal 30% deines Bestands auf einmal. Dieser Schutzmechanismus bewahrt dich davor, dass durch einen API-Ausfall bei mobile.de versehentlich alle deine Autos auf der Webseite verschwinden. Das Limit kann von Experten überschrieben werden.

BasisCars → Einstellungen → Bestand → mobile.de → Synchronisierung

Bild-Handling (Hotlinking)

Hotlinking spart Speicherplatz und hält deine Website schnell: Die Bilder werden nicht auf deinen Server kopiert, sondern direkt vom CDN von mobile.de ausgeliefert. Beachte, dass dabei die IP-Adressen deiner Besucher an mobile.de übermittelt werden – das gehört in deine Datenschutzerklärung. Wenn du lieber alles auf dem eigenen Server behalten willst, wähle den Mediathek-Download.

BasisCars → Einstellungen → Bestand → mobile.de → Medien & Bilder

Fahrzeugliste & Adressen

Die Fahrzeugliste liegt auf einer ganz normalen WordPress-Seite. Du baust sie mit Elementor, Divi oder Gutenberg wie jede andere Seite – BasisCars gibt dir dafür keinen Sonderweg vor. Unter BasisCars → Einstellungen → Darstellung → Seiten & Shortcodes wählst du aus, welche Seite das ist. Die Adressen deiner Fahrzeuge folgen dieser Seite automatisch.

Auf eine gefilterte Liste verlinken

Jeder Filter lässt sich als Parameter an die Adresse der Fahrzeugliste hängen. So verlinkst du aus dem Menü, einem Elementor-Button oder einem Markenlogo direkt auf eine Auswahl:

/fahrzeuge/?make=BMW
/fahrzeuge/?make=BMW&fuel=DIESEL
/fahrzeuge/?category=OFFROAD&price_max=25000
/fahrzeuge/?make=VOLVO&sort=price_asc

Seit Version 0.4.44 gilt das auch umgekehrt: klickt ein Besucher die Filter selbst an, wandert seine Auswahl in die Adresszeile. Er kann sie kopieren, verschicken und als Lesezeichen sichern. Parameter, die nicht zum Plugin gehören – etwa utm_source aus einem Newsletter – bleiben dabei unangetastet, und die Blätter-Position bleibt draußen: ein geteilter Link öffnet die gefilterte Liste von oben.

Die gefilterte Ansicht trägt weiterhin die canonical der sauberen Seitenadresse. Für Google bleibt es also eine Seite, egal wie viele Filter-Links auf sie zeigen.

Shortcodes Cheatsheet

Die flexibelste Art, BasisCars zu nutzen. Kopiere Shortcodes direkt per Klick und füge sie an beliebigen Stellen im Theme, Gutenberg oder Elementor ein.

Fahrzeug-Daten & eigene Felder (SEO, Yoast, Page Builder)

Jedes Fahrzeug speichert seine Daten als Custom Fields von WordPress – Preis, Leistung, Kraftstoff, HU und rund vierzig weitere. Du kommst überall dort an sie heran, wo WordPress get_post_meta() kennt: in dynamischen Meta-Descriptions, in Elementor-Dynamic-Tags, in eigenen Templates.

Alle Felder

BasisCars_Util::label( 'categories', 'OFFROAD' );        // SUV / Geländewagen
BasisCars_Util::label( 'fuels', 'PETROL' );              // Benzin
BasisCars_Util::label( 'gearboxes', 'AUTOMATIC_GEAR' );  // Automatik
BasisCars_Util::label( 'colors', 'GREY' );               // Grau
BasisCars_Util::label( 'conditions', 'NEW' );            // Neufahrzeug

Dynamische Meta-Description mit Yoast SEO

Yoast führt im Description-Feld keine Shortcodes aus – dort wirken nur Yoast-Variablen. Mit diesem Snippet (functions.php des Child-Themes oder ein Code-Snippets-Plugin) bekommst du eine eigene: %%basiscars_auto%%. Trage sie danach einmal unter Yoast SEO → Darstellung in der Suche → Inhaltstypen → Fahrzeuge ein, und jedes Fahrzeug beschreibt sich selbst.

add_action( 'wpseo_register_extra_replacements', function () {
    wpseo_register_var_replacement(
        '%%basiscars_auto%%',
        'meine_fahrzeug_beschreibung',
        'advanced',
        'Fahrzeugdaten aus BasisCars'
    );
} );

function meine_fahrzeug_beschreibung() {
    $id = get_the_ID();

    if ( ! $id || 'basiscars_vehicle' !== get_post_type( $id ) ) {
        return '';
    }

    $feld = function ( $name ) use ( $id ) {
        return get_post_meta( $id, '_basiscars_' . $name, true );
    };

    $teile = array();

    $ort   = $feld( 'location' );
    $preis = (float) $feld( 'price' );

    if ( $preis > 0 ) {
        $teile[] = ( $ort ? 'in ' . $ort . ' ' : '' )
            . 'für ' . number_format( $preis, 0, ',', '.' ) . ' €';
    }

    // Rohwerte uebersetzen, statt OFFROAD in die Suchergebnisse zu schreiben.
    $form = BasisCars_Util::label( 'categories', $feld( 'category' ) );
    $ps   = (int) $feld( 'power_ps' );
    $kw   = (int) $feld( 'power_kw' );

    if ( $form && $ps ) {
        $teile[] = $form . ' mit ' . $ps . ' PS / ' . $kw . ' kW';
    }

    $hu = $feld( 'general_inspection' );

    if ( $hu ) {
        // Der Formatierer des Plugins, statt selbst an strtotime() zu raten.
        $teile[] = 'HU bis ' . BasisCars_Util::format_year_month( $hu );
    }

    return implode( ' – ', $teile );
}

Brauchst du nur einen einzelnen Rohwert, geht auch Yoasts eingebaute Custom-Field-Variable – wegen des führenden Unterstrichs mit zwei davon: %%cf__basiscars_price%%. Sie liefert den Wert unformatiert und unübersetzt, also 20362 und OFFROAD.

Elementor, Divi & eigene Templates

Dieselben Feldnamen funktionieren überall: in Elementors Dynamic Tags → Beitragsfeld (ACF/Custom Field), in Divis Dynamic Content und in jedem Theme-Template über get_post_meta( get_the_ID(), '_basiscars_price', true ). Auch hier gilt: die mit * markierten Felder vorher durch BasisCars_Util::label() schicken.

Page Builder Integration (Elementor, Divi & Gutenberg)

BasisCars ist zu 100% mit allen gängigen WordPress Page Buildern kompatibel.

Design & Theme

BasisCars bringt bereits ein exzellentes Design mit. Du kannst jedoch die primären Akzent-Farben und Button-Farben exakt an dein Corporate Design anpassen. Ebenso kannst du erzwingen, ob das Layout Hell oder Dunkel erscheinen soll. Wie das aussieht, zeigt die Seite Designs.

BasisCars → Einstellungen → Darstellung → Allgemein → Farbschema

Custom CSS

Für Profis und Agenturen: Füge ganz einfach eigene CSS-Anweisungen hinzu. Verändere Button-Rundungen, Schriftarten, Abstände oder lege eigene Schatten-Effekte auf die Fahrzeug-Karten, ohne das Theme anfassen zu müssen.

BasisCars → Einstellungen → Darstellung → Allgemein → Custom CSS

Eigene Texte & Labels

Überschreibe alle sichtbaren Texte im Plugin direkt im Backend. Möchtest du statt "Preis" lieber "Unser Angebotspreis" anzeigen? Oder statt "EZ" lieber "Erstzulassung"? Passe jeden Textbaustein individuell an.

BasisCars → Einstellungen → Darstellung → Texte & Wording

Fehlerbehebung: Bilder, Abgleich und API-Fehler

Lösungen für die häufigsten Hürden bei Server-Limits, API-Abfragen und Bildern.

Entwickler & Agentur-Referenz

Passe Farben, Abstände und Verhaltensweisen von BasisCars über globale CSS-Variablen oder PHP-Filter an.

:root {
  --bc-primary: #3b82f6;        /* Hauptfarbe: Buttons, Links, Preise */
  --bc-primary-hover: #2563eb;  /* dieselbe Farbe beim Überfahren */
  --bc-surface: #ffffff;        /* Kartenhintergrund */
  --bc-bg: #f8f9fa;             /* Flächen dahinter */
  --bc-text: #212529;           /* Fließtext */
  --bc-text-muted: #6c757d;     /* Nebenangaben, Brotkrumenpfad */
  --bc-border: #e9ecef;         /* Linien und Rahmen */
  --bc-radius: 12px;            /* Abrundung */
}

Fahrzeug-Anfragen (Leads)

Alle Kundenanfragen, die über das BasisCars Kontaktformular im Fahrzeug-Exposé gesendet werden, laufen in diesem Bereich übersichtlich zusammen. So geht dir kein potenzieller Käufer mehr verloren, selbst wenn mal eine E-Mail im Spam landet. Wie das Formular beim Besucher aussieht, zeigt die Seite Funktionen.

Unter dem Nachrichtenfeld kannst du dieselben drei Häkchen anbieten, die mobile.de kennt: Finanzierung, Termin vor Ort und Inzahlungnahme des alten Fahrzeugs. Jedes einzeln – schalte nur ein, was du wirklich anbietest. Du findest die Schalter unter Einstellungen → Kontakt → Anfragen, direkt über der Löschfrist. Was der Interessent ankreuzt, steht anschließend in der Anfrage-Mail, hier in der Liste und in der DSGVO-Auskunft. Standardmäßig sind alle drei aus, damit sich an bestehenden Formularen durch ein Update nichts ändert.

Das Formular muss nicht auf der Seite stehen. Unter Einstellungen → Darstellung → Detailseite → Formular schaltest du es auf Popup um: auf der Seite bleibt ein Knopf, das Formular geht darüber auf – und „Fahrzeug anfragen“ im Titelbereich öffnet es ebenfalls, statt nach unten zu springen. Wer ohne JavaScript unterwegs ist, sieht das Formular an seinem gewohnten Platz; ein Fahrzeug lässt sich also in jedem Fall anfragen. Die Umschaltung gehört zu den Pro-Designs und braucht mindestens den Tarif Händler.

BasisCars → Einstellungen → Kontakt → Anfragen

E-Mail & SMTP

Wenn die Standard-WordPress E-Mail-Funktion (PHPMailer) deines Hosters nicht zuverlässig ist oder Mails im Spam landen, kannst du hier deinen eigenen, sicheren SMTP-Server (z. B. Microsoft 365, Google Workspace, SendGrid) eintragen.

BasisCars → Einstellungen → Kontakt → E-Mail & SMTP

CSV Import (Beta)

In allen Tarifen enthalten, derzeit Beta: Lade deinen Fahrzeugbestand auch manuell per CSV-Tabelle hoch, wenn du die mobile.de API nicht nutzen möchtest oder Fahrzeuge von anderen Drittanbietern aggregierst.

BasisCars → Einstellungen → Bestand → CSV-Import

System Status Dashboard

Dein technischer Leitstand. Behalte stets den Überblick über die Gesamtzahl deiner aktiven Fahrzeuge, den Live-Status der API-Verbindung, PHP-Versionen und die Anzahl der gespeicherten Bilder.

BasisCars → Einstellungen → Übersicht

Darüber steht die Einrichtungs-Checkliste. Sie zählt keine Haken, sondern liest den tatsächlichen Zustand: ob Zugangsdaten hinterlegt sind, ob Fahrzeuge ankamen, welche Seite die Liste trägt und wohin Anfragen gehen. Jeder offene Punkt hat einen Knopf, der genau dorthin springt.