Je werkt je WordPress site bij en opeens gaat het mis. Een foutmelding, een wit scherm, of je site blijft hangen in onderhoudsmodus. Vervelend, maar bijna altijd op te lossen. Hieronder loop je van de simpele checks naar de zwaardere oplossingen.
Waarom een update misgaat
Een update loopt meestal vast door een van deze dingen:
- Wegvallende internetverbinding, waardoor bestanden niet compleet binnenkomen.
- Pluginconflict, een plugin werkt niet samen met de nieuwe WordPress versie.
- Te weinig schijfruimte op je hosting, zodat WordPress niet alle bestanden kan wegschrijven.
- Verkeerde bestandsrechten, WordPress mag de bestanden niet overschrijven.
- Geblokkeerde updates door een security plugin of serverinstelling.
- Te lage PHP-limiet, het updatescript loopt stuk op te weinig geheugen.
Het gevolg is een ontoegankelijke site (Internal Server Error of wit scherm), een vastzittende onderhoudsmodus, of subtielere problemen zoals trage pagina's en formulieren die niet meer werken.
Begin bij de basis
Drie checks die je in een paar minuten doet.
- Stabiel internet. Hapert je verbinding, wissel van netwerk of update tijdelijk via mobiele data.
- Genoeg schijfruimte. Kijk in je hostingpaneel. Ruim oude back-ups, ongebruikte thema's en zware afbeeldingen op. Een plugin als All-in-One WP Migration zet elke back-up ook op de server, dat vreet ruimte.
- Bestandsrechten. Controleer via FTP of WordPress de mappen mag beschrijven. De map wp-content moet schrijfbaar zijn. Bij twijfel zet je dit recht via je hostingpaneel.
Probeer eerst de makkelijke oplossingen
Vaak zit het in een klein dingetje.
- Leeg je browsercache. Soms is de update wel gelukt, maar laadt je browser een oude pagina. Cache legen, browser sluiten, site opnieuw openen.
- Schakel plugins uit. Zet alle plugins uit en probeer de update opnieuw. Lukt het wel, activeer ze dan een voor een. Zodra het probleem terugkomt, weet je welke plugin de boosdoener is. Zoek een alternatief of wacht op een update van die plugin.
Werk handmatig bij via FTP
Blijft de automatische update weigeren? Dan doe je het zelf. Maak eerst een back-up, dan kun je altijd terug.
De stappen
- Download de nieuwste versie van wordpress.org en pak het ZIP-bestand uit.
- Maak met een FTP-programma zoals FileZilla verbinding met je site.
- Ga naar de hoofdmap (waar wp-content en wp-admin staan).
- Upload de nieuwe mappen wp-admin en wp-includes en overschrijf de bestaande.
- Upload ook de losse bestanden uit de nieuwe WordPress map (zoals wp-login.php en wp-settings.php).
- Laat wp-content met rust. Daar staan je thema's, plugins en inhoud. Overschrijf je die, dan ben je content kwijt.
Log daarna in op je dashboard. Vraagt WordPress om een database-update, dan klik je dat gewoon weg.
Site blijft in onderhoudsmodus hangen
WordPress zet je site in onderhoudsmodus met een bestandje .maintenance in de hoofdmap. Blijft de site hangen, verwijder dat bestand via FTP en vernieuw de pagina. WordPress denkt dan niet langer dat de update nog bezig is.
Zo voorkom je het de volgende keer
- Maak altijd een verse back-up voor je begint.
- Check compatibiliteit. Kijk of je belangrijke plugins en je thema klaar zijn voor de nieuwe versie. In de plugin-beschrijving zie je wanneer die voor het laatst is bijgewerkt.
- Houd je hosting in de gaten. Krappe schijfruimte of een lage PHP-limiet laat een grote update struikelen. Loopt het vaak mis, neem dan een ruimer pakket.
- Beperk je plugins. Minder plugins betekent minder kans op conflicten en een snellere site.
- Zet debugmodus aan bij twijfel. Stel
WP_DEBUGoptruein wp-config.php. WordPress toont dan de foutmelding, handig bij een wit scherm.
Na de update
Een geslaagde update is niet het einde. Controleer je pagina's, formulieren en eventuele shop. Vraag klanten of ze nog foutmeldingen zien. En doe af en toe een snelheidstest via GTmetrix of Pingdom.
Kleine problemen los je zo op voor ze groot worden. Heb je geen zin in dit gedoe? Dan nemen wij het WordPress onderhoud van je over, dan hoef je hier zelf nooit meer naar om te kijken.