PrestaShop module installeren vanuit een ZIP-bestand: stap voor stap en wat je doet als het mislukt
Een PrestaShop-module installeren vanuit een ZIP-bestand kost drie klikken onder Modules → Modulebeheer: de uploadknop, het bestand kiezen en de configuratie. Bij een fout ligt de oorzaak meestal aan de opbouw van het pakket, een uploadlimiet op de server, of een moduleversie die niet bij je webshop past. Maak vooraf een back-up van de webshop en controleer waar het pakket vandaan komt.
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
Wat je controleert voordat je een module installeert
Een module is code die op je server draait en toegang heeft tot de database van de webshop. Vijf minuten controleren voor het installeren is goedkoper dan achteraf repareren.
- Bron. Download de module bij de maker, op Addons of bij de release van de maker op GitHub. Gratis kopieën van betaalde modules van willekeurige sites zijn een veelvoorkomende manier waarop kwaadaardige code in een webshop komt.
- Compatibiliteit met je versie van de webshop. De modulebeschrijving noemt de PrestaShop- en PHP-versies waarop ze draait. De versie van je webshop zie je onder Geavanceerde parameters → Informatie.
- Of je al een module hebt die hetzelfde doet. Twee reviewmodules of twee verzendmodules zijn een veelvoorkomende oorzaak van conflicten.
- Back-up. Een back-up van de bestanden en de database bij je host of met een back-upmodule. Zonder back-up is elke fout duur.
- Tijdstip. Installeer als het rustig is in de webshop. Probeer betaal- en verzendmodules eerst op een testkopie.
Zo installeer je een module vanuit een ZIP-bestand
De backoffice van PrestaShop 8 en 9 heeft hiervoor een formulier in Modulebeheer. De handleiding van PrestaShop over modules beschrijft het modulescherm in het algemeen.
- Ga naar Modules → Modulebeheer.
- Klik bovenaan de pagina op de knop om een module te uploaden.
- Sleep het ZIP-bestand naar het vak of kies het van je computer. Pak het niet eerst uit.
- Wacht op de melding van de installatie. Bij grotere modules duurt dat enkele tientallen seconden.
- Klik op Configureren en stel de module in volgens de instructies van de maker.
- Open de webshop in een privévenster. Controleer de homepage, een productpagina en de winkelwagen.
- Kijk in Geavanceerde parameters → Logs of er na de installatie nieuwe fouten zijn verschenen.
Bijwerken vanuit een ZIP werkt op dezelfde manier: je uploadt een nieuwere versie van dezelfde module. PrestaShop herkent dat de module er al is, vervangt de bestanden en voert de upgradescripts uit.
Waar je op let bij het bijwerken van een module
Een update is meer dan bestanden vervangen. Een nieuwe versie kan databasetabellen wijzigen, nieuwe plekken op de pagina toevoegen of standaardinstellingen veranderen.
- Lees het wijzigingslog van de maker. Zoek naar zinnen over de vereiste PHP-versie, nieuwe instellingen en wijzigingen in templates.
- Controleer of je thema een kopie van het template van de module heeft. Zo ja, dan kan de nieuwe moduleversie er anders uitzien dan de beschrijving van de maker, of de nieuwe elementen helemaal niet tonen.
- Werk betaal- en verzendmodules bij buiten de winkeluren. Plaats na de update een testbestelling.
- Spring zonder back-up niet meerdere versies tegelijk. Upgradescripts zijn vaak geschreven met de vorige versie in gedachten.
De meest voorkomende fouten bij het installeren van een module
| Melding of symptoom | Oorzaak | Wat je doet |
|---|---|---|
| de module is ongeldig, of het bestand lijkt geen geldige module-zip | de ZIP heeft geen modulemap met een bestand met dezelfde naam | pak uit op je computer; erin hoort één map te staan, bijv. mymodule/mymodule.php |
| dezelfde fout met een pakket van Addons | de gedownloade ZIP bevat de module, documentatie en licentie in één archief | pak het uit en upload alleen de binnenste ZIP van de module |
| het uploaden eindigt met een fout zonder beschrijving | het bestand is groter dan de uploadlimiet van de server | laat je host de limiet verhogen of upload de module via FTP |
| de module is niet compatibel met je versie van de webshop | de maker heeft een bereik van PrestaShop-versies in de module vastgelegd | download de moduleversie voor jouw PrestaShop |
| een lege pagina of een 500 error na de installatie | de module heeft een andere PHP-versie nodig of botst met een andere module | schakel de module uit, lees het foutenlog |
| geen schrijfrechten | de server staat schrijven in de map modules niet toe | vraag je host de juiste mapmachtigingen in te stellen |
De PrestaShop-documentatie over de opbouw van modules beschrijft hoe een correct pakket eruitziet: de modulemap heeft dezelfde naam als de module, en de module in de ZIP moet in een submap staan. De ontwikkelaars van PrestaShop beschreven het probleem van te grote pakketten in de specificatie van de meldingen in Modulebeheer, samen met de PHP-instellingen die ervoor verantwoordelijk zijn.
Toont de webshop na de installatie niets meer, begin dan met het bericht over de PrestaShop 500 error. Werkt de module maar breekt ze iets, schakel haar dan uit in plaats van te deïnstalleren, zoals we beschrijven in het bericht over een module uitschakelen.
Zo installeer of werk je een module bij via de chat
Je geeft je chat (Claude of ChatGPT) een directe https-link naar het ZIP-bestand, bijvoorbeeld naar een release op GitHub of naar een bestand van de maker. De chat downloadt het pakket eerst voor een voorbeeld en controleert het voordat er iets in de webshop komt: de naam en versie van de module, de bron, de SHA-256-controlesom en de opbouw van het pakket. Een bestand van je computer uploaden kan op deze manier niet; er is een link nodig.
Jij: Werk de betaalmodule bij naar 2.4.1 vanaf deze release-link op GitHub. Controleer de webshop voor en na.
Je chat: Voorbeeld van het pakket: betaalmodule, geïnstalleerde versie 2.3.0, pakketversie 2.4.1. Bron: de release van de maker op GitHub. Opbouw correct, één modulemap. De SHA-256-controlesom staat in het voorbeeld, zodat je hem kunt vergelijken met die van de maker.
Voor het bijwerken maak ik een back-up van de modulebestanden. Databasewijzigingen van het upgradescript kan ik niet vanuit de geschiedenis terugdraaien; daarvoor is de databaseback-up van vandaag. Op dit moment heeft het log geen fouten van deze module. Bijwerken?
Jij: Ja.
Je chat: Bijgewerkt naar 2.4.1. De winkelwagen en de bestelpagina reageren correct, en er staan geen nieuwe fouten in het log.
Status van de kaart: wacht op jouw “ja”oude versie: versie 2.3.0
nieuwe versie: versie 2.4.1
De versienummers in het voorbeeld zijn ter illustratie. Een voorbeeldverzoek staat in de use case een module installeren of bijwerken vanuit een ZIP-pakket, en werkt er na de wijziging iets niet meer, in de use case een module uitschakelen die de winkelwagen breekt.
TellMyShop Pro installeert en werkt modules bij zodra de schakelaar Modules in het modulepaneel aanstaat. De schakelaar werkt 24 uur en vereist een databaseback-up van dezelfde dag. De chat installeert niets zonder voorbeeld en jouw akkoord, en raadt een module uit een onzekere bron af. Een module deïnstalleren kun je niet ongedaan maken, dus de chat stelt eerst uitschakelen voor. In de gratis versie TellMyShop Free zie je de lijst met modules met hun versies en de plekken waar ze worden getoond. Een vergelijking van de versies staat op de pagina prijzen, en het opruimen van oude modules bespreken we in het bericht over ongebruikte modules.
Vragen en antwoorden
Waar installeer ik in PrestaShop een module vanuit een ZIP-bestand?
In het menu Modules, in Modulebeheer. Bovenaan de pagina staat een knop om een module te uploaden, waar je het ZIP-bestand naartoe sleept of het van je computer kiest. Na het uploaden installeert PrestaShop de module en biedt het aan om haar te configureren.
Wat betekent de melding dat de module ongeldig is?
Meestal vond PrestaShop in het pakket geen modulemap met een bestand met dezelfde naam. Misschien heb je een pakket met documentatie gedownload in plaats van de module, een archief met meerdere modules erin, of een ZIP in een andere ZIP. Pak het pakket uit op je computer en kijk wat erin zit.
Verwijdert het bijwerken van een module vanuit een ZIP haar instellingen?
Meestal niet. Upload je een nieuwere versie van dezelfde module, dan vervangt PrestaShop de bestanden en voert het de upgradescripts van de module uit. De instellingen blijven, maar de scripts kunnen de database wijzigen. Maak daarom voor het bijwerken een back-up van de webshop, en test het het liefst op een testkopie.
Kan ik een module-installatie ongedaan maken?
Een nieuwe module kun je uitschakelen of deïnstalleren. Deïnstalleren verwijdert meestal haar gegevens en instellingen, dus dat is niet terug te draaien. Bij een update kun je de bestanden uit een back-up terugzetten, maar databasewijzigingen van het upgradescript draai je zonder databaseback-up niet terug.
Kan TellMyShop Free een module installeren?
Nee. De gratis versie TellMyShop Free leest alleen rapporten over de webshop, waaronder de lijst met modules en hun versies. TellMyShop Pro installeert en werkt modules bij vanuit een ZIP-pakket zodra de schakelaar Modules voor 24 uur aanstaat.
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.