Optimisez votre boutique grâce à la
Marketplace Officielle de PrestaShop !

Comment installer un module PrestaShop

Installer un module depuis le panneau d'administration

Cette méthode est la plus simple, mais elle peut ne pas fonctionner dans certains cas. On utilisera alors la méthode manuelle présentée plus bas :

  • Dans l'onglet Modules , cliquez sur Ajouter un nouveau module

  • Si l'archive du module se trouve sur Internet, spécifiez l'URL de celui-ci dans le champ Module URL puis cliquez sur Télécharger ce module

  • Si l'archive se trouve sur votre ordinateur, cliquez sur Parcourir pour ouvrir la boîte de dialogue vous permettant de parcourir l'arborescence de votre disque, sélectionnez le fichier puis valider la boîte de dialogue.

  • Cliquez ensuite sur Télécharger ce module.

  • Si le message d'erreur suivant s'affiche :
    Message d'erreur
    C'est que l'extension PHP php_zip n'est pas installée sur ce serveur. Il vous faudra alors l'installer ou la faire installer par votre hébergeur.

  • En cas de succès de l'installation, un message l'indique :
    Succès de l'installation
    Le module apparaît alors dans la liste des modules de l'onglet Modules.

  • Cliquer sur le bouton Installer pour installer le module.
    Installer le module

  • Si la mention >> Configurer apparaît dans l'encart du module, cliquer dessus pour le configurer.
    Configurer le module

Attention
Si la boutique est en production, tant que le module n'a pas été configuré, il peut être bon de le désactiver en cliquant sur la coche verte, notamment s'il s'agit de modules de paiement. Une fois le module configuré, cliquer sur la croix rouge pour le réactiver.

Installer un module manuellement

Cette méthode est à utiliser si l'installation manuelle ne fonctionne pas. Elle peut sembler fastidieuse a priori pour les débutants, car faisant appel à un certain nombre de connaissances (FTP, etc.), néanmoins elle n'est pas plus complexe et peut même s'avérer plus pratique du fait qu'elle fonctionne à tous les coups.
De plus, les connaissances qu'elle demande sont des acquis élémentaires que tout gestionnaire de boutique devrait avoir.

Installer un logiciel de compression

Un module PrestaShop est fourni sous la forme d'un fichier archive au format ZIP. Une archive consiste en le regroupement de plusieurs dossiers et fichiers en un seul fichier, compressé ou non. Une archive est créée à l'aide d'un logiciel de compression et un tel logiciel est donc nécessaire pour réaliser l'opération inverse, c'est-à-dire extraire le contenu de l'archive pour pouvoir l'exploiter. Il existe de nombreux logiciels de compression, gratuits ou non. Pour extraire le contenu de notre module, nous allons utiliser le logiciel gratuit 7zip (prononcer "sevenzip").
Pour télécharger ce programme, rendez-vous à l'adresse http://www.7-zip.org/ et téléchargez la version qui vous correspond. Sous Windows, ce sera généralement la version .exe 32 bits. Une fois le fichier d'installation téléchargé, double-cliquez dessus pour lancer l'assistant d'installation.
Suivre les étapes de l'assistant d'installation jusqu'au bout. Il se peut qu'il faille redémarrer l'ordinateur.

Extraire l'archive

Un module est composé d'un dossier contenant lui-même les fichiers et dossiers constituant le module. Par exemple le module "Mon module" est constitué d'un dossier monmodule renfermant des fichiers et éventuellement d'autres dossiers (mails, img, js, etc.). L'ensemble est ensuite regroupé dans une archive au format ZIP (fichier compressé) ; par exemple mon_module.zip. Tous les modules PrestaShop sont ainsi fournis au format ZIP.
Il faut donc extraire le contenu de ce fichier mon_module.zip pour récupérer le dossier du module, car c'est uniquement de ce dossier et de son contenu que nous aurons besoin ensuite.

Note
Il peut dès lors survenir une confusion à laquelle beaucoup sont confrontés, faisant échouer cette installation manuelle. Ceci va dépendre de la façon dont l'archive est extraite.

