Tools-Referenz

Dieses Dokument ist eine Referenz für den Bereich Tools des ADP Car Market Hub-Plugins (Car Market Hub → Tools). Es behandelt Exporte, Cache-Verwaltung, Taxonomie-Synchronisation, den API-Verbindungstest, Demodaten und das Diagnosezentrum.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dies, wenn Sie Folgendes tun müssen:

• Importierte Fahrzeugdaten für Backups, Audits oder Migrationen exportieren.
• Das Plugin zwingen, frische Daten von der AutoScout24-API abzurufen.
• Taxonomie-Begriffe (Marke, Modell, Kraftstoff, Farbe …) wieder mit importierten Fahrzeugen verknüpfen.
• Überprüfen, ob die API-Zugangsdaten funktionieren.
• Demodaten für eine Verkaufspräsentation oder eine Staging-Umgebung installieren oder entfernen.
• Gezielte Diagnosen für einen einzelnen Fahrzeug-Beitrag ausführen oder einen System-Snapshot für den Support erstellen.

Übersicht

Der Tools-Bereich ist der operative Werkzeugkasten für Administratoren. Er gruppiert Wartungsaktionen in unabhängige Karten, sodass sie direkt auf der Seite ausgelöst werden können:

• Setup Wizard — öffnet den optionalen sechsstufigen Ersteinrichtungs-Assistenten. Jederzeit verfügbar, selbst nachdem der Assistent abgeschlossen oder übersprungen wurde. Ein erneutes Ausführen ermöglicht es Ihnen, den Einrichtungsmodus, das Autohaus-Profil, die AutoScout24-Verbindung, die Standardseiten und die Standardeinstellungen für Frontend-Funktionen neu zu konfigurieren; bestehende Einstellungen bleiben erhalten, sofern Sie sie nicht explizit ändern.
• Export Vehicles — CSV- oder JSON-Download importierter Fahrzeugdaten. Diese Karte erscheint nur, wenn die Exportfunktion aktiviert ist; sie kann ausgeblendet werden.
• Cache Clearer — löscht den OAuth2-Token-Cache und den Modell-Cache.
• Taxonomy Sync — wendet Taxonomie-Begriffe aus den gespeicherten Werten für jedes importierte Fahrzeug erneut an.
• API Connection Test — führt eine Live-Anfrage an AutoScout24 mit den aktuellen Zugangsdaten aus.
• Demo Data — installiert oder entfernt einen markierten Satz von Demo-Fahrzeugen, Leads, Suchaufträgen und Analytics.
• Diagnostics Centre — Einzelbeitrags-Diagnose, Dry-Run-Vorschau und ein JSON-System-Snapshot.

Anforderungen oder Voraussetzungen

• Ein Benutzer mit der Berechtigung zur Verwaltung des Plugins.
• Damit der API-Verbindungstest und der Cache-Clearer nützlich sind: Gültige API-Zugangsdaten, die in den Einstellungen konfiguriert sind.
• Für die Diagnose eines einzelnen Beitrags: Die WordPress-Beitrags-ID eines importierten Fahrzeugs.

Schritt-für-Schritt-Anleitung

Importierte Fahrzeuge exportieren

1. Öffnen Sie Car Market Hub → Tools.
2. Klicken Sie in der Karte Export Vehicles auf Export CSV für Tabellenkalkulations-Workflows oder auf Export JSON für strukturierte Daten und Entwicklerzwecke.

Caches löschen

1. Klicken Sie in der Karte Cache Clearer auf: - Clear Token Cache — entfernt das zwischengespeicherte OAuth2-Access-Token. Die nächste API-Anfrage ruft ein neues Token ab. - Clear Model Cache — entfernt die zwischengespeicherten Fahrzeug-Modell-Lookup-Daten, sodass sie bei Bedarf neu aufgebaut werden.
2. Die Statuszeile zeigt an, ob derzeit ein Token zwischengespeichert ist.

Verwenden Sie dies nach Änderungen der Zugangsdaten, nach dem Wechsel der API-Umgebungen oder wenn frische API-Daten erforderlich sind.

Taxonomien synchronisieren

1. Klicken Sie in der Karte Taxonomy Sync auf Run Taxonomy Sync.
2. Das Plugin geht alle importierten Fahrzeug-Beiträge durch und wendet die Beziehungen der Taxonomie-Begriffe (Marke, Modell, Kraftstoff, Farbe und andere Fahrzeugattribute) basierend auf den in der Fahrzeugtabelle gespeicherten Werten neu an.
3. Die Anzahl der verarbeiteten Beiträge wird nach dem Durchlauf angezeigt.

Verwenden Sie dies, wenn Filterbegriffe fehlen, veraltet oder nicht synchron sind (beispielsweise nach einer Datenbankmigration oder einer Reaktivierung des Plugins).

API-Verbindung testen

1. Klicken Sie in der Karte API Connection Test auf die Test-Schaltfläche.
2. Das Plugin sendet eine Live-Anfrage an die AutoScout24-API mit den aktuellen Zugangsdaten und meldet das Ergebnis.

Führen Sie dies aus, nachdem Sie die Zugangsdaten aktualisiert haben oder wenn Importe unerwartet fehlschlagen.

Demodaten installieren oder entfernen

