đź””Prestashop - Nouvelle Documentation Connecteur

Vous avez la possibilitĂ© d'automatiser la transmission des preuves d'achat et des services grâce au CMS Prestashop. 

Voici les Ă©tapes Ă  suivre pour installer et configurer le module : (CLIQUEZ SUR CHAQUE TITRE POUR RETORUVER L'INFORMATION)

Principe de fonctionnement

Une fois le module installé et configuré, tout est automatique : Avis Vérifiés communique directement avec votre solution e-commerce.

  • RĂ©cupĂ©ration automatique des commandes et demandes d’avis : Le module nous communique directement vos dernières commandes. Notre plateforme rĂ©cupère donc les commandes pour lesquelles nous devons envoyer des demandes d'avis, et cela en fonction de la configuration renseignĂ©e lors du paramĂ©trage dĂ©crit dans la suite de ce document.
  • Affichage des avis produits sur votre site : Le module vous permet d’afficher vos avis produits collectĂ©s sur notre plateforme directement sur vos fiches produits et ainsi rassurer vos clients sur la qualitĂ© de vos produits.

Installation du module

  • Connectez-vous Ă  votre backoffice Prestashop
  • Cliquez sur Module Catalog et recherchez "netreviews", le module "VerifiedReviews" sera renvoyĂ© ou bien cliquer ici
  • Cliquez sur Installer

blobid0.png

  • Un message de rĂ©ussite apparaĂ®tra après l'installation

blobid1.png

Configuration des accès

Configuration initiale

Pour configurer le module dans l’environnement Prestashop, veuillez-vous rendre dans le menu                 Â« Modules > Gestionnaire de modules », dans l’onglet « Modules » repĂ©rez le module Avis VĂ©rifiĂ©s et cliquez sur « Configurer ».

blobid2.png

Attention !

Avant tout configuration, dans le cas d’une installation Prestashop multi-boutique, veillez à bien vérifier que le module est activé dans le gestionnaire de modules et une fois sur la page de configuration du module, bien sélectionner la boutique concernée via le sélecteur Prestashop en haut de page.

blobid3.png

Pour que notre plateforme puisse communiquer avec votre boutique, il est nécessaire de renseigner les deux champs « Connectorsecret Key » et « Identifiant de site web» que vous pouvez récupérer sur votre espace client Avis Vérifiés. Depuis le menu « Gestion du compte > Mon connecteur Prestashop », copiez vos codes d’intégrations (cf image ci-dessous).

blobid4.jpg

Et reportez-les sur votre boutique Prestashop dans la partie « CONFIGURATION ».

blobid5.jpg

 

Cliquez sur « Sauvegarder » pour activer votre module du côté de Prestashop. Vous devrez ensuite compléter l’activation du module dans votre compte Avis Vérifiés.

Configuration multilingue

Attention !

Si votre Prestashop est en mode multi boutique, vous ne pouvez connecter un compte Avis Vérifiés qu'à une seule boutique (un seul id_shop). Si vous souhaitez intégrer le module Avis Vérifiés sur plusieurs boutiques, vous devez avoir autant de boutiques que de comptes Avis Vérifiés (idWebsite et clé secrètes différentes).

Si votre site est disponible dans différentes langues, vous pouvez choisir d’activer la configuration multilingue du module. Pour cela, vous devez avoir des comptes Avis Vérifiés sur différentes plateformes et compléter la Clé secrète et l’ID Website propre à chaque compte.

Par ex : votre site est disponible en français, espagnol, italien et anglais. Pour bénéficier de la configuration multilingue vous devez avoir un compte sur chacune de nos plateformes :

La configuration multilingue par défaut suit le comportement suivant :

  • chaque plateforme rĂ©cupère les commandes de la langue qui lui correspond, ce qui permet d’envoyer des mails de demande d’avis dans la langue de votre client (par ex sur le site en ES, la commande sera rĂ©cupĂ©rĂ©e sur la plateforme http://opiniones-verificadas.com ) et de rĂ©colter des avis dans les langues des pages.
  • les pages produits FR afficheront ensuite les avis rĂ©coltĂ©s sur http://avis-verifies.com , les pages ES afficheront ceux de http://opiniones-verificadas.com etc.
  • le module permet Ă©galement en le personnalisant au niveau du code d’afficher tous les avis dans toutes les langues.

Si votre site n’est pas disponible en plusieurs langues, ne pas activer la configuration multilingue.

 

Configuration du module sur Avis vérifiés

Maintenant que votre module est installé et que vos codes sont intégrés sur votre environnement Prestashop, vous pouvez assurer que le module communique bien avec notre plateforme.

Rendez-vous sur votre espace client Avis Vérifiés dans le menu
« Gestion du compte > mon connecteur Prestashop».

Codes d’intégration

Comme vu dans la section « Configuration des accès » vous devez vous rendre sur la page « Gestion du compte > Mon connecteur Prestashop » copier les codes et les coller dans les champs correspondants dans votre connecteur.

Configuration de la collecte d’avis

Afin de configurer la collecte via le module, rendez-vous sur la page configuration dans la partie collecte d’avis (voir screen ci-dessous).

blobid6.png

 

Depuis cette interface vous pourrez configurer tous les aspects de votre collecte.

Activer la collecte d’avis marque 

Cette option permet d’automatiser votre collecte des commandes. Si celle-ci est cochĂ© notre système va rĂ©cupĂ©rer les commandes passĂ©s sur votre site afin d’envoyer des demandes d’avis. Cliquer sur cette option pour la dĂ©sactiver/l'activer. 

blobid7.jpg

Délai avant envoi de la demande d’avis marque

Cette option vous permet de gérer le temps d’attente avant l’envoi de vos demande d’avis. Ce délai s’applique dès lors que nos services reçoivent une commande.

blobid8.jpg

Statuts souhaités pour récupérer vos commandes

Cette option vous permet de choisir le ou les statuts sur lequel/lesquels nos services vont se baser pour récupérer vos commandes.

blobid9.png

Activer la collecte d’avis produit

Cette option permet la collecte d’avis sur vos produits. 

blobid10.jpg

Différer l’envoi de la demande d’avis produit

Cette option permet de sĂ©parer en deux email la demande d’avis marque et la demande d’avis produit. 

blobid11.jpg

Délai après envoi de la demande d’avis marque

Cette option permet de sélectionner le nombre de jours d’espacement entre l’envoi de la demande d’avis marque et produit.

blobid13.jpg

Relance de demande d’avis

Cette option vous permet de renvoyer une notification à vos consommateur afin que ceux-ci dépose un avis. Vous pouvez paramétrer également le temps entre avant l’envoi de cette email.

blobid14.jpg

Extensions d’emails à exclure

Vous pouvez renseigner dans ce champs les noms de domaines sur lesquels aucune demande d’avis sera renvoyĂ©. 

blobid15.jpg

Configuration de l’affichage des avis produits

Afin de configurer l’affichage de vos avis (produit), rendez-vous dans la partie « Gestion du compte »puis sur« Mon connecteur Prestashop »(voir screen ci-dessous).

blobid16.jpg

 

Une fois sur la page cliquer sur l’onglet « Widget display ».

blobid17.jpg

Une fois sur la page, deux option seront disponibles :

  • Afficher les avis : Cette option vous permet d’activer/dĂ©sactiver l’apparition du widget d’avis produit ainsi que des Ă©toiles/notes sur vos fiches produits.

 

blobid18.jpg

  • Choix du template du widget produit : Cette option vous permet de choisir entre deux affichage l’aspect du widget d’avis produit.

blobid19.jpg

Premier export de commandes

Pour obtenir rapidement vos premiers Avis, le module Avis-Vérifiés intègre une fonctionnalité d'import/export de commandes vous permettant d’envoyer vos anciennes commandes. Ce premier import de commandes vous permet de générer les premiers avis rapidement en sondant les clients de vos commandes déjà passées.

Importer des commandes

Cette fonctionnalité est très utile lors du lancement de votre collecte et vous permettra d’obtenir un grand nombre d’avis rapidement.

Cette option se trouve présente dans les étapes d’onboarding suite à la création de votre compte.

Vous pouvez également retrouver cette option à tout moment dans le menu « Collecte des avis > Configuration » en bas de page.

blobid20.png

DĂ©tail des options :

  • RĂ©cupĂ©rer les dernières commandes : Cliquer sur le bouton pour activer/dĂ©sactiver le lancement de la rĂ©cupĂ©ration de l’historique (cette action s’effectuera une seul fois).
  • DĂ©lai de rĂ©cupĂ©ration des commandes: Temps indiquer en jours, cette option nous permet de savoir quel plage de date nous devons prendre en compte pour effectuer l’import. Exemple : 30jours, nous rĂ©cupĂ©rerons toutes les commandes passĂ©s lors de cette pĂ©riode.
  • Statuts souhaitĂ©s pour rĂ©cupĂ©rer vos commandes: vous pouvez sĂ©lectionner un ou plusieurs statuts sur lesquels vous souhaitez que l’on se base pour rĂ©cupĂ©rer vos commandes.

Une fois les options renseignĂ©s cliquer sur le bouton « enregistrer » 

Exporter mes commandes 

Si vous souhaitez Ă©viter de charger toutes vos commandes depuis l’outil d’import de commande. Il est Ă©galement possible de gĂ©nĂ©rer un fichier CSV avec vos commande passĂ© et de les chargĂ©s directement dans votre Espace Client Avis-VĂ©rifiĂ©s. 

Pour cela :

  • AccĂ©dez au back office de votre boutique puis cliquez sur « Modules > Gestionnaire de module ».
  • Dans la barre de recherche, tapez « Avis VĂ©rifiĂ©s »
  • Le module devrait apparaitre dans la liste, cliquer sur « Configurer»

Une fois arrivé sur la page de configuration du module, allez jusqu’à la section « EXPORTER MES COMMANDES ».

blobid21.png


DĂ©tail des options :

  • Depuis : vous pouvez rĂ©cupĂ©rer des commandes jusqu'Ă  12 mois (tel que dĂ©fini dans nos Conditions GĂ©nĂ©rales d’Utilisation).
  • RĂ©cupĂ©rer les avis produits : sĂ©lectionner “oui” si vous souhaitez rĂ©cupĂ©rer des avis produits pour ces commandes (indispensable si vous dĂ©sirez sonder vos produits)
  • Exporter les commandes avec le statut : vous pouvez sĂ©lectionner un ou plusieurs statuts de rĂ©cupĂ©ration

Une fois que vous aurez rĂ©cupĂ©rĂ© le csv gĂ©nĂ©rĂ© en cliquant sur le bouton en bas Ă  droite, vous pouvez vous rendre directement Ă  l’espace de tĂ©lĂ©chargement des commandes via l’url                                       suivant : https://app.netreviews.eu/fr/collect/request-send.

blobid22.jpg

 

Vous devez uploader le csv et bien vérifier les informations proposées avant de valider l’importation des commandes.

Actions avancées

Si vous cliquez sur « DEBUG » dans la configuration du connecteur, les options avancées apparaîtront.
Cette partie est habituellement réservée à Avis vérifiés mais vous pouvez l’utiliser au besoin pour affiner le paramétrage technique de notre module.

Afficher l’onglet (x avis)

Vous pouvez cacher l’onglet « x avis ».

blobid23.jpg

Renommer l'onglet avis produit

blobid24.png

Cette option vous permet de modifier le nom de l’onglet d’avis, voici un exemple sur le front :

blobid25.png

Afficher les Ă©toiles sur la page d'accueil

Vous pouvez désactiver les étoiles catégories sur la page d’accueil si vous ne souhaitez pas qu’elles soient affichées.

Utilisez le numéro de référence EAN UPC unique pour les déclinaisons des produits

Par défaut, si vous avez des déclinaisons sur vos produits, nous récupérons le GTIN_EAN et GTIN_UPC de la déclinaison.

Si vous activez cette option (Oui), nous récupérons les informations du produit parent.

DĂ©finir le nombre maximum de produits dans une demande d'avis
Pour éviter de demander l’avis à vos clients sur tous les produits commandés, vous pouvez définir un nombre maximum de produits à interroger dans le formulaire Avis Vérifiés. Vous n’avez pas la possibilité de choisir les produits à interroger dans ce cas.

Purger toutes les commandes de cette boutique
Importante ! 

Cette action vide la table av_orders (table spécifique Avis vérifiés) dans la base de données. Cette table est notre table de référence pour définir les commandes à récupérer.

Générer les commandes perdues depuis l’installation du module

Si vous voyez que des commandes correspondant à la configuration définie dans votre compte Avis vérifiés, n’ont pas été récupérées alors qu’elles ont bien été créées après l’installation du module, vous pouvez recourir à cette option.

  • GĂ©nĂ©rer pour toute la pĂ©riode : nous rĂ©cupĂ©rerons les commandes manquantes dans notre table av_orders, commandes crĂ©Ă©es depuis la date d’installation du module
  • Choisir une pĂ©riode : vous pouvez spĂ©cifier une pĂ©riode pour rĂ©cupĂ©rer ces commandes. Nous rĂ©cupĂ©rerons les commandes crĂ©Ă©es entre les dates spĂ©cifiĂ©es.

Remarque :

Cette option ne génère pas une récupération automatique par notre cron. Elle permet seulement de remplir la table av_orders en base de données.

Notre cron de récupération automatique se base ensuite sur le contenu de la table av_orders et croise les données avec la table de commandes pour sélectionner les commandes à récupérer.

 

Tableau de bord et rajout des hooks

L’option « add all hooks » vous permet de regreffer les hooks dans le cas où ils aient été mal enregistrés par exemple. Cette fonctionnalité est disponible à partir de la version 1.6.

Récupération automatique des commandes

Processus général

Nous rĂ©cupĂ©rons vos commandes selon la configuration que vous dĂ©finissez dans votre compte Avis VĂ©rifiĂ©s  « Collecte des avis> Configuration ».

Vous pouvez faire le suivi des commandes récupérées dans votre compte dans « Collecte des avis > Suivi des demandes d’avis ».

Lorsque nous récupérons aussi le détail des produits, la référence du produit est l’ID Prestashop. Si un avis est déposé sur le produit, cet avis sera associé à l’ID Prestashop dans votre compte Avis Vérifiés. Ensuite cet avis sera synchronisé vers votre site et sera affiché sur la page produit correspondant à cet ID Prestashop.

Hooks de récupération

Notre système de récupération de commandes se base sur le système par défaut de Prestashop : à chaque validation de commande nous l’enregistrons via l’exécution du hookaction Validate Order dans notre table av_orders. Cependant, pour anticiper l’action de certains modules spécifiques qui modifient le système de Prestashop, nous effectuons une double vérification et utilisons aussi le hookactionOrderStatusPostUpdate pour enregistrer les commandes dans notre table.

Google Shopping

Pour pouvoir partager vos avis produits à Google Shopping, nous avons besoin du GTIN_EAN (Europe) ou GTIN_UPC (US, Canada) qui est la donnée la plus précise pour Google ou, le cas échéant, du duo marque + MPN. Il convient également de renseigner marque et MPN même si vous avez des GTIN : plus nous pourrons fournir d’informations sur vos produits à Google, plus il sera facile pour Google d’associer les avis aux produits.

Lors de la récupération des commandes, nous récupérons automatiquement les informations Google Shopping dès lors qu’elles sont correctement renseignées sur les fiches produits du catalogue dans le Back-Office Prestashop.

Recommandations techniques

Cette documentation présente les options disponibles dans la dernière version du module. Il est toujours recommandé de mettre à jour votre module pour bénéficier des nouvelles fonctionnalités / résolution de bugs et de vérifier régulièrement la connexion avec votre module sur notre plateforme.

Mise Ă  jour du module

Si votre module a été personnalisé (surcharges, fichiers du module modifiés etc.), veillez à bien faire une copie des fichiers avant la mise à jour et à tester la mise à jour sur un site de préproduction avant de mettre à jour sur votre site principal.

Changements au niveau de la structure de votre site

Nous communiquons avec votre site via une URL API. Cette URL API correspond au chemin vers le fichier netreviewsApi.php présent à la racine du module.

Si vous déplacez le module au niveau de vos fichiers, si vous ajoutez un sous-répertoire, veillez à toujours vérifier la connexion et à contacter le support pour modifier l’URL API si nécessaire.

Par ex : le nom de domaine de votre site est : https://monsupersitedetest.com et vous installez le module à la racine du site, l’url API sera https://monsupersitedetest.com/modules/netreviews/netreviewsApi.php. Si ensuite vous déplacez votre shop dans un sous-répertoire https://monsupersitedetest.com/shop/, nous devrons modifier l’url API comme ceci : https://monsupersitedetest.com/shop/modules/netreviews/netreviewsApi.php.

FAQ

Mes avis ne s’affichent pas

  • VĂ©rifications des rĂ©fĂ©rences produits
  • Comme dĂ©taillĂ© prĂ©cĂ©demment, le module Prestashop utilise l’ID produit prestashop comme rĂ©fĂ©rence produit. Vous pouvez vĂ©rifier dans votre compte Avis vĂ©rifiĂ©s que vos avis sont bien rattachĂ©s Ă  des ID Prestashop.

 

  • Autres cas

Dans les autres cas, voici les étapes à suivre dans le cas où les avis ne s’affichent pas :

1. Vérifier la connexion entre notre plateforme et votre site rendez-vous dans votre compte Avis Vérifiés puis dans« Gestion du compte > Mon connecteur Prestashop », vous pouvez cliquer sur le bouton «Tester la connexion ».Si vous obtenez un message d'échec, veuillez contacter le support.

2. VĂ©rifier dans votre compte Avis VĂ©rifiĂ©s  « Gestion du compte > onglet widget display» que l’option “Afficher les avis sur les produits” est bien activĂ©.

3. Cliquer sur le bouton “Ajouter tous les crochets” pour ré-enregistrer les hooks (page de configuration du module dans le Back-Office Prestashop > section DEBUG)

4. Vider tous vos caches : cache Smarty et plugin de cache (par ex Page Cache Ultimate). Lorsque vous videz les caches smarty, bien s’assurer que l’option “Never recompile template” n’est pas sélectionnée.

Si après tout cela, les avis ne s’affichent toujours pas, le plus probable est donc que votre thème n’intègre pas les hooks sur lesquels nous nous greffons. Vous pouvez alors insérer manuellement nos hooks personnalisés dans votre templateproduct.tpl :

  • {hook h='ExtraNetreviews'} pour afficher les Ă©toiles
  • {hook h='TabcontentNetreviews' product=$product} pour afficher le bloc d’avis

En ce qui concerne les étoiles sur les pages catégories, notre module se greffe sur les hooks :

  • displayProductListReviews si la version Prestashop est < 1.7
  • displayProductPriceBlock (type=”before_price”) si la version Prestashop est > 1.7

Après activation de cette option, si les étoiles (dans la liste de produit) n'apparaissent toujours pas, cela signifie que ces hooks ne sont pas présents dans votre thème. Dans ce cas vous pouvez ajouter directement notre hook personnalisé {hook h='CategorystarsNetreviews' product=$product} dans le fichier product-list.tpl (Prestashop < 1.7) ou dans le fichier de la miniature produit (sur le theme par défaut de Prestashop 1.7, chemin du fichier themes/classic/templates/catalog/_partials/miniatures/product.tpl)

L'affichage de mes avis produits est cassé

Il s’agit généralement d’un problème de cache.

Dans la page de configuration du module dans le Back-Office Prestashop > section DEBUG, cliquez sur le bouton “Ajouter tous les crochets” pour ré-enregistrer les hooks puis videz tous vos caches : cache Smarty et plugin de cache (par ex Page Cache Ultimate). Lorsque vous videz les caches smarty, bien s’assurer que l’option “Never recompile template” n’est pas sélectionnée.

Je veux déplacer mes avis

Nos étoiles sur les pages produits et catégorie ainsi que le bloc d’avis apparaissent normalement de façon automatique.

Si leur position ne vous satisfait pas et que vous souhaitez les déplacer vous pouvez le faire en suivant les étapes suivantes :

1. DĂ©greffer le ou les hooks en question

Pour cela, depuis la page de configuration du module, cliquez sur Points d’accroche

  • Cochez l’option “Afficher les points d’accroche invisibles” pour voir tous les hooks associĂ©s au module

Pour désactiver l’affichage automatique des étoiles sur les fiches produits, dégreffer “displayProductButtons”, “displayLeftColumnProduct”, ”displayRightColumnProduct”

 

Pour désactiver l’affichage automatique du bloc d’avis produits dans un onglet sur les fiches produits, dégreffer “displayProductExtraContent”

Pour désactiver l’affichage automatique des avis produits dans les miniatures produits sur les pages de catégories, dégreffer “displayProductPriceBlock”, “displayProductListReviews”.

2. Insérer manuellement nos hooks personnalisés

Fiches produits : dans votre templateproduct.tpl, ajouter:

{hook h='ExtraNetreviews'} pour afficher les étoiles

{hook h='TabcontentNetreviews' product=$product} pour afficher le bloc d’avis

Pages catégories : dans le fichier product-list.tpl (Prestashop < 1.7) ou dans le fichier de la miniature produit (sur le theme par défaut de Prestashop 1.7, chemin du fichier themes/classic/templates/catalog/_partials/miniatures/product.tpl), ajouter :

{hook h='CategorystarsNetreviews' product=$product}

Mes commandes ne sont pas récupérées

Vérifier la connexion entre notre plateforme et votre site (compte Avis Vérifiés > Intégration > Configurer mon module Prestashop, vous pouvez cliquer sur le bouton “Tester la connexion” ou bien cliquer sur “Envoyer la configuration”). Si vous obtenez un message d'échec, veuillez contacter le support.

Vérifier si l’automatisation est bien activée dans votre compte Avis Vérifiés Gestion du compte > Mon connecteur PrestashopVérifier que vos commandes à récupérer ont bien le(s) même(s) statut(s) que celui ou ceux vous avez sélectionné(s) sur votre compte Avis Vérifiés dans la page de configuration du module

Si vous obtenez une connexion, que l’automatisation est bien activée et que les statuts sont corrects, veuillez contacter le support.

 

 

 

 

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0