Systeem- en hulpreferentie

Dit document is een referentie voor het scherm Systeem & Hulp van de ADP Car Market Hub-plugin (Car Market Hub → System & Help). Het legt de panelen voor connectiviteit, achtergrondtaken, server, logbestanden en de afbeeldingenwachtrij uit die door dit statusoverzicht worden getoond.

Wanneer u dit document moet gebruiken

Lees dit als u het volgende moet doen:

• Bevestigen dat de AutoScout24-API, het REST-eindpunt van de plugin en de Market Hub-API bereikbaar zijn.
• Controleren of geplande taken (cron-jobs) gezond zijn en wanneer ze de volgende keer worden uitgevoerd.
• Een import, een run van de afbeeldingenwachtrij of het leegmaken van de wachtrij vanaf één centrale plek activeren.
• Controleren of de server voldoet aan de vereisten van de plugin (PHP-versie, geheugen, uitvoeringstijd).
• De grootte en rotatiestatus van het logbestand inspecteren, evenals de gezondheid van de wachtrij voor het importeren van afbeeldingen.

Overzicht

Het scherm is een dashboard dat voornamelijk bedoeld is voor het aflezen van de status. Een actiebalk bovenaan de kaarten bevat een knop Diagnostische gegevens downloaden — gelabeld als Diagnostische ZIP downloaden, of Diagnostische JSON downloaden wanneer ZIP-ondersteuning niet beschikbaar is op de server — waarmee u een diagnostisch pakket kunt downloaden dat u aan een ondersteuningsverzoek kunt toevoegen.

Het scherm is opgedeeld in de volgende kaarten:

• Connectiviteit & API — AutoScout24-API-status, OAuth2-tokenstatus, controle van het REST-eindpunt van de plugin en Market Hub-API-status.
• Diagnostische gegevens voor privé-updates — update- en versiediagnostiek met een kopieerbaar JSON-rapport.
• Achtergrondtaken — lijst met geplande cron-gebeurtenissen met hun schema en volgende uitvoeringstijd, plus actieknoppen.
• Plugin-vereisten — minimale versies en feature flags.
• Server & Opslag — PHP-configuratie, serveromgeving en gezondheid van de uploads-map.
• Status logbestand — huidige grootte van het logbestand, rotatiestatus en pad.
• Status afbeeldingenwachtrij — openstaande afbeeldingen, statistieken van de laatste run van de worker.

Elke rij maakt gebruik van verkeerslicht-badges (ok, warn, bad) met tooltips die de drempelwaarde of de herstelstap uitleggen.

Vereisten of randvoorwaarden

• Een gebruiker met de beheerdersrechten van de plugin.
• Voor de connectiviteitscontroles: uitgaande HTTPS-toegang vanaf de webserver naar de geconfigureerde API-eindpunten.
• Voor de REST API-controle: WordPress mooie permalinks ingeschakeld.
• Voor de cron-sectie: de ingebouwde cron van WordPress moet actief zijn, of een planner op serverniveau moet wp-cron.php aanroepen.

Stapsgewijze instructies

Connectiviteit verifiëren

1. Open Car Market Hub → System & Help.
2. Controleer in Connectiviteit & API het volgende: - AS24 API-eindpuntstatus en AS24 API-bereikbaarheid voor de AutoScout24 basis-URL. - Tokenstatus (Geldig / Verloopt binnenkort / Verlopen / Geen token). - REST API-status voor het as24ci/v1/cron-import-eindpunt van de plugin. - Market Hub-bereikbaarheid voor de Market Hub-API.
3. Beweeg de muis over een badge voor de tooltip met de achterliggende details (HTTP-status, latentie of foutmelding).

Diagnostische gegevens voor updates bekijken

