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 Autohaus-Website passt.
Wann Sie dieses Dokument lesen 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 vor dem Lesen der detaillierten Abschnitte prüfen möchten, ob ein bestimmter Anwendungsfall abgedeckt ist.
Übersicht
ADP Car Market Hub verbindet eine WordPress-Website mit der offiziellen AutoScout24-API und verwandelt deren Fahrzeugbestand in nativen WordPress-Inhalt. Importierte Angebote werden als Custom Post Type (as24ci_car) gespeichert, mit Fahrzeugattribut-Taxonomien angereichert und über die Templates, Shortcodes und Admin-Tools des Plugins dargestellt.
Das Plugin ist für Autohäuser und Autohaus-Gruppen konzipiert, die bereits über einen AutoScout24-API-Zugang verfügen. Es führt kein Scraping der öffentlichen AutoScout24-Website durch. Alle Fahrzeugdaten werden über den konfigurierten API-Endpunkt mit den von Ihrem Anbieter bereitgestellten Zugangsdaten abgerufen.
Hauptfunktionen:
- Importieren und Synchronisieren von Fahrzeugangeboten, Bildern, Ausstattungen und Preisen aus der konfigurierten API.
- Planen von wiederkehrenden Importen über WP-Cron oder einen externen System-Cron mit einem Token-gesicherten REST-Trigger.
- Verwalten von Fahrzeugen im WordPress-Adminbereich und Präsentieren dieser im Frontend über die mitgelieferten Archiv-, Einzelansichts-, Vergleichs- und Favoriten-Templates.
- Erfassen von Leads aus Kontaktformularen und Probefahrt-Anfragen und Weiterleiten an die konfigurierte Empfängeradresse.
- Verwalten von durch das Plugin gesteuerten Autohaus-Ansprechpartnern (CMH Team), die auf den Fahrzeugseiten angezeigt und zur Weiterleitung von Leads verwendet werden.
- Optionale Add-ons für KI-generierte Beschreibungen, Content Studio-Marketingtexte, Suchaufträge (Smart Stock Alerts), Analytics, einen Finanzierungsrechner, ein PDF-Datenblatt, Standorte, Market Insights und mehr.
Zielgruppe
- Autohaus-Mitarbeiter und Redakteure — verwalten den Fahrzeugbestand, Leads und die Frontend-Präsentation über den WordPress-Adminbereich.
- Website-Administratoren — installieren, konfigurieren und betreiben das Plugin, einschließlich Zugangsdaten, Cron-Jobs und Integrationen.
- Entwickler und Integratoren — erweitern das Plugin, erstellen benutzerdefinierte Integrationen oder Theme-Overrides.
Einordnung in die Dokumentation
Die deutsche Dokumentation ist in folgende Hauptabschnitte unterteilt:
- Erste Schritte — Installation und erste Verbindung.
- Technische Systemanforderungen — Hosting-, PHP- und Netzwerkvoraussetzungen.
- Benutzerhandbuch — tägliche redaktionelle Arbeitsabläufe.
- Admin-Referenz — Erklärung aller Admin-Bereiche.
- 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 — versionsspezifische Änderungen.
- Anhänge — Schnellreferenzen für Shortcodes, Einstellungen, Hooks und Endpunkte.
- Entwickler-Dokumentation — Erweiterungspunkte für benutzerdefinierten Code.
Nicht im Leistungsumfang enthalten
- 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: Das Client-Secret der AutoScout24-API wird 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 Adminbereich 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 betriebliche Daten enthalten.
- Optionale Funktionen wie der AI Assistant, Webhooks, Suchaufträge und die öffentliche REST-API sind deaktiviert, bis ein Administrator sie aktiviert.
- 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.