1. Klicken Sie in der Karte Demo Data auf Install Demo Data.
2. Das Plugin installiert 10 Demo-Fahrzeuge: 8 werden sofort veröffentlicht und 2 erscheinen als noch nicht importierte Angebote auf der Seite Fahrzeug-Importer, damit Sie den Import-Workflow testen können. Es erstellt außerdem Beispiel-Leads, Suchaufträge und synthetische Analytics-Daten für 30 Tage.
3. Um dies rückgängig zu machen, klicken Sie auf Remove Demo Data. Es werden nur Datensätze entfernt, die vom Demo-Installer erstellt wurden; echte Kundendaten sind nicht betroffen.

Die Karte zeigt eine Live-Zusammenfassung der aktuell installierten Daten (importierte Fahrzeuge, ausstehende Importer-Angebote, Leads, Suchaufträge und Analytics-Ereignisse) oder No demo data installed, wenn nichts vorhanden ist. Nachdem Sie Demodaten installiert oder entfernt haben, zeigt ein abschließendes Zusammenfassungspanel an, was erstellt oder bereinigt wurde.

Verwenden Sie dies für Produktpräsentationen, interne Prüfungen und Frontend-Tests ohne eine aktive AutoScout24-Verbindung.

Einen einzelnen Fahrzeug-Beitrag diagnostizieren

1. Suchen Sie im Diagnostics Centre den Bereich Diagnose a Vehicle Post.
2. Geben Sie die WordPress-Beitrags-ID eines importierten Fahrzeugs ein und senden Sie das Formular ab.
3. Das Plugin gibt Beitrags-Metadaten, Bildreferenzen, die rohe AutoScout24-Payload (falls vorhanden) und Live-API-Antworten für die Angebots- und Ausstattungs-Endpunkte zurück.

Einen Dry Run ausführen

1. Suchen Sie im Diagnostics Centre den Bereich Dry Run.
2. Senden Sie das Formular ab. Das Plugin zeigt eine Vorschau der Daten an, die es von AutoScout24 importieren würde, ohne Änderungen in die Datenbank zu schreiben. Die Vorschau ist auf etwa 25 Zeilen begrenzt und wird als JSON-Vorschau dargestellt.

Verwenden Sie dies, um die API-Datenstruktur vor einem vollständigen Import zu überprüfen.

Einen System-Snapshot teilen

1. Erweitern Sie im Diagnostics Centre den Bereich Show System Snapshot.
2. Kopieren Sie den JSON-Inhalt und hängen Sie ihn an ein Support-Ticket an oder teilen Sie ihn mit Ihrem Betriebsteam.

Der Snapshot enthält die Plugin-Version, die Website-URL, die WordPress- und PHP-Versionen, den Theme-Namen, den Protokollstatus und eine zensierte Ansicht der wichtigsten Plugin-Einstellungen (nur Flags wie Client ID set: yes/no; rohe Geheimnisse werden nicht exportiert).

Konfigurationsreferenz

Der Tools-Bereich speichert keine eigenen Einstellungen. Er dient als Starter für einmalige Aktionen.

Betriebshinweise

• Alle Aktionen in diesem Bereich sind direkte, einmalige Operationen. Es gibt hier keine Zeitplanung.
• Die Statusanzeige des Token-Caches (Token cache active / No token cache) spiegelt das OAuth2-Token wider, das derzeit im transienten Speicher von WordPress hinterlegt ist.
• Demodaten werden durch ein internes Tag identifiziert, sodass das Entfernen sicher ist und echte Kundendatensätze nicht berührt werden. Überprüfen Sie dieses Verhalten in der aktuellen Plugin-Version, bevor Sie es auf einer Live-Website ausführen.
• Exporte können je nach Anzahl der importierten Fahrzeuge groß sein. CSV wird als Stream generiert; JSON wird im Arbeitsspeicher erstellt.
• Die Beitragsdiagnose führt einen Live-API-Aufruf an AutoScout24 für die Angebots- und Ausstattungs-Endpunkte durch. Der Ergebnisbereich zeigt alle von der API zurückgegebenen Fehler an.
• Der System-Snapshot lässt sensible Geheimnisse absichtlich aus. Behandeln Sie ihn als wenig sensibel, aber dennoch als intern.

Fehlerbehebung

• Der Export-Download ist leer. Es wurden noch keine Fahrzeuge importiert oder ein anderes Plugin fängt admin-post.php-Anfragen ab. Vergewissern Sie sich in der Fahrzeug-Importer Referenz, dass der Importer erfolgreich gelaufen ist.
• Taxonomy Sync meldet null verarbeitete Beiträge. Es existieren noch keine Fahrzeug-Beiträge. Führen Sie zuerst einen Import aus.
• Der API-Verbindungstest meldet einen Fehler. Überprüfen Sie Client ID, Client Secret und Base URL in den Einstellungen erneut, klicken Sie dann auf Clear Token Cache und versuchen Sie es noch einmal.
• Die Diagnose gibt "Missing listingid or sellerid meta on this post." zurück. Der Beitrag ist kein importiertes Fahrzeug oder der Beitrag stammt aus der Zeit vor dem aktuellen Fahrzeug-Speicherlayout. Importieren Sie das Fahrzeug erneut.
• Demodaten lassen sich nicht installieren. Stellen Sie sicher, dass der Benutzer über die Verwaltungsberechtigung verfügt und die Datenbank die Demo-Datensätze schreiben kann. Details finden Sie in den Protokollen.
• Der System-Snapshot zeigt client_id_set: no. Es sind keine Zugangsdaten gespeichert. Speichern Sie diese in den Einstellungen, bevor Sie den Test durchführen.

Verwandte Dokumente

• Einstellungs-Referenz
• Fahrzeug-Importer Referenz
• Referenz für Import und Limits
• Protokoll-Referenz
• System- und Hilfe-Referenz
• Support-Referenz