Dokumentation · Entwickler-Dokumentation
Entwickler-Übersicht
Dieses Dokument dient als Orientierungsseite für Entwickler und Integratoren, die mit ADP Car Market Hub arbeiten. Es verbleibt bewusst auf einer übergeordneten Ebene. Interne Implementierungsdetails, private APIs, interne Speicherstrukturen und sicherheitsrelevante Release-Infrastrukturen werden separat gepflegt und sind nicht Teil der öffentlichen Dokumentation.
Wann Sie dieses Dokument verwenden sollten
Lesen Sie dieses Dokument, wenn Sie:
- Ein Website-Implementierer sind, der eine Orientierung benötigt, bevor er Templates oder Einstellungen für eine bestimmte Garage anpasst.
- Ein Integrator sind, der das Plugin über die dokumentierten, unterstützten Schnittstellen mit einem CRM, Marketing-Tool oder externen Scheduler verbindet.
- Ein Reviewer sind, der das Plugin auf hoher Ebene bewertet, bevor er es empfiehlt.
Endbenutzer (Mitarbeiter von Garagen, die das Plugin über den WordPress-Admin konfigurieren) sollten stattdessen mit den benutzerorientierten 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 Fahrzeugangebote von einem vorgelagerten Marktplatz in WordPress importiert und synchronisiert und Folgendes bereitstellt:
- 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 Regionen geliefert und bietet einen sauberen Aktivierungs-, Deaktivierungs- und Deinstallationspfad.
So navigieren Sie in diesem Abschnitt
- Für die Einrichtung der Umgebung siehe Lokales Entwicklungs-Setup.
- Für Codierungsrichtlinien siehe Coding Standards.
- Für unterstützte Integrationsschnittstellen siehe Shortcodes für Entwickler und Template-System und Overrides.
- Für Übersetzungsbeiträge siehe Internationalisierung für Entwickler.
- Für den Beitragsprozess siehe 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
Wenn Sie das Plugin integrieren, nutzen Sie vorzugsweise diese stabilen Schnittstellen:
- Die Admin-Einstellungen-Benutzeroberfläche des Plugins.
- 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 Releases ohne vorherige Ankü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 Releases ändern. Verlassen Sie sich in Drittanbieter-Code, Themes oder externen Systemen nicht auf diese Elemente. Direkte Datenbankzugriffe werden nicht unterstützt.
Hinweis zur öffentlichen Dokumentation. Diese Seite bietet nur eine übergeordnete 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.