1. Open de kaart Diagnostische gegevens voor privé-updates in de rechterkolom.
2. Lees de rijen om te bevestigen dat het updatekanaal van de plugin gezond is: de geïnstalleerde versie, of update-hooks zijn geregistreerd, de aangeboden externe nieuwe versie, consistentie van de transient (gecachete updategegevens), de licentiestatus en het genormaliseerde domein.
3. Als u contact opneemt met de ondersteuning over een update- of licentieprobleem, gebruik dan het kopieerbare JSON-rapport onderaan de kaart en plak dit in uw ticket.

Deze kaart is een snelle manier om te bevestigen dat de plugin privé-updates kan zien en toepassen zonder gevoelige inloggegevens bloot te leggen.

Geplande taken controleren

1. Scrol naar Achtergrondtaken.
2. De kop van de kaart toont een badge die aangeeft of de planning via WP-Cron of een Server Cron verloopt, samen met een heartbeat-notitie zoals Laatste import X geleden uitgevoerd of Geen recente importrun gedetecteerd.
3. Bekijk de tabel: elke rij toont de cron-taak, het schema, de tijdstempel van de volgende run en een statusbadge. Taken kunnen import-, afbeeldingenwachtrij-, analytics- en Pricing Analysis-taken omvatten.
4. Naast de normale status voor de volgende run kan een taak de melding Lock vastgelopen, Afgehandeld door server-cron of Niet gepland rapporteren.
5. Als de ingebouwde cron van WordPress is uitgeschakeld (DISABLE_WP_CRON), wordt er een waarschuwing weergegeven; stel in dat geval een planner op serverniveau in die wp-cron.php aanroept.
6. Gebruik de inline knoppen om indien nodig direct acties uit te voeren: Import nu uitvoeren, Afbeeldingenwachtrij nu uitvoeren of Afbeeldingenwachtrij wissen.

Servercompatibiliteit verifiëren

1. Lees Plugin-vereisten voor de minimale versies en feature flags, inclusief de beschikbaarheid van ZipArchive en de status van de ionCube Loader (met de Loader-versie).
2. Lees Server & Opslag voor de PHP-configuratie: - memory_limit, WP Memory Limit, max_execution_time, upload_max_filesize, post_max_size, max_input_vars. - PHP SAPI en Server OS. - Status van de uploads-map en vrije schijfruimte.

Het logbestand en de afbeeldingenwachtrij inspecteren

1. Status logbestand toont of het logbestand bestaat, de huidige grootte, de resterende ruimte voor rotatie, de laatste rotatietijd en het bestandspad.
2. Status afbeeldingenwachtrij toont openstaande afbeeldingenimports plus statistieken van de laatste run van de worker (verwerkt aantal, fouten, resterende items).

Configuratieruimte

Het scherm Systeem & Hulp slaat zelf geen instellingen op. Het leest uit de huidige WordPress-configuratie, plugin-opties en runtime-status.

Connectiviteit & API-badges

De exacte bewoording van de labels kan per plugin-versie licht verschillen; vertrouw op de kleur van de badge en de details in de tooltip in plaats van de exacte tekst.

De rij voor de REST API wordt pas volledig gecontroleerd wanneer er een cron-token is gegenereerd in Beheerdersreferentie voor Import & Limieten. Anders wordt Not checked — no cron token configured getoond.

Diagnostische gegevens voor privé-updates

Deze kaart toont de status van de updates en licenties van de plugin. De rijen bevatten doorgaans de geïnstalleerde versie, of update-hooks zijn geregistreerd, de aangeboden externe nieuwe versie, consistentie van de transient (gecachete updategegevens), de licentiestatus en het genormaliseerde domein. Een kopieerbaar JSON-rapport onderaan bundelt deze waarden voor de ondersteuningsafdeling.

Serverdrempels

De overige PHP-waarden (upload_max_filesize, post_max_size, max_input_vars, schrijfrechten van de uploads-map, vrije schijfruimte) worden gepresenteerd met hun huidige waarden en een contextuele badge.

