Documentatie · Probleemoplossing

Overzicht Probleemoplossing

Dit document biedt een gestructureerd startpunt voor het diagnosticeren en oplossen van problemen met de ADP Car Market Hub WordPress Plugin. Het beschrijft de aanbevolen diagnostische volgorde, waar u logs en statusinformatie kunt vinden, en veilige werkwijzen bij het inschakelen van support.

Wanneer u dit document moet gebruiken

Lees dit document eerst wanneer de plugin zich niet naar verwachting gedraagt. Het leidt u naar de juiste specialistische pagina en helpt u de benodigde informatie te verzamelen voordat u contact opneemt met support.

Overzicht

De ADP Car Market Hub plugin maakt verbinding met de AutoScout24 API, importeert voertuiggegevens in WordPress, beheert geautomatiseerde taken en toont de voertuigen op de frontend. Problemen kunnen in elk van deze lagen optreden. Door te starten met een systematische diagnostische volgorde voorkomt u dat u tijd besteedt aan de verkeerde laag.

Aanbevolen diagnostische volgorde

Werk opeenvolgend door elke laag heen. Stop en raadpleeg het relevante specialistische document zodra u het probleemgebied heeft geïdentificeerd.

  1. Controleer het plugin-logbestand – De plugin schrijft alle belangrijke gebeurtenissen, fouten en importresultaten naar een specifiek logbestand. Dit is altijd de eerste plek om te kijken.
  2. Controleer de API-verbinding – Als het logbestand authenticatie- of HTTP-fouten toont, of als de Systeemstatus-pagina een verbindingsprobleem meldt, raadpleeg dan API-verbindingsfouten.
  3. Controleer importresultaten – Als er voertuigen ontbreken, gedeeltelijk zijn geïmporteerd of verouderde gegevens tonen, raadpleeg dan Importfouten.
  4. Controleer geautomatiseerde taken – Als automatische imports niet worden uitgevoerd, of als de tijd van de laatste uitvoering niet verschuift, raadpleeg dan Cron-fouten.
  5. Controleer afbeeldingen-import – Als voertuigafbeeldingen ontbreken of niet volledig zijn gedownload, raadpleeg dan Afbeeldingen-importfouten.
  6. Controleer weergave aan de frontend – Als voertuigen wel in de backend verschijnen maar niet correct op de frontend worden getoond, raadpleeg dan Problemen met frontend-weergave.
  7. Controleer machtigingen – Als beheerdersschermen of importacties fouten over geweigerde toegang retourneren, raadpleeg dan Machtigingsfouten.

Waar u logs en statusinformatie kunt vinden

Plugin-logbestand

De plugin schrijft naar een logbestand in de WordPress uploads-map:

wp-content/uploads/as24ci-logs/adp-car-market-hub.log

De logmap is beschermd tegen directe webtoegang door een .htaccess-bestand en een index.php-barrière. Open het bestand via SFTP, de bestandsbeheerder van uw hosting, of een log-viewer tool met servertoegang.

Het logbestand roteert automatisch zodra het groter is dan 10 MB. Geroteerde archieven krijgen de naam adp-car-market-hub-YYYYMMDD-HHMMSS.log en worden na 7 dagen automatisch verwijderd.

Uitgebreide logboekregistratie (regels per voertuig en per afbeelding) is standaard ingeschakeld. U kunt dit uitschakelen in de plugin-instellingen om het logvolume bij grote catalogi te beperken.

Systeemstatus-pagina

Het beheergedeelte van de plugin bevat een tabblad Systeem & Hulp dat het volgende toont:

  • API-verbindingsstatus (meest recent getest met de geconfigureerde Seller ID)
  • Tijdstip van de laatste import en resultaat-aantallen (toegevoegd, bijgewerkt, overgeslagen, fouten)
  • Status van WP-Cron of server-cron en de laatste uitvoeringstijd
  • Status van de afbeeldingenwachtrij (items in de wachtrij, laatste uitvoering van de worker)

Bekijk deze pagina voordat u de ruwe logs controleert.

WordPress-beheer

Standaard WordPress-hulpprogramma's bieden ook nuttige informatie:

  • Gereedschap → Geplande taken (of een WP-Cron viewer-plugin): controleer of de taken as24ci_scheduled_import en as24ci_image_queue_process aanwezig zijn en een realistische volgende uitvoeringstijd hebben.
  • Media: controleer of voertuigafbeeldingen aan de juiste berichten zijn gekoppeld.
  • Berichten → Cars: controleer het aantal gepubliceerde voertuigberichten en eventuele concepten of wachtende berichten.

Vereisten voor effectieve probleemoplossing

Controleer het volgende voordat u op onderzoek uitgaat:

  • U heeft beheerderstoegang tot het WordPress-dashboard.
  • U heeft servertoegang (SFTP, SSH of de bestandsbeheerder van uw hosting) om het logbestand te lezen.
  • U weet welke plugin-versie momenteel is geïnstalleerd (zichtbaar in Plugins → Geïnstalleerde plugins).
  • U weet de PHP-versie en WordPress-versie van de site (zichtbaar in Gereedschap → Systeemservice).

Veilige werkwijzen bij het inschakelen van support

  • Deel geen API-inloggegevens (Client ID, Client Secret of toegangstokens) in supporttickets of openbare forums. Het plugin-logbestand maskeert deze waarden automatisch.
  • Lever het relevante deel van het logbestand aan (niet het volledige bestand, tenzij hierom wordt gevraagd).
  • Voeg de uitvoer van de Systeemstatus-pagina of een screenshot toe.
  • Beschrijf de exacte stappen die u heeft genomen voordat het probleem optrad, inclusief recente wijzigingen in instellingen of plugin-updates.
  • Als u een probleem met de WordPress- of hostingomgeving vermoedt, voeg dan de uitvoer van Gereedschap → Systeemservice → Info toe.

Operationele opmerkingen

  • De meeste problemen worden veroorzaakt door onjuiste inloggegevens, een onbereikbaar API-eindpunt of een uitgeschakelde of verkeerd geconfigureerde cron-planning.
  • De plugin gebruikt WordPress transient locks om overlappende importtaken te voorkomen. Als een import abnormaal is onderbroken, kan de lock tot 40 minuten actief blijven voordat deze automatisch wordt gewist.
  • De plugin slaat het laatste importresultaat (aantallen en tijdstempel) op in WordPress-opties. Deze zijn zichtbaar op het beheerdersdashboard en worden ook naar het logbestand geschreven.

Gerelateerde documenten