Documentatie · Aan de slag

Go-live checklist

Dit document is de controlelijst voor productiegereedheid voor ADP Car Market Hub. Het verzamelt elk overkoepelend punt dat moet worden bevestigd voordat automatische imports worden ingeschakeld op de live WordPress-site van een klant, zodat de lancering voorspelbaar en omkeerbaar is.

Het is een aanvulling op en geen vervanging van Eerste installatie: Eerste installatie beschrijft stap voor stap hoe u de plugin configureert; dit document beschrijft hoe u verifieert of de configuratie veilig is om in live-bedrijf te nemen.

Wanneer u dit document moet gebruiken

Gebruik dit document als u:

Een bureau of implementatiepartner bent die op het punt staat een nieuwe ADP Car Market Hub-implementatie voor een klant op te leveren.
Een WordPress-beheerder bent die een gevalideerde staging-configuratie overzet naar een productiesite.
Een hostingteam bent dat verantwoordelijk is voor het bevestigen dat de productieomgeving de juiste omvang en configuratie heeft voor geplande imports.
Een operationeel beheerder bent die een gecontroleerde herlancering uitvoert na een servermigratie, domeinwijziging, certificaatverlenging of grote plugin-update.

De doelgroep is technisch: een WordPress-beheerder met volledige toegang tot de backoffice, die (indien van toepassing) samenwerkt met de hostingprovider en met degene die de eigenaar is van de AutoScout24 API-toegang voor de dealer.

Overzicht

Een livegang voor productie van ADP Car Market Hub is geen op zichzelf staande actie — het inschakelen van automatische imports is de laatste stap in een keten die afhankelijk is van:

Gereedheid van de hosting- en PHP-omgeving.
Correcte API-inloggegevens die eigendom zijn van de dealer.
Een succesvolle, herhaalbare Verbindungstest en ten minste één succesvolle testimport.
Een frontend die is gecontroleerd aan de hand van echte, geïmporteerde voertuiggegevens.
Juridische, privacy- en toestemmingsinstellingen die overeenkomen met het gepubliceerde beleid van de dealer.
Een gedocumenteerd terugdraaipad (rollback) als er na de lancering iets mislukt.

De onderstaande controlelijst is gegroepeerd per onderwerp. Elk item moet worden afgevinkt of expliciet worden geaccepteerd met een gedocumenteerde reden voordat de site wordt opengesteld voor echt verkeer met live imports.

Vereisten voordat u de controlelijst doorloopt

Bevestig dat aan al het volgende is voldaan voordat u deze controlelijst opent:

De plugin is geïnstalleerd en geactiveerd op de productiesite (zie Installation Guide).
Er is een geconfigureerde staging-omgeving aanwezig en dezelfde configuratie is gerepliceerd op productie (zie Staging to Live Migration).
De API-inloggegevens voor het account van de dealer zijn beschikbaar via een beveiligd kanaal (zie API-inloggegevens instellen, AutoScout24 API Setup, External API Credentials).
De site heeft een actuele, herstelbare back-up die de database en wp-content/ bevat.
Belanghebbenden (dealer, bureau, hosting) zijn een tijdvenster voor de livegang overeengekomen waarin de eerste imports kunnen worden gemonitord.

Step by step instructions

Work through the sections in order. Do not enable automatic scheduling until every applicable item is confirmed.

1. Environment and infrastructure

[ ] WordPress meets the plugin's minimum version (Requires at least: 6.2) and PHP meets the minimum (Requires PHP: 8.1). See Technical System Requirements.
[ ] Required PHP extensions are present: openssl, curl, mbstring, json, and one of gd or imagick. See PHP and Database Requirements.
[ ] Outbound HTTPS to the configured AutoScout24 API host is allowed by the hosting firewall and any WAF in front of the site. See API, Network and SSL Requirements.
[ ] The server's CA bundle trusts the API host's certificate chain (no SSL/TLS validation errors during the Connection Test).
[ ] The wp-content/uploads/ directory is writable by the web-server user, and wp-content/uploads/as24ci-logs/ is created or createable for plugin logging.
[ ] Sufficient disk space is available for the projected media library (imported vehicle images, including any WebP variants if conversion is enabled).
[ ] Server resources (memory, max execution time, database) are sized for the expected catalogue. See Hosting Requirements.
[ ] All entries on the Pre-Installation Checklist are confirmed.
[ ] Car Market Hub → System & Help shows no red badges.

