Tools-Referenz

Dieses Dokument ist eine Referenz für den Bereich Tools des ADP Car Market Hub-Plugins (CMH Center → 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 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

Der Tools-Bildschirm 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-Assistent — öffnet den optionalen siebenstufigen Erste Einrichtung-Assistenten. Jederzeit verfügbar, selbst nachdem der Assistent abgeschlossen oder übersprungen wurde. Wenn Sie ihn erneut ausführen, können Sie die Lizenz, den Einrichtungsmodus, das Garagen-Profil, die AutoScout24-Verbindung, die Standardseiten und die Frontend-Funktionsstandards neu konfigurieren; bestehende Einstellungen bleiben erhalten, sofern Sie sie nicht explizit ändern.
• Fahrzeuge exportieren — lädt importierte Fahrzeugdaten herunter und exportiert alle Fahrzeugfelder mit kanonischen AutoScout24-Feldnamen als Spaltenüberschriften (plus Ausstattungsspalten). Der Export kann über den Datei-Upload unter Verbindungen wieder importiert werden. Diese Karte wird nur angezeigt, wenn die Exportfunktion aktiviert ist; sie kann ausgeblendet werden.
• Cache-Bereinigung — löscht den OAuth2-Token-Cache und den Modell-Cache.
• Taxonomie-Sync — wendet Taxonomie-Begriffe aus gespeicherten Werten für jedes importierte Fahrzeug neu an.
• API-Verbindungstest — führt eine Live-Anfrage an AutoScout24 mit den aktuellen Zugangsdaten aus.
• Demodaten — installiert oder entfernt einen markierten Satz von Demofahrzeugen, Leads, Suchabos und Analytics-Daten.
• Diagnosezentrum — 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 die Cache-Bereinigung nützlich sind: Gültige AutoScout24-API-Zugangsdaten, die auf der Seite Verbindungen konfiguriert sind.
• Für Diagnosen an einem einzelnen Beitrag: Die WordPress-Beitrags-ID eines importierten Fahrzeugs.

Schritt-für-Schritt-Anleitung

Importierte Fahrzeuge exportieren

1. Öffnen Sie CMH Center → Tools.
2. Klicken Sie in der Karte Fahrzeuge exportieren auf CSV exportieren für Tabellenkalkulations-Arbeitsabläufe oder auf JSON exportieren für strukturierte Daten und Entwicklerzwecke. Der CSV-Export enthält jedes Fahrzeugfeld mit kanonischen AutoScout24-Spaltenüberschriften (plus Ausstattungsspalten) und kann über den Datei-Upload unter Verbindungen wieder importiert werden.

Caches löschen

1. Klicken Sie in der Karte Cache-Bereinigung auf: - Token-Cache löschen — entfernt das zwischengespeicherte OAuth2-Access-Token. Die nächste API-Anfrage ruft ein neues Token ab. - Modell-Cache löschen — entfernt die zwischengespeicherten Fahrzeug-Modell-Suchdaten, 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 von API-Umgebungen oder wenn frische API-Daten erforderlich sind.

Taxonomien synchronisieren

1. Klicken Sie in der Karte Taxonomie-Sync auf Taxonomie-Sync ausführen.
2. Das Plugin geht alle importierten Fahrzeug-Beiträge durch und wendet die Taxonomie-Beziehungen (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 Reaktivierung des Plugins).

API-Verbindung testen

1. Klicken Sie in der Karte API-Verbindungstest 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 Demodaten auf Demodaten installieren.
2. Das Plugin installiert 10 Demofahrzeuge: 8 werden sofort veröffentlicht und 2 erscheinen als noch nicht importierte Angebote auf der Seite Referenz zum Fahrzeug-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 Demodaten entfernen. Es werden nur Datensätze gelöscht, 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, Suchabos und Analytics-Ereignisse) oder Keine Demodaten installiert, 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 Produktpräsentationen, interne Prüfungen und Frontend-Tests ohne eine Live-Datenquellenverbindung. Die Seite Verbindungen verlinkt hierher, damit Sie das Plugin mit Demodaten testen können, bevor Sie eine echte Quelle anbinden.

Einzelnen Fahrzeug-Beitrag diagnostizieren

1. Suchen Sie im Diagnosezentrum den Bereich Einen Fahrzeug-Beitrag diagnostizieren.
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 AutoScout24-Rohdaten (falls vorhanden) sowie Live-API-Antworten für die Angebots- und Ausstattungsendpunkte zurück.

Einen Dry-Run ausführen

1. Suchen Sie im Diagnosezentrum 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.

System-Snapshot teilen

1. Erweitern Sie im Diagnosezentrum den Bereich System-Snapshot anzeigen.
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, WordPress- und PHP-Versionen, den Theme-Namen, den Log-Status und eine geschützte Ansicht der wichtigsten Plugin-Einstellungen (nur Flags wie Client ID gesetzt: ja/nein; Passwörter und Keys werden nicht exportiert).

---

Konfigurationsreferenz

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

Betriebliche Hinweise

• Alle Aktionen auf diesem Bildschirm sind direkte, einmalige Operationen. Es gibt hier keine Zeitplanung.
• Die Statusanzeige des Token-Caches (Token-Cache aktiv / Kein Token-Cache) spiegelt den OAuth2-Token wider, der derzeit im transienten Speicher WordPress hinterlegt ist.
• Demodaten sind durch ein internes Tag gekennzeichnet, sodass das Entfernen sicher ist und keine echten Kundendaten berührt. Überprüfen Sie dieses Verhalten in der aktuellen Plugin-Version vor der Ausführung, wenn Sie auf einer Live-Website arbeiten.
• Exporte können je nach Anzahl der importierten Fahrzeuge gross sein. CSV wird als Stream generiert; JSON wird im Arbeitsspeicher erstellt.
• Die Diagnose-Beitragssuche führt einen Live-API-Aufruf an AutoScout24 für die Listing- und Ausstattungs-Endpunkte durch. Der Ergebnisbereich zeigt alle von der API zurückgegebenen Fehler an.
• Der System-Snapshot lässt sensible Zugangsdaten (Secrets) bewusst aus. Behandeln Sie ihn als wenig sensibel, aber dennoch als intern.

Fehlerbehebung

• 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.
• Taxonomie-Sync meldet null verarbeitete Beiträge. Es existieren noch keine Fahrzeug-Beiträge. Führen Sie zuerst einen Import aus.
• API-Verbindungstest meldet Fehler. Überprüfen Sie Client ID, Client Secret und die Basis-URL für AutoScout24 auf der Seite Verbindungen und klicken Sie anschliessend auf Token-Cache leeren, um es erneut zu versuchen.
• Diagnose gibt "Fehlende listingid- oder sellerid-Metadaten bei diesem Beitrag" 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 Logs.
• System-Snapshot zeigt client_id_set: no. Die Zugangsdaten sind nicht gespeichert. Speichern Sie die AutoScout24-Zugangsdaten auf der Seite Verbindungen vor dem Testen.

Verwandte Dokumente

• Verbindungen-Referenz
• Einstellungen-Referenz
• Referenz zum Fahrzeug-Importer
• Referenz zu Import & Limits
• Logs-Referenz
• System- und Hilfe-Referenz
• Support-Referenz