Documentatie · Beheerdersreferentie

Beheerdersreferentie voor Tools

Dit document is een referentie voor het Tools-scherm van de ADP Car Market Hub-plugin (Car Market Hub → Tools). Het behandelt exports, cachebeheer, taxonomie-synchronisatie, de API-verbindingstest, demogegevens en het diagnostisch centrum.

Wanneer u dit document moet gebruiken

Lees dit als u het volgende moet doen:

  • Geïmporteerde voertuiggegevens exporteren voor back-up, controle of migratie.
  • De plugin dwingen om nieuwe gegevens op te halen uit de AutoScout24 API.
  • Taxonomie-termen (merk, model, brandstof, kleur ...) opnieuw koppelen aan geïmporteerde voertuigen.
  • Controleren of de API-inloggegevens werken.
  • Demogegevens installeren of verwijderen voor een verkoopdemo of staging-omgeving.
  • Gerichte diagnostiek uitvoeren op een specifieke voertuig-post of een systeem-momentopname genereren voor ondersteuning.

Overzicht

Het Tools-scherm is de operationele gereedschapskist voor beheerders. Het groepeert onderhoudsacties in onafhankelijke kaarten, zodat ze kunnen worden geactiveerd zonder de pagina te verlaten:

  • Setup Wizard — opent de optionele zes-stappen Eerste installatie. Altijd beschikbaar, zelfs nadat de wizard is voltooid of overgeslagen. Door deze opnieuw uit te voeren, kunt u de installatiemodus, het dealerprofiel, de AutoScout24-verbinding, de standaardpagina's en de standaardinstellingen voor de frontend opnieuw configureren; bestaande instellingen blijven behouden, tenzij u ze expliciet wijzigt.
  • Export Vehicles — CSV- of JSON-download van geïmporteerde voertuiggegevens. Deze kaart verschijnt alleen wanneer de exportfunctie is ingeschakeld; deze kan worden verborgen.
  • Cache Clearer — wist de OAuth2-tokencache en de modelcache.
  • Taxonomy Sync — past taxonomie-termen opnieuw toe op basis van opgeslagen waarden voor elk geïmporteerd voertuig.
  • API Connection Test — voert een live verzoek uit naar AutoScout24 met de huidige inloggegevens.
  • Demo Data — installeert of verwijdert een getagde set demovoertuigen, leads, zoekopdrachten en analytics.
  • Diagnostics Centre — diagnostiek voor een specifieke post, preview van een dry run en een JSON-systeem-momentopname.

Vereisten of randvoorwaarden

  • Een gebruiker met de beheersrechten van de plugin.
  • Om de API Connection Test en Cache Clearer nuttig te laten zijn: geldige API-inloggegevens geconfigureerd in Settings.
  • Voor diagnostiek op een specifieke post: de WordPress post-ID van een geïmporteerd voertuig.

Stapsgewijze instructies

Geïmporteerde voertuigen exporteren

  1. Open Car Market Hub → Tools.
  2. Klik in de kaart Export Vehicles op Export CSV voor spreadsheet-werkstromen, of op Export JSON voor gestructureerde gegevens en ontwikkelaarsgebruik.

Caches wissen

  1. Klik in de kaart Cache Clearer op: - Clear Token Cache — verwijdert het gecachte OAuth2-toegangstoken. Het volgende API-verzoek haalt een nieuw token op. - Clear Model Cache — verwijdert de gecachte opzoekgegevens voor voertuigmodellen, zodat deze op aanvraag opnieuw worden opgebouwd.
  2. De statusregel geeft aan of er momenteel een token is gecacht.

Gebruik dit na wijzigingen in de inloggegevens, na het wisselen van API-omgeving of wanneer er nieuwe API-gegevens nodig zijn.

Taxonomieën synchroniseren

  1. Klik in de kaart Taxonomy Sync op Run Taxonomy Sync.
  2. De plugin doorloopt alle geïmporteerde voertuig-posts en past de relaties met taxonomie-termen (merk, model, brandstof, kleur en andere voertuigkenmerken) opnieuw toe op basis van de waarden die in de voertuigentabel zijn opgeslagen.
  3. Het aantal verwerkte posts wordt na de run weergegeven.

Gebruik dit wanneer filtertermen ontbreken, verouderd zijn of niet synchroon lopen (bijvoorbeeld na een databasemigratie of het opnieuw activeren van de plugin).

De API-verbinding testen

  1. Klik in de kaart API Connection Test op de testknop.
  2. De plugin voert een live verzoek uit naar de AutoScout24 API met de huidige inloggegevens en rapporteert het resultaat.

Voer dit uit na het bijwerken van de inloggegevens of wanneer imports onverwacht mislukken.

Demogegevens installeren of verwijderen

  1. Klik in de kaart Demo Data op Install Demo Data.
  2. De plugin installeert 10 demovoertuigen: 8 worden direct gepubliceerd en 2 verschijnen als nog niet geïmporteerde advertenties op de pagina Beheerdersreferentie voor de Car Importer, zodat u de import-werkstroom kunt testen. Het maakt ook voorbeeldleads, zoekopdrachten en synthetische analytics voor 30 dagen aan.
  3. Om dit ongedaan te maken, klikt u op Remove Demo Data. Alleen records die door de demo-installer zijn gemaakt, worden verwijderd; echte klantgegevens worden niet beïnvloed.

