Comment installer un module PrestaShop ?

Cela apparaît a priori simple, mais il y a plusieurs façons d’installer un module PrestaShop. Je vais vous en présenter plusieurs qui peuvent vous aider si une des solutions ne fonctionne pas.

Qu’est-ce qu’un module PrestaShop ?

Un module est une extension qui vient s’ajouter à votre PrestaShop pour ajouter de nouvelles fonctionnalités. Cela permet des ajouts à votre boutique en ligne sans modifier le cœur du CMS.

Il y a aussi des modules qui sont essentiels au bon fonctionnement de votre PrestaShop. Voici des exemples de module :

• Module de paiement PrestaShop (Payplug, PayPal, Stripe…)
• Module de livraison PrestaShop (Colissimo, Mondial Relay, Chronopost…)
• Module SEO (optimisation des balises, redirection, sitemap, rich snippets)
• Module marketing (newsletter, codes promo, avis clients, relance panier abandonné, etc.)

Tous ces modules peuvent être rangés dans différentes catégories :

• Les modules natifs : Déjà inclus avec PrestaShop par défaut (ex. : module de paiement par virement bancaire, module de recherche, compte et panier).
• Les modules gratuits : Téléchargeables depuis la communauté PrestaShop ou directement dans le back-office.
• Les modules premium (payants) : proposés sur la marketplace PrestaShop ou par des développeurs indépendants. Ils offrent souvent des fonctionnalités plus avancées, une sécurité supplémentaire et un support technique.

Pourquoi utiliser un module PrestaShop ?

Une des principales raisons d’utiliser un module qui remplit une fonction particulière est le gain de temps et d’argent. Cela vous évite de développer, ou de faire développer, une fonctionnalité spécifique, ce qui représenterait forcément un coût si elle devait être créée de A à Z.

Certains développeurs ou agences préfèrent concevoir leurs propres modules et fonctionnalités pour un projet client, afin de maîtriser totalement l’architecture et le fonctionnement du site. Cependant, dans la plupart des cas, il est plus judicieux d’utiliser un module déjà existant, bénéficiant de mises à jour régulières, de retours utilisateurs et offrant une meilleure pérennité dans le temps.

De manière générale, l’installation d’un module contribue à améliorer l’expérience utilisateur dans votre boutique en ligne grâce aux nouvelles fonctionnalités qu’il apporte. Cela peut inclure, par exemple :

• un moteur de recherche plus performant,
• un module de compression d’images,
• un outil d’optimisation pour le référencement naturel sur Google.

En pratique, il existe toujours un module capable d’enrichir votre boutique et de faciliter l’expérience d’achat de vos clients.

Les différentes méthodes pour installer un module PrestaShop

Je vais vous proposer plusieurs méthodes pour l’installation d’un module sur PrestaShop, de la plus simple à la plus compliquée.

Installer un module depuis le back-office de PrestaShop

Ceci est vraiment la méthode la plus simple. Il vous suffit de vous connecter à votre tableau de bord PrestaShop et d’aller dans l’onglet “Modules” et “Gestionnaire de modules“. À partir de là, vous avez un bouton en haut à droite qui permet d’ajouter un module. Il faut toujours importer le fichier au format ZIP.

Vous avez ensuite plus qu’à sélectionner votre fichier ZIP ou le faire glisser-déposer dans la fenêtre qui apparaît. Une fois cela réalisé, un pop-up vous informera que le module est bien installé et que vous pouvez le configurer directement.

Vous pouvez maintenant rechercher votre module dans la barre de recherche et ensuite le configurer, l’activer, le désinstaller, le réinitialiser.

Installation depuis la marketplace PrestaShop

Pour cette méthode, il vous faut déjà, depuis le point précédent, installer le module officiel de Marketplace PrestaShop.

Une fois installé, vous pouvez connecter votre compte Addons PrestaShop à votre boutique et vous retrouverez automatiquement le catalogue PrestaShop Addons dans votre boutique. Il faut bien associer votre boutique à votre compte addons.

Pour y accéder, rendez-vous également dans l’onglet Modules. Au-dessus du gestionnaire de modules, vous trouverez un accès intitulé, par exemple, « Marketplace ».

Depuis cet espace, vous pouvez gérer l’installation des modules que vous avez achetés. Vous y trouverez aussi des modules natifs gratuits que vous pouvez télécharger de nouveau, par exemple si vous en avez supprimé un par erreur.

Enfin, vous avez la possibilité de rechercher un module et de l’acheter directement depuis cette interface.

Installer un module PrestaShop par FTP

C’est une méthode avancée pour installer un module PrestaShop sur votre boutique. Plusieurs raisons peuvent justifier ce choix, par exemple :

• Un module trop volumineux ou un problème de “timeout” empêchant son installation via le back-office.
• Contourner certaines restrictions d’installation et éviter des contraintes techniques.
• Corriger une installation incomplète en ajoutant ou remplaçant des fichiers manquants.

