Entwickler-FAQ

Diese Seite sammelt häufig gestellte, integrationsorientierte Fragen. Sie verzichtet bewusst darauf, interne Klassennamen, Tabellennamen, Option-Keys, Hook-Namen, REST-Routen, Berechtigungs-IDs oder Details zur Release-Pipeline aufzuführen – diese sind interne Implementierungsdetails.

Allgemein

Was ist dieses Plugin?

ADP Car Market Hub ist ein WordPress-Plugin, das Fahrzeugbestände von einem vorgelagerten Marktplatz in WordPress importiert und synchronisiert. Es stellt einen Frontend-Katalog (Archiv, Einzelfahrzeug, Vergleich, Favoriten, Suchfilter) sowie einen Admin-Bereich für Konfiguration, Importe und Lead-Management bereit.

Was sind die Versionsanforderungen?

Die erforderlichen WordPress- und PHP-Versionen des Plugins sind im Plugin-Header und in der composer.json des Projekts deklariert. Bitte prüfen Sie diese Werte für die aktuell unterstützten Mindestversionen.

Wo speichert das Plugin seine Daten?

Fahrzeugangebote und Leads nutzen den Standard-Inhaltsspeicher von WordPress. Die Konfiguration verwendet WordPress-Optionen. Das Plugin verwaltet zudem einige pluginspezifische Speicherbereiche, sofern dies für die eigene Funktionalität erforderlich ist. Ein direkter Datenbankzugriff auf vom Plugin verwaltete Speicherstrukturen wird nicht unterstützt.

Hat das Plugin Laufzeitabhängigkeiten?

Über WordPress und PHP in den dokumentierten Mindestversionen hinaus sind keine zusätzlichen Laufzeitabhängigkeiten erforderlich. Im veröffentlichten Paket gibt es keinen JavaScript-Build-Schritt.

Integration

Wie binde ich den Katalog in eine Seite ein?

Verwenden Sie die dokumentierten Shortcodes.

Wie ändere ich das Aussehen einer Fahrzeugseite?

Überschreiben Sie die mitgelieferten Templates über Ihr Theme. Siehe Template-System und Overrides.

Wie leite ich Leads an mein CRM weiter?

Nutzen Sie die Konfiguration für ausgehende Webhooks in der Admin-Benutzeroberfläche des Plugins, anstatt sich in interne Events einzuklinken. Überprüfen Sie den konfigurierten Webhook bei der Einrichtung anhand der aktuellen Plugin-Version.

Wie trigger ich Importe über einen externen Scheduler?

Konfigurieren Sie die plugin-eigene Automatisierung über die Admin-Benutzeroberfläche; diese enthält die unterstützte, dokumentierte Schnittstelle für diesen Anwendungsfall. Verlassen Sie sich nicht auf interne Hook-Namen oder undokumentierte Endpunkte.

Kann ich Plugin-Analytics oder Market Insights-Daten von außerhalb des Plugins auslesen?

Nein. Berichte werden über die Admin-Benutzeroberfläche des Plugins bereitgestellt; interne Speicherstrukturen und Endpunkte sind kein öffentlicher Vertrag.

Support

Wie melde ich einen Fehler?

Nutzen Sie den im Leitfaden für Beiträge beschriebenen Contribution-Kanal des Projekts. Verwenden Sie für Umgebungsinformationen vorzugsweise den Diagnose-Export aus der Admin-Benutzeroberfläche des Plugins, anstatt rohe Protokolldateien zu kopieren.

Unterstützte öffentliche Integrationsschnittstellen

Wenn Sie eine Integration mit dem Plugin vornehmen, nutzen Sie bitte bevorzugt diese stabilen Schnittstellen:

• Die Admin-Einstellungen in der 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, Berechtigungs- und Nonce-IDs sowie die Release- und Update-Infrastruktur werden als Implementierungsdetails behandelt. Sie können sich zwischen den Versionen 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, Speicherlayouts und Sicherheitsimplementierungen können sich zwischen den Versionen ändern. Verlassen Sie sich in Drittanbieter-Code, Themes oder externen Systemen nicht auf diese Details. Direkte Schreibzugriffe auf die Datenbank werden nicht unterstützt.

Hinweis zur öffentlichen Dokumentation. Diese Seite bietet lediglich eine allgemeine Integrationsübersicht. Interne Implementierungsdetails, private APIs, Speicher-Interna 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 sowie alle in diesem Abschnitt explizit veröffentlichten Erweiterungspunkte.