De kaart toont een live samenvatting van wat er momenteel is geïnstalleerd (geïmporteerde voertuigen, openstaande advertenties in de importer, leads, zoekopdrachten en analytics-gebeurtenissen) of No demo data installed wanneer er niets aanwezig is. Nadat u demogegevens hebt geïnstalleerd of verwijderd, rapporteert een laatste installatie-/verwijderingssamenvatting wat er is aangemaakt of opgeschoond.

Gebruik dit voor productdemo's, interne beoordelingen en frontend-testen zonder een live AutoScout24-verbinding.

Een specifieke voertuig-post diagnosticeren

  1. Zoek in het Diagnostics Centre naar Diagnose a Vehicle Post.
  2. Voer de WordPress post-ID van een geïmporteerd voertuig in en verzend het formulier.
  3. De plugin retourneert post-metadata, afbeeldingsreferenties, de ruwe payload van AutoScout24 (indien aanwezig) and live API-reacties voor de advertentie- en uitrustings-endpoints.

Een dry run uitvoeren

  1. Zoek in het Diagnostics Centre naar Dry Run.
  2. Verzend het formulier. De plugin toont een preview van de gegevens die deze uit AutoScout24 zou importeren, zonder wijzigingen in de database op te slaan. De preview is beperkt tot ongeveer 25 rijen en wordt weergegeven als een JSON-preview.

Gebruik dit om de API-datastructuur te controleren vóór een volledige import.

Een systeem-momentopname delen

  1. Vouw in het Diagnostics Centre Show System Snapshot uit.
  2. Kopieer de JSON-inhoud en voeg deze toe aan een supportticket of deel deze met uw operationele team.

De momentopname bevat de plugin-versie, de site-URL, WordPress- en PHP-versies, de themanaam, de logstatus en een gecensureerde weergave van de belangrijkste plugin-instellingen (alleen vlaggen zoals Client ID set: yes/no; ruwe geheimen worden niet geëxporteerd).

Configuratiereferentie

Het Tools-scherm slaat zelf geen instellingen op. Het is een startpunt voor eenmalige acties.

ActieKaartResultaat
Export CSVExport VehiclesSpreadsheet-vriendelijk bestand met geïmporteerde voertuigen.
Export JSONExport VehiclesGestructureerde JSON met geïmporteerde voertuigen.
Clear Token CacheCache ClearerGecacht OAuth2-toegangstoken wordt verwijderd.
Clear Model CacheCache ClearerGecachte opzoekgegevens voor voertuigmodellen worden verwijderd.
Run Taxonomy SyncTaxonomy SyncRelaties met taxonomie-termen opnieuw toegepast op elk geïmporteerd voertuig.
Run API TestAPI Connection TestLive verzoek naar AutoScout24, succes of fout wordt inline gerapporteerd.
Install Demo DataDemo DataGetagde demovoertuigen, leads, zoekopdrachten en analytics aangemaakt.
Remove Demo DataDemo DataGetagde demorecords verwijderd.
Diagnose PostDiagnostics CentreTechnisch rapport per post.
Dry RunDiagnostics CentrePreview van API-gegevens zonder wijzigingen op te slaan.
Show System SnapshotDiagnostics CentreJSON-momentopname voor ondersteuning.

Operationele opmerkingen

  • Alle acties in dit scherm zijn directe, eenmalige bewerkingen. Er is hier geen planning of scheduling.
  • De statusindicator van de Token Cache (Token cache active / No token cache) weerspiegelt het OAuth2-token dat momenteel is opgeslagen in de WordPress transient-opslag.
  • Demogegevens worden geïdentificeerd door een interne tag, zodat verwijdering veilig is en geen echte klantrecords raakt. Controleer dit gedrag in de huidige plugin-versie voordat u dit uitvoert op een productie-site.
  • Exports kunnen groot zijn, afhankelijk van het aantal geïmporteerde voertuigen. CSV wordt gegenereerd als een stream; JSON wordt in het geheugen gegenereerd.
  • Het opzoeken van de diagnostische post voert een live API-oproep uit naar AutoScout24 voor de advertentie- en uitrustings-endpoints. De resultaatsectie toont eventuele fouten die door de API worden geretourneerd.
  • De systeem-momentopname laat opzettelijk ruwe geheimen weg. Behandel deze als weinig gevoelig, maar nog steeds als intern.

Probleemoplossing

  • Export-download is leeg. Er zijn nog geen voertuigen geïmporteerd, of een andere plugin onderschept admin-post.php-verzoeken. Controleer of de importer succesvol heeft gedraaid op de Beheerdersreferentie voor de Car Importer.
  • Taxonomy Sync rapporteert nul verwerkte posts. Er bestaan nog geen voertuig-posts. Voer eerst een import uit.
  • API Connection Test rapporteert een fout. Controleer de Client ID, Client Secret en Base URL opnieuw in Settings, klik vervolgens op Clear Token Cache en probeer het opnieuw.
  • Diagnostiek retourneert "Missing listingid or sellerid meta on this post." De post is geen geïmporteerd voertuig, of de post is ouder dan de huidige opslagstructuur voor voertuigen. Importeer het voertuig opnieuw.
  • Demogegevens worden niet geïnstalleerd. Controleer of de gebruiker de beheersrechten heeft en of de database de demorecords kan wegschrijven. Controleer de Logs voor details.
  • Systeem-momentopname toont client_id_set: no. Inloggegevens zijn niet opgeslagen. Sla ze op in Settings voordat u gaat testen.

Gerelateerde documenten