Pour extraire l'archive :

Premier choix

Faire un clic droit sur l'archive du module (mon_module.zip).

Dans le menu contextuel qui apparaît, choisir : 7zip puis : Extraire vers "mon_module"

On obtient ici un dossier mon_module qui a été créé pour recevoir le contenu de l'archive.
Ce n'est pas ce dossier qui nous intéresse.

En ouvrant ce dossier, on trouve le dossier du module, monmodule. mon_module.
C'est ce dossier qu'il faudra transférer dans la boutique.

Deuxième choix

Faire un clic droit sur l'archive du module (mon_module.zip).

Dans le menu contextuel qui apparaît, choisir : 7zip puis : Extraire vers "mon_module"

On obtient ici un dossier mon_module qui a été créé pour recevoir le contenu de l'archive que l'on souhaite.

De façon générale, selon la façon dont le développeur a créé l'archive et la façon dont l'archive est extraite, le dossier du module peut se retrouver dans un ou plusieurs sous-dossiers. Dans tous les cas, on ignorera les dossiers parents pour ne prendre que celui contenant les fichiers du module.
Par exemple, dans l'illustration suivante, les dossiers dossier_1 à dossier_4 seront ignorés. C'est uniquement le dossier monmodule et son contenu que l'on utilisera.

Extraire l'archive

Transfert FTP

Le transfert du module sur le serveur de votre hébergeur se fait grâce à un protocole spécialement conçu pour le transfert de fichiers sur les réseaux, appelé FTP (File Transfert Protocol).
Pour ce faire, il y a deux possibilités :

  • soit votre hébergeur met à votre disposition, dans le panneau d'administration de votre hébergement, une interface vous permettant de réaliser le transfert FTP de votre module. Si c'est le cas, il vous faut maintenant vous y connecter et réaliser le transfert du module dans le dossier /modules de votre boutique,

  • soit il vous donne les codes d'accès du compte FTP de votre hébergement, et il vous faut alors utiliser un logiciel appelé "client FTP" afin de réaliser le transfert. C'est ce que nous allons voir ci-dessous.

Certains hébergeurs peuvent proposer ces deux solutions simultanément. A vous de choisir celle qui vous convient le mieux.

Installer un client FTP

L'un des clients FTP gratuits les plus populaires est FileZilla. Pour le télécharger, rendez-vous à l'adresse http://filezilla-project.org/download.php?type=client et téléchargez la version qui vous correspond. Sous Windows, ce sera généralement la version win32-setup.exe.
Une fois le fichier d'installation téléchargé, double-cliquez dessus pour lancer l'assistant d'installation. Suivre les étapes de l'assistant d'installation jusqu'au bout. Il se peut qu'il faille redémarrer l'ordinateur.

Transfert du module

Pour réaliser le transfert du module vers votre hébergement, il vous faudra les identifiants de connexion FTP fournis par votre hébergeur. Ceux-ci vous ont normalement été envoyés par e-mail. Ils peuvent également être spécifiés dans votre panneau d'administration.
Pour l'utilisation du logiciel FileZilla, nous vous proposons de suivre les étapes du guide détaillé fourni par le support de l'hébergeur OVH à l'adresse http://guides.ovh.com/FtpFileZilla.
Le module doit être déposé dans le dossier /modules de votre boutique PrestaShop comme l'indique l'image suivante.

Transfert du module

Installer et configurer le module

Une fois le module en place sur le serveur, il faut l'installer dans la boutique.
Connectez-vous au panneau d'administration (Back Office) de votre boutique PrestaShop, puis dans l'onglet Panneau d'administration >> Modules, localisez le module et cliquer sur le bouton correspondant. Si l'installation se fait sans problème, un message devrait l'indiquer : . Certains modules peuvent être paramétrables. Si c'est le cas, un lien >> Configurer apparaît dans le cadre du module. Cliquez sur ce lien pour accéder à son interface de configuration.