Guide d utilisation Module Prestashop : Piwik Référence 01 Nb de pages 8 Auteurs Benjamin Lapierre Blapierre@sutunam.com État Final Date diffusion 06/08/12
Sommaire Guide d utilisation... 1 Module Prestashop : Piwik... 1 1 Installation du module... 3 1.1 Première méthode : l outil de transfert Prestashop... 3 1.2 Seconde méthode : L installation via ftp... 5 2 Configuration du module... 7 2.1 Configuration requise... 7 2.2 Configuration optionnelle... 8 Page 2 sur 8
1 Installation du module 1.1 Première méthode : l outil de transfert Prestashop Prestashop contient un outil d installation de module automatique, qui gère le transfert et l installation sans nécessiter d opération complexe. Afin de transférer puis d installer votre module, rendez vous dans le panneau «module» de l interface d administration de PrestaShop. Ensuite, cliquez sur le bouton «Ajouter un module depuis mon ordinateur», puis sur «Parcourir». Sélectionnez votre fichier, cliquez sur «Ouvrir» puis «Charger le module» Page 3 sur 8
Le message «Module téléchargé» apparaîtra, et il ne vous restera plus qu à l installer. Rien de plus simple : toujours sur la même page, cliquez sur la catégorie «Administration», vous verrez alors le nouveau module. Cliquez sur installer, et c est fait! Le message de confirmation «Module installé» apparaîtra, et il ne vous restera plus qu à vous rendre dans «Modules» «Statistiques et Analyses» «Piwik Web Analytics Reports» pour configurer le module! Page 4 sur 8
1.2 Seconde méthode : L installation via ftp L autre méthode, plus complexe, est de vous connecter via ftp (en utilisant un logiciel comme Filezilla) et d effectuer manuellement le transfert. Pour que l installation se passe correctement, veillez à décompresser le dossier import.zip avant de l envoyer sur votre serveur. Envoyez ensuite le dossier décompressé sans le renommer dans le dossier modules de votre boutique prestashop. Une fois le dossier envoyé, l installation se termine dans l interface d administration, comme dans les étapes de la première méthode : Rendez vous dans l onglet «Modules», allez dans la rubrique «Statistiques & Analyses», cliquez sur installer, et c est fait! Page 5 sur 8
Le message de confirmation «Module installé» apparaîtra, et il ne vous restera plus qu à vous rendre dans «Modules» «Statistiques et Analyses» «Piwik Web Analytics Reports» pour configurer le module! Page 6 sur 8
2 Configuration du module 2.1 Configuration requise Afin de pouvoir récupérer correctement les données de votre site vers Piwik, vous devez renseigner quelques champs dans l écran de configuration. Voici l écran de configuration principal, où vous devrez entrer des informations vitales au bon fonctionnement du module : Les informations des trois champs de texte se trouveront sur le domaine où votre API Piwik est hébergée. N Titre Description 1 Piwik Side ID Cette donnée correspond à l identifiant de votre site sur votre API Piwik. Pour le trouver, une fois connecté dans votre interface d administration Piwik, cliquez sur le bouton «Paramètres», en haut à droite de l écran, puis sur «Sites». Vous serez alors face à un tableau regroupant les sites enregistrés sur votre plateforme Piwik 2 Piwik Host Ce champ doit contenir l adresse du domaine où est hébergé votre API Piwik ; par exemple : example.com/piwik. (sans http://) 3 Piwik Token Cette clé se trouve dans votre panneau de gestion Piwik. Une fois que vous êtes connecté sur votre interface de gestion Piwik, cliquez sur le bouton «API» en haut à droite de l écran. Votre clé d utilisation se trouve dans la boîte verte «&token_auth» Page 7 sur 8
Une fois ces informations renseignées, il ne vous reste plus qu à sélectionner le type de données que vous voulez que Piwik récupère sur votre site. La dernière étape est simplement de sauvegarder vos options. Votre module sera alors fonctionnel, et vos données commenceront à être sauvegardées sur Piwik. 2.2 Configuration optionnelle Même si le module est fonctionnel une fois les étapes ci-dessus complétées, vous disposez encore d autres options de personnalisation. Si vous sélectionnez le mode de suivi PHP, vous pourrez régler deux options dans l enregistrement des données par Piwik : La date sauvegardée pour l enregistrement d une vente comme terminée (date de commande sur le site ou date de mise à jour de la commande au statut X (voir cidessous)) Le ou les statuts à partir desquels une vente est considérée comme effectuée. La liste proposée sera celle de tous les statuts de commandes disponibles sur votre boutique. Comme précedemment, n oubliez pas d enregistrer vos informations pour que tout fonctionne correctement. Page 8 sur 8