PrestaShop module uitschakelen: vind de module die je webshop breekt
Een PrestaShop-module uitschakelen is de veiligste manier om een module die je webshop breekt stil te zetten. De module werkt niet meer, maar haar instellingen en gegevens blijven bestaan, dus je kunt haar met één klik weer inschakelen. De boosdoener vind je in het foutenlog en in de volgorde van recente updates. Verwijderen komt als laatste, omdat het de gegevens van de module weghaalt.
Auteur: Het TellMyShop-team. Een gids voor eigenaren van PrestaShop-winkels: de oorzaak, de oplossing met de hand en hetzelfde werk in een gesprek met de chat.
Laatst bijgewerkt: · 6 min lezen
Hoe ziet een module eruit die de webshop breekt?
Het begint meestal op dezelfde manier. Gisteren werkte iets, vandaag niet, en ertussen heeft iemand iets bijgewerkt. Donderdag, 14:15. Een klant stuurt een schermafbeelding van een productpagina: de reviews staan er twee keer, onder elkaar, en de sterren naast de naam zijn weg. Vanochtend heb je een nieuwe reviewmodule geïnstalleerd, omdat de oude geen reviewverzoeken verstuurde. Niemand heeft de oude uitgeschakeld.
De symptomen van een moduleconflict zijn herkenbaar. De pagina laadt, maar één element reageert niet. Een productpagina toont een blok twee keer. De winkelwagen rekent verkeerd of toont geen vervoerder. In het ergste geval eindigt de pagina in een 500 error. Begin dan met het bericht over de PrestaShop 500 error, want daar telt elke minuut.
Uitschakelen, deïnstalleren of verwijderen?
Zoek je de oorzaak, schakel dan altijd uit. De andere twee handelingen kun je niet terugdraaien.
| Handeling | Wat er gebeurt | Gegevens van de module | Weg terug |
|---|---|---|---|
| Uitschakelen | de module werkt niet meer in de webshop | blijven bewaard | één klik op “Inschakelen” |
| Deïnstalleren | PrestaShop verwijdert de instellingen, inhoud en tabellen van de module | verwijderd | alleen uit een databaseback-up |
| Verwijderen | ook de bestanden van de module worden van de server gehaald | verwijderd | opnieuw installeren en vanaf nul configureren |
| De map hernoemen via FTP | noodoplossing om de module over te slaan als de backoffice niet werkt | blijven bewaard | de naam terugzetten |
In de backoffice schakel je een module uit in Modules > Modulebeheer, in het menu naast de knop Configureren. Onthoud bij betaal- en verzendmodules dat klanten die methode meteen kwijt zijn.
Zo vind je de module die je webshop breekt
Begin bij de foutmelding, en schakel pas daarna modules een voor een uit.
- Schrijf op wat er veranderd is. Welke modules je hebt bijgewerkt, of de PHP-versie is veranderd, of iemand het thema heeft bewerkt. De laatste wijziging is verdachte nummer één.
- Lees het log. Geavanceerde parameters > Logs toont fouten met een datum. De melding wijst vaak naar een bestand in de map
modules/module_name. Dit scherm staat beschreven in de documentatie over logs. - Schakel de meest verdachte module uit. Maar één. Controleer de webshop in een privévenster van de browser.
- Werkt het nog steeds niet, schakel haar dan weer in en schakel de volgende uit. Schakel je meerdere modules tegelijk uit, dan weet je moeilijk welke de schuldige was.
- Controleer overrides. Overschrijven twee modules dezelfde klasse, dan werkt elk op zichzelf, maar niet samen. In Geavanceerde parameters > Prestaties kun je alle overrides even uitzetten en kijken of het probleem verdwijnt. Wat overrides zijn en waarom ze problemen geven, legt de ontwikkelaarsdocumentatie uit.
- Meld de fout bij de ontwikkelaar. Stuur de tekst van de melding, de PrestaShop-versie, de PHP-versie en de moduleversie. Zonder die gegevens moet de ontwikkelaar gokken.
Knowband heeft de typische oorzaken van conflicten na een upgrade van de webshop verzameld in zijn handleiding over modules. Webwinkeliers beschrijven vergelijkbare verhalen op het PrestaShop-forum (in het Pools).
Zo vind en schakel je de foute module uit in één gesprek
Je beschrijft het symptoom, en je chat (Claude of ChatGPT) met de TellMyShop-module controleert welke modules op die plek van de pagina draaien, leest het log en wijst de meest waarschijnlijke module aan. Hij toont het uitschakelen in een voorbeeld en voert het pas uit na jouw goedkeuring.
Jij: De reviews staan dubbel op de productpagina sinds ik een nieuwe reviewmodule heb toegevoegd. Kijk wat daar wordt getoond en schakel de oude module uit, maar verwijder haar niet.
Je chat: Onder de productbeschrijving zijn twee reviewmodules gekoppeld: de nieuwe, vandaag geïnstalleerd, en de oude, al twee jaar ingeschakeld. Beide voegen hetzelfde blok toe, vandaar de dubbele reviews. Het log heeft geen fouten. De oorzaak is twee modules die hetzelfde doen.
Reviews die de oude module heeft verzameld, blijven in de database. De nieuwe module ziet ze meestal niet, omdat ze reviews in haar eigen tabellen bewaart. Uitschakelen?
Jij: Ja.
Je chat: Uitgeschakeld. Ververs de productpagina in een privévenster van de browser. Zie je de sterren nog steeds niet, dan kijk ik waar de nieuwe module ze toont.
Status van de kaart: wacht op jouw “ja”Voorbeeld van de wijziging:
oude versie: Oude reviewmodule: ingeschakeld
nieuwe versie: Oude reviewmodule: uitgeschakeld
Het log en de modulelijst lezen werkt in de gratis TellMyShop Free, dus je krijgt de diagnose zonder iets te kopen. Een voorbeeld van zo’n verzoek is foutmeldingen na een module-update. Het uitschakelen zelf vereist TellMyShop Pro en de schakelaar Modules. Die staat na de installatie uit, en je zet hem in het modulepaneel aan voor 24 uur. Dezelfde aanpak werkt als de winkelwagen breekt, zoals beschreven in de use case een module uitschakelen die de winkelwagen breekt.
Uitschakelen duurt meestal tien seconden tot iets minder dan een minuut, omdat PrestaShop zijn cache opnieuw opbouwt. Je kunt het ongedaan maken vanuit de wijzigingsgeschiedenis. De chat schakelt de TellMyShop-module niet uit, want daarmee praat hij met je webshop. Deïnstalleren kan, maar daarvoor moet de exacte naam van de module worden ingetypt en het is niet terug te draaien, dus de chat stelt eerst uitschakelen voor.
Wanneer is uitschakelen niet genoeg?
Blijft het probleem nadat je de verdachte module hebt uitgeschakeld, dan ligt de oorzaak ergens anders. Er zijn drie typische situaties.
De eerste is een override die een andere module heeft achtergelaten, bijvoorbeeld een die met een fout is gedeïnstalleerd. Een bestand in de map override verandert nog steeds hoe PrestaShop werkt, ook al is de module weg. Zo’n bestand controleren en verwijderen is werk voor een ontwikkelaar.
De tweede is een wijziging in het thema. De module kan een kopie van haar template in het thema hebben, en die kopie breekt, niet de module zelf. Controleer de map modules in de themamap.
De derde is een wijziging aan de kant van de server. De host kan bijvoorbeeld in dezelfde nacht waarin jij de modules bijwerkte, zijn overgestapt op een nieuwe PHP-versie. Dan wijst het foutenlog naar meerdere modules tegelijk, niet naar één. Vraag je host wat er op de server is veranderd.
Wat als de uitgeschakelde module nodig was?
Spreek een oplossing af met de ontwikkelaar en werk tot dan zonder de module of met een vervanger. Brengt de ontwikkelaar een nieuwe versie uit, werk de module dan bij, schakel haar in en controleer de plek die brak. Loop de volgende dag het log nog eens na.
Blijkt de module na een week uitgeschakeld te zijn overbodig, dan kun je haar deïnstalleren. Hoe je dat zonder verrassingen doet, beschrijven we in het bericht over ongebruikte PrestaShop-modules.
Vragen en antwoorden
Wat is het verschil tussen een module uitschakelen en verwijderen?
Een uitgeschakelde module werkt niet meer, maar haar instellingen, inhoud en databasetabellen blijven bestaan. Je schakelt haar met één klik weer in en alles komt terug. Verwijderen haalt de gegevens van de module weg: configuratie, inhoud van banners, soms hele tabellen. Dat maak je zonder databaseback-up niet ongedaan, dus als je de boosdoener zoekt, schakel je altijd alleen uit.
Wat is een moduleconflict in PrestaShop?
Dat is wanneer twee modules hetzelfde deel van de webshop wijzigen en elkaar in de weg zitten. Meestal overschrijven beide dezelfde PrestaShop-klasse, of haken ze in op hetzelfde element van de pagina en laden ze scripts die botsen. Elk werkt op zichzelf, maar samen breken ze de winkelwagen of de productpagina. Een van beide uitschakelen en met de ontwikkelaars praten helpt.
Is het veilig om een betaalmodule uit te schakelen?
De gegevens van de module blijven bestaan, maar klanten verliezen die betaalmethode meteen. Is het je enige online betaling, dan verkoopt de webshop praktisch niets meer. Controleer voor het uitschakelen of er een andere methode overblijft, en pak het probleem snel weer op. Hetzelfde geldt voor verzendmodules: de vervoerder verdwijnt uit de winkelwagen.
Hoe controleer ik welke modules op de productpagina draaien?
Open in de backoffice Uiterlijk > Posities en kies een plek op de pagina, bijvoorbeeld het blok onder de productbeschrijving. De lijst toont de modules die daar zijn gekoppeld, in de volgorde van weergave. Zie je daar twee modules die hetzelfde doen, bijvoorbeeld twee reviewsystemen, dan heb je je eerste kandidaat om uit te schakelen.
Kan ik in een gesprek vragen om een module uit te schakelen?
Ja, in TellMyShop Pro, zodra je de schakelaar Modules aanzet. De schakelaar werkt 24 uur en vereist een databaseback-up van dezelfde dag. De chat laat zien wat er verandert, waarschuwt je bij betaal- en verzendmodules en wacht op jouw goedkeuring. Het uitschakelen kun je ongedaan maken vanuit de wijzigingsgeschiedenis. De chat stelt verwijderen niet als eerste stap voor.
PrestaShop is een geregistreerd handelsmerk van PrestaShop SA. Claude is een handelsmerk van Anthropic PBC. ChatGPT en OpenAI zijn handelsmerken van OpenAI. TellMyShop is niet gelieerd aan deze bedrijven.