Installer un module PrestaShop semble simple en théorie. En pratique, entre les modules téléchargés depuis l’addon store, ceux achetés sur des marketplaces tierces, ceux développés en interne et les contraintes spécifiques du multi-boutique, on rencontre vite des cas particuliers. Ce guide couvre les trois méthodes d’installation valides en 2026, les erreurs les plus fréquentes, et les bonnes pratiques pour ne pas casser une boutique en production.
Avant de commencer : sauvegarder votre boutique
Cette étape n’est pas négociable. Avant tout ajout de module sur une boutique en production, vous devez disposer d’une sauvegarde fraîche de la base de données et des fichiers. Si vous utilisez un hébergeur sérieux (o2switch, OVH, Cloudways), une sauvegarde quotidienne automatique existe déjà — vérifiez qu’elle est récente et qu’elle est restaurable.
L’idéal reste de tester sur un environnement de pré-production identique à votre production, puis de répliquer l’installation. Si vous n’avez pas de staging, un export rapide via l’outil PrestaShop d’exportation de la base de données est mieux que rien.
Méthode 1 : installation via le back-office
C’est la méthode la plus courante et la plus sûre. Elle fonctionne pour tous les modules livrés sous forme de fichier ZIP — qu’ils viennent de l’addon store officiel, d’une marketplace tierce ou d’un développeur indépendant.
- Connectez-vous au back-office PrestaShop
- Allez dans Modules → Gestionnaire de modules
- Cliquez sur Installer un module (en haut à droite)
- Glissez votre fichier ZIP dans la zone de dépôt, ou cliquez pour le sélectionner
- Attendez le message de confirmation
- Cliquez sur Configurer pour accéder aux paramètres du module
Si l’upload échoue avec un message d’erreur de taille, vos directives PHP sont trop restrictives. Il faut augmenter upload_max_filesize, post_max_size et memory_limit dans votre php.ini ou via un fichier .htaccess à la racine de PrestaShop. Valeurs raisonnables : 64M pour les deux premiers, 256M pour la mémoire.
Cas particulier : module verrouillé par PrestaShop Marketplace
Si vous avez acheté votre module sur addons.prestashop.com, le ZIP est parfois protégé par une signature qui exige une connexion à votre compte PrestaShop. Dans ce cas, l’installation passe obligatoirement par Modules → Sélection et le bouton d’installation associé à votre achat. C’est volontaire — PrestaShop empêche ainsi la redistribution non autorisée.
Méthode 2 : installation par FTP
Cette méthode est utile dans deux cas : votre fichier ZIP est trop gros pour les limites PHP de votre hébergement, ou vous installez plusieurs modules d’un coup et vous voulez aller plus vite.
- Décompressez le ZIP du module sur votre poste
- Vous devez obtenir un dossier portant le nom du module (par exemple
monmodule/) - Uploadez ce dossier dans
/modules/à la racine de votre PrestaShop via FTP ou SFTP - Retournez dans Modules → Gestionnaire de modules
- Cherchez le module dans la liste et cliquez sur Installer
Attention : ne décompressez pas un ZIP qui contient déjà /modules/monmodule/ dans la racine de votre PrestaShop — vous risquez d’écraser des fichiers existants. Vérifiez toujours l’arborescence du ZIP avant l’extraction.
Alternative : Explorer FTP directement dans le back-office
Si vous utilisez Explorer FTP, vous pouvez uploader vos fichiers de modules directement depuis le back-office, sans client FTP externe. Pratique quand vous travaillez en mobilité ou que vous n’avez pas accès à FileZilla.
Méthode 3 : installation via Composer (PrestaShop 9)
Cette méthode concerne uniquement les modules modernes développés selon les standards Symfony — pour l’instant, principalement les modules officiels et certains modules développeur. Composer télécharge automatiquement le module et ses dépendances PHP.
cd /chemin/vers/prestashop
composer require prestashop/module-namePuis vous l’activez via le back-office comme un module classique. La documentation officielle PrestaShop liste les modules compatibles Composer. Pour les modules tiers (marketplaces, développeurs indépendants), la méthode 1 reste la norme.
Configurer un module après installation
Une fois installé, un module reste désactivé tant que vous ne l’avez pas configuré. Cliquez sur Configurer à côté du nom du module pour accéder à ses paramètres.
Les modules sérieux fournissent une page de configuration claire avec les paramètres essentiels. Les modules amateurs vous laissent seul devant un fichier config.xml à éditer — c’est un signe d’alerte.
Beaucoup de modules nécessitent également d’activer un ou plusieurs hooks. Un hook, c’est un emplacement dans la page où le module va injecter son contenu. Par exemple, un module de slider doit s’attacher au hook displayHome pour apparaître sur la page d’accueil. Vérifiez dans Modules → Positions que les hooks attendus sont activés.
Tester en environnement de staging
Sur une boutique à fort trafic, jamais d’installation directe en production. La séquence à respecter :
- Dupliquer la boutique en pré-production (mêmes versions PrestaShop, PHP, MySQL)
- Installer le module sur le staging
- Tester pendant 24 à 48 heures les parcours critiques : ajout au panier, checkout complet, paiement, multi-boutique si applicable
- Vérifier les logs (Symfony, Apache, PHP) — un module peut fonctionner en surface mais générer des erreurs silencieuses en arrière-plan
- Si tout est vert, répliquer l’installation en production hors heures de pointe
Les erreurs les plus fréquentes et leurs solutions
« Le module n’apparaît pas dans la liste »
Trois causes possibles : le ZIP a été décompressé dans le mauvais dossier (vérifiez qu’il est bien dans /modules/nomdumodule/), les permissions de fichiers sont incorrectes (les fichiers PHP doivent être en 644 et les dossiers en 755), ou le cache du back-office est obsolète. Pour vider le cache, allez dans Paramètres avancés → Performance et cliquez sur Vider le cache.
« Erreur 500 après activation »
Le module est probablement incompatible avec votre version de PrestaShop ou de PHP. Désactivez-le en supprimant le dossier du module via FTP, puis vérifiez les versions sur sa fiche produit. La compatibilité PrestaShop 1.7 vs 8 est la source numéro un d’incompatibilité.
« Le module fonctionne mais ne s’affiche pas »
Hook non activé. Allez dans Modules → Positions, trouvez votre module dans la liste, et vérifiez les hooks accrochés. Si rien n’est coché, accrochez-le aux hooks recommandés par sa documentation.
« Conflit avec un autre module »
Symptôme typique : un module marche seul, mais casse quand vous activez un second. La résolution passe par les logs Symfony (dans var/logs/) et par la désactivation alternée pour identifier le coupable. Les conflits les plus fréquents impliquent des modules qui modifient les mêmes hooks ou les mêmes templates.
Bonnes pratiques après installation
Une fois votre module installé et configuré, deux réflexes :
- Documenter — gardez un fichier listant les modules installés, leurs versions, leurs licences. En cas de migration ou de support, vous gagnez des heures.
- Mettre à jour régulièrement — la plupart des failles de sécurité PrestaShop documentées proviennent de modules tiers obsolètes. Activez les notifications de mise à jour dans Modules → Notifications.
Et après ?
Pour aller plus loin, explorez notre catalogue de modules PrestaShop 8 par catégorie : SEO, checkout, marketing et plus. Chaque module DataFirefly est livré avec une documentation d’installation détaillée et un support technique en français.