Documentatie · Beheerdersreferentie
Systeem- en helpreferentie
Dit document is een referentie voor het scherm Systeem & Hulp van de ADP Car Market Hub-plugin (CMH Center → System & Help). Het legt de panelen uit voor connectiviteit, achtergrondtaken, server, logbestanden en de afbeeldingenwachtrij die door deze statusweergave worden getoond.
Wanneer u dit document moet gebruiken
Lees dit als u het volgende moet doen:
- Bevestigen dat uw gegevensbronnen, 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, uitvoering van de afbeeldingenwachtrij of het leegmaken van de wachtrij vanaf één plek starten.
- Controleren of de server voldoet aan de vereisten van de plugin (PHP-versie, geheugen, uitvoeringstijd).
- De grootte en rotatiestatus van het logbestand en de status van de wachtrij voor het importeren van afbeeldingen inspecteren.
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 supportaanvraag kunt toevoegen.
Het scherm is opgedeeld in de volgende kaarten:
- Connectiviteit & API — een rij Gegevensbronnen (status per bron), de controle van de REST API-integratie van de plugin en de status van de Market Hub API. De diagnostische gegevens voor het AutoScout24-eindpunt, de bereikbaarheid en het OAuth2-token bevinden zich nu op de AutoScout24-bronkaart op de pagina Connecties, niet hier.
- E-mail & afleverbaarheid — of uitgaande e-mail waarschijnlijk werkt, plus een actie Test-e-mail verzenden.
- 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 status 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 beheersrechten 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 aan de serverzijde moet
wp-cron.phpaanroepen.
Stapsgewijze instructies
Connectiviteit verifiëren
- Open
CMH Center → System & Help. - Controleer in Connectiviteit & API:
- Gegevensbronnen — een statusoverzicht per bron voor uw verbonden bronnen (AutoScout24, mobile.de, carcuro, feed, e-mail).
- REST API-integratie voor het
as24ci/v1/cron-import-eindpunt van de plugin. - Market Hub API bereikbaarheid voor de Market Hub API. - Beweeg de muis over een badge voor de tooltip met de onderliggende details (HTTP-status, latentie of foutmelding).
- Open voor het AutoScout24-eindpunt, de bereikbaarheid en de tokendiagnostiek de AutoScout24-kaart op de pagina Connecties.
E-mailafleverbaarheid controleren en een test-e-mail verzenden
- Scrol naar de kaart E-mail & afleverbaarheid. Deze bevestigt of uitgaande e-mail waarschijnlijk werkt voor meldingen over leads, zoekopdrachten en proefritten.
- Bekijk de verkeerslicht-rijen:
- E-mailtransport — of WordPress überhaupt e-mail kan verzenden (PHP
mail()of een SMTP-/mailer-transport). - SMTP / mailer — of een erkende SMTP-/mailer-plugin actief is (bijvoorbeeld WP Mail SMTP, FluentSMTP, Post SMTP, Easy WP SMTP) of alleen kale PHPmail(). - Afzenderadres — het effectieve afzenderadres en of het domein daarvan overeenkomt met uw sitedomein (SPF/DKIM-uitlijning). - SPF-record en DMARC-record — DNS-lookups op basis van 'best-effort' en caching voor het verzendende domein. - Beweeg de muis over een badge voor de tooltip met de hersteltip.
- Gebruik Test-e-mail verzenden om de daadwerkelijke aflevering te bevestigen. Het ontvangersveld is standaard ingesteld op het e-mailadres van de huidige beheerder; pas dit indien nodig aan en verzend het formulier. Het bericht wordt verzonden via WordPress's
wp_mail(), en direct daarna wordt een duidelijke inline succes- of foutmelding getoond.
Update-diagnostiek bekijken
- Open de kaart Diagnostische gegevens voor privé-updates in de rechterkolom.
- 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, de consistentie van de transient (gecachte updategegevens), de licentiestatus en het genormaliseerde domein.
- Als u contact opneemt met de support 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
- Scrol naar Achtergrondtaken.
- 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 importuitvoering gedetecteerd.
- Bekijk de tabel: elke rij toont de cron-taak, het schema, de tijdstempel van de volgende uitvoering en een statusbadge. Taken kunnen import-, afbeeldingenwachtrij-, analytics- en Pricing Analysis-taken omvatten.
- Naast de normale status voor de volgende uitvoering kan een taak de melding Vergrendeling vastgelopen, Afgehandeld door server-cron of Niet gepland rapporteren.
- Als de ingebouwde cron van WordPress is uitgeschakeld (
DISABLE_WP_CRON), wordt er een waarschuwing weergegeven; stel in dat geval een planner aan de serverzijde in diewp-cron.phpaanroept. - Gebruik de inline knoppen om indien nodig direct acties uit te voeren: Import nu uitvoeren, Afbeeldingenwachtrij nu uitvoeren of Afbeeldingenwachtrij wissen.
Servercompatibiliteit verifiëren
- Lees Plugin-vereisten voor de minimale versies en feature flags, inclusief de beschikbaarheid van ZipArchive and de status van de ionCube Loader (met de bijbehorende Loader-versie).
- 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
- Status logbestand toont of het logbestand bestaat, de huidige grootte ervan, de resterende ruimte voor rotatie, de tijd van de laatste rotatie en het bestandspad.
- Status afbeeldingenwachtrij toont openstaande afbeeldingenimports plus statistieken van de laatste run van de worker (aantal verwerkte items, fouten, resterende items).
Configuration reference
Het scherm Systeem & Hulp slaat zelf geen instellingen op. Het leest uit de huidige WordPress-configuratie, plugin-opties en runtime-status.
Connectivity & API badges
| Rij | Mogelijke statussen |
|---|---|
| Gegevensbronnen | Een samenvatting per bron voor de bronnen die u hebt verbonden (AutoScout24, mobile.de, carcuro, feed, e-mail). Elk toont ok / warn / bad. Bronspecifieke diagnostische gegevens (voor AutoScout24: eindpunt, bereikbaarheid, OAuth2-token) bevinden zich op de kaart van die bron op de pagina Connections. |
| REST API-integratie | Eindpunt bereikbaar, bijv. Actief, tokenbeveiliging werkt (het eindpunt weigert een ongeldig health-check-token met HTTP 403); REST-eindpunt niet gevonden (HTTP 404); of onbereikbaar. |
| Market Hub API | Bereikbaarheid van de Market Hub API (vergelijkbaar patroon in latentiestijl). |
De exacte bewoording van de labels kan per plugin-versie enigszins verschillen; vertrouw op de kleur van de badge en de details in de tooltip in plaats van op de exacte tekst.
De REST API-rij wordt pas volledig gecontroleerd wanneer er een cron-token is gegenereerd in Import And Limits. Anders wordt
Not checked — no cron token configuredweergegeven.
E-mail & Deliverability rows
| Rij | Wat het rapporteert |
|---|---|
| E-mailtransport | ok wanneer WordPress e-mail kan verzenden (PHP mail() of een SMTP-/mailer-transport beschikbaar is); bad wanneer geen van beide wordt gedetecteerd (uitgaande e-mail zal mislukken). |
| SMTP / mailer | ok met de gedetecteerde mailernaam (bijv. WP Mail SMTP, FluentSMTP, Post SMTP, Easy WP SMTP of SMTP-constanten); warn wanneer alleen kale PHP mail() beschikbaar is (belandt vaak in de spambox). |
| Van-adres | Toont het effectieve Van-adres; ok wanneer het domein overeenkomt met uw sitedomein, warn bij een domeinverschil (slecht voor SPF/DKIM-uitlijning). |
| SPF-record | Best-effort, gecachte DNS-controle op een v=spf1-record op het verzendende domein. |
| DMARC-record | Best-effort, gecachte DNS-controle op een v=DMARC1-record op het verzendende domein. |
De actie Test-e-mail verzenden onder de tabel verzendt een bericht via wp_mail() naar de ontvanger (standaard het e-mailadres van de huidige beheerder) en rapporteert een duidelijk inline succes- of foutresultaat.
Private Update Diagnostics
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 (gecachte updategegevens), de licentiestatus en het genormaliseerde domein. Een kopieerbaar JSON-rapport onderaan bundelt deze waarden voor support.
Server thresholds
| Instelling | ok | warn | bad |
|---|---|---|---|
memory_limit | ≥ 256 MB of onbeperkt | 128–255 MB | < 128 MB |
max_execution_time | > 60 s of onbeperkt | 30–60 s | < 30 s |
De overige PHP-waarden (upload_max_filesize, post_max_size, max_input_vars, schrijfbaarheid van de uploads-map, vrije schijfruimte) worden gepresenteerd met hun huidige waarden en een contextuele badge.
Background-task actions
| Knop | Effect |
|---|---|
| Nu import uitvoeren | Start de reguliere import eenmalig, onmiddellijk. |
| Nu afbeeldingenwachtrij verwerken | Verwerkt de volgende batch uit de afbeeldingenwachtrij. |
| Afbeeldingenwachtrij wissen | Maakt de wachtrij met openstaande afbeeldingen leeg. Destructief. |
Operational notes
- Connectiviteitscontroles gebruiken een korte time-out en een aangepaste user-agent en cachen hun resultaat gedurende ongeveer één minuut om overbelasting van de upstream-services te voorkomen. 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-gezondheidssondeGETgebruiken (de Market Hub-sonde is gericht op een/v1/health-eindpunt). - De knop Diagnostische gegevens downloaden in de bovenste actiebalk genereert een diagnostisch pakket (een ZIP-bestand waar dit wordt ondersteund, anders een JSON-bestand) om bij een supportaanvraag te voegen.
- De tooltip voor het verlopen van tokens 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 404geeft aan dat het eindpunt niet bereikbaar is (meestal een probleem met permalinks of herschrijfregels). - Als
DISABLE_WP_CRONactief is, worden geplande taken niet uitgevoerd, tenzij de host is geconfigureerd omwp-cron.phpzelf 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.
Troubleshooting
- Een gegevensbron toont
bad. Open de kaart van die bron op de pagina Connections om de bronspecifieke diagnostische gegevens te bekijken. Voor AutoScout24 ontbreekt mogelijk de basis-URL of is deze onjuist geformatteerd, of is de upstream offline — de AutoScout24-kaart toont het eindpunt, de bereikbaarheid en de tokendetails. - AutoScout24 heeft geen token / het token is verlopen. Sla een geldige Client ID en Secret op voor AutoScout24 op de pagina Connections (de AutoScout24-kaart toont de tokenstatus) en voer vervolgens Verbinding testen uit op Tools.
- REST API-status meldt dat het eindpunt niet is gevonden (HTTP 404). Mooie permalinks staan uit, of een andere plugin overschrijft de REST-routing. Sla permalinks opnieuw op onder
Settings → Permalinks. - De REST API-rij zegt "Niet gecontroleerd — geen cron-token geconfigureerd." Open Import And Limits en genereer een cron-token.
- Achtergrondtaken hebben een verouderde "Volgende uitvoering". WordPress-cron is uitgeschakeld of er is geen verkeer op de site. Gebruik de knop Nu import uitvoeren om te bevestigen dat de taak zelf wordt uitgevoerd en plan vervolgens een trigger aan de serverzijde.
memory_limitheeftbadgemarkeerd. Verhoogmemory_limitinphp.iniofwp-config.php(define('WP_MEMORY_LIMIT', '256M');) — vereist voor grote imports.- Afbeeldingenwachtrij blijft groeien. Klik op Nu afbeeldingenwachtrij verwerken om een batch te verwerken. Als het aantal blijft stijgen, verlaag dan het aantal geïmporteerde afbeeldingen per voertuig in Import And Limits of verhoog daar de frequentie van de worker-uitvoering.
- Logbestand gemarkeerd met
badof Nog geen logbestand. Controleer of de logmap beschrijfbaar is. Verifieer dit in de huidige plugin-versie alvorens te publiceren.