WordPress admin: wat doe je als je niet meer kunt inloggen?

TL;DR

• Kom je niet in je WordPress admin, begin dan bij het makkelijkste: cookies en cache leegmaken en je wachtwoord opnieuw instellen. Dat lost het vaakst het probleem op.
• Gebruikersnaam en wachtwoord zijn hoofdlettergevoelig. Dat is verrassend vaak de hele oorzaak.
• Zie je een witte pagina of een foutmelding, dan zit het in een plugin, je thema of PHP. Zet dan eerst debuggen aan zodat je ziet wat er misgaat.
• “Error establishing a database connection” betekent bijna altijd verkeerde gegevens in je wp-config.php of een database die niet reageert.
• Krijg je een mail met “Uw site heeft een technisch probleem”, dan zit daar een herstelmodus-link in waarmee je alsnog naar je beheerpaneel kunt.
• Maak altijd eerst een back-up voordat je in bestanden of je database gaat sleutelen.
• Blijf je vastzitten na een half uur, schakel dan hulp in. Doorprikken zonder back-up maakt het probleem meestal groter.

Introductie

Je typt je gebruikersnaam in, klikt op inloggen, en er gebeurt niets. Of je krijgt een witte pagina. Of een melding over een databaseverbinding. En je site staat online, dus ergens loopt een klok door terwijl jij niet bij je eigen beheerpaneel kunt.

Het goede nieuws: in de meeste gevallen is het geen ramp en zijn de oorzaken beperkt in aantal. Er zijn ongeveer zes dingen die dit veroorzaken, en ze zijn in een vaste volgorde uit te sluiten. In deze blog lopen we die volgorde langs: van de makkelijkste oplossing tot de gevallen waarbij je in bestanden moet duiken. Met steeds de waarschuwing waar je voorzichtig moet zijn.

Waarom kun je niet inloggen op je WordPress admin?

De oorzaken vallen uiteen in twee groepen. Óf je inlog werkt niet (verkeerd wachtwoord, cookies geblokkeerd, rechten weg), óf je site werkt niet (een plugin, je thema, PHP of je database). Dat onderscheid bepaalt wat je gaat doen, dus stel eerst vast in welke groep je zit.

Zo weet je het:

• Je ziet het inlogscherm en het werkt niet. Dan is het je inlog: wachtwoord, cookies, rechten of een blokkade.
• Je ziet een witte pagina, een foutmelding of een 500-fout. Dan is het je site: een plugin, je thema, PHP of je database.
• Je logt in en wordt direct teruggestuurd naar het inlogscherm. Dat is meestal een cookie- of URL-probleem.
• Je logt in maar ziet geen menu-items. Dan zijn je beheerdersrechten weg.

Dat vaststellen kost je dertig seconden en het scheelt je een uur zoeken op de verkeerde plek.

Wat probeer je als eerste?

Begin bij de vier dingen die geen risico met zich meebrengen: cookies en cache leegmaken, controleren of je hoofdletters goed staan, je wachtwoord opnieuw instellen en het in een andere browser of incognitovenster proberen. Deze vier lossen het merendeel van de inlogproblemen op en je kunt er niets mee stukmaken.

Per stap:

1. Cookies en cache leegmaken. WordPress heeft cookies nodig om je ingelogd te houden. Blokkeert je browser die, of staat er een oude sessie in de weg, dan kom je niet binnen. WordPress noemt dit zelf als een van de hoofdoorzaken.

2. Let op hoofdletters. Gebruikersnaam en wachtwoord zijn hoofdlettergevoelig. Een ingeschakelde Caps Lock of een wachtwoordmanager die iets net anders invult is een reëler probleem dan je denkt.

3. Wachtwoord opnieuw instellen. Klik op “Wachtwoord vergeten” en gebruik de link uit de mail. Komt die mail niet aan, dan heb je een tweede probleem: je site kan geen mail versturen. Dat is een aparte klus en meestal een kwestie van een SMTP-instelling.

4. Andere browser of incognito. Sluit een browserextensie of een lokale instelling uit. Werkt het incognito wel, dan zit het in je browser en niet in je site.

Werkt geen van deze vier, dan gaan we een laag dieper. Vanaf hier geldt: maak eerst een back-up.

Wat doe je bij “Error establishing a database connection”?

Deze melding betekent dat WordPress je database niet kan bereiken. Er zijn drie oorzaken: de inloggegevens in je wp-config.php kloppen niet, de databaseserver reageert niet, of je database is beschadigd. In die volgorde controleer je het.

Wat je doet:

• Controleer je wp-config.php. Daar staan de databasenaam, gebruikersnaam, wachtwoord en host. Vergelijk die met wat er in je hostingpaneel staat. Deze fout komt vaak voor kort na een verhuizing, want dan zijn die gegevens veranderd.
• Check of je hosting een storing heeft. Kijk op de statuspagina van je hostingpartij of neem contact op. Als de databaseserver plat ligt, kun je zelf niets repareren.
• Kijk of je opslag- of databaselimiet vol zit. Een volle database geeft dezelfde melding.
• Als niets daarvan het is: je database kan beschadigd zijn. Er is een reparatiefunctie in WordPress die je activeert door define('WP_ALLOW_REPAIR', true); toe te voegen aan je wp-config.php. Zet die daarna weer uit, want de reparatiepagina is voor iedereen bereikbaar.

