Een syntax error in WordPress kan ervoor zorgen dat je website ineens niet meer goed werkt. Soms zie je alleen een wit scherm. Soms verschijnt er een foutmelding met een bestandspad en een regelnummer.
De oorzaak is vaak klein, maar het gevolg kan groot zijn. Een vergeten puntkomma, een verkeerd haakje of een stukje code op de verkeerde plek kan genoeg zijn om WordPress vast te laten lopen.
Gelukkig geeft de foutmelding meestal aanwijzingen. Als je rustig kijkt naar het bestand en het regelnummer, kun je vaak snel vinden waar het probleem zit.
In dit artikel leggen we uit wat een syntax error betekent, hoe je de fout herkent en hoe je je website veilig herstelt zonder extra schade te veroorzaken.
Wat betekent een syntax error in WordPress?
Een syntax error betekent dat er iets mis is met de opbouw van de code. WordPress probeert de code te lezen, maar loopt vast omdat een teken, haakje, komma of regel niet klopt.
Dat gebeurt meestal in PHP-code. PHP is de programmeertaal waar WordPress voor een groot deel op draait. Als PHP een regel niet begrijpt, stopt het proces en krijg je een foutmelding.
De fout kan zitten in een thema, plugin, codefragment of bestand dat handmatig is aangepast. Vaak gaat het om functions.php, maar het kan ook in een ander bestand zitten.
Een syntax error betekent dus niet dat heel WordPress kapot is. Meestal is er één stukje code dat hersteld moet worden.
Hoe herken je een syntax error?
Een syntax error herken je vaak aan een melding waarin woorden staan zoals parse error, syntax error, unexpected of on line.
De foutmelding geeft meestal drie belangrijke dingen aan. Je ziet welk bestand het probleem veroorzaakt, welk type fout er is en op welke regel WordPress vastloopt.
Een voorbeeld van zo’n melding kan lijken op:
Parse error: syntax error, unexpected token in /wp-content/themes/thema/functions.php on line 42In dit voorbeeld zit de fout in functions.php van het actieve thema. Het regelnummer helpt je om sneller naar de juiste plek te gaan.
Zie je helemaal geen foutmelding, maar alleen een wit scherm? Dan kan het nog steeds om een codefout gaan. In dat geval moet je debugging inschakelen om meer informatie zichtbaar te maken.
Als je wilt weten hoe je foutmeldingen zichtbaar maakt zonder te gokken, helpt dit artikel je stap voor stap verder: Handleiding WordPress debugging inschakelen stap voor stap.
Waardoor ontstaat een syntax error?
Een syntax error ontstaat meestal nadat er iets is aangepast aan de website. Denk aan nieuwe code in functions.php, een aangepast thema, een pluginupdate of een codefragment dat niet goed is geplaatst.
Veelvoorkomende oorzaken zijn een ontbrekend haakje, een vergeten puntkomma, verkeerde aanhalingstekens of code die op de verkeerde plek is geplakt.
Ook gekopieerde code van internet kan problemen geven. Soms mist er een stukje code, of past de code niet bij jouw thema, plugin of PHP-versie.
Daarom is het verstandig om nooit zomaar code toe te voegen aan een live website zonder back-up. Een klein foutje kan ervoor zorgen dat je website niet meer opent.
Maak eerst een back-up voordat je iets wijzigt
Voordat je bestanden aanpast, maak je eerst een back-up. Dat hoeft niet ingewikkeld te zijn, maar het is wel belangrijk.
Download minimaal het bestand dat je gaat bewerken. Als de fout bijvoorbeeld in functions.php zit, download je eerst een kopie van dat bestand naar je computer.
Nog beter is een volledige back-up van de website en database. Dan kun je altijd terug als er iets misgaat.
Weet je niet precies waarom een back-up belangrijk is bij WordPress-fouten? Dan legt dit artikel de basis duidelijk uit: Wat is een website backup en hoe beschermt dit je site?
Stap 1: lees de foutmelding rustig
Begin met de foutmelding. Daar staat meestal precies waar je moet zoeken.
Let vooral op het bestandspad en het regelnummer. Het bestandspad vertelt in welk bestand de fout zit. Het regelnummer vertelt waar WordPress de fout tegenkomt.
Toch hoeft de echte fout niet altijd exact op die regel te staan. Soms staat het probleem een paar regels erboven. Bijvoorbeeld wanneer een haakje eerder niet goed is afgesloten.
Lees daarom niet alleen de genoemde regel, maar ook de regels ervoor en erna.
Stap 2: open het bestand via File Manager of FTP
Als je nog in het WordPress-dashboard kunt, kun je soms via het thema- of pluginbestand zoeken. Maar bij een syntax error werkt het dashboard vaak niet meer.
Gebruik dan File Manager in je hostingpaneel of een FTP-programma. Daarmee kun je de bestanden van je website openen zonder in te loggen in WordPress.
Ga naar het bestand dat in de foutmelding wordt genoemd. Staat de fout bijvoorbeeld in het actieve thema, dan vind je het bestand meestal in de map wp-content, daarna themes en daarna de map van je thema.
Open het bestand pas nadat je een back-up hebt gemaakt.
Stap 3: controleer de code rond het regelnummer
Ga naar het regelnummer dat in de foutmelding staat. Controleer daar de code en kijk ook naar de regels erboven.
Let vooral op ontbrekende of extra tekens. Een syntax error ontstaat vaak door kleine fouten die makkelijk over het hoofd worden gezien.
Voorbeelden zijn:
- een ontbrekende puntkomma
- een haakje dat niet is gesloten
- verkeerde aanhalingstekens
- een extra komma
- code die buiten een functie is geplakt
- PHP-code die niet goed is geopend of gesloten
Dit is een van de weinige plekken waar een korte lijst nuttig is, omdat je gericht kunt controleren waar het fout gaat.
Herstel de fout en sla het bestand op. Open daarna de website opnieuw in je browser.
Stap 4: zet de laatste wijziging terug
Weet je niet precies wat er fout is? Denk dan terug aan de laatste wijziging die je hebt gedaan.
Heb je net code toegevoegd aan functions.php? Verwijder dan eerst die nieuwe code. Heb je een plugin aangepast of een codefragment toegevoegd? Zet die wijziging terug.
Vaak is dat sneller dan zoeken in het hele bestand. Een syntax error ontstaat meestal direct na een aanpassing.
Als de website na het terugzetten weer werkt, weet je dat de fout in die laatste wijziging zat. Daarna kun je de code rustig opnieuw controleren voordat je hem terugplaatst.
Wil je beter begrijpen wat functions.php doet en waarom fouten in dit bestand zo snel problemen geven, dan kun je dit artikel lezen: Wat is functions.php? Uitleg over dit WordPress bestand.
Syntax error door een fout in wp-config.php
Een syntax error kan ook ontstaan wanneer er iets verkeerd wordt aangepast in wp-config.php. Dit bestand bevat belangrijke instellingen van WordPress en moet voorzichtig worden bewerkt.
Soms staat in dit bestand bijvoorbeeld deze regel:
define('DISALLOW_FILE_MODS', true);Deze regel is op zichzelf geen syntax error. Als hij goed is geschreven, zorgt hij ervoor dat bestandsaanpassingen, plugininstallaties of updates via het WordPress-dashboard beperkt kunnen worden.
Het probleem ontstaat pas wanneer deze regel verkeerd wordt geplaatst of fout wordt geschreven. Denk aan een ontbrekende puntkomma, verkeerde aanhalingstekens of een extra teken op de verkeerde plek. Dan kan WordPress de code niet goed lezen en kan er een syntax error ontstaan.
Pas wp-config.php daarom alleen aan als je weet wat je doet. Maak altijd eerst een back-up van het bestand en controleer na elke wijziging direct of de website nog werkt.
Stap 5: schakel een plugin uit als de fout daar vandaan komt
Soms komt de syntax error niet uit je thema, maar uit een plugin. Dat zie je vaak aan het bestandspad in de foutmelding.
Staat er wp-content/plugins in het pad? Dan zit de fout waarschijnlijk in een plugin.
Als je niet meer in het dashboard kunt, kun je de plugin uitschakelen via File Manager of FTP. Ga naar wp-content/plugins en zoek de map van de plugin. Hernoem de map tijdelijk, bijvoorbeeld door -old achter de naam te zetten.
WordPress kan de plugin dan niet meer laden. Als de fout daarna verdwijnt, weet je dat die plugin de oorzaak was.
Lukt het vaker niet om plugins goed te installeren of te activeren, dan helpt dit artikel je om de oorzaak beter te vinden: Wat te doen als je geen WordPress plugin installeren kunt.
Stap 6: schakel tijdelijk terug naar een standaardthema
Als de fout in je thema zit en je weet niet meteen welke regel verkeerd is, kun je tijdelijk overschakelen naar een standaardthema.
Dat doe je meestal niet vanuit WordPress, want het dashboard werkt vaak niet. Via File Manager of FTP kun je de map van het actieve thema tijdelijk hernoemen.
WordPress probeert dan een ander beschikbaar thema te gebruiken. Dit werkt alleen als er ook een standaardthema aanwezig is, zoals een recent WordPress-thema.
Gebruik deze stap voorzichtig. Maak eerst een back-up van de themamapnaam en verander alleen wat nodig is.
Als de website daarna weer opent, weet je dat het probleem in je actieve thema zit.
Stap 7: gebruik debugging om meer informatie te krijgen
Als de foutmelding onduidelijk is, kun je WordPress debugging gebruiken. Daarmee krijg je meer informatie over fouten die normaal verborgen blijven.
Debugging helpt vooral wanneer je een wit scherm ziet of wanneer de foutmelding niet genoeg zegt. Je kunt dan beter zien welk bestand of welke regel het probleem veroorzaakt.
Zet debugging niet onnodig lang aan op een live website. Foutmeldingen kunnen technische informatie tonen die bezoekers niet hoeven te zien.
Gebruik debugging dus om de oorzaak te vinden, herstel de fout en zet het daarna weer netjes uit.
Wat moet je niet doen bij een syntax error?
Bij een syntax error is het belangrijk om rustig te blijven. Ga niet willekeurig bestanden aanpassen, want dan kun je het probleem groter maken.
Verwijder geen hele mappen zonder te weten wat ze doen. Pas ook niet meerdere bestanden tegelijk aan. Dan weet je later niet meer welke wijziging het probleem heeft veroorzaakt.
Gebruik geen code van internet zonder te controleren of die past bij jouw website. Vooral PHP-code moet precies kloppen.
Werk liever stap voor stap. Eerst de foutmelding lezen, dan het juiste bestand openen, daarna de laatste wijziging controleren en pas daarna andere oorzaken bekijken.
Hoe voorkom je een syntax error in WordPress?
Je voorkomt syntax errors vooral door voorzichtig om te werken met code. Plak geen code direct in een belangrijk bestand zonder eerst een back-up te maken.
Werk bij voorkeur met een child theme als je aanpassingen aan een thema doet. Zo blijven wijzigingen beter gescheiden van het hoofdthema en raak je ze minder snel kwijt bij updates.
Voor kleine codefragmenten kun je beter een veilige code-snippet plugin gebruiken. Een voorbeeld daarvan is WPCode. Daarmee hoef je code niet direct in functions.php of andere themabestanden te plaatsen.
Dat is veiliger, omdat je codefragmenten makkelijker kunt beheren, aanpassen of uitschakelen. Gaat er iets mis met een snippet, dan kun je die meestal sneller terugvinden dan wanneer de code handmatig in een themabestand is geplakt.
WPCode is vooral handig om nieuwe syntax errors te voorkomen. Als je website al vastloopt door een syntax error en je niet meer kunt inloggen, moet je de fout meestal eerst herstellen via File Manager of FTP.
Test grotere wijzigingen liever eerst op een testomgeving. Zo voorkom je dat een fout meteen zichtbaar wordt voor bezoekers.
Goede beveiliging en veilig beheer helpen ook om fouten en risico’s te beperken. Voor een bredere basis kun je dit artikel gebruiken: WordPress beveiliging: 23 tips om je website te beschermen.
“Werk slimmer met je code, niet sneller. Eén kleine aanpassing op de juiste manier voorkomt uren zoeken naar fouten.”
Bron: WPuptodate
Wanneer moet je hulp inschakelen?
Schakel hulp in als je niet weet welk bestand je moet aanpassen of als je bang bent om de website verder kapot te maken.
Dat geldt vooral wanneer de fout in een actief thema, maatwerkcode of een belangrijke plugin zit. Een verkeerde aanpassing kan nieuwe fouten veroorzaken.
Ook als je geen back-up hebt, is voorzichtigheid belangrijk. Laat dan eerst iemand meekijken voordat je bestanden overschrijft.
Een syntax error is meestal goed op te lossen, maar je moet wel precies werken.
Conclusie
Een syntax error in WordPress ontstaat meestal door een kleine fout in code. Denk aan een ontbrekend haakje, verkeerde aanhalingstekens of een codefragment dat op de verkeerde plek is geplaatst.
De foutmelding helpt je vaak om het juiste bestand en regelnummer te vinden. Open het bestand via File Manager of FTP, controleer de laatste wijziging en herstel de code rustig.
Maak altijd eerst een back-up voordat je iets aanpast. Werk stap voor stap en verander niet meerdere dingen tegelijk.
Als de fout onduidelijk blijft, gebruik dan debugging of schakel hulp in. Zo voorkom je dat een klein probleem groter wordt.
Veelgestelde vragen
1. Wat betekent syntax error in WordPress?
Een syntax error betekent dat WordPress een stuk code niet goed kan lezen. Meestal komt dat door een ontbrekend teken, verkeerd haakje of fout geplaatste code.
2. Kan een syntax error mijn website offline zetten?
Ja, dat kan. Soms blijft alleen een deel van de website werken, maar in andere gevallen zie je een wit scherm of kun je niet meer inloggen.
3. Waar zit een syntax error meestal?
Vaak zit de fout in functions.php, een pluginbestand, een themabestand of een codefragment dat handmatig is toegevoegd.
4. Hoe los je een syntax error snel op?
Lees de foutmelding, open het genoemde bestand via File Manager of FTP en controleer de code rond het genoemde regelnummer.
5. Wat als ik niet meer in WordPress kan inloggen?
Gebruik dan File Manager of FTP om het bestand aan te passen. Je hoeft daarvoor niet in het WordPress-dashboard te komen.
6. Kan een plugin een syntax error veroorzaken?
Ja, een plugin kan een syntax error veroorzaken als er foutieve code in zit of als een update niet goed is gegaan.
7. Moet ik altijd een developer inschakelen?
Niet altijd. Als de foutmelding duidelijk is en je weet welke wijziging je hebt gedaan, kun je het vaak zelf herstellen. Twijfel je, schakel dan hulp in.