Acties voor achtergrondtaken

Operationele opmerkingen

• Connectiviteitscontroles gebruiken een korte time-out en een aangepaste user-agent, en cachen hun resultaat ongeveer één minuut om te voorkomen dat de upstream-diensten overbelast raken. Ze gebruiken niet allemaal dezelfde HTTP-methode: de AutoScout24-controle voert een HEAD-verzoek uit, terwijl de REST-zelfcontrole van de plugin en de Market Hub-statuscontrole GET gebruiken (de Market Hub-controle is gericht op een /v1/health-eindpunt).
• De knop Diagnostische gegevens downloaden in de bovenste actiebalk genereert een diagnostisch pakket (een ZIP waar ondersteund, anders een JSON-bestand) om aan een ondersteuningsverzoek toe te voegen.
• De tooltip voor het verlopen van het token gebruikt de tijdzone van de WordPress-site voor weergave, maar de gecachte waarde wordt opgeslagen als een UNIX-timestamp.
• De REST API-controle gebruikt opzettelijk een ongeldig token — een gezonde installatie reageert met HTTP 403. HTTP 404 geeft aan dat het eindpunt niet bereikbaar is (meestal een probleem met permalinks of herschrijfregels).
• Als DISABLE_WP_CRON actief is, worden geplande taken niet uitgevoerd, tenzij de host is geconfigureerd om zelf wp-cron.php aan te roepen. Imports en afbeeldingsverwerking lijken zonder dit vast te lopen.
• De waarschuwingsbadge voor de afbeeldingenwachtrij verschijnt wanneer de wachtrijgrootte de interne drempelwaarde van de plugin overschrijdt (momenteel 1.000 openstaande items).
• Vrije schijfruimte wordt gerapporteerd op basis van 'best-effort'. Sommige hosts verbergen dit; in dat geval toont de badge Kan niet worden bepaald.

Probleemoplossing

• AS24 API-bereikbaarheid is bad. De basis-URL in Instellingen ontbreekt, is onjuist geformatteerd of de upstream is offline. Controleer de tooltip voor de achterliggende fout.
• Tokenstatus is No token. Sla een geldige Client ID en Secret op in Instellingen en voer vervolgens Verbinding testen uit op Hulpmiddelen.
• REST API-status meldt dat het eindpunt niet is gevonden (HTTP 404). Mooie permalinks staan uit, of een andere plugin overschrijft de REST-routering. Sla de permalinks opnieuw op onder Settings → Permalinks.
• REST API-rij zegt "Niet gecontroleerd — geen cron-token geconfigureerd." Open Beheerdersreferentie voor Import & Limieten en genereer een cron-token.
• Achtergrondtaken hebben een verouderde "Volgende run". De WordPress-cron is uitgeschakeld of er is geen verkeer op de site. Gebruik de knop Import nu uitvoeren om te bevestigen dat de taak zelf draait, en plan vervolgens een trigger op serverniveau.
• memory_limit gemarkeerd met bad. Verhoog memory_limit in php.ini of wp-config.php (define('WP_MEMORY_LIMIT', '256M');) — vereist voor grote imports.
• Afbeeldingenwachtrij blijft groeien. Klik op Afbeeldingenwachtrij nu uitvoeren om een batch te verwerken. Als het aantal blijft stijgen, verlaag dan het aantal geïmporteerde afbeeldingen per voertuig in Instellingen of verhoog de frequentie van de worker-run in Beheerdersreferentie voor Import & Limieten.
• Logbestand gemarkeerd met bad of Nog geen logbestand. Controleer of de logmap beschrijfbaar is. Verifieer dit in de huidige plugin-versie voordat u publiceert.

Gerelateerde documenten

• Instellingenreferentie
• Beheerdersreferentie voor Import & Limieten
• Hulpmiddelenreferentie
• Beheerdersreferentie voor Logs
• Ondersteuningsreferentie