WordPress blijft hangen in onderhoudsmodus? Zo haal je hem eruit

Je start een update, gaat even koffie halen, en als je terugkomt staat er op je hele site maar één zin: “Kort niet beschikbaar voor gepland onderhoud. Controleer het over een minuut opnieuw.” Die minuut duurt inmiddels een half uur.

Er is niets kapot. De update is onderbroken voordat WordPress kon opruimen, en daardoor staat er nog een bestandje dat zegt dat er onderhoud bezig is.

Wat er gebeurt tijdens een update

Zodra WordPress een plugin, thema of zichzelf bijwerkt, zet het een bestand .maintenance in de hoofdmap van je site. Zolang dat er staat, krijgt elke bezoeker de onderhoudsmelding. Is de update klaar, dan haalt WordPress het weer weg.

Sluit je je browser halverwege, loopt de server tegen een tijdslimiet aan of valt de verbinding weg, dan blijft het bestand staan. In het bestand staat het tijdstip waarop de update begon. Na tien minuten negeert WordPress het zelf. Blijft de melding langer staan, dan is dat meestal een cache die de oude pagina blijft tonen, of een update die telkens opnieuw vastloopt.

Het bestand weghalen

1. Log in met FTP of SFTP, of open de bestandsbeheerder in je hostingpaneel.
2. Ga naar de map waar ook wp-config.php staat.
3. Zet het tonen van verborgen bestanden aan. Een bestand dat met een punt begint, zie je anders niet.
4. Verwijder .maintenance.
5. Leeg je cache, in je cacheplugin of bij je hoster, en laad je site opnieuw.

Heb je SSH-toegang, dan kan het ook met WP-CLI:

wp maintenance-mode status
wp maintenance-mode deactivate

Daarna: wat is er half bijgewerkt?

Dit is de stap die vaak wordt overgeslagen. Je site doet het weer, maar de update die werd onderbroken is niet afgemaakt. Een plugin kan half vervangen zijn: een deel van de bestanden nieuw, een deel oud. Dat werkt soms, tot het ineens niet meer werkt.

1. Ga naar Dashboard, Updates. Staat de plugin er nog tussen, voer de update dan opnieuw uit, en blijf er deze keer bij.
2. Is een plugin uit je lijst verdwenen, dan was WordPress de oude map al aan het verwijderen. Installeer hem opnieuw. Je instellingen staan in de database en blijven bewaard.
3. Kijk in wp-content/upgrade. Daar pakt WordPress updates uit. Staan er nog mappen in, dan mag je die weggooien.
4. Klik een paar belangrijke pagina’s door en verstuur een testformulier.

Krijg je na het weghalen een kritieke fout in plaats van de onderhoudsmelding, dan is een plugin wel kapotgegaan. Hoe je dat oplost lees je in er is een kritieke fout opgetreden.

Waar het meestal misgaat

• Het bestand is onzichtbaar. Je kijkt in de goede map en ziet niets, omdat verborgen bestanden niet getoond worden.
• In de verkeerde map gekeken. Het bestand staat naast wp-config.php, niet in wp-content.
• Bestand weg, melding blijft. Dan toont je cache de oude pagina. Leeg de cache, of kijk in een privévenster.
• Tien plugins tegelijk bijgewerkt. Hoe meer er in één keer gaat, hoe groter de kans dat de server halverwege de tijdslimiet haalt. Werk grote plugins los bij.
• De update nooit afgemaakt. De site werkt, maar een plugin draait op een halve versie. Dat merk je weken later.

Tot slot

Eén bestand weg en je site is terug. Het echte werk is daarna: controleren wat er half is blijven liggen. Blijf bij je updates tot ze klaar zijn, en werk de grote plugins één voor één bij. Dan zie je deze melding waarschijnlijk nooit meer.