Installer un module PrestaShop depuis un fichier ZIP : pas à pas, et que faire quand ça échoue
Installer un module PrestaShop depuis un fichier ZIP prend trois clics dans Modules → Gestionnaire de modules : le bouton d’envoi, le choix du fichier, la configuration. En cas d’erreur, la cause est en général la construction du paquet, une limite de taille de fichier sur le serveur ou une version incompatible avec votre boutique. Avant d’installer, sauvegardez la boutique et vérifiez l’origine du paquet.
Auteur: L’équipe TellMyShop. Un guide pour les propriétaires de boutiques PrestaShop : la cause, la correction manuelle et le même travail dans une conversation avec le chat.
Dernière mise à jour: · 7 min de lecture
Quoi vérifier avant d’installer un module
Un module est du code qui tourne sur votre serveur et qui a accès à la base de données de la boutique. Cinq minutes de vérification avant l’installation coûtent moins cher que les réparations après.
- La source. Téléchargez le module chez son auteur, sur Addons ou depuis une version publiée par l’auteur sur GitHub. Les copies gratuites de modules payants trouvées sur des sites au hasard sont une voie fréquente d’entrée de code malveillant dans une boutique.
- La compatibilité avec la version de votre boutique. La description du module indique les versions de PrestaShop et de PHP sur lesquelles il fonctionne. Vous voyez la version de votre boutique dans Paramètres avancés → Informations.
- Si vous avez déjà un module qui fait la même chose. Deux modules d’avis ou deux modules de livraison sont une cause fréquente de conflits.
- La sauvegarde. Une sauvegarde des fichiers et de la base de données chez votre hébergeur ou avec un module de sauvegarde. Sans elle, chaque erreur coûte cher.
- Le moment. Installez quand la boutique est calme. Essayez d’abord les modules de paiement et de livraison sur une copie de préproduction.
Comment installer un module depuis un fichier ZIP
Le back office de PrestaShop 8 et 9 a un formulaire pour cela dans le Gestionnaire de modules. Le guide PrestaShop sur les modules décrit l’écran des modules en général.
- Allez dans Modules → Gestionnaire de modules.
- Cliquez sur le bouton d’installation d’un module en haut de la page.
- Faites glisser le fichier ZIP dans le cadre ou choisissez-le sur votre ordinateur. Ne le décompressez pas avant.
- Attendez le message d’installation. Avec les gros modules, cela prend quelques dizaines de secondes.
- Cliquez sur Configurer et réglez le module en suivant les instructions de l’auteur.
- Ouvrez la boutique dans une fenêtre de navigation privée. Vérifiez la page d’accueil, une fiche produit et le panier.
- Regardez dans Paramètres avancés → Logs si de nouvelles erreurs sont apparues après l’installation.
La mise à jour depuis un ZIP se fait de la même façon : vous envoyez une version plus récente du même module. PrestaShop reconnaît que le module est déjà là, remplace les fichiers et lance les scripts de mise à jour.
À quoi faire attention en mettant à jour un module
Une mise à jour est plus qu’un échange de fichiers. Une nouvelle version peut modifier des tables de la base de données, ajouter de nouveaux emplacements sur la page ou changer des réglages par défaut.
- Lisez le journal des modifications de l’auteur. Cherchez les phrases sur la version de PHP requise, les nouveaux réglages et les changements de modèles.
- Vérifiez si votre thème a une copie du modèle du module. Si c’est le cas, la nouvelle version du module peut s’afficher autrement que dans la description de l’auteur, ou ne pas montrer du tout les nouveaux éléments.
- Mettez à jour les modules de paiement et de livraison en dehors des heures d’achat. Passez une commande de test après la mise à jour.
- Ne sautez pas plusieurs versions d’un coup sans sauvegarde. Les scripts de mise à jour sont souvent écrits en pensant à la version précédente.
Les erreurs les plus fréquentes à l’installation d’un module
| Message ou symptôme | Cause | Que faire |
|---|---|---|
| le module est invalide, ou le fichier ne ressemble pas à un zip de module valide | le ZIP ne contient pas de dossier de module avec un fichier du même nom | décompressez sur votre ordinateur ; à l’intérieur, il doit y avoir un seul dossier, par ex. monmodule/monmodule.php |
| la même erreur avec un paquet venant d’Addons | le ZIP téléchargé contient le module, la documentation et la licence dans une seule archive | décompressez-le et n’envoyez que le ZIP intérieur du module |
| l’envoi se termine par une erreur sans description | le fichier dépasse la limite d’envoi du serveur | faites relever la limite par votre hébergeur ou envoyez le module par FTP |
| le module n’est pas compatible avec la version de votre boutique | l’auteur a défini une plage de versions de PrestaShop dans le module | téléchargez la version du module pour votre PrestaShop |
| une page blanche ou une erreur 500 après l’installation | le module exige une autre version de PHP ou entre en conflit avec un autre module | désactivez le module, lisez le journal d’erreurs |
| pas de droit d’écriture | le serveur ne permet pas d’écrire dans le dossier des modules | demandez à votre hébergeur de régler les bons droits sur le dossier |
La documentation PrestaShop sur la structure des modules décrit comment est construit un paquet correct : le dossier du module porte le même nom que le module, et le module doit se trouver dans un sous-dossier du ZIP. Les développeurs de PrestaShop ont décrit le problème des paquets trop gros dans la spécification des alertes du Gestionnaire de modules, avec les réglages PHP qui en sont responsables.
Si la boutique ne s’affiche pas après l’installation, commencez par l’article sur l’erreur 500 PrestaShop. Si le module fonctionne mais casse quelque chose, désactivez-le au lieu de le désinstaller, comme nous le décrivons dans l’article sur la désactivation d’un module.
Comment installer ou mettre à jour un module via le chat
Vous donnez à votre chat (Claude ou ChatGPT) un lien https direct vers le fichier ZIP, par exemple vers une version publiée sur GitHub ou vers un fichier de l’auteur. Le chat télécharge d’abord le paquet pour un aperçu et le vérifie avant que quoi que ce soit n’arrive dans la boutique : le nom et la version du module, la source, la somme de contrôle SHA-256 et la structure du paquet. Vous ne pouvez pas envoyer un fichier depuis votre ordinateur de cette façon : il faut un lien.
Vous: Mets à jour le module de paiement en 2.4.1 depuis ce lien de version GitHub. Vérifie la boutique avant et après.
Votre chat: Aperçu du paquet : module de paiement, version installée 2.3.0, version du paquet 2.4.1. Source : la version publiée par l’auteur sur GitHub. Structure correcte, un seul dossier de module. La somme de contrôle SHA-256 figure dans l’aperçu : vous pouvez la comparer à celle publiée par l’auteur.
Avant la mise à jour, je sauvegarde les fichiers du module. Je ne peux pas annuler depuis l’historique les modifications de la base de données faites par le script de mise à jour ; c’est à cela que sert la sauvegarde de la base de données du jour. Pour l’instant, les logs ne contiennent aucune erreur de ce module. Je mets à jour ?
Vous: Oui.
Votre chat: Mis à jour en 2.4.1. Le panier et la page de commande répondent correctement, et il n’y a pas de nouvelles erreurs dans les logs.
Statut de la carte : attend votre « oui »ancienne version : version 2.3.0
nouvelle version : version 2.4.1
Les numéros de version de l’exemple sont donnés à titre d’illustration. Un exemple de demande se trouve dans le cas d’usage installer ou mettre à jour un module depuis un paquet ZIP, et si quelque chose cesse de fonctionner après la modification, dans le cas d’usage désactiver un module qui casse le panier.
TellMyShop Pro installe et met à jour des modules une fois l’interrupteur Modules activé dans le panneau du module. L’interrupteur reste actif 24 heures et exige une sauvegarde de la base de données faite le même jour. Le chat n’installe rien sans aperçu et sans votre accord, et il déconseillera un module d’une source incertaine. La désinstallation d’un module ne peut pas être annulée : le chat propose donc d’abord de le désactiver. Dans la version gratuite TellMyShop Free, vous voyez la liste des modules avec leurs versions et les emplacements où ils s’affichent. Une comparaison des versions se trouve sur la page tarifs, et nous parlons du ménage dans les anciens modules dans l’article sur les modules inutilisés.
Questions et réponses
Où installer un module depuis un fichier ZIP dans PrestaShop ?
Dans le menu Modules, dans le Gestionnaire de modules. En haut de la page se trouve un bouton pour installer un module, où vous faites glisser le fichier ZIP ou le choisissez sur votre ordinateur. Une fois le fichier envoyé, PrestaShop installe le module et propose de le configurer.
Que signifie le message indiquant que le module est invalide ?
Le plus souvent, PrestaShop n’a pas trouvé dans le paquet un dossier de module contenant un fichier du même nom. Vous avez peut-être téléchargé un paquet avec la documentation au lieu du module, une archive contenant plusieurs modules, ou un ZIP emballé dans un autre ZIP. Décompressez le paquet sur votre ordinateur et vérifiez ce qu’il contient.
Mettre à jour un module depuis un ZIP supprime-t-il ses réglages ?
En général, non. Quand vous envoyez une version plus récente du même module, PrestaShop remplace les fichiers et lance les scripts de mise à jour du module. Les réglages restent, mais les scripts peuvent modifier la base de données. Sauvegardez donc la boutique avant la mise à jour, et testez-la idéalement sur une copie de préproduction.
Peut-on annuler l’installation d’un module ?
Vous pouvez désactiver ou désinstaller un nouveau module. La désinstallation supprime en général ses données et ses réglages : elle ne peut donc pas être annulée. Avec une mise à jour, les fichiers peuvent être restaurés depuis une sauvegarde, mais vous ne pouvez pas revenir sur les modifications de la base de données faites par le script de mise à jour sans sauvegarde de la base.
TellMyShop Free peut-il installer un module ?
Non. La version gratuite TellMyShop Free ne lit que les rapports de la boutique, y compris la liste des modules avec leurs versions. TellMyShop Pro installe et met à jour des modules depuis un paquet ZIP une fois l’interrupteur Modules activé pour 24 heures.
PrestaShop est une marque déposée de PrestaShop SA. Claude est une marque d’Anthropic PBC. ChatGPT et OpenAI sont des marques d’OpenAI. TellMyShop n’est pas affilié à ces entreprises.