Een witte pagina, een kapot contactformulier of een checkout die niet meer werkt na een update: op een WordPress-site merk je het vaak pas als een bezoeker of je klant belt. De debug.log staat uit of niemand kijkt erin. Met de errors.nl-plugin komt elke fout binnen in één dashboard, met de plugin of het thema waar het misging.
1. Maak een project aan
Log in bij errors.nl, maak een organisatie en een project aan en kopieer de DSN. Die ziet eruit als https://<sleutel>@ingest.errors.nl/<project>.
2. Installeer de plugin
Download de plugin en upload hem in WordPress via Plugins > Nieuwe plugin > Plugin uploaden. Activeer hem daarna.
3. Plak de DSN
Ga naar Instellingen > errors.nl, plak de DSN en sla op. Klik op Stuur een testfout: binnen een paar seconden staat hij onder Issues in het dashboard.
4. Kies wat je wilt zien
- PHP-fouten staan standaard aan: fatals en exceptions die niet worden afgevangen.
- PHP-warnings staan standaard uit. Oudere plugins geven er vaak veel, en elke opgeslagen fout kost een credit.
- JavaScript-fouten van bezoekers zet je aan met één vinkje. Het script zit in de plugin zelf, er wordt geen externe CDN geladen.
Bij elke fout zie je welke plugin of welk thema hem veroorzaakte, plus de versies van WordPress en PHP. Zo weet je na een update meteen welke plugin je moet terugzetten.
5. Veel sites? Zet het in wp-config.php
Beheer je sites voor klanten, dan wil je niet per site door het instellingenscherm. Zet de instellingen in wp-config.php, of in je deploy-script:
define( 'ERRORSNL_DSN', 'https://<sleutel>@ingest.errors.nl/<project>' ); define( 'ERRORSNL_ENVIRONMENT', 'production' ); define( 'ERRORSNL_RELEASE', '[email protected]' );
Maak per klantsite een project aan, dan zie je per site wat er misgaat. De credits deel je over al je projecten. Lees ook foutmonitoring voor webbureaus.
6. Persoonsgegevens
De plugin stuurt de foutmelding, de stacktrace met de betreffende regels code, de URL zonder querystring en de versies van WordPress, PHP en het thema. Geen cookies, formulierdata of gegevens van ingelogde gebruikers. Wil je een event aanpassen of tegenhouden, gebruik dan het filter errorsnl_event en geef null terug om niets te versturen.
errors.nl filtert daarnaast wachtwoorden, tokens, e-mailadressen en rekeningnummers uit elke fout voordat we die opslaan. Meer daarover lees je in Foutmonitoring en de AVG.
Meldingen
Wil je weten wanneer er iets misgaat zonder het dashboard open te hebben? Zet bij je project een melding per e-mail aan, of koppel Slack, Teams, Discord of ntfy voor pushmeldingen op je telefoon.