Dokumentation
Der offizielle Guide, um BasisCars perfekt auf deiner WordPress-Seite einzurichten.
Installation
Nach dem Herunterladen des ZIP-Archivs kannst du das Plugin direkt in deiner WordPress-Installation unter Plugins → Installieren → Plugin hochladen einfügen. Klicke anschließend auf Aktivieren, um das BasisCars Menü in deiner Seitenleiste anzuzeigen.
Lizenzaktivierung
Um Premium-Updates und den vollen Funktionsumfang freizuschalten, navigiere zu den Lizenz-Einstellungen. Gib hier deinen erhaltenen Lizenzschlüssel und die Registrierungs-E-Mail ein. Eine erfolgreiche Aktivierung schaltet das Plugin dauerhaft für diese Domain frei.
API Anbindung (mobile.de)
Dies ist der wichtigste Schritt: Trage deine mobile.de Zugangsdaten ein. Die Händler-ID wird oft automatisch vom System erkannt. Im Profi-Tarif kannst du auch mehrere Händler-IDs kommagetrennt eingeben, um Bestände zusammenzuführen.
Automatischer Sync (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).
Manuelle Synchronisation
Möchtest du Änderungen, die du gerade bei mobile.de vorgenommen hast, sofort live sehen? Nutze die manuelle Synchronisation, um den Abgleich in Echtzeit zu erzwingen, ohne auf den nächsten Cronjob warten zu müssen.
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.
Bild-Handling (Hotlinking)
Optimiere die Geschwindigkeit deiner Webseite sowie deinen Speicherplatz massiv durch Hotlinking. Die Bilder werden dann nicht auf deinen Server geladen, sondern direkt über das CDN von mobile.de ausgeliefert.
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-Grid / Bestand
[basiscars_inventory limit="12" layout="grid"]
Bettet die Fahrzeugliste mit konfigurierbarem Limit und Grid- oder Listen-Layout ein.
Nativer Suchfilter
[basiscars_search]
Platziert die AJAX-Suchmaske (Marke, Modell, Preis, Baujahr, Kraftstoff) überall auf der Seite.
Fahrzeug-Exposé Details
[basiscars_car_details]
Zeigt das komplette Einzelansichts-Exposé inklusive Galerie, Ausstattungsliste & PDF-Button an.
Wunschliste / Merkliste
[basiscars_wishlist]
Bettet eine persönliche Merkliste ein, auf der Besucher gespeicherte Autos wiederfinden.
Page Builder Integration (Elementor, Divi & Gutenberg)
BasisCars ist zu 100% mit allen gängigen WordPress Page Buildern kompatibel.
Elementor
Nutze entweder das native BasisCars Elementor Widget in der Widget-Leiste oder füge ein Shortcode-Widget ein. Das Layout wird automatisch im Live-Editor gerendert.
Divi Builder
Füge ein Code-Modul oder Text-Modul in dein Divi-Layout ein und platziere den gewünschten Shortcode (z. B. [basiscars_inventory]).
Gutenberg Editor
Nutze den nativen BasisCars Block im WordPress Block-Editor oder wähle den Gutenberg Shortcode-Block für volle Flexibilität.
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.
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.
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.
Troubleshooting & Hilfe
Lösungen für die häufigsten Hürden bei Server-Limits, API-Abfragen und Bildern.
1. Bilder-Import bricht ab oder lädt unvollständig
Ursache: Das PHP-Speicherlimit (Memory Limit) oder die maximale Ausführungszeit des Webservers reichen bei großen Fahrzeugbeständen nicht aus.
define('WP_MEMORY_LIMIT', '256M');
@ini_set('max_execution_time', '300');
2. Auto-Sync führt nicht regelmäßig aus
Ursache: Der interne WordPress WP-Cron wird nur ausgelöst, wenn Besucher die Webseite aufrufen.
Lösung: Richte in cPanel / Plesk einen echten Server-Cronjob ein:
*/15 * * * * curl -s https://deinedomain.de/wp-cron.php > /dev/null 2>&1
3. API-Fehler 401 (Unauthorized)
Lösung: Logge dich bei Händler-mobile.de ein und generiere dein API-Passwort im Bereich Schnittstellen neu. Achte darauf, nicht das normale Kunden-Passwort zu nutzen.
Entwickler & Agentur-Referenz
Passe Farben, Abstände und Verhaltensweisen von BasisCars über globale CSS-Variablen oder PHP-Filter an.
Globale CSS-Variablen überschreiben
Füge diese Variablen in deinem Theme oder im BasisCars Custom CSS Bereich ein:
:root {
--basiscars-accent: #3b82f6; /* Hauptfarbe / Buttons */
--basiscars-card-bg: #0f172a; /* Hintergründe */
--basiscars-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 potentieller Käufer mehr verloren, selbst wenn mal eine E-Mail im Spam landet.
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.
CSV Import (Beta)
Ein mächtiges Profi-Feature: 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.
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.
