Natuurlijk, ik help je graag bij het plannen en uitvoeren van je migratie van Statamic 2.11.2 naar Statamic 3. Hier is een overzicht van de stappen en overwegingen: 1. Voorbereiding en Analyse - Backup: Maak volledige backups van je websitebestanden en database. - Documentatie: Noteer je huidige structuur, collecties, velden, koppelingen en gebruikte add-ons. - Compatibiliteit: Controleer of je add-ons compatibel zijn met Statamic 3 of zoek naar alternatieven. 2. Planning - Tijdlijn: Bepaal een realistische migratiedatum, bij voorkeur buiten de drukke periodes. - Testomgeving: Zet een staging omgeving op voor testen en ontwikkeling. - Dataformaten: Inventariseer alle dataformaten en koppelingen tussen collecties. 3. Voorbereiding op Statamic 3 - Nieuwe installatie: Installeer Statamic 3 op je staging omgeving volgens de officiële documentatie. - Schemalogica: Maak nieuwe collecties, velden, taxonomieën en routes aan volgens de nieuwe structuur. - Add-ons: Installeer en configureer beschikbare add-ons die je nodig hebt. 4. Data Migratie - Data exporteren: Exporteer data uit je bestaande collecties, inclusief relaties en koppelingen. - Data transformeren: Zet je data om naar het nieuwe format, gebruikmakend van scripts of tools (bijvoorbeeld PHP of Laravel Migrations). - Data importeren: Importeer de getransformeerde data in je Statamic 3 setup. - Koppelingen: Zorg dat relaties tussen collecties correct worden hersteld. 5. Aanpassen van Functionaliteiten - Templates: Update je Blade-templates en front-end code volgens de nieuwe structuur. - Custom code: Pas eventuele aangepaste scripts of functies aan. - Payments: Configureer je betalingsgateway integraties opnieuw, afhankelijk van de gebruikte add-ons. 6. Testen - Functionaliteit: Test alle belangrijke functionaliteiten, inclusief collecties, koppelingen en betaalprocessen. - Data-integriteit: Controleer of alle data correct is overgezet. - Performance: Test de snelheid en optimaliseer waar nodig. 7. Uitrol - Live zetten: Plan de migratie naar productie, bij voorkeur buiten kantooruren. - Monitoring: Houd de website nauwlettend in de gaten na livegang voor eventuele issues. 8. Na de Migratie - Backups: Maak direct een nieuwe backup van de gemigreerde site. - Feedback: Verzamel gebruikersfeedback en los eventuele problemen op. Specifieke uitdagingen en tips: - Data in verschillende formaten: Schrijf maatwerk scripts om data te converteren, bijvoorbeeld van CSV, JSON of XML naar het nieuwe format. - Koppelingen tussen collecties: Gebruik unieke identifiers en zorg dat je migraties scripts deze relaties correct herstellen. - Add-ons: Als je geen directe vervangers hebt, overweeg om functionaliteit zelf te bouwen of te zoeken naar geschikte alternatieven. Met deze stappen kun je gestructureerd en succesvol migreren naar Statamic 3. Mocht je specifieke vragen hebben over scripts, dataformaten of configuraties, help ik je daar graag verder mee.

