Naar inhoud
Frank Spin
Alle artikelen

Een WordPress-site naar Astro verhuizen, stap voor stap

Het meeste werk bij een migratie zit niet in het nieuwe ontwerp. Het zit erin dat elke pagina, link en elk formulier meekomt. Dit is de volgorde waarin ik het doe.

Verhuis je een WordPress-site naar Astro, dan krijgt hij een nieuw fundament. Het ontwerp mag hetzelfde blijven. Wat mee moet, is alles wat Google en je bezoekers al kennen: de pagina’s, de URL’s, de formulieren die mail versturen.

Dit is de volgorde waarin ik het doe. Wat het kost, lees je in wat kost het om van WordPress naar Astro te gaan?

1. Zet elke URL op een lijst

Voordat ik iets bouw, maak ik een lijst van elke URL die de site heeft. Niet alleen de pagina’s uit het menu. Ik haal ze uit vier bronnen:

  • De XML-sitemap die WordPress maakt.
  • Search Console: elke pagina met vertoningen in het afgelopen jaar.
  • Analytics: pagina’s waar nog bezoekers komen.
  • Links van andere sites naar de jouwe.

Je vindt altijd dingen die niemand zich meer herinnert. Een campagnepagina uit 2021. Tagarchieven. Een pdf waar een andere site naar linkt. Elke URL op de lijst krijgt straks een nieuw adres, of de beslissing dat hij weg mag.

2. Tel de templates

Daarna kijk ik welke soorten pagina’s er zijn. Blogs, diensten, cases, vacatures, een contactpagina. Elke soort krijgt een template in Astro en een contenttype met eigen velden.

Een blog is simpel: titel, datum, afbeelding, tekst. Een vacature heeft een standplaats, uren en een sluitingsdatum. Dat leg ik per type vast, voordat ik ook maar één pagina overzet.

3. Kies waar je teksten aanpast

Je kunt content beheren in een CMS als Sanity , of als Markdown-bestanden in de site zelf, zoals op deze site. Werkt er een redacteur elke week in WordPress? Dan kies ik Sanity. Die krijgt velden die passen bij de content en een preview van de echte pagina.

4. Zet de content over met een script

Ik kopieer geen pagina’s met de hand. Een script haalt de content uit WordPress en zet hem in de nieuwe velden. Berichten, pagina’s, categorieën, auteurs, en bij WPML of Polylang ook welke pagina bij welke vertaling hoort.

Is de site gemaakt met de gewone WordPress-editor? Dan is dat redelijk schoon. Bij Elementor, Divi of WPBakery zit de tekst tussen shortcodes en instellingen. Het script vist de tekst daaruit. Pagina’s die echt afwijken, bouw ik met de hand na.

Ik draai het script opnieuw tot het resultaat klopt. Dat is het voordeel van een script: zit er iets fout, dan pas ik het script aan en niet vijfhonderd pagina’s.

5. Afbeeldingen

Afbeeldingen gaan mee als origineel. Ik zet ze in opslag op Cloudflare (R2). Cloudflare maakt aan de rand van het netwerk de maat die een bezoeker nodig heeft, in AVIF of WebP als de browser dat ondersteunt. Een plugin om afbeeldingen te optimaliseren heb je niet meer nodig.

Het script past ook de links naar afbeeldingen in de tekst aan. Een oude link naar /wp-content/uploads/ die nog in een bericht staat, is een 404 die zit te wachten.

6. Bouw na wat plugins deden

Loop je je lijst met plugins door, dan zie je dat de helft niet meer nodig is. Caching, beveiliging, afbeeldingen comprimeren en SEO zitten in de nieuwe opzet.

Wat overblijft, doet echt iets: een contactformulier, zoeken, een aanmelding voor de nieuwsbrief. Die bouw ik als kleine functie op Cloudflare, naast de site. Een formulier staat er zo. Inloggen en een ledenomgeving zijn een project op zich.

7. Redirects

Nu komt de lijst uit stap 1 terug. Elke oude URL krijgt een permanente redirect (301) naar zijn nieuwe adres. De meeste komen uit het script, want dat weet welke oude pagina bij welke nieuwe hoort. De rest koppel ik met de hand.

Twee regels:

  • In één stap. Een oude URL gaat direct naar het eindadres, niet via een redirect die nog een keer doorstuurt.
  • Niet alles naar de homepage. Heeft een pagina geen opvolger, dan gaat hij naar de pagina die dezelfde vraag het best beantwoordt. Een redirect naar een pagina die er niets mee te maken heeft, ziet Google als een soft 404.

Op Cloudflare zijn de redirects een gewoon tekstbestand in het project. Je kunt ze lezen, en ze gaan mee met elke deploy.

8. Titels, omschrijvingen en de sitemap

Elke pagina houdt zijn SEO-titel en meta-omschrijving. Gebruikt de site Yoast of Rank Math, dan neemt het script ze mee met de content. Canonical-tags, hreflang voor meerdere talen en een nieuwe XML-sitemap komen uit de templates. Daarna leg ik de oude en de nieuwe site pagina voor pagina naast elkaar, op een testadres, voordat we overstappen.

9. Livegang

De livegang zelf is klein. Het domein wijst naar Cloudflare en binnen een paar minuten staat de nieuwe site live. Ik stuur de nieuwe sitemap in bij Search Console en meld de pagina’s via IndexNow bij Bing en andere zoekmachines.

10. Houd Search Console in de gaten

Na de livegang kijk ik een paar weken mee in Search Console. Welke URL’s geven een 404? Welke pagina’s vallen uit de index? Houden de belangrijkste pagina’s hun positie? Een vergeten URL duikt meestal in de eerste twee weken op. Die los ik op met een extra regel in het redirectbestand.

Als het klaar is

Een goed verhuisde site ziet er voor Google hetzelfde uit als ervoor, alleen sneller. Je redactie werkt in een CMS dat alleen over content gaat, en niemand hoeft nog elke week updates te installeren.

Heb je een WordPress-site die hieraan toe is? Op de pagina WordPress-migratie lees je hoe ik een project aanpak en wat ik van je nodig heb voor een prijs.