Documentatie · Systeemvereisten

Pre-installatie checklist

Doel

Deze checklist bundelt alles wat een bureau of beheerder moet controleren voordat ADP Car Market Hub wordt geïnstalleerd of voordat een staging-installatie naar productie wordt overgezet. De checklist is bewust praktisch van opzet: elk item verwijst naar een concrete controle die binnen enkele minuten kan worden uitgevoerd op de hostingomgeving, de WordPress-site of het AutoScout24-account.

Wanneer u dit document gebruikt

Gebruik dit document wanneer u:

Een nieuwe dealer onboardt en één pagina nodig heeft om hun hosting te valideren voordat u de plugin installeert.
Een nieuw gebouwde site overzet van staging naar productie.
Een bestaande installatie controleert die al een tijdje draait en mogelijk is afgeweken van de aanbevolen basislijn.
Een site overdraagt aan een ander bureau of aan het interne IT-team van de klant.

Overzicht

De checklist is onderverdeeld in negen gebieden. Elk gebied bevat een klein aantal ja/nee-items. Beschouw elke "nee" als een blokkade voor productie-imports totdat deze is opgelost of expliciet is goedgekeurd.

Voor meer achtergrondinformatie over een item kunt u de link volgen in de sectie Gerelateerde documenten onderaan deze pagina.

Checklist

1. Hosting en runtime

[ ] PHP 8.1 of nieuwer is geïnstalleerd en actief voor de WordPress-site.
[ ] PHP memory_limit is minimaal 256 MB (128 MB is het absolute minimum dat het tabblad System & Help accepteert).
[ ] PHP max_execution_time is minimaal 120 seconden; 300 seconden wordt aanbevolen voor imports met veel afbeeldingen.
[ ] PHP-extensies openssl, curl, mbstring, json en een van gd / imagick zijn geladen; ZipArchive is beschikbaar voor exportbundels.
[ ] Er is ten minste 1 GB vrije schijfruimte beschikbaar op het volume dat wp-content/uploads/ host; reken op 5–25 MB per voertuig voor media.
[ ] De webserver draait op Nginx, Apache of een andere door WordPress ondersteunde server met URL-rewriting ingeschakeld.

2. WordPress

