Dokumentation · Übersicht

Funktionsübersicht

Dieses Dokument fasst die Funktionen des ADP Car Market Hub-Plugins zusammen und verweist auf die detaillierte Dokumentation für jeden Bereich.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie eine einseitige Übersicht über die Funktionen des Plugins benötigen, wenn Sie entscheiden, welche optionalen Funktionen Sie aktivieren möchten, oder wenn Sie schnell die richtige Detailreferenz finden möchten.

Übersicht

Das Plugin gruppiert seine Funktionalität in die folgenden Funktionsbereiche. Jeder Bereich wird durch einen oder mehrere Admin-Tabs bereitgestellt und ist im entsprechenden Abschnitt dieses Handbuchs ausführlich dokumentiert.

Import und Synchronisation

Importiert Fahrzeugangebote in den Custom Post Type as24ci_car aus mehreren Datenquellen, die alle auf der zentralen Seite Verbindungen verknüpft sind: der AutoScout24-API, der mobile.de-API, der carcuro-API, einem automatischen Feed (https://-URL, FTP/SFTP, Serverordner oder Cloud-Freigabelink), einem E-Mail-Posteingang oder einem einmaligen Datei-Upload aus Ihrer Garagen-Software (DMS).
Alle API-Zugangsdaten und Datenquellen-Verbindungen werden unter Verbindungen (CMH Center → Connections) eingegeben, wo auch der Verbindungsstatus jeder Quelle angezeigt wird.
Importiert Fahrzeugbilder mit optionaler WebP-Konvertierung (erfordert GD oder Imagick) und einer konfigurierbaren maximalen Anzahl von Bildern pro Fahrzeug.
Änderungserkennung: Ein Inhalts-Hash und ein Bild-Hash werden pro Fahrzeug gespeichert, sodass unveränderte Angebote bei nachfolgenden Durchläufen übersprungen werden.
Optionale Vollständige Synchronisation: Fahrzeuge, die aus der Remote-Quelle verschwinden, werden lokal gelöscht, einschliesslich ihrer importierten Anhänge. Opt-in zur Sicherheit.
Manuelle Vollimporte über den Batch-Wizard mit adaptiver Batch-Grösse, Live-Fortschritt, geschätzter verbleibender Zeit (ETA) und Steuerelementen zum Pausieren/Fortsetzen/Abbrechen.
Dieselbe nachgelagerte Pipeline (VIN-Wiedereinstellungs-Erkennung, Wertnormalisierung, Bildimport, Slug-Generierung, Team-Zuweisung) läuft unabhängig davon, aus welcher Quelle ein Fahrzeug stammt.

Siehe Referenz zu Verbindungen, Import-Engine und Referenz zum Fahrzeug-Importer.

Automation und Zeitplanung

Integrierter WP-Cron-Scheduler mit stündlichen, 6-stündlichen, zweimal täglichen, täglichen und benutzerdefinierten Intervallen (Mindestintervall 15 Minuten).
Token-gesicherter REST-Cron-Endpunkt für externe System-Cron-Trigger.
Konfigurierbares Fahrzeuglimit pro Durchlauf und Bildwarteschlangen-Modus für Cron-Stabilität auf Shared-Hosting-Umgebungen.
Bildwarteschlangen-Worker, der Anhänge asynchron verarbeitet, um PHP-Timeouts zu verhindern.

Siehe Cron-Events und Scheduler und Server-Cron-Einrichtung.

Fahrzeug-Datenmodell

Eine Zeile pro Fahrzeug in einer dedizierten as24_vehicles-Tabelle mit indizierten Spalten für häufige Abfragen.
15 native WordPress Fahrzeugattribut-Taxonomien (Marke, Modell, Karosserietyp, Zustand, Treibstoffart, Getriebe, Antrieb, Aussen-/Innenfarbe, Schadstoffklasse, Energieetikette, Fahrzeugkategorie, Zylinderanordnung, Garantieart, Garantiedetails).
Abwärtskompatible Post-Meta-Keys spiegeln die am häufigsten verwendeten Felder für die Theme-Kompatibilität wider.
Eine manual_overrides-Ebene ermöglicht es Administratoren, Feldwerte zu sperren, die Re-Importe überdauern.

Siehe Datenbankschema, Custom Post Types und Taxonomien und Datenmodell.

Frontend-Präsentation

Mitgelieferte Archiv- und Einzelfahrzeug-Templates mit Bildergalerie, Ausstattungsliste, Fahrzeugdetails, Kontaktformular und optionalen Add-ons.
Layout Manager: Konfigurieren Sie Suchfilter, Archivkarten, Einzelfahrzeug-Blöcke und das Favoriten-/Vergleichs-Layout direkt aus dem Admin-Bereich.
Theme-Override-Pfade für archive-as24ci_car.php und single-as24ci_car.php.
Shortcodes für das Archiv, den Suchfilter, die Vergleichsseite, die Favoritenseite und Standort-/Öffnungszeiten-Karten. Siehe Shortcode-Referenz.
Optionale Favoriten / Merkliste (Browser-LocalStorage) und Fahrzeugvergleich-Abläufe im Frontend, wo die entsprechenden Shortcodes oder Layouts platziert sind.
Optionaler Finanzierungsrechner auf den Fahrzeugdetailseiten mit konfigurierbarem Standardsatz, Laufzeit, Anzahlung und Platzierung (aktiv, wo in Design & Styles aktiviert).
Optionale Generierung und Download von PDF-Datenblättern pro Fahrzeug, sofern der PDF Manager konfiguriert und die Funktion aktiviert ist.
Optionale Standort- / Öffnungszeiten-Karten für Garagen-Standorte, sofern der Bereich Standorte befüllt und der entsprechende Shortcode platziert ist.

Leads und Kontaktformular

Integriertes Kontaktformular auf Einzelfahrzeugseiten, gespeichert als as24ci_lead-Beiträge.
Konfigurierbare sichtbare Felder, Einverständnis-Checkbox, Erfolgs- und Fehlermeldungen.
Anpassbare E-Mail-Templates für die Benachrichtigung der Garage und die Bestätigung für den Kunden.
CSV-Export aus dem Admin-Tab Leads.

Siehe Lead-Speicherung und -Verarbeitung und Leads-Referenz.

Verkaufsberater (CMH Team)

Vom Plugin verwaltete Verkaufsberater der Garage, gepflegt im separaten Hauptmenü CMH Team. Teammitglieder benötigen kein WordPress-Login.
Jeder Kontakt speichert einen Namen, ein optionales Foto, E-Mail und Telefonnummer, die als Kontaktkarte auf den Fahrzeugdetailseiten angezeigt werden.
Kontakte können pro Fahrzeug, pro Garagen-Standort/Verkäufer oder als globaler Standard zugewiesen werden, wobei manuelle Auswahlen bei Re-Importen erhalten bleiben und optionale automatische Zuweisungsregeln angewendet werden können.
Der ermittelte Kontakt wird als bevorzugter Empfänger für Leads verwendet, mit einer optionalen Kopie an die allgemeine E-Mail-Adresse der Garage.

Siehe CMH Team und Kontakt-Routing.

Probefahrt-Buchung

Optionales Probefahrt-Formular auf den Fahrzeugdetailseiten.
Konfigurierbare verfügbare Wochentage, tägliches Zeitfenster, Slot-Dauer und Sperrtage.
Buchungsanfragen werden als Leads gespeichert und an die konfigurierte Empfänger-E-Mail-Adresse weitergeleitet.

Siehe Probefahrt-Anfragen.

Suchabos (Smart Stock Alerts)

Besucher können gespeicherte Suchkriterien abonnieren und erhalten eine Benachrichtigung, wenn ein passendes Fahrzeug importiert wird.
DSGVO-konformer Double-Opt-In-Ablauf: Abonnenten müssen die Anmeldung über einen E-Mail-Link bestätigen, bevor Benachrichtigungen gesendet werden.
Benachrichtigungen werden automatisch ausgelöst, wenn passende Fahrzeuge importiert werden.
Abonnements werden in der dedizierten Tabelle as24ci_search_agents gespeichert und im Admin-Tab Suchabos verwaltet.

Siehe Suchabos Frontend, Suchabos-Referenz und Suchabos Double-Opt-In.

AI Assistant (optional)

Generiert Fahrzeugbeschreibungen, SEO-Meta-Titel und -Beschreibungen, Bild-Alt-Texte und Ausstattungs-Highlights.
Verwendet die verwaltete Google Gemini-Konfiguration in ADP Car Market Hub. Im WordPress-Backend ist keine Provider-Auswahl, Modell-Auswahl oder Eingabe eines API-Keys erforderlich; die kundenspezifische AI-Bereitstellung wird nach der Installation durch AD Promotion abgeschlossen.
Konfigurierbare Sprache, Tonalität, Ziel-Länge und eine benutzerdefinierte Prompt-Vorlage.
Die Hintergrund-Warteschlange verarbeitet AI-Aufgaben asynchron über ein eigenes 5-Minuten-WP-Cron-Intervall.

Siehe AI Assistant-Referenz und Technische Hinweise zum AI Assistant.

Content Studio (optional)

Verwandelt ein bereits im Bestand vorhandenes Fahrzeug in sofort veröffentlichungsbereite Marketing-Inhalte für Social Media und andere Kanäle: Facebook, Instagram, TikTok, YouTube, Google Business Profile, WhatsApp, einen Garagen-Newsletter und die Website.
Generiert ein vollständiges Content-Paket: Marketingtext, Bilder und Kurzvideos mit Google Veo (Formate wie Facebook Reel, YouTube Short, YouTube Video und ein Fahrzeug-Galerievideo; ca. 8 Sekunden; 9:16 oder 16:9), mit optionalem deutschem Voice-over und einer Referenzfoto-Auswahl für Videos. Nur einige einzelne Formate sind als "Demnächst verfügbar" gekennzeichnet.
Die Generierung kann in einer oder mehreren Sprachen gleichzeitig erfolgen, mit einem konfigurierbaren Standard-Tonfall, der Markenstimme der Garage und obligatorischen Compliance-/Disclaimer-Vorgaben.
Die Generierung läuft asynchron mit Live-Fortschrittsanzeige; bei temporären Google-Problemen wird der Versuch automatisch wiederholt. Jedes Bibliothekselement kann als ZIP-Paket (Beitragstext, Marketingbild oder -video, Alt-Text) für das manuelle Posten heruntergeladen werden.
Die Generierung nutzt einen Google-API-Schlüssel, der im Besitz der Garage ist und verschlüsselt gespeichert wird (Text und Bilder über Google Gemini, Videos über Google Veo). Eine kostenlose "Schlüssel überprüfen"-Funktion und eine monatliche Nutzungstabelle (Beiträge, Tokens, Bilder) machen den Zustand und die Nutzung des Schlüssels sichtbar; das Plugin postet niemals selbstständig in sozialen Netzwerken.
Verfügbar, sofern in der Lizenz enthalten; liest ausschliesslich Fahrzeugdaten und schreibt nur in die eigenen Content Studio-Einträge.

Siehe Content Studio-Referenz.

Analytics

Serverseitiges Tracking von Seitenaufrufen, Archiv-/Vergleichs-/Favoriten-Ansichten, Filtersuchen, Kontakt-Öffnungs-Ereignissen und Lead-Übermittlungen.
Tägliche Diagramme und ein Top-Fahrzeug-Ranking auf dem Analytics-Admin-Tab.
Konfigurierbares Aufbewahrungsfenster mit einem täglichen Bereinigungs-Cron.
Optionales Einholen der Einwilligung über den Filter as24ci_analytics_consent_check.

Siehe Analytics-Tracking und Analytics-Aufbewahrung.

Market Insights (optional)

Aggregierte Marktanalysen und Preisbewertungsansichten für den lokalen Bestand, dargestellt auf der Admin-Seite für Market Insights.
Der Zugriff wird über das Lizenz-Featurerecht (market_insights_allowed) gesteuert, nicht über einen Hub-API-Schlüssel. Wenn das Recht enthalten ist, ist der Bildschirm automatisch aktiv, ohne dass etwas konfiguriert werden muss.

EnVKV / Energie-Kennzeichnung (optional)

Konfiguration für die deutsche Pkw-Energieverbrauchskennzeichnungsverordnung (EnVKV / Pkw-EnVKV), einschliesslich Verbrauchs-, Emissions- und Energielabel-Feldern, die auf Archivkarten, Fahrzeugdetailseiten und dem PDF-Datenblatt verwendet werden.
Aktiv, wo für die relevanten Märkte aktiviert und konfiguriert; kann bei Installationen, die keine EnVKV-Kennzeichnung erfordern, unberührt bleiben.

Webhooks (optional)

Ausgehende new_lead- und new_import-Ereignisse, die an vom Administrator konfigurierte URLs gesendet werden.
Optionale HMAC-SHA256-Signatur zur Verifizierung des Empfängers.
Begrenzte Wiederholungsstrategie bei vorübergehenden Fehlern.

Siehe Webhooks und Webhook-Ereignisreferenz.

REST-API (optional)

Öffentliche, schreibgeschützte GET /wp-json/as24ci/v1/vehicles- und GET /wp-json/as24ci/v1/vehicles/{id}-Endpunkte für externe Konsumenten.
Ein Favoriten-Helper, der von der Frontend-Favoritenseite verwendet wird.
Ein öffentlicher Analytics-Tracking-Endpunkt, der vom Frontend-Skript verwendet wird.
Ein tokengeschützter GET /wp-json/as24ci/v1/cron-import-Endpunkt für externe Scheduler.

Siehe REST-API-Endpunkte und REST-Endpunkt-Referenz.

Design und Layout

Markenfarben, Typografie, Badges, Galeriekonfiguration und benutzerdefiniertes CSS über den Tab Design & Styles.
Der Layout Manager ordnet Suchfilter, Archivkarten, Blöcke für Einzelfahrzeuge und die Vergleichs-/Favoriten-Layouts ohne Code an.
Der Mapping-Tab ermöglicht das Bearbeiten der Beschriftungen und der Sichtbarkeit jedes importierten Feldes.

Siehe Referenz für Design & Styles, Layout Manager-Referenz und Mapping-Referenz.

Betrieb und Wartung

Ausführliche Protokollierung mit automatischer Rotation bei einer Grenze von 10 MB.
Tab "System & Hilfe" mit Umgebungstests, Cron-Status, Bildwarteschlangen-Status, Protokoll-Status, Verbindungstest und Diagnose-Export.
Tab "Tools" für Einzelbeitrags-Diagnosen, Testlauf-Importe und den Import/Export von Plugin-Einstellungen.

Siehe Betrieb und Wartung.