Entwickler-FAQ

Diese Seite sammelt häufig gestellte, integrationsorientierte Fragen. Sie listet bewusst keine internen Klassennamen, Tabellennamen, Option-Keys, Hook-Namen, REST-Routen, Berechtigungs-IDs oder Details zur Release-Pipeline auf — dies sind interne Implementierungsdetails.

Allgemein

Was ist dieses Plugin?

ADP Car Market Hub ist ein WordPress-Plugin, das Fahrzeugangebote 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. Überprü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 Speicher, wo dies für die eigene Funktionalität erforderlich ist. Ein direkter Datenbankzugriff auf vom Plugin verwaltete Speicher wird nicht unterstützt.

Hat das Plugin Laufzeitabhängigkeiten?

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

Integration

Wie bette ich den Katalog in eine Seite ein?

Verwenden Sie die dokumentierten Shortcodes.

Wie ändere ich das Aussehen einer Fahrzeugseite?

Überschreiben Sie die mitgelieferten Templates aus Ihrem Theme. Siehe Template-System und Overrides.

Wie leite ich Leads an mein CRM weiter?

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

Wie triggere ich Importe über einen externen Scheduler?

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

Kann ich Plugin-Analytics oder Market Insights-Daten von ausserhalb des Plugins auslesen?

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

Support

Wie melde ich einen Fehler?

Nutzen Sie den im Leitfaden für Beiträge beschriebenen Beitragskanal des Projekts. Bevorzugen Sie für Umgebungsinformationen den Diagnose-Export aus der Admin-Benutzeroberfläche des Plugins, anstatt rohe Logdateien zu kopieren.

Unterstützte öffentliche Integrationsschnittstellen

Bevorzugen Sie bei der Integration mit dem Plugin diese stabilen Schnittstellen:

• Die Admin-Einstellungen des Plugins in der Benutzeroberfläche.
• 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 Vorankündigung ändern und sind nicht Bestandteil 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 darauf. 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, Speicherinterna und sicherheitsrelevante Release-Infrastrukturen werden separat gepflegt und sind nicht Bestandteil 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.