Zeker, ik help je graag bij het plannen en uitvoeren van je migratie van Statamic 2.11.2 naar Statamic 3. Laten we dit gestructureerd aanpakken. ### Overzicht van je huidige situatie: * **Huidige versie:** Statamic 2.11.2 * **Structuur:** Je gebruikt drie hoofdcollecties: * `producten` * `blog` * `klantenreviews` * **Add-ons:** Een (niet-gespecificeerde) add-on voor een betalingsgateway. * **Uitdagingen:** Data in verschillende formaten en koppelingen (relaties) tussen deze collecties. --- ### Stappenplan voor de Migratie #### Fase 1: Voorbereiding en Testomgeving (Cruciaal!) 1. **Maak een volledige backup:** Zorg ervoor dat je een complete backup hebt van je huidige website, inclusief de database, alle bestanden in de `site/` en `public/assets/` mappen, en je `.env` bestand. 2. **Creëer een testomgeving:** Stel een lokale of gescheiden ontwikkelomgeving in (bijv. met Laravel Valet, Laragon, Docker, of een apart subdomein). **Voer de migratie NOOIT eerst op je live site uit.** 3. **Clone je project:** Zet een kopie van je live site in deze testomgeving. 4. **Controleer compatibiliteit van add-ons:** Je betalingsgateway-add-on is de grootste onbekende. Ga naar de documentatie of de Statamic Marketplace om te zien of er een Statamic 3-compatibele versie beschikbaar is. Als deze niet bestaat, moet je op zoek naar een alternatief of zelf de functionaliteit nabouwen, wat de migratie aanzienlijk complexer maakt. #### Fase 2: Uitvoering van de Migratie Voer deze stappen uit in je testomgeving. 1. **Update Composer-dependencies:** ```bash composer require statamic/cms:^3.0 --update-with-dependencies ``` Dit commando zal Statamic en alle andere officiële packages bijwerken naar hun v3-versies. 2. **Voer de migratie-commando's uit:** Statamic 3 heeft een aantal artisan-commando's om oude configuraties en inhoud automatisch bij te werken. ```bash php please migrate:statamic ``` Dit commando is de hoeksteen van de migratie. Het zal: * Je `content/`-map migreren van YAML naar Markdown (.md)-bestanden. * Je oude `settings/`- en `variables/`-YAML-bestanden omzetten naar PHP-configuratiebestanden in `config/statamic/`. * De structuur van `users.yaml` aanpassen. 3. **Handmatige nazorg en controle:** De automatische migratie is goed, maar niet perfect. Hier moet je extra aandacht aan besteden: * **Koppelingen tussen collecties (Relations):** Dit is je grootste uitdaging. In Statamic 2 werden relaties vaak opgeslagen als ID's of slugs. In Statamic 3 gebruikt men officieel het `relation`-veldtype. * Controleer hoe je koppelingen momenteel zijn opgeslagen (bijv. in een `product: product-slug` veld). * Je zult likely de veldconfiguratie in je blauwdrukken (blueprints) moeten aanpassen om het `relation`-veldtype te gebruiken en de juiste collectie te targeten (bijv. `collection: producten`). * De bestaande data zou compatibel moeten zijn, maar test dit grondig! Bekijk of een blogpost nog correct linkt naar een product en andersom. * **Dataformaten:** De migratie naar Markdown betekent dat alle inhoud nu in een `content: ...` veld staat. Controleer of complexe YAML-structuren (bijv. replicator- of bard-velden) correct zijn overgezet. Soms kan handmatig ingrijpen nodig zijn. * **Blauwdrukken (Blueprints):** Je blauwdrukken zijn gemigreerd van YAML naar PHP. Controleer ze in het Control Panel onder `Settings -> Blueprints`. Let vooral op de velden die relaties beheren. * **Views & Templates:** De meeste Blade-templates zullen gewoon werken. Let op: * Oude tag-syntax zoals `{{ get_content }}` is vervangen door `{{ statamic:content }}`. * De `{{ noparse }}` tag is vervangen door `{{ verbatim }}`. * Controleer of alle variabelen en antlers-logica correct werken. 4. **Add-on migratie:** Installeer en configureer de v3-versie van je betalingsgateway-add-on. Test de betalingsstroom end-to-end. #### Fase 3: Testen en Livegang 1. **Uitgebreid testen:** Test alles! * Navigeer door alle pagina's. * Controleer alle relaties (haal producten op bij een review, laat gerelateerde blogposts zien, etc.). * Test formulierinzendingen. * Voer een testbetaling uit. * Controleer of alle afbeeldingen en assets correct worden geladen. 2. **Performance check:** Laad de site en het Control Panel. Soms kan een cache-leegmaking helpen (`php artisan cache:clear`, `php artisan statamic:stache:clear`, `php artisan statamic:static:clear`). 3. **Live migratie:** Als alles in de testomgeving perfect werkt, plan je een onderhoudsvenster voor de live site. * Zet de live site in onderhoudsmodus. * Maak een nieuwe backup. * Herhaal de migratiestappen (composer update, `migrate:statamic`, handmatige controles) op de live server. * Test snel de kritieke functionaliteit. * Haal de site uit de onderhoudsmodus. ### Specifieke aandachtspunten voor jouw situatie: * **`klantenreviews` collectie:** Deze zal almost zeker een relatie hebben naar de `producten` collectie. Wees hier extra alert op tijdens het controleren van de blueprint en de weergave in de templates. * **Betalingsgateway:** Dit is je grootste risico. Zonder een v3-compatibele add-on komt de migratie tot stilstand. Onderzoek dit direct. ### Handige bronnen: * **Officiële migratiegids:** [Statamic 2 to 3 Migration](https://statamic.dev/upgrade#2-to-3) - Verplichte lectuur! * **Relation Field:** [Relation Field Documentation](https://statamic.dev/fieldtypes/relation) - Begrijp hoe relaties nu werken. Succes met de migratie! Begin in de testomgeving en wees geduldig met het controleren van de relaties tussen je inhoud.