Dokumentation · Entwickler-Dokumentation
Entwickler-Übersicht
Diese Seite dient als Orientierung für Entwickler und Integratoren, die mit ADP Car Market Hub arbeiten. Sie ist bewusst auf einer übergeordneten Ebene gehalten. Interne Implementierungsdetails, private APIs, interne Speicherstrukturen und sicherheitsrelevante Release-Infrastrukturen werden separat gepflegt und sind nicht Teil der öffentlichen Dokumentation.
Wann Sie dieses Dokument lesen sollten
Lesen Sie dieses Dokument, wenn Sie:
- Ein Website-Implementierer sind, der eine Orientierung benötigt, bevor er Templates oder Einstellungen für ein bestimmtes Autohaus anpasst.
- Ein Integrator sind, der das Plugin über die dokumentierten, unterstützten Schnittstellen mit einem CRM, Marketing-Tool oder externen Scheduler verbindet.
- Ein Prüfer sind, der das Plugin auf hoher Ebene evaluiert, bevor er es empfiehlt.
Endanwender (Mitarbeiter des Autohauses, die das Plugin über den WordPress-Adminbereich konfigurieren) sollten stattdessen mit den anwenderorientierten Abschnitten der Dokumentation beginnen, insbesondere mit dem Benutzerhandbuch und der Admin-Referenz.
Was das Plugin ist
ADP Car Market Hub ist ein WordPress-Plugin, das Fahrzeugbestände von einem vorgelagerten Marktplatz in WordPress importiert und synchronisiert. Es bietet:
- Einen öffentlichen Fahrzeugkatalog (Archiv, Einzelfahrzeugseite, Vergleichsseite, Favoriten, Suchfilter).
- Einen Admin-Bereich für Konfiguration, Importe und Lead-Management.
- Eine kleine Auswahl an dokumentierten Shortcodes und vom Theme überschreibbaren Templates, auf die sich Integratoren verlassen können.
Das Plugin erfordert die im Plugin-Header deklarierten WordPress- und PHP-Versionen. Es wird mit gebündelten Übersetzungen für die unterstützten Sprachen ausgeliefert und bietet einen sauberen Aktivierungs-, Deaktivierungs- und Deinstallationspfad.
So navigieren Sie durch diesen Abschnitt
- Informationen zur Einrichtung der Umgebung finden Sie unter Lokales Entwicklungs-Setup.
- Informationen zu Codierungsrichtlinien finden Sie unter Coding Standards.
- Informationen zu unterstützten Integrationsschnittstellen finden Sie unter Shortcodes für Entwickler und Template-System und Overrides.
- Informationen zur Mitwirkung an Übersetzungen finden Sie unter Internationalisierung für Entwickler.
- Informationen zum Ablauf von Beiträgen finden Sie unter Richtlinien für Beiträge.
Andere Seiten in diesem Abschnitt bieten eine öffentlich zugängliche Zusammenfassung von Bereichen (Architektur, Speicherung, REST/AJAX, Cron, Sicherheit, Release, Analytics, Market Insights usw.), deren interne Details bewusst nicht veröffentlicht werden.
Unterstützte öffentliche Integrationsschnittstellen
Verwenden Sie bei der Integration mit dem Plugin vorzugsweise diese stabilen Schnittstellen:
- Die Benutzeroberfläche der Plugin-Admin-Einstellungen.
- Die dokumentierten Shortcodes.
- Template-Overrides auf Theme-Ebene, wie in Template-System und Overrides beschrieben.
- Die allgemeine Entwickler-Übersicht zur Orientierung.
Interne Klassennamen, Option-Keys, Datenbanktabellen, REST- und AJAX-Endpunkte, Cron-Hook-Namen, Capability- und Nonce-Identifikatoren sowie die Release- und Update-Infrastruktur werden als Implementierungsdetails behandelt. Sie können sich zwischen den Versionen ohne Vorankündigung ändern und sind nicht Teil des öffentlichen Integrationsvertrags.
Stabilitäts- und Änderungsrichtlinie
Alles, was oben nicht als unterstützte öffentliche Schnittstelle aufgeführt ist, gilt als internes Implementierungsdetail. Interne APIs, das Speicherlayout und Sicherheitsimplementierungen können sich zwischen den Versionen ändern. Verlassen Sie sich in Code von Drittanbietern, Themes oder externen Systemen nicht auf diese Details. Direkte Schreibzugriffe auf die Datenbank werden nicht unterstützt.
Hinweis zur öffentlichen Dokumentation. Diese Seite bietet nur eine allgemeine Integrationsübersicht. Interne Implementierungsdetails, private APIs, interne Speicherstrukturen und sicherheitsrelevante Release-Infrastrukturen werden separat gepflegt und sind nicht Teil der öffentlichen Dokumentation. Unterstützte Integrationsschnittstellen sind die dokumentierten Shortcodes, Template-Overrides, die Einstellungs-Benutzeroberfläche und alle in diesem Abschnitt explizit veröffentlichten Erweiterungspunkte.