Als er iets kapotgaat op je website, is de eerste reflex vaak: alles updaten en hopen op het beste. Laten we daar direct een punt achter zetten. Dat is namelijk geen troubleshooting, dat is gokken. En bij Welldotcom houden we van resultaat, niet van casino-praktijken.
Deze gids is gebaseerd op het artikel van Joomla-medeoprichter Brian Teeman. Hij legt uit hoe je als een professional problemen aanpakt. Heb je hier zelf geen tijd voor of zie je door de bomen het bos niet meer? Geen punt. Bij Welldotcom duiken we dagelijks in dit soort technische puzzels om het voor onze klanten weer tot in de puntjes te regelen.
Eerst checken, dan pas klikken
Voordat je ook maar één instelling aanraakt of een bestand opent, moet je de volgende zaken kunnen afvinken:
- Ik weet wat er als laatste is gewijzigd (of ik weet zeker dat er niets is veranderd).
- Ik kan precies omschrijven wat er kapot is, waar dat gebeurt en voor wie.
- Ik heb Joomla, PHP of extensies nog niet geüpdatet sinds de fout optrad.
- Ik ben bereid om één ding tegelijk aan te passen en het resultaat te bekijken.
Kun je dit niet afvinken? Dan ben je nog niet klaar om te debuggen. Professionals gaan niet lukraak dingen installeren of verwijderen om te kijken of het helpt. Dat is paniekvoetbal, en daar maken wij geen punt van.
Stap 1: Stop en blijf overal vanaf
Elke wijziging die je nu maakt, vernietigt bewijsmateriaal. Schrijf eerst op: wat veranderde er vlak voordat het probleem ontstond? Gebeurt het aan de voorkant, de achterkant, of beide? Is het op elke pagina of slechts één? "Er is niets veranderd" is ook belangrijke informatie.
Stap 2: Dwing Joomla de waarheid te vertellen
Joomla weet meestal precies wat er mis is, maar je moet wel even goed kijken.
- Een witte pagina: Dit is vaak een PHP-fout waarbij het systeem crasht voordat er een melding getoond kan worden. Zet de foutrapportage in de Algemene Configuratie op 'Maximaal'.
- Een standaard Joomla foutpagina: Joomla verbergt hier de details. Zet 'Systeem debuggen' aan om te zien waar het precies misgaat.
- De oranje foutpagina: Dit duidt vaak op een probleem op server- of databaseniveau.
Kun je niet meer in de backend komen? Geen punt. Open je configuration.php via FTP en zet public $debug = true; en public $error_reporting = 'maximum';. Vergeet dit niet terug te zetten als je klaar bent.
Stap 3: Lees de logs als een volwassene
Joomla houdt continu logs bij. Kijk in /administrator/logs/error.php of check de PHP-error logs van je server. Zoek naar patronen. Wordt hetzelfde bestand steeds genoemd? Dan heb je de dader waarschijnlijk te pakken.
Stap 4: Schakel caching uit (want caching liegt)
Caching is er om werk te verbergen, en dat is precies wat je niet wilt tijdens het zoeken naar een fout. Zet de systeemcache en de paginacache-plugin uit en leeg alle buffers. Als het probleem nu verdwijnt, heb je het niet opgelost, maar heb je de oorzaak blootgelegd.
Stap 5: Is het template de schuldige?
Templates zijn vaak de 'usual suspects'. Schakel even over naar het standaard Cassiopeia template. Werkt alles nu wel? Dan zit de fout in je template, een override of een stukje JavaScript.
Stap 6: Schakel extensies methodisch uit
Gooi niet de hele boel in één keer dicht. Schakel plugins één voor één uit, beginnend bij systeem- en content-plugins. Test na elke wijziging. Zodra het probleem weg is, heb je de boosdoener gevonden.
Stap 7: Controleer compatibiliteit
Stel jezelf de saaie vraag: is deze extensie eigenlijk wel geschikt voor deze versie van Joomla of PHP? Als een extensie al jaren niet is bijgewerkt, heeft Joomla je niet verraden; de extensie is simpelweg verouderd.
Stap 8: Rechten en paden
Vooral na een verhuizing kan er wat scheef zitten. Controleer of mappen op 755 staan en bestanden op 644. Check ook of de paden naar je /tmp en /logs mappen nog wel kloppen.
Stap 9: Reproduceer de fout
Als je de fout niet bewust kunt laten verschijnen, kun je hem ook niet fixen. Test in een andere browser, een privévenster of met een ander gebruikersaccount.
Stap 10: Vraag hulp met bewijsmateriaal
Kom je er echt niet uit? Als je hulp vraagt, geef dan direct de feiten: Joomla-versie, PHP-versie, de volledige foutmelding en wat je al geprobeerd hebt. "Mijn site doet het niet" is geen omschrijving, maar een bekentenis dat je bovenstaande stappen hebt overgeslagen.
Conclusie Joomla gaat zelden zomaar kapot. Het is meestal een niet-passende extensie, een vergeten override of een slordige update. Stop met gokken, start met debuggen. Of bel Welldotcom, dan is het zo geregeld.
Geen zin in technisch speurwerk?
Laten we eerlijk zijn: je bent waarschijnlijk liever bezig met je eigen business dan met het doorspitten van foutrapportages en PHP-logs. Als je website kuren vertoont, is dat precies het punt waar Welldotcom in beeld komt. Wij lossen het snel en nuchter voor je op, zodat jij weer verder kunt.
Of het nu gaat om een vage foutmelding na een update of een volledige witte pagina: wij zoeken het uit tot de onderste steen boven is. Neem contact met ons op en we maken er direct een punt van.
Bron: Dit artikel is een bewerking van A No-Nonsense Guide to Troubleshooting Joomla door Brian Teeman.
Kennis omzetten in resultaat?
Een informatief artikel is een goed startpunt. Maar de echte groei voor je bedrijf zit in de professionele uitvoering. Geen tijd of zin om zelf met de techniek, het ontwerp of de vindbaarheid van je website aan de slag te gaan? Als jouw partner nemen we dit werk graag volledig uit handen. Zo kun jij je focussen op wat echt telt: je onderneming.