Een PrestaShop-module installeren lijkt in theorie eenvoudig. In de praktijk loopt u, tussen modules van de addons-marketplace, aankopen op externe marketplaces, intern ontwikkelde modules en de eigenaardigheden van multistore, al snel tegen randgevallen aan. Deze gids behandelt de drie correcte installatiemethodes in 2026, de meest voorkomende fouten en de best practices waarmee u een draaiende productieshop niet breekt.
Voordat u begint: maak een back-up van uw shop
Deze stap is niet onderhandelbaar. Voordat u een module aan een productieshop toevoegt, moet u beschikken over een verse back-up van de database en de bestanden. Bij een serieuze hoster (o2switch, OVH, Cloudways) bestaat er al een automatische dagelijkse back-up. Controleer of die actueel is en of hij daadwerkelijk te herstellen valt.
De ideale aanpak is testen op een stagingomgeving die identiek is aan productie, en de installatie daarna herhalen. Heeft u geen staging, dan is een snelle database-export via de ingebouwde PrestaShop-tool beter dan niets.
Methode 1: installatie via de backoffice
Dit is de meest gebruikte en veiligste methode. Ze werkt voor elke module die als ZIP-bestand wordt geleverd, of die nu van de officiële addons-marketplace komt, van een externe marketplace of van een onafhankelijke ontwikkelaar.
- Log in op de PrestaShop-backoffice
- Ga naar Modules → Modulebeheer
- Klik op Module uploaden (rechtsboven)
- Sleep het ZIP-bestand naar het uploadveld of klik om het te selecteren
- Wacht op de bevestigingsmelding
- Klik op Configureren om de module-instellingen te openen
Eindigt de upload in een foutmelding over de bestandsgrootte, dan zijn uw PHP-directives te restrictief. Verhoog upload_max_filesize, post_max_size en memory_limit in php.ini of via .htaccess in de hoofdmap van PrestaShop. Redelijke waarden: 64M voor de eerste twee, 256M voor het geheugen.
Bijzonder geval: module vergrendeld door de PrestaShop Marketplace
Heeft u een module gekocht op addons.prestashop.com, dan is het ZIP-bestand soms beveiligd met een handtekening die inloggen op uw PrestaShop-account vereist. In dat geval verloopt de installatie via Modules → Modulecatalogus en de installatieknop die aan uw aankoop is gekoppeld. Dat is bewust zo: PrestaShop blokkeert op die manier ongeautoriseerde herdistributie.
Methode 2: installatie via FTP
Deze methode is nuttig in twee gevallen: het ZIP-bestand is te groot voor de PHP-limieten van uw hosting, of u installeert meerdere modules tegelijk en wilt sneller werken.
- Pak de ZIP van de module uit op uw computer
- U krijgt een map met de naam van de module (bijvoorbeeld
mijnmodule/) - Upload die map via FTP of SFTP naar
/modules/in de hoofdmap van PrestaShop - Ga terug naar Modules → Modulebeheer
- Zoek de module in de lijst en klik op Installeren
Let op: pak in de hoofdmap van PrestaShop geen archief uit dat zelf al het pad /modules/mijnmodule/ bevat. U riskeert bestaande bestanden te overschrijven. Controleer altijd de structuur van het archief voordat u het uitpakt.
Alternatief: FTP Explorer rechtstreeks in de backoffice
Gebruikt u de module FTP Explorer, dan kunt u modulebestanden rechtstreeks vanuit de backoffice uploaden, zonder externe FTP-client. Handig wanneer u onderweg werkt of geen toegang heeft tot FileZilla.
Methode 3: installatie via Composer (PrestaShop 9)
Deze methode geldt uitsluitend voor moderne modules die volgens de Symfony-standaarden zijn gebouwd, voorlopig vooral officiële modules en een deel van de developermodules. Composer haalt de module en zijn PHP-dependencies automatisch binnen.
cd /pad/naar/prestashop
composer require prestashop/module-nameDaarna activeert u de module in de backoffice zoals elke andere module. De officiële PrestaShop-documentatie vermeldt welke modules Composer-compatibel zijn. Voor externe modules (marketplaces, onafhankelijke ontwikkelaars) blijft methode 1 de norm.
De module configureren na installatie
Na de installatie blijft een module inactief totdat u hem configureert. Klik op Configureren naast de modulenaam om de instellingen te openen.
Serieuze modules leveren een overzichtelijke configuratiepagina met de belangrijkste parameters. Amateurmodules laten u alleen achter met een config.xml-bestand om handmatig te bewerken, en dat is een waarschuwingssignaal.
Veel modules vereisen ook de activering van een of meerdere hooks. Een hook is een aanhaakpunt op de pagina waar de module zijn content in injecteert. Een slidermodule moet zich bijvoorbeeld aan de hook displayHome koppelen om op de homepage te verschijnen. Controleer in Modules → Posities of de verwachte hooks actief zijn.
Testen op een stagingomgeving
Bij een shop met veel verkeer installeert u nooit rechtstreeks op productie. De volgorde die u het beste aanhoudt:
- Dupliceer de shop naar een stagingomgeving (dezelfde versies van PrestaShop, PHP en MySQL)
- Installeer de module op staging
- Test 24 tot 48 uur lang de kritieke paden: toevoegen aan winkelwagen, volledige checkout, betaling, multistore indien van toepassing
- Controleer de logs (Symfony, Apache, PHP). Een module kan aan de oppervlakte werken en tegelijkertijd stilletjes fouten op de achtergrond genereren
- Staat alles op groen, herhaal de installatie dan op productie buiten de piekuren
Veelvoorkomende fouten en hun oplossingen
“De module verschijnt niet in de lijst”
Drie mogelijke oorzaken: het archief is in de verkeerde map uitgepakt (controleer of het in /modules/modulenaam/ staat), de bestandsrechten kloppen niet (PHP-bestanden horen op 644, mappen op 755) of de backoffice-cache is verouderd. Om de cache te legen gaat u naar Geavanceerde instellingen → Prestaties en klikt u op Cache legen.
“Fout 500 na activering”
De module is waarschijnlijk niet compatibel met uw PrestaShop- of PHP-versie. Schakel hem uit door de modulemap via FTP te verwijderen en controleer daarna de versies op de productpagina. Compatibiliteit tussen PrestaShop 1.7 en 8 is de belangrijkste bron van conflicten.
“De module werkt, maar wordt niet weergegeven”
De hook is niet geactiveerd. Ga naar Modules → Posities, zoek de module in de lijst en controleer de gekoppelde hooks. Is er niets aangevinkt, koppel de module dan aan de hooks die in de documentatie worden aanbevolen.
“Conflict met een andere module”
Typisch symptoom: de module werkt op zichzelf, maar breekt zodra een tweede module wordt ingeschakeld. De oplossing loopt via de Symfony-logs (in var/logs/) en afwisselend uitschakelen om de boosdoener aan te wijzen. De meeste conflicten betreffen modules die dezelfde hooks of dezelfde templates aanpassen.
Best practices na installatie
Zodra de module is geïnstalleerd en geconfigureerd, twee reflexen:
- Documenteer: houd een bestand bij met de geïnstalleerde modules, hun versies en licenties. Bij een migratie of een supportaanvraag bespaart u uren.
- Werk regelmatig bij: de meeste gedocumenteerde beveiligingslekken in PrestaShop komen voort uit verouderde externe modules. Schakel updatenotificaties in via Modules → Meldingen.
En daarna?
Wilt u verder, bekijk dan onze catalogus met PrestaShop 8 modules per categorie: SEO, checkout, marketing en meer. Elke DataFirefly-module wordt geleverd met gedetailleerde installatiedocumentatie en technische ondersteuning.
Is de module eenmaal geïnstalleerd: al onze overzichten van PrestaShop modules per doel.