Belangrijk: sleutel niet in je database zonder back-up. Een export maken via je hostingpaneel kost je een minuut en het is je enige terugweg.

Hoe los je een witte pagina of foutmelding op?

Een witte pagina of een 500-fout betekent dat er iets in de PHP-code stukloopt, meestal een plugin of je thema. Zet als eerste debuggen aan zodat je de echte foutmelding ziet, in plaats van te gokken. Daarna schakel je plugins en thema uit tot je de veroorzaker vindt.

Stap 1: zet debuggen aan. Voeg in je wp-config.php deze regels toe boven de regel /* That's all, stop editing! */:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

De foutmeldingen komen dan in wp-content/debug.log te staan, zoals WordPress documenteert. Met WP_DEBUG_DISPLAY op false zien je bezoekers niets. Zet deze regels weer uit als je klaar bent.

Stap 2: sluit plugins uit. Kun je niet bij je beheerpaneel, dan ga je via FTP of je bestandsbeheer naar wp-content/plugins en geef je die map tijdelijk een andere naam, bijvoorbeeld plugins-oud. Alle plugins zijn dan uitgeschakeld. Werkt je site weer, dan weet je dat het een plugin is. Zet de naam terug en schakel ze dan één voor één weer aan tot het misgaat.

Stap 3: sluit je thema uit. Werkt het nog niet, geef dan je themamap een andere naam. WordPress valt dan terug op een standaardthema. Werkt het daarna, dan zit het in je thema.

Stap 4: controleer je PHP-versie. WordPress adviseert PHP 8.3 of hoger. Een verouderd thema of plugin kan op een nieuwere PHP-versie fouten geven, en een oude PHP-versie krijgt geen beveiligingsupdates meer. Dit is een wijziging die je altijd eerst op een testomgeving doet.

Wat is de herstelmodus van WordPress?

Als er een fatale fout optreedt, stuurt WordPress een mail naar het beheerdersadres met de melding dat je site een technisch probleem heeft. In die mail zit een speciale link waarmee je in herstelmodus kunt inloggen. De plugin of het thema dat de fout veroorzaakt is dan tijdelijk uitgeschakeld, zodat je erbij kunt om het op te lossen.

Dat is de makkelijkste route als je hem hebt, en hij wordt vaak gemist omdat de mail in een spamfilter belandt of naar een oud adres gaat.

Twee praktische punten:

• Check je spamfilter op een mail met “technisch probleem” of “technical issue” in de titel.
• Controleer welk e-mailadres er als beheerdersadres staat. Staat daar het adres van een oud-medewerker of van je vorige bureau, dan komt die mail nooit bij jou. Dat is een van die dingen die je nu regelt en niet tijdens een storing.

Werkt de link niet meer, dan is hij verlopen. Dan pak je de route via de bestanden uit de vorige sectie.

Wat als je wel inlogt maar geen beheerdersrechten meer hebt?

Dan zie je een uitgekleed menu of alleen je profiel. Dat komt doordat je rol is gewijzigd, doordat de gebruikersrollen in de database beschadigd zijn geraakt, of doordat er een plugin met rechtenbeheer iets heeft omgezet. Je gebruiker bestaat nog; hij mag alleen niets meer.

Wat je kunt doen:

• Log in met een andere beheerdersaccount als er nog een is, en zet je rol terug. Dit is de eenvoudigste oplossing en de reden om altijd twee beheerders te hebben.
• Check je actieve plugins. Een plugin voor rollen of ledenbeheer is de meest voorkomende oorzaak.
• Via de database. In de tabel wp_usermeta staat de rol per gebruiker onder wp_capabilities. Dit is de laatste optie en alleen met een back-up.
• Overweeg of het iets ernstigers is. Als je rechten zonder aanleiding zijn gewijzigd en er zijn onbekende gebruikers bij, dan kan je site gecompromitteerd zijn. Kijk dan verder dan dit ene probleem, en lees onze blog over je website beveiligen.

Hoe voorkom je dat je opnieuw buitengesloten raakt?

Met vijf maatregelen die je één keer regelt en waar je daarna geen omkijken naar hebt: een tweede beheerdersaccount, een kloppend beheerdersadres, werkende back-ups, een testomgeving en tijdig onderhoud. Vier van de vijf kosten je vijf minuten.

De lijst:

• Twee beheerdersaccounts. Op twee verschillende e-mailadressen. Als er één vastloopt, kun je met de andere naar binnen. Dit is de goedkoopste verzekering die er is.
• Een beheerdersadres dat je leest. Anders mis je de herstelmodus-mail en de meldingen van je updates.
• Back-ups die je hebt getest. Automatisch, buiten je server, en minstens één keer daadwerkelijk teruggezet. Een back-up die je nooit hebt teruggezet is een aanname.
• Een testomgeving. Zodat je updates eerst op een kopie probeert en niet op je live site. Hoe dat werkt staat in onze blog over staging.
• Tijdig onderhoud. De meeste van deze problemen ontstaan bij een update die niet is getest, of doordat er maanden niet is bijgewerkt. Hoe je dat inricht staat in onze blog over het perfecte WordPress onderhoudsschema.

Zit je er nu middenin en kom je niet verder? Neem contact op, dan kijken we ernaar. En wil je dit voorkomen, dan is WordPress onderhoud precies waarvoor dat bestaat. Vooraf weet je wat we doen en wat het kost.