Tools-Referenz

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

Wann Sie dieses Dokument lesen 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 neu abzurufen.
• Taxonomie-Begriffe (Marke, Modell, Treibstoff, 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

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

• Setup Wizard — öffnet den optionalen sechsstufigen Assistenten für die erste Einrichtung. Jederzeit verfügbar, selbst nachdem der Assistent abgeschlossen oder übersprungen wurde. Wenn Sie ihn erneut ausführen, können Sie den Setup-Modus, das Garagen-Profil, die AutoScout24-Verbindung, die Standardseiten und die Frontend-Funktionsstandards neu 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 neu an.
• API Connection Test — führt eine Live-Anfrage an AutoScout24 mit den aktuellen Zugangsdaten aus.
• Demo Data — installiert oder entfernt ein markiertes Set von Demofahrzeugen, Leads, Suchabos und Analytics-Daten.
• Diagnostics Centre — Einzelbeitrags-Diagnose, Dry-Run-Vorschau und ein JSON-System-Snapshot.

Anforderungen oder Voraussetzungen

• Ein Benutzer mit der Berechtigung zur Plugin-Verwaltung.
• Damit der API Connection Test 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-Arbeitsabläufe oder auf Export JSON für strukturierte Daten und Entwicklerzwecke.

Caches leeren

1. Klicken Sie in der Karte Cache Clearer auf: - Clear Token Cache — entfernt das zwischengespeicherte OAuth2-Zugriffstoken. Die nächste API-Anfrage ruft ein neues Token ab. - Clear Model Cache — entfernt die zwischengespeicherten Fahrzeug-Modell-Suchdaten, sodass diese 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 benötigt werden.

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, Treibstoff, 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 erneuten Aktivierung 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 Demofahrzeuge: 8 werden sofort veröffentlicht und 2 erscheinen als noch nicht importierte Angebote auf der Seite Car Importer, damit Sie den Import-Arbeitsablauf testen können. Zudem werden Beispiel-Leads, Suchabos und synthetische Analytics-Daten für 30 Tage erstellt.
3. Um dies rückgängig zu machen, klicken Sie auf Remove Demo Data. Es werden nur Datensätze entfernt, die durch den 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, Suchabos und Analytics-Events) oder No demo data installed, wenn nichts vorhanden ist. Nach dem Installieren oder Entfernen von Demodaten zeigt ein abschliessendes Zusammenfassungspanel an, was erstellt oder bereinigt wurde.

Verwenden Sie dies für Produkt-Demos, 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 liefert Beitrags-Metadaten, Bildreferenzen, die rohen AutoScout24-Nutzdaten (falls vorhanden) sowie Live-API-Antworten für die Angebots- und Ausstattungs-Endpunkte.

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. Klappen Sie im Diagnostics Centre den Bereich Show System Snapshot auf.
2. Kopieren Sie den JSON-Inhalt und hängen Sie ihn an ein Support-Ticket an oder teilen Sie ihn mit Ihrem Operations-Team.

Der Snapshot enthält die Plugin-Version, die Website-URL, die WordPress- und PHP-Versionen, den Theme-Namen, den Log-Status und eine zensierte Ansicht wichtiger Plugin-Einstellungen (nur Flags wie Client ID set: yes/no; rohe Passwörter/Secrets werden nicht exportiert).

Konfigurations-Referenz

Die Tools-Seite speichert keine eigenen Einstellungen. Sie dient als Starter für einmalige Aktionen.

Betriebliche Hinweise

• Alle Aktionen auf dieser Seite 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 abgelegt ist.
• Demodaten werden durch ein internes Tag identifiziert, sodass das Entfernen sicher ist und echte Kundendaten 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 gross 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 rohe Secrets 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 Referenz zum Fahrzeug-Importer, 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.
• API Connection Test 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 neu.
• Demodaten lassen sich nicht installieren. Vergewissern Sie sich, dass der Benutzer die Berechtigung zur Verwaltung hat und dass die Datenbank die Demo-Datensätze schreiben kann. Details finden Sie in den Logs.
• 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

• Settings Reference
• Referenz zum Fahrzeug-Importer
• Referenz zu Import & Limits
• Logs-Referenz
• System And Help Reference
• Support Reference