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 detaillierte Referenz finden möchten.

Übersicht

Das Plugin gruppiert seine Funktionen 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 vom konfigurierten AutoScout24-API-Endpunkt in den Custom Post Type as24ci_car.
  • 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 (Full Sync): Fahrzeuge, die aus dem Remote-Feed 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.

Siehe Import-Engine und Referenz zum Fahrzeug-Importer.

Automation und Zeitplanung

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

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

Fahrzeugdatenmodell

  • 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, Treibstoff, Getriebe, Antrieb, Aussen-/Innenfarbe, Schadstoffklasse, Energieeffizienz, 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 festzupinnen, die Re-Importe überdauern.

Siehe Datenbankschema, Custom Post Types und Taxonomien und Datenmodell.

Front-End-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 (lokaler Browserspeicher) und Fahrzeugvergleichs-Abläufe im Front-End, 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 PDF-Datenblatt-Generierung und -Download pro Fahrzeug, sofern der PDF-Manager konfiguriert und die Funktion aktiviert ist.
  • Optionale Standort- / Öffnungszeiten-Karten für Garagen-Standorte, sofern der Bereich Standorte ausgefü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-Vorlagen 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 Sperrdaten.
  • 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 Search Alerts verwaltet.

Siehe Suchabos Front-End, 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 Auswahl des Anbieters, des Modells oder die Eingabe eines API-Schlüssels 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.
  • Eine Hintergrund-Warteschlange verarbeitet AI-Aufgaben asynchron über ein benutzerdefiniertes 5-Minuten-WP-Cron-Intervall.

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

Content Studio (optional)

  • Verwandelt ein bereits im Bestand befindliches Fahrzeug in sofort einsatzbereite Marketingtexte für Social Media und andere Kanäle: Facebook, Instagram, TikTok, Google Business Profile, WhatsApp, einen Garagen-Newsletter und die Website.
  • Die Generierung kann in einer oder mehreren Sprachen gleichzeitig erfolgen, mit einer konfigurierbaren Standardtonalität, der Markenstimme der Garage und obligatorischen Compliance-/Disclaimer-Vorgaben.
  • Die Textgenerierung verwendet einen Google-API-Schlüssel, der im Besitz der Garage ist und verschlüsselt gespeichert wird; das Plugin erstellt Texte (und für einige Formate einen Entwurf für ein Marketingbild) zum manuellen Kopieren und Veröffentlichen und 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-Datensätze.

Siehe Content Studio-Referenz.

Analytics

  • Serverseitiges Tracking von Seitenaufrufen, Archiv-/Vergleichs-/Favoriten-Aufrufen, Filtersuchen, Kontakt-Öffnungen und Lead-Absendungen.
  • Tägliche Diagramme und ein Ranking der Top-Fahrzeuge im Admin-Tab Analytics.
  • Konfigurierbares Aufbewahrungsfenster mit einem täglichen Bereinigungs-Cron.
  • Optionale Einwilligungsschranke (Consent Gating) ü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, bereitgestellt über die Admin-Seite Market Insights.
  • Aktiv, sofern konfiguriert; je nach installierter Plugin-Konfiguration erfordern einige Panels möglicherweise eine zusätzliche verwaltete Datenquelle, die von AD Promotion bereitgestellt werden muss.

EnVKV / Kennzeichnung des Energieverbrauchs (optional)

  • Konfiguration für die deutsche Pkw-Energieverbrauchskennzeichnungsverordnung (EnVKV), einschliesslich Verbrauchs-, Emissions- und Energieeffizienzklassen-Feldern, die auf Archivkarten, Fahrzeugdetailseiten und im PDF-Datenblatt verwendet werden.
  • Aktiv, sofern 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 Front-End-Favoritenseite verwendet wird.
  • Ein öffentlicher Analytics-Tracking-Endpunkt, der vom Front-End-Skript verwendet wird.
  • Ein Token-geschü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, Einzelfahrzeug-Blöcke sowie die Vergleichs- und Favoriten-Layouts ohne Code an.
  • Der Mapping-Tab ermöglicht das Bearbeiten der Beschriftungen und der Sichtbarkeit jedes importierten Feldes.

Siehe Referenz zu Design & Styles, Referenz zum Layout-Manager und Mapping-Referenz.

Betrieb und Wartung

  • Ausführliche Protokollierung (Logging) mit automatischer Rotation bei einer Grenze von 10 MB.
  • Tab „System & Hilfe“ mit Umgebungstests, Cron-Status, Bildwarteschlangen-Status, Log-Status, Verbindungstest und Diagnose-Export.
  • Tab „Tools“ für Einzelbeitrags-Diagnosen, Testlauf-Importe (Dry-Run) und den Import/Export von Plugin-Einstellungen.

Siehe Betrieb und Wartung.

Verwandte Dokumente