Cette fois-ci, vous devez décompresser votre module afin d’obtenir le dossier correspondant.

Pour l’importer, connectez-vous à votre serveur via un logiciel FTP. Une fois à la racine de votre boutique en ligne, ouvrez le dossier « modules », qui contient l’ensemble des dossiers de chaque module installé sur votre site PrestaShop.

Glissez ensuite le dossier du module décompressé dans ce répertoire. ⚠️ Veillez à ne pas l’insérer dans un sous-dossier par erreur.

Une fois le transfert terminé, retournez dans votre back-office et accédez à l’onglet Modules : votre nouveau module devrait apparaître dans la liste, prêt à être installé ou configuré.

Vérifier le bon fonctionnement du module PrestaShop

C’est assez logique, mais une fois votre module importé, il est important de vérifier son bon fonctionnement. Concrètement, le module doit apparaître dans votre menu Modules, être visible dans la liste complète et pouvoir être configuré.

En cliquant sur le bouton correspondant, vous devez accéder à la page de configuration du module. Si une erreur survient à ce stade, elle devra être corrigée.

À noter que certains modules nécessitent des hooks (emplacements) fonctionnels dans PrestaShop. S’ils ne sont pas greffés automatiquement lors de l’installation, vous devrez les rattacher manuellement. Pour cela, n’hésitez pas à consulter la documentation officielle du module afin de suivre la procédure adaptée.

Problèmes fréquents et solutions

Il arrive parfois qu’un module ne puisse pas être installé correctement sur une boutique PrestaShop. Voici quelques causes fréquentes et leurs solutions.

Erreur lors de l’installation d’un module PrestaShop

Lors de l’installation d’un module, une pop-up de confirmation s’affiche normalement pour indiquer que tout est bien installé et que vous pouvez accéder à sa configuration.
Dans certains cas, cette pop-up peut signaler une erreur. Dans ce cas, PrestaShop vous recommande d’activer le mode debug afin d’identifier la source du problème.

⚠️ Attention : utilisez le mode debug avec précaution (j’en parle plus en détail dans un autre article).
En général, l’erreur affichée fournit des informations utiles pour corriger le dysfonctionnement. Si besoin, reportez-vous au support du module pour obtenir une assistance.

Module non compatible avec la version de PrestaShop

Aujourd’hui, nous en sommes à PrestaShop 9, mais il existe encore de nombreuses boutiques qui tournent sur des versions antérieures. Il est donc essentiel de télécharger un module adapté à la version que vous utilisez.

Certains modules sont compatibles avec plusieurs versions (par exemple, beaucoup de modules développés pour PrestaShop 1.7 fonctionnent également sur PrestaShop 8). Cependant, ce n’est pas toujours le cas. Il peut aussi exister des incompatibilités au sein d’une même version de PrestaShop.

👉 Si vous utilisez une ancienne version (par exemple, un PrestaShop 1.7 non mis à jour), vous pourriez avoir besoin d’une version antérieure du module.
Heureusement, la plupart des développeurs publient régulièrement des mises à jour de leurs modules pour suivre l’évolution de PrestaShop.

Cache à vider (Smarty, etc.)

Après l’installation d’un module, il peut arriver que celui-ci ne s’affiche pas correctement, notamment s’il intervient en front-office.
Dans ce cas, rendez-vous dans le menu Performances de votre back-office et videz le cache de votre boutique. Cela permet souvent de forcer l’apparition du module et d’afficher les modifications.

Compatibilité PHP/MySQL à vérifier

Un autre problème courant concerne la compatibilité avec la version de PHP ou de MySQL utilisée par votre serveur.

Exemple : PrestaShop 8 est conçu pour fonctionner avec PHP 8.1. Si le module que vous souhaitez installer n’est pas encore compatible avec cette version, cela peut provoquer des erreurs. Dans ce cas, il faut :

• vérifier les prérequis du module auprès de son éditeur,
• adapter la configuration de votre serveur,
• ou demander une mise à jour/correction au support du module.

Parfois, revenir temporairement à une version antérieure de PHP (compatible avec le module) peut être une solution provisoire.

Optez pour la bonne pratique et la sécurité

Au final, l’une des meilleures pratiques consiste à utiliser des modules développés par des éditeurs reconnus par la communauté, ou bien à passer directement par la Marketplace PrestaShop.
Certes, beaucoup de ces modules sont payants, mais ce coût est justifié : il vous garantit une installation plus simple sur votre boutique ainsi qu’un accès à un support en cas de problème.

De plus, vous aurez l’assurance de disposer de la version adaptée à votre PrestaShop, ce qui permet d’éviter de nombreux soucis de compatibilité. C’est également un gage de sécurité et de qualité quant à la manière dont le module est codé.

Je vous souhaite à tous une bonne installation de vos modules PrestaShop !