🔔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
• Installation du module
• Configuration des accès
  • Configuration initiale
  • Configuration multilingue
• Configuration du module sur Avis vérifiés
  • Codes d’intégration
  • Configuration de la collecte d’avis
• Configuration de l’affichage des avis produits
• Premier export de commandes
  • Importer des commandes
  • Exporter mes commandes 

• Actions avancées

• Récupération automatique des commandes

  • Processus général

  • Hooks de récupération
  • Google Shopping
• Recommandations techniques
  • Mise à jour du module
  • Changements au niveau de la structure de votre site
• FAQ

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

• Un message de réussite apparaîtra après l'installation

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 ».

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.

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).

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

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 :

• http://avis-verifies.com (FR)
• http://opiniones-verificadas.com (ES)
• http://recensioni-verificate.com (IT)
• https://www.verified-reviews.co.uk/ (UK)

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).

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. 

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.

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.

Activer la collecte d’avis produit

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

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. 

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.

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.

Extensions d’emails à exclure

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

Configuration de l’affichage des avis produits

Etape 1 : Configuration du widget avis produit sur votre compte Avis Vérifiés

Rendez-vous dans la partie Affichage des avis puis sur Intégrer mes widgets.

Cliquez sur Ajouter un widget et choississez Avis Produit.

Nommez le widget selon votre besoin.

Choisissez la forme d’affichage et la couleur puis configurez les paramètres avancés : Rich Snippets.

Cliquez sur Enregistrer.

Etape 2 : Intégration du widget sur votre site

Cliquez sur le widget que vous venez d’enregistrer et cliquez sur le bouton Intégrer le widget.

Mise en place 

Intégrez le script qui s'affiche avant la balise </body> du code HTML de votre site, sur toutes les pages où vous souhaitez afficher les widgets.

Intégration Note produit 

Si vous souhaitez afficher la note du produit, vous devez ajouter le code HTML qui s'affiche à l’endroit précis où vous souhaitez positionner cette note.

Intégration Liste d’avis 

💡Important !

Remplacez chaque élément de données du code par les valeurs appropriées de votre site web et des attributs du produit.

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.

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 ».

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.

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 ».

Renommer l'onglet avis produit

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

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.