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 der offiziellen AutoScout24-API und verwandelt deren Fahrzeugbestand in nativen WordPress-Inhalt. Importierte Inserate werden als benutzerdefinierter Inhaltstyp (Custom Post Type, as24ci_car) gespeichert, mit Taxonomien für Fahrzeugattribute angereichert und über die Templates, Shortcodes und Admin-Tools des Plugins bereitgestellt.
Das Plugin wurde für Garagen und Garagengruppen entwickelt, die bereits über einen AutoScout24-API-Zugang verfügen. Es scrapet nicht die öffentliche AutoScout24-Website. Alle Fahrzeugdaten werden über den konfigurierten API-Endpunkt mit den von Ihrem Anbieter bereitgestellten Zugangsdaten abgerufen.
Hauptfunktionen:
- Importieren und Synchronisieren von Fahrzeuginseraten, Bildern, Ausstattungen und Preisen über die konfigurierte API.
- Planen wiederkehrender Importe über WP-Cron oder einen externen System-Cron mit einem Token-gesicherten REST-Trigger.
- Verwalten von Fahrzeugen im WordPress-Adminbereich und Präsentieren dieser auf der Website ü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 durch das Plugin gesteuerten Verkaufsansprechpartnern der Garage (CMH Team), die auf den Fahrzeugseiten angezeigt und für die Lead-Weiterleitung verwendet werden.
- Optionale Add-ons für KI-generierte Beschreibungen, Content Studio-Marketingtexte, Suchabos (Smart Stock Alerts), Analytics, einen Finanzierungsrechner, ein PDF datasheet, Standorte, Market Insights und mehr.
Zielgruppe
- Garagenmitarbeiter und Redaktoren — verwalten den Fahrzeugbestand, Leads und die Darstellung auf der Website über den WordPress-Adminbereich.
- 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 Hauptabschnitte unterteilt:
- Erste Schritte — Installation und erste Verbindung.
- Systemanforderungen — Hosting-, PHP- und Netzwerkvoraussetzungen.
- Benutzerhandbuch — tägliche redaktionelle Arbeitsabläufe.
- Admin-Referenz — Erklärung aller Admin-Ansichten.
- Technische Dokumentation — Architektur, Datenmodell und internes Verhalten.
- Integrationsanleitung — Zugangsdaten, Server-Cron, Themes und Page Builder.
- Frontend-Anleitung — 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 — versionierte Änderungen.
- Anhänge — Schnellreferenzen für Shortcodes, Einstellungen, Hooks und Endpunkte.
- Entwicklerdokumentation — Erweiterungspunkte für benutzerdefinierten Code.
Ausserhalb des Leistungsumfangs
- 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 AutoScout24-API-Client-Secret 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, 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 Konfiguration des Kunden abhängt. Überprüfen Sie jedes Verhalten, das Sie für Endkunden veröffentlichen möchten, anhand der aktuellen Plugin-Version.