Updateproces

Dit document beschrijft het aanbevolen proces voor het updaten van de ADP Car Market Hub-plugin op een live WordPress-site. Het volgen van een gestructureerd updateproces vermindert het risico op gegevensverlies, configuratiewijzigingen of frontend-regressies.

Wanneer u dit document moet gebruiken

Lees dit document telkens wanneer er een nieuwe versie van de plugin beschikbaar is en u deze op een live site moet toepassen. Lees het ook vóór een geplande WordPress-core-update die de compatibiliteit van de plugin kan beïnvloeden.

Overzicht

Plugin-updates kunnen bugfixes, beveiligingspatches, nieuwe functies of wijzigingen in het databaseschema bevatten. De plugin verwerkt migraties van het databaseschema automatisch bij activering en op plugins_loaded, maar een test op een staging-omgeving vóór de productie-implementatie wordt ten zeerste aanbevolen bij belangrijke versiewijzigingen.

Het algemene proces is: bekijk de changelog → maak een back-up → test op staging → pas toe op productie → controleer de werking.

Systeemvereisten

• Beheerderstoegang tot de WordPress-beheeromgeving op zowel de staging-omgeving als de productie-omgeving.
• Een recente volledige back-up van de productiedatabase en de uploads-map (zie Back-up en herstel).
• Een staging-omgeving die een exacte kopie is van de productiesite. Als er geen staging-omgeving bestaat, maak dan een volledige back-up voordat u updatet en wees voorbereid op een rollback.
• De manage_as24_imports-functionaliteit op het account dat de update uitvoert.

Stapsgewijze instructies

Stap 1: Bekijk de release-notes

1. Lees de release-notes voor de nieuwe versie (zie Release Notes).
2. Identificeer eventuele ingrijpende wijzigingen (breaking changes), databasemigraties of configuratiestappen die in de release-notes worden vermeld.
3. Let op eventuele nieuwe vereisten voor de PHP-versie of WordPress-versie. De plugin vereist PHP 8.1 of hoger en WordPress 6.2 of hoger vanaf versie 1.0.0. Controleer de header van het pluginbestand of readme.txt voor de huidige verklaarde vereisten.

Stap 2: Maak een volledige back-up

1. Maak een back-up van de productiedatabase en de wp-content/uploads/-map voordat er wijzigingen worden aangebracht.
2. Noteer de huidige plugin-versie, zodat u hiernaar kunt terugkeren als dat nodig is.
3. Sla de back-up op een locatie op die ook toegankelijk is als de WordPress-beheeromgeving niet beschikbaar is (bijvoorbeeld een back-up op hostingniveau of een lokale download).

Stap 3: Test de update op staging

1. Pas de nieuwe plugin-versie toe op de staging-site.
2. Als de staging-site niet de huidige productiestatus weerspiegelt, herstel dan een recente productie-back-up naar staging voordat u de update toepast.
3. Controleer na het updaten op staging het volgende: - De beheerpagina's van de plugin laden zonder PHP-fouten of witte schermen. - Het tabblad Health toont geen nieuwe kritieke problemen. - De API-verbindingsstatus is Connected in het tabblad System & Help. - Een handmatige import wordt succesvol voltooid (gebruik de knop Trigger import now in Automation). - Geïmporteerde voertuigadvertenties worden correct weergegeven op het frontend-archief en de pagina's van individuele voertuigen. - Het lead-contactformulier wordt succesvol verzonden en levert een notificatiemail op. - Analytics-trackinggebeurtenissen worden geregistreerd (als analytics is ingeschakeld).
4. Als er problemen worden gevonden op staging, ga dan niet door naar productie. Meld het probleem en wacht op een oplossing of advies.

Stap 4: Pas de update toe op productie

Optie A: Updaten via WordPress-beheeromgeving

1. Log in op de productie-WordPress-beheeromgeving.
2. Navigeer naar Dashboard → Updates (of Plugins → Geïnstalleerde plugins).
3. Zoek naar ADP Car Market Hub in de updatelijst en klik op Updaten.
4. WordPress zal de plugin deactiveren, de pluginbestanden vervangen en deze opnieuw activeren. De activeringshook van de plugin voert schema- en optiemigraties automatisch uit.

Optie B: Handmatige bestandsupdate

1. Zet de site in onderhoudsmodus als uw workflow dit vereist.
2. Download het nieuwe plugin-versiepakket.
3. Vervang via SFTP of uw hostingbestandsbeheerder de inhoud van wp-content/plugins/adp-car-market-hub/ door de bestanden van de nieuwe versie.
4. De plugins_loaded-hook van de plugin zal schemamigraties activeren zodra het volgende WordPress-verzoek wordt verwerkt.

Stap 5: Controleer de productie-update

1. Open ADP Car Market Hub → System & Help en bevestig dat de API-verbindingsstatus Connected is.
2. Controleer het tabblad Dashboard en bevestig dat de voertuigaantallen en informatie over de laatste uitvoering aanwezig zijn.
3. Open het tabblad Logs en bevestig dat er geen nieuwe fouten zijn die verband houden met de update.
4. Navigeer naar de voertuigarchiefpagina op de frontend en bevestig dat de advertenties correct laden.
5. Als het versienummer van de plugin ergens in de beheeromgeving wordt weergegeven (bijvoorbeeld op het tabblad Health of Support), bevestig dan dat dit de nieuwe versie toont.
6. Start een handmatige import vanaf het tabblad Import & Limits en bevestig dat deze zonder fouten wordt voltooid.

Stap 6: Monitor gedurende 24–48 uur

1. Voer na de productie-update de standaard dagelijkse controles uit (zie Dagelijkse werkstromen) gedurende de volgende één tot twee dagen.
2. Let op nieuwe fouten in het tabblad Logs.
3. Bevestig dat geplande imports op tijd blijven draaien.

Configuratiereferentie

Operationele opmerkingen

• De plugin gebruikt plugins_loaded- en admin_init-hooks om databaseschemamigraties te controleren en toe te passen. Schema-upgrades worden automatisch uitgevoerd en vereisen geen handmatige SQL-uitvoering.
• De plugin registreert een aangepaste functionaliteit (manage_as24_imports) tijdens de activering. Als deze functionaliteit ontbreekt na een update, deactiveer de plugin dan en activeer deze opnieuw om de registratie van de functionaliteit te activeren.
• De plugin slaat een databaseversie op in de WordPress-optietabel (as24ci_db_version). De plugin leest deze waarde en past eventuele openstaande migraties toe wanneer er een versieverschil wordt gedetecteerd.
• Aangepaste template-overrides die buiten de plugin-map zijn opgeslagen (bijvoorbeeld in een child-theme) worden niet beïnvloed door plugin-updates. Als de update echter de template-structuur wijzigt, moeten uw aangepaste templates mogelijk worden bijgewerkt om overeen te komen.
• De afbeeldingswachtrij, import-lock transients en het gecachte toegangstoken worden niet beïnvloed door plugin-updates. Lopende importtaken moeten normaal worden voltooid.

Rollback uitvoeren

Als de productie-update problemen veroorzaakt en een rollback vereist is:

1. Herstel de database-back-up die in Stap 2 is gemaakt.
2. Herstel de vorige pluginbestanden vanuit de back-up of door de vorige versie te downloaden.
3. De vorige plugin-versie zal de herstelde databasestatus detecteren en de gegevens zullen consistent zijn.
4. Onderzoek de oorzaak van de fout voordat u de update opnieuw probeert.

Probleemoplossing

Gerelateerde documenten

• Back-up en herstel
• Maandelijks onderhoud
• Logboekregistratie en monitoring