Fouten in uw Joomla-website oplossen: stappenplan
U kunt fouten in uw Joomla-website oplossen door eerst vast te stellen wie de melding geeft: Joomla zelf of de webserver. Daarna zet u foutrapportage aan in het bestand configuration.php, leest u de melding en schakelt u de extensie of wijziging uit die de fout veroorzaakt. Dat kan ook als u niet meer in de beheerder (het inlogscherm van uw site) komt. Hieronder staat de volgorde die ik zelf aanhoud.
Hoe kan ik fouten in mijn Joomla-website oplossen: geeft Joomla of de webserver de fout?
Een foutmelding met Joomla-opmaak komt van Joomla zelf. Een kale melding van de server, zoals een algemene fout 500 of een wit scherm zonder tekst, komt vaak van vóór het moment dat Joomla start.
Dat verschil bepaalt wat u kunt doen. De debuginstellingen van Joomla helpen alleen als Joomla zelf draait. Volgens de Joomla-documentatie kan Joomla twee soorten foutpagina's tonen. De systeemfoutpagina heeft een rode achtergrond. De sjabloonfoutpagina lijkt op de normale sjabloon, met een foutmelding in het inhoudsgebied.
Ziet u een van die twee, dan is Joomla gestart en leest u de melding gewoon. Ziet u een kale serverfout of een leeg scherm, dan zit het probleem eerder in de keten. Denk aan een ongeldig .htaccess-bestand (een configuratiebestand voor de webserver) of een PHP-fout die Joomla niet kan afvangen. In dat geval helpt het logbestand van de server verder.
Veel handleidingen op internet zijn geschreven voor Joomla 3. Instellingen en foutpagina's zijn sindsdien aangepast. Let er daarom op dat een handleiding over Joomla 4 of 5 gaat.
Hoe maak ik de foutmelding zichtbaar als ik niet kan inloggen?
U zet foutrapportage aan door het bestand configuration.php in de hoofdmap van uw site te bewerken. Dat doet u met FTP of de bestandsbeheerder van uw hostingpaneel.
Volgens de Joomla-documentatie wijzigt u daarin de parameter $error_reporting in 'maximum'. Dat is gelijk aan foutrapportage op Maximum zetten in de beheerder.
Ververs daarna de pagina. Een wit scherm toont dan vaak een melding met een bestandsnaam en regelnummer. Aan het pad in die melding ziet u meestal welke extensie, welk sjabloon of welke plugin de oorzaak is.
Wilt u meer dan het scherm, kijk dan in de logbestanden. Joomla schrijft eigen logs naar de map logs van de site. Fouten van de webserver of PHP staan in het error log van de server. De locatie van dat bestand verschilt per server. In een hostingpaneel vindt u het vaak onder een onderdeel als logs of foutlogboek.
Hoe weet ik welke extensie de fout veroorzaakt?
Kijk eerst wat u als laatste hebt gewijzigd. Een fout die direct na het installeren of bijwerken van een extensie optreedt, wijst bijna altijd naar die extensie.

Staat er in de foutmelding een pad, dan zit de naam van de extensie meestal in dat pad. Mappen onder plugins, components en modules dragen de naam van de extensie. Ziet u geen pad, dan schakelt u extensies een voor een uit en kijkt u na elke stap of de site terug is.
Kunt u niet inloggen, dan zijn er twee manieren:
- Hernoem via FTP de map van de extensie, bijvoorbeeld van mijnplugin naar mijnplugin_uit. Joomla laadt de extensie dan niet meer.
- Open de database met een hulpmiddel als phpMyAdmin. Zoek in de tabel met extensies (de naam eindigt op _extensions) de regel van de extensie en zet de kolom enabled op 0.
Werkt de site weer, dan logt u in en kijkt u of er een nieuwere versie van die extensie bestaat. Is dat niet zo, dan laat u hem uit staan.
Hoe zet ik een mislukte update of wijziging terug?
Zet de bestanden en de database samen terug naar de staat van vóór de update. Alleen de bestanden terugzetten werkt meestal niet, omdat een Joomla-update ook de database aanpast.
Een volledige backup bevat in het algemeen twee delen: de bestanden van de site en een export van de database. Maakt u zelf een backup met een extensie als Akeeba Backup, dan gebruikt u die ook voor het terugzetten.
Een stappenplan dat bij de meeste fouten past:
1. Maak eerst een kopie van de huidige situatie, ook al is die kapot.
2. Zet de bestanden terug naar de versie van vóór de update.
3. Zet de bijbehorende database terug.
4. Controleer de site en het beheerpaneel.
5. Voer de update pas opnieuw uit nadat u hebt gelezen waarom hij misging. Vaak staat dat in de foutmelding of in de documentatie van de extensie.
Komt u niet meer in de beheerder, dan doet u stap 2 en 3 buiten Joomla, met dezelfde hulpmiddelen als hierboven: FTP voor de bestanden en phpMyAdmin voor de database.
Waar kan ik terecht met vragen?
Met vragen over uw hosting kunt u rechtstreeks bij mij terecht. Ik beheer de server zelf en werk zelf met Joomla en VirtueMart. U spreekt dus met mij en niet met een callcenter. Op een vraag krijgt u binnen 24 uur antwoord, van mij zelf. Neem daarvoor contact op. Over het controleren van een site op fouten leest u meer in website laten controleren op fouten.
Veelgestelde vragen
Mijn Joomla-site toont een wit scherm. Wat doe ik?
Zet foutrapportage aan in configuration.php en ververs de pagina. Een wit scherm betekent meestal dat er een PHP-fout is die niet wordt getoond. Met foutrapportage op maximum verschijnt de melding en ziet u welk bestand de fout veroorzaakt.
Blijft het scherm leeg, kijk dan in het error log van de server.
Kan een kapotte .htaccess een fout 500 geven?
Ja. Een ongeldige regel in .htaccess zorgt ervoor dat de webserver de pagina niet kan uitvoeren, nog voordat Joomla start.
Hernoem het bestand tijdelijk naar .htaccess_oud en laad de site opnieuw. Werkt hij dan, dan zat de fout in dat bestand. Joomla levert een standaardbestand mee met de naam htaccess.txt. Dat kopieert u naar .htaccess om weer een werkende basis te hebben.
Moet ik foutopsporing weer uitzetten als de fout is opgelost?
Ja. Volgens de Joomla-documentatie wordt het niet geadviseerd de foutopsporingsmodus blijvend in te schakelen wanneer uw website online is.
Gelden handleidingen voor Joomla 3 ook voor Joomla 4 en 5?
Gedeeltelijk. De werkwijze met configuration.php, extensies uitschakelen en een backup terugzetten is hetzelfde gebleven.
Menu's, schermen en sommige instellingen zijn veranderd. Controleer daarom bij elke handleiding voor welke Joomla-versie die is geschreven.
Waar vind ik het error log van mijn Joomla-site?
Het error log van de server staat op een plek die per server verschilt. In een hostingpaneel staat het vaak onder logs of foutlogboek.
Joomla schrijft zelf ook logs, in de map logs van de site. Een kale serverfout zoals een fout 500 vindt u in het log van de server, niet in dat van Joomla.