[ ] WordPress 6.2 of nieuwer is geïnstalleerd.
[ ] HTTPS is actief op de openbare site met een geldig certificaat.
[ ] Permalinks zijn ingesteld op iets anders dan "Eenvoudig" (vereist voor het cron REST-endpoint en mooie archief-URL's).
[ ] Er is een beheerdersaccount beschikbaar voor installatie en configuratie.
[ ] Er is geen conflicterende AutoScout24- / voertuigimport-plugin actief.
[ ] Er bestaat een staging-omgeving met dezelfde PHP- en MySQL-versies als productie.

3. Database

[ ] MySQL 5.7+ of MariaDB 10.3+ (overeenkomend met de eigen minima van WordPress) is in gebruik, met utf8mb4 als de standaard tekenset.
[ ] De WordPress-databasegebruiker heeft de rechten CREATE, ALTER, INDEX, DROP, INSERT, UPDATE, DELETE en SELECT zodat de activering dbDelta() kan uitvoeren voor de aangepaste tabellen van de plugin.
[ ] Dagelijkse database-back-ups zijn geconfigureerd en het herstel ervan is ten minste eenmaal getest.

4. Netwerk, API en SSL

[ ] Uitgaand HTTPS (TCP/443) is toegestaan vanaf de webserver naar de geconfigureerde AutoScout24 API-host (bijv. api.autoscout24.com, api.autoscout24.ch, …) en naar de AutoScout24 afbeeldingen-CDN-hosts.
[ ] DNS-resolutie vanaf de webserver zelf werkt voor de AutoScout24-hostnamen.
[ ] De CA-bundel van het systeem is up-to-date; eventuele uitgaande TLS-interceptie installeert de eigen root-CA in de trust store van het systeem.
[ ] Als een uitgaande HTTP-proxy vereist is, zijn de WP_PROXY_*-constanten ingesteld in wp-config.php.
[ ] Als AI-generatie wordt gebruikt, is uitgaand HTTPS naar generativelanguage.googleapis.com toegestaan. AI-functies maken gebruik van de beheerde Google Gemini-configuratie in ADP Car Market Hub — er hoeft geen provider, model of API-sleutel te worden ingevoerd in de WordPress-backend; de klantspecifieke AI-inrichting wordt na installatie door AD Promotion voltooid.

5. Licentie en AutoScout24-account

[ ] De ADP Car Market Hub licentiesleutel van AD Promotion is bij de hand. De licentie is vereist om de premium-onderdelen van de plugin na activering te ontgrendelen; zonder deze sleutel toont elk beheerders-tabblad behalve Settings een "License required"-scherm.
[ ] Een actief AutoScout24-partneraccount met API-toegang is aanwezig.
[ ] Client ID en Client Secret zijn uitgegeven en veilig opgeslagen (wachtwoordbeheerder of kluis).
[ ] Een of meer Seller IDs zijn bekend en bevestigd als behorend tot de dealer(s) die worden geonboard.
[ ] De juiste API Base URL voor de markt van de dealer is bekend (bijv. https://api.autoscout24.ch voor Zwitserland).
[ ] Uitgaande IP-adressen van de productieserver zijn gedeeld met AutoScout24 als het account IP-whitelisting vereist.

6. Cron en achtergrondverwerking

[ ] Er is een cron-strategie gekozen: WP-Cron (alleen acceptabel voor kleine sites of sites met veel verkeer) of server-cron (aanbevolen voor productie).
[ ] Als server-cron is gekozen, is define( 'DISABLE_WP_CRON', true ); toegevoegd aan wp-config.php.
[ ] Als server-cron is gekozen, zijn er twee cron-taken gepland: één die het REST-endpoint van de plugin aanroept met de geheime token (elke 15 minuten is een goede standaard), en één die wp-cron.php uitvoert (elke 5 minuten) om de afbeeldingenwachtrij, het opschonen van statistieken en andere terugkerende taken actief te houden.
[ ] De geheime cron-token wordt samen met de inloggegevens opgeslagen en geroteerd wanneer medewerkers met toegang het project verlaten.
[ ] Er zijn afzonderlijke cron-tokens gepland voor staging en productie, zodat een staging-trigger geen productie-import kan starten.

7. E-mail

[ ] Er is een werkend pad voor transactionele e-mail geconfigureerd (hosting-MTA, SMTP-plugin die verwijst naar een e-mailprovider, of een corporate relay).
[ ] SPF-, DKIM- en DMARC-uitlijning zijn geverifieerd voor het verzendende domein.
[ ] Test-e-mails (leadmelding, aanmelding voor zoekopdrachten, WordPress wachtwoord herstellen) zijn verzonden en ontvangen.

8. Back-ups, monitoring en beheer

[ ] Dagelijkse externe back-ups omvatten de volledige WordPress-database (inclusief de aangepaste tabellen van de plugin met het voorvoegsel {wp_prefix}as24_) en de volledige map wp-content/uploads/, met een bewaartermijn van ten minste 7 dagen (30+ dagen aanbevolen).
[ ] Het herstellen van back-ups is ten minste eenmaal geoefend.
[ ] Uptime-monitoring is ingesteld op de openbare archief-URL.
[ ] Uptime- of succesmonitoring is ingesteld op het cron-trigger-endpoint wanneer server-cron wordt gebruikt.
[ ] Schijfruimte-waarschuwingen zijn geconfigureerd voor het volume dat wp-content/uploads/ host.
[ ] Er is een stand-by contactpersoon en een gedocumenteerd escalatiepad voor incidenten in productie.

9. Pre-launch validatie in WordPress

[ ] Plugin geïnstalleerd en geactiveerd op staging.
[ ] Licentie geactiveerd via Settings → License Activation zodat de andere beheerders-tabbladen zijn ontgrendeld (geen "License required"-scherm).
[ ] Instellingen voltooid: API Base URL, Token URL (indien nodig), Client ID, Client Secret, Seller ID('s).
[ ] Tools tab → Test Connection geeft een succesvolle melding.
[ ] System & Help / Health tab toont groene indicatoren voor PHP, database, schijfruimte, cron, API en (indien geconfigureerd) AI Assistant.
[ ] Een kleine import via de Batch-Wizard heeft de verwachte voertuigberichten, taxonomieën en media gegenereerd.
[ ] Pagina's voor individuele voertuigen en het archief worden correct weergegeven met het actieve thema.
[ ] Een test-lead en een test-aanmelding voor een zoekopdracht zijn ingediend en de bijbehorende e-mails zijn ontvangen.
[ ] Cron-modus, schema, limiet voor voertuigen per run en de afbeeldingenwachtrij zijn definitief vastgelegd in het tabblad Import & Limits.
[ ] Er is een volledige import uitgevoerd via de trigger die gelijk is aan productie (server-cron of gekozen alternatief).
[ ] Dezelfde checklist is opnieuw gevalideerd op productie na de livegang.

Goedkeuring

Voordat u productie-imports inschakelt, dient u te bevestigen dat elk item hierboven is gecontroleerd of formeel is geaccepteerd als een bekende beperking, en legt u het volgende vast:

Wie de controles heeft uitgevoerd en op welke datum.
De geïnstalleerde plugin-versie (zie de WordPress Plugins-pagina).
De gebruikte PHP-, WordPress- en databaseversies.
De geconfigureerde cron-modus en het schema.
De eigenaar van de AutoScout24-inloggegevens en de geheime cron-token.

Een kort tekstbestand of een wiki-pagina met de bovenstaande gegevens is voldoende en vereenvoudigt latere ondersteuningsverzoeken aanzienlijk.