Dokumentation · Übersicht
Produktübersicht
Dieses Dokument stellt das ADP Car Market Hub WordPress-Plugin vor: was es tut, für wen es gedacht ist und wie es in eine typische Website einer Garage passt.
Wann Sie dieses Dokument verwenden sollten
Lesen Sie dieses Dokument, wenn Sie das Plugin zum ersten Mal evaluieren, wenn Sie eine kurze Zusammenfassung für einen Kollegen oder Stakeholder benötigen oder wenn Sie bestätigen möchten, ob ein bestimmter Anwendungsfall abgedeckt ist, bevor Sie die detaillierten Abschnitte lesen.
Übersicht
ADP Car Market Hub verbindet eine WordPress-Website mit dem Fahrzeugbestand einer Garage und verwandelt ihn in nativen WordPress-Inhalt. Fahrzeuge können aus verschiedenen Datenquellen stammen – der offiziellen AutoScout24-API, der mobile.de-API, der carcuro-API, einem automatischen Feed, einem E-Mail-Posteingang oder einem einmaligen Dateiupload aus Ihrer Garagen-Software (DMS) – alle verbunden über eine einzige Verbindungen-Seite. Importierte Inserate werden als benutzerdefinierter Inhaltstyp (as24ci_car) gespeichert, mit Fahrzeugattribut-Taxonomien angereichert und über die Templates, Shortcodes und Admin-Tools des Plugins bereitgestellt.
Das Plugin wurde für Garagen und Garagengruppen entwickelt, einschliesslich derer, die bereits über einen AutoScout24- oder carcuro-API-Zugriff verfügen. Es scrapt nicht die öffentliche AutoScout24-Website. Live-API-Daten werden über die konfigurierten Endpunkte mit den von Ihrem Anbieter bereitgestellten Zugangsdaten abgerufen.
Hauptfunktionen:
- Importieren und Synchronisieren von Fahrzeuginseraten, Bildern, Ausstattungen und Preisen aus mehreren Datenquellen (AutoScout24, mobile.de, carcuro, Feed, E-Mail oder Dateiupload), verbunden und autorisiert auf der Verbindungen-Seite.
- Planen von wiederkehrenden Importen über WP-Cron oder einen externen System-Cron mit einem token-gesicherten REST-Trigger.
- Verwalten von Fahrzeugen im WordPress-Admin und Präsentieren dieser im Frontend über die mitgelieferten Archiv-, Einzelansichts-, Vergleichs- und Favoriten-Templates.
- Erfassen von Leads aus Kontaktformularen und Probefahrtanfragen und Weiterleiten an die konfigurierte Empfängeradresse.
- Verwalten von plugin-gesteuerten Verkaufsansprechpartnern der Garage (CMH Team), die auf den Fahrzeugseiten angezeigt und zur Weiterleitung von Leads verwendet werden.
- Optionale Add-ons für KI-generierte Beschreibungen, Content Studio-Marketinginhalte (Text, Bilder und kurze Videos über Google Veo mit optionalem deutschem Voice-over), Suchabos (Smart Stock Alerts), Analytics, einen Finanzierungsrechner, ein PDF-Datenblatt, Standorte, Market Insights und mehr.
Zielgruppe
- Garagenmitarbeiter und Redaktoren – verwalten den Bestand, Leads und die Frontend-Präsentation über den WordPress-Admin.
- Website-Administratoren – installieren, konfigurieren und betreiben das Plugin, einschliesslich Zugangsdaten, Cron und Integrationen.
- Entwickler und Integratoren – erweitern das Plugin, erstellen benutzerdefinierte Integrationen oder Theme-Overrides.
Einordnung in die Dokumentation
Die Schweizer Hochdeutsche Dokumentation ist in die folgenden Hauptkapitel unterteilt:
- Erste Schritte – Installation und erste Verbindung.
- Systemanforderungen – Hosting-, PHP- und Netzwerkvoraussetzungen.
- Benutzerhandbuch – tägliche redaktionelle Arbeitsabläufe.
- Admin-Referenz – jeder Admin-Bildschirm im Detail erklärt.
- Technische Dokumentation – Architektur, Datenmodell und internes Verhalten.
- Integrationshandbuch – Zugangsdaten, Server-Cron, Themes und Page Builder.
- Frontend-Handbuch – was Besucher sehen und wie es aufgebaut ist.
- Betrieb und Wartung – Betrieb des Plugins in der Produktionsumgebung.
- Datenschutz, Sicherheit und Compliance – Datenverarbeitung, Einwilligung und Zugriffskontrolle.
- Fehlerbehebung – problemorientierte Lösungsansätze.
- Versionshinweise – Änderungen nach Versionen.
- Anhänge – Schnellreferenzen für Shortcodes, Einstellungen, Hooks und Endpunkte.
- Entwickler-Dokumentation – Erweiterungspunkte für eigenen Code.
Ausserhalb des Funktionsumfangs
- Scraping von HTML-Seiten von AutoScout24 oder Dritten.
- Ersatz für einen AutoScout24-Händlervertrag oder API-Zugang.
- Hosting der WordPress-Website selbst; das Plugin läuft innerhalb einer vom Kunden verwalteten WordPress-Installation.
Betriebliche Hinweise
- Das Plugin verwendet die WordPress-Optionstabelle zur Speicherung seiner Konfiguration. Sensible Geheimnisse sind im Ruhezustand geschützt: Datenquellen-Geheimnisse (das AutoScout24-API-Client-Secret, das carcuro-Firmentoken und die Feed-/Postfach-Passwörter) werden verschlüsselt über den Secret-Store des Plugins mittels authentifizierter AES-256-GCM-Verschlüsselung gespeichert (wobei der Schlüssel von den WordPress-Salts abgeleitet wird), und das Cron-Import-Token wird als Einweg-HMAC-SHA256-Hash gespeichert. Das Klartext-Cron-Token wird im Admin-Bereich nur für ein kurzes Zeitfenster nach der Generierung angezeigt. Datenbank-Backups sollten dennoch als sensibel behandelt werden, da sie auch Leads, Einstellungen und andere Betriebsdaten enthalten.
- Optionale Funktionen wie der AI Assistant, Webhooks, Suchabos und die öffentliche REST-API sind deaktiviert, bis ein Administrator sie einschaltet.
- Lokalisierte Admin-Labels und Übersetzungsdateien werden mit dem Plugin ausgeliefert. Die englische Dokumentation ist die Ausgangssprache und verwendet unter Umständen vorsichtige Formulierungen, wo das Verhalten von der Kundenkonfiguration abhängt. Überprüfen Sie jedes Verhalten, das Sie für Kunden veröffentlichen möchten, anhand der aktuellen Plugin-Version.