✨ Prestashop - Nouvelle Documentation Connecteur

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

Cette documentation n'est valable que pour les clients qui disposent de la dernière version de la plateforme Avis Vérifiés.

 

Si vous ne disposez pas de cette page, utilisez la documentation suivante : Prestashop - Documentation Connecteur

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

 

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

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

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

 

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

Configuration de l’affichage des avis produits

1. Configurer le widget produit

2. Intégrer le widget produit

2 options d'intégration sont disponibles :

Dans le cadre d'une intégration manuelle du widget, remplacez chaque élément de données du code par les valeurs appropriées de votre site web et des attributs du produit.

En savoir plus sur l'intégration du widget produit.

3. Intégrer les étoiles sur les pages catégories

Vous pouvez activer l’affichage des étoiles sur les pages catégories et/ou sur la page d’accueil depuis la page de configuration du module de votre compte Prestashop : section Design :

Configuration de l'affichage des avis Marque

Vous avez deux possibilités pour intégrer notre widget :

Comment intégrer le widget marque manuellement ?

Si vous souhaitez procéder à une intégration manuelle dans le code de votre site,

  • Cliquez sous l'affichage de l'intégration automatique

  • ou, une fois que vous avez configuré votre widget fixe et que vous l'avez enregistré, cliquez sur Intégrer
  • Suivez les instructions :

 

Intégration automatique des widgets marque et produit

L'intégration automatique n'est valable que pour les clients qui disposent de la dernière version de la plateforme Avis Vérifiés et elle fonctionne uniquement pour intégrer un widget flottant. 

À tout moment, vous pouvez désactiver l'intégration automatique.

La suppression d'un widget de marque dans le back-office annule automatiquement toute intégration automatique si celui-ci était en place.

Exporter mes commandes (version 9.0.0

En cas de perte temporaire d’automatisation, vous pouvez générer un fichier CSV avec vos commandes passées pour effectuer un rattrapage.

Chaque export contient au maximum 5000 commandes. Dès qu’un premier export est effectué, les commandes incluses dans le fichier sont considérées comme récupérées par nos services. Veillez donc à bien transmettre le CSV sur notre plateforme.

Afin d'éviter toute sur sollicitation, assurez vous également que les commandes présentes dans le fichier ne sont pas déjà présentes dans notre système.

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électionnez “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é, contactez notre équipe Care.

  • 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 il remontera sur le widget produit qui 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 que le connecteur nous transmet correctement les commandes passées sur votre site.

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 (seulement si votre version du connecteur est inférieure à la version 9.0.0) 

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.

Synchronisation de la configuration de collecte et d’affichage des widgets avec votre site Prestashop 

Lorsque vous enregistrez une configuration de collecte ou activez l’intégration automatique d’un widget, il peut se passer jusqu’à une heure pour que les changements soient appliqués.

Dans le cas où vous voudriez appliquer ces changements de façon immédiate, vous pouvez forcer la synchronisation en cliquant sur le bouton « Récupération » dans la section Actions avancées de la page de configuration du module dans le Back-Office Prestashop.

 

 

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.

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 (seulement si votre version de connecteur est inférieure à la version 9.0.0).

2. Vérifier dans votre compte Avis Vérifiés  « Intégrer mes widgets > que l'intégration automatique est bien activée.

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 (seulement si votre version de connecteur est inférieure à la version 9.0.0).

Vérifier si l’automatisation est bien activée dans votre compte Avis Vérifiés Collecte des avis > ConfigurationVé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