2. Plugin configuration

[ ] The license has been activated on Car Market Hub → Settings (License Activation card). The plugin's admin tabs no longer show the "License required" screen, confirming the premium areas are unlocked. See First Setup.
[ ] The plugin's main settings on Car Market Hub → Settings have been saved and reflect the production environment, not staging.
[ ] API Base URL, Seller ID (one or more), Client ID and Client Secret are populated on Settings.
[ ] Default currency matches the dealer's pricing currency.
[ ] Image options (whether to import images, maximum images per vehicle, optional WebP conversion and quality) are set deliberately and not left at unverified defaults.
[ ] Default post status and default post author for newly imported vehicles are appropriate for production.
[ ] The Default pages option is either enabled (so that the Cars, Compare Cars and Favorites pages are created) or explicitly handled by the dealership's own pages using the documented shortcodes.
[ ] Filters, mappings, design and styles, and any layout customisations have been reviewed on real, imported vehicle data — not on placeholder content.

3. API connection

[ ] The API Connection Test on Car Market Hub → Tools completes successfully on the production site, against the production API credentials. See Verbindungstest.
[ ] If multiple Seller IDs are configured, a Dry Run has been executed from Tools and returns data for every configured Seller ID.
[ ] No authentication, authorisation or SSL errors appear in Car Market Hub → Logs for the most recent Connection Test and Dry Run.
[ ] Credentials in production are not the same throwaway values used during early staging tests; rotated production credentials, where applicable, have been re-tested.

4. Test imports and data quality

[ ] At least one manual import of a single vehicle through Car Market Hub → Car Importer has succeeded, including image attachments.
[ ] A full manual import via the Batch-Wizard on Car Market Hub → Import & Limits has completed without errors. The Batch-Wizard supports pause, resume and abort if needed.
[ ] The number of imported vehicles matches the expectation for the configured Seller IDs (verify against the dealer's AutoScout24 inventory).
[ ] A representative sample of imported vehicles has been reviewed for: title, price, currency, mileage, equipment list, image count and image order.
[ ] Full Sync is only enabled after the test import confirms that all expected vehicles arrive correctly. Full Sync permanently deletes local car posts and their images for any listing no longer returned by the API.

5. Scheduling and background processing

[ ] The desired automatic import interval (hourly, every 6 hours, twice daily, daily or custom) has been chosen and reflects the dealer's data refresh expectations.
[ ] If WP-Cron is unreliable on the host (for example because page visits are too sparse or the host throttles internal cron), a real server cron job is configured against the plugin's token-secured REST endpoint. See Server Cron Setup and Cron and Background Processing.
[ ] The image queue is enabled to keep cron runs within PHP timeouts on large catalogues. The queue status on System & Help shows healthy progress after the test import.
[ ] The cron robustness settings (maximum vehicles per cron run) are sized for the catalogue and the host's PHP execution limits.
[ ] Token cache behaviour has been verified: a fresh test after credential rotation succeeds (clearing the token cache from Tools if needed).

6. Frontend and customer experience

[ ] The Cars archive page renders correctly with real vehicles, including filters, pagination, sorting and image thumbnails.
[ ] At least one single vehicle page has been reviewed end to end: gallery, vehicle details table, equipment list, price formatting, contact form (with the consent checkbox), and any optional features (financing calculator, Test Drive form, social sharing) that are enabled.
[ ] A test contact form submission appears under Car Market Hub → Leads and triggers the configured recipient email.
[ ] If Search Alerts are enabled, a test subscription has been completed including the Double-Opt-In confirmation email. See Search Alerts Double Opt-In.
[ ] If the AI Assistant is enabled, AI-generated outputs on at least one vehicle have been reviewed and are acceptable for publication.
[ ] Translations / language strings on the frontend reflect the site's language; missing strings have been addressed via the standard WordPress translation workflow. See Translation and PoEdit Guide.

[ ] The site has a published privacy policy that covers the data the plugin collects (contact form data, optional analytics events, optional search-alert subscriptions). See GDPR / DSGVO Notes and Data Storage Overview.
[ ] The contact form's consent checkbox label, required state and visible fields under Car Market Hub → Leads match the dealer's privacy policy. See Lead Data and Consent.
[ ] If Test Drive booking is enabled, the available weekdays, daily time window, slot duration and blackout dates reflect the dealership's actual availability.
[ ] The dealership has accepted that imported lead and search-alert data will be stored in the WordPress database and is responsible for any retention or export obligations under applicable law.

8. Performance, caching and SEO

[ ] Any page or object cache (server-side cache, CDN, caching plugin) has been configured so that vehicle archive and single-vehicle pages display fresh data after each import, and so that admin requests are not served from cache.
[ ] If a CDN serves images from wp-content/uploads/, image purges or short cache lifetimes are in place so that newly imported images become visible promptly.
[ ] The site is reachable on the final production domain over HTTPS, and the WordPress Site Address / WordPress Address options point to that domain.
[ ] The site is not set to "Discourage search engines from indexing this site" (unless that is the dealership's explicit intent).
[ ] An XML sitemap exists (provided by WordPress core or by an SEO plugin) and the new vehicle URLs follow the dealership's canonical structure.
[ ] No staging URLs, test email addresses or test consent text remain in the production configuration.

9. Operations, monitoring and support

[ ] Car Market Hub → Logs has been opened and the rotation behaviour is understood. The log directory wp-content/uploads/as24ci-logs/ is writable. See Logging and Monitoring.
[ ] A schedule for routine checks has been agreed with the customer: daily lead and import review (Daily Operation), Weekly Maintenance and Monthly Maintenance.
[ ] Import Monitoring and Image Queue Maintenance are understood by whoever will operate the site.
[ ] A backup and restore procedure is documented and has been tested at least once. See Backup and Restore.
[ ] The plugin's update channel is agreed (admin upload of a new ZIP, or SFTP replacement of the plugin folder) and matches the Update Process.
[ ] A documented rollback plan exists: how to disable scheduling, how to deactivate the plugin without losing data, and how to restore from backup if needed.
[ ] Day-to-day operation has been delegated to the appropriate users via the plugin's role and capability. See Access Control and Capabilities.
[ ] Contact paths for support are documented on the customer side: who handles WordPress issues, who handles hosting, who owns the AutoScout24 API account, and how to escalate to AD Promotion if needed.
[ ] The information needed to open a support ticket is known in advance. See Support Information Checklist.

10. Final go-live actions

Only after every applicable item above is ticked:

Re-run the Connection Test on the production site as a final sanity check.
Enable automatic imports on Car Market Hub → Import & Limits with the chosen interval.
Trigger one import manually (or wait for the first scheduled run) and watch Logs until it completes.
Re-check the frontend on the production domain, including a real contact-form submission and, if applicable, a real Search Alert subscription.
Hand over to the agreed monitoring routine and inform the customer that imports are now live.

Configuration reference

This document does not introduce new settings; it only references the configuration documented elsewhere. The most relevant pages are:

API connection fields: see API-inloggegevens instellen.
Import scheduling and limits: see Eerste installatie (Step 5) and Cron and Background Processing.
Lead and consent fields: see Lead Data and Consent.
Server cron and external triggers: see Server Cron Setup.

Operationele opmerkingen

Omkeerbaarheid. Het uitschakelen van het automatische schema op Import & Limits stopt nieuwe imports zonder reeds geïmporteerde voertuigen te verwijderen. Het deactiveren van de plugin schakelt de functies ervan uit, maar behoudt geïmporteerde voertuigen, opties, leads en analytische gegevens in de database. Gegevens worden alleen bij het verwijderen van de plugin gewist als de bijbehorende opschooninstelling is ingeschakeld. Zie Uninstall and Data Cleanup.
Full Sync bij lancering. Het is over het algemeen veiliger om te lanceren met Full Sync uitgeschakeld, een volledige importcyclus te observeren en Full Sync pas in te schakelen zodra de geïmporteerde voorraad consistent compleet is. Het voortijdig inschakelen van Full Sync kan permanent voertuigen verwijderen die simpelweg ontbraken in een tijdelijke API-respons. Controleer dit gedrag in de huidige plugin-versie voordat u live gaat als u twijfelt.
Domein- en URL-wijzigingen. Als de site wordt gelanceerd op een nieuw domein (bijvoorbeeld bij een verhuizing van staging.example.com naar www.example.com), zorg er dan voor dat de WordPress-URL's, eventuele caching-lagen en externe diensten die naar de site linken, zijn afgestemd voordat u imports inschakelt. Zie Staging to Live Migration.
Stille lanceringen. Overweeg voor gevoelige lanceringen om automatische imports buiten kantooruren in te schakelen en de eerste cron-cyclus te volgen via de weergave Logs voordat klanten de nieuwe pagina's kunnen bereiken.
Overdracht van documentatie. Voorzie de klant van de relevante pagina's uit het User Handbook en de sectie Operations and Maintenance, zodat zij de dagelijkse workflow begrijpen waarvoor zij de verantwoordelijkheid overnemen.

Probleemoplossing

Symptoom bij livegang	Waarschijnlijke oorzaak	Wat te controleren
Verbindungstest mislukt op productie, maar slaagde op staging.	Productie-inloggegevens verschillen, het productienetwerk is restrictiever, of de productieserver heeft een andere CA-bundel.	Voer de inloggegevens opnieuw in, controleer uitgaande HTTPS naar de API-host bij de hostingprovider en controleer SSL-fouten. Zie Verbindungstest en API Connection Errors.
Geplande imports starten niet na het inschakelen van het schema.	WP-Cron is uitgeschakeld of beperkt op de host.	Configureer een server-cronjob voor het REST-eindpunt van de plugin. Zie Server Cron Setup en Cron Errors.
Eerste productie-import verwijdert voertuigen die nog zouden moeten bestaan.	Full Sync was ingeschakeld voordat de geïmporteerde voorraad als compleet was bevestigd.	Schakel Full Sync uit, herstel de getroffen voertuigen vanuit een back-up en schakel Full Sync pas weer in nadat u een volledige, complete importcyclus heeft geobserveerd.
Voertuigpagina's worden geladen zonder afbeeldingen, of afbeeldingen verschijnen geleidelijk.	De afbeeldingswachtrij wordt op de achtergrond verwerkt (verwacht) of PHP-timeouts onderbreken downloads.	Bekijk de status van de afbeeldingswachtrij op System & Help; activeer Run image queue now. Zie Image Import Errors en Image Queue Maintenance.
Lead-e-mails worden niet afgeleverd.	Site kan geen e-mail verzenden, het ontvangersadres is onjuist, of de host blokkeert uitgaande SMTP.	Controleer het e-mailadres van de ontvanger onder Leads en de configuratie voor uitgaande e-mail van de site. Zie Email and Lead Errors.
Gecachte pagina's blijven de oude voertuigvoorraad tonen.	Paginacache of CDN serveert verouderde inhoud.	Configureer cache-invalidatie of kortere TTL's voor de getroffen URL's.
Bezoekers komen na de lancering op staging-URL's terecht.	Verouderde links, onjuiste WordPress site-URL, of DNS is nog niet overal bijgewerkt.	Bevestig de opties voor WordPress Site Address en WordPress Address, en controleer de DNS-propagatie voor het productiedomein.

Voor bredere diagnostiek op basis van symptomen, zie de sectie Troubleshooting.