Skip to content

Installer sur PrestaShop ​

Sur PrestaShop, le module Humind injecte pour vous les widgets Humind sur votre boutique. Il n'y a aucun snippet à coller dans votre thème.

Pas sur PrestaShop ?

Voir Installer le chat pour le snippet HTML qui fonctionne sur n'importe quel site.

1. Installer et connecter le module ​

Suivez Synchro catalogue PrestaShop : installez le module, puis cliquez sur Se connecter à Humind. La connexion autorise aussi le domaine de votre boutique, ce qu'Humind exige avant de charger les widgets.

Deux cas où le domaine n'est pas autorisé pour vous :

  • Vous avez saisi une clé d'API à la main : ajoutez vous-même votre domaine sur la page de liste blanche des URL (Humind demande un enregistrement DNS TXT pour prouver que vous le contrôlez).
  • Vous vous êtes connecté en un clic, mais un pare-feu ou un service de sécurité (Cloudflare, par exemple) a bloqué l'appel de preuve que Humind fait à votre boutique : la page du module affiche alors un avertissement avec un lien Autoriser mon domaine vers cette même page. Humind y a déjà ouvert la demande pour votre domaine : ajoutez l'enregistrement DNS TXT affiché et vérifiez le domaine (la demande reste ouverte 24 heures). Le même avertissement apparaît quand le domaine est déjà relié à une autre entreprise Humind.

2. Vérifier les interrupteurs des widgets ​

Une fois la boutique connectée, le panneau Sur votre boutique de la page de configuration du module a une carte par bloc, chacune avec son interrupteur :

InterrupteurCe qu'il ajoutePar défaut
Assistant de chatLe chat Humind sur chaque page de la boutique, sauf le paiement.Actif
Questions produitDes questions sur le produit générées par l'IA, sous le bouton d'ajout au panier des fiches produit (hook displayReassurance).Actif
Générateur de cadeauxLe bloc de recherche « posez votre question » sur la page d'accueil (hook displayHome).Inactif

Assistant de chat et Questions produit sont actifs dès que la boutique est connectée. Si votre thème porte déjà le widget Humind (collé à la main), retirez-le du thème.

Questions produit et Générateur de cadeaux ouvrent le chat : ils n'apparaissent que tant que Assistant de chat est actif et que le chat est rattaché à la page. Sinon leur carte indique A besoin de l'assistant de chat : il n'apparaît pas tant que le chat est désactivé., le bloc n'est pas affiché et un code collé n'affiche rien.

L'apparence et les textes des widgets se règlent dans votre dashboard Humind, pas dans le module : chaque carte a un lien Personnaliser vers la bonne page.

Le module enregistre les scripts de chargement Humind via le gestionnaire d'assets du thème (différés, en bas de page) et ajoute lui-même les éléments. Pour le chat, il ajoute <humind-widget> avec les attributs que vous définiriez sinon à la main : votre company (company-id, ou shop-domain quand le module n'a pas d'identifiant de company), le type de page (template-name, voir les valeurs), la langue et le pays, et sur les pages produit le produit que regarde le visiteur (product-id). Il s'annonce avec integration="prestashop", ce qui résout product-id dans votre catalogue synchronisé et active le panier natif, l'attribution des commandes et le client connecté. Les questions produit et le générateur de cadeaux portent aussi integration="prestashop". Un thème qui n'appelle pas le hook de fin de page reçoit quand même le chat : le module l'ajoute à la page terminée.

Désactivez un widget et cliquez sur Enregistrer pour le retirer de la boutique sans déconnecter la synchro catalogue. Si votre thème met les pages en cache, videz le cache PrestaShop après avoir changé un interrupteur.

Sur une boutique servie depuis localhost, saisissez une clé d'API et votre Identifiant d'entreprise dans les Options avancées du module et autorisez localhost dans votre dashboard Humind, pour que les widgets se chargent.

3. Choisir où chaque bloc apparaît ​

Les cartes Questions produit et Générateur de cadeaux règlent les emplacements de leur bloc, avec une case par emplacement, regroupées par page : cochez les emplacements, puis cliquez sur Enregistrer. Le chat n'a pas d'emplacement à choisir : il est sur chaque page. Le module lit les gabarits de votre thème actif et ne liste que les emplacements que le thème possède vraiment (un emplacement déjà choisi reste listé). Chaque carte indique où se trouve son bloc : Apparaît ici : suivi des emplacements, Apparaîtra ici une fois activé : tant que le bloc ou le chat est désactivé, ou Aucun emplacement actif.

PageEmplacementsGénérateur de cadeauxQuestions produit
Page d'accueilDans le contenuOui, par défautNon
Page catégorieEn haut, En basOuiNon
Fiche produitEn haut, sous les images ; Sous le bouton panier ; En basOuiOui, par défaut sous le bouton panier
PanierSous le panierOuiNon
Pied de page de toutes les pagesAu-dessus du pied de page ; Dans le pied de pageOuiNon

Un bloc apparaît une seule fois par page, quel que soit le nombre d'emplacements qui le demandent, et seulement tant que son interrupteur et le chat sont actifs.

Codes à coller ​

Pour placer un bloc dans votre contenu, collez son code dans une page CMS, une description de produit, un module de texte ou un constructeur de pages. Le code est remplacé par le bloc sur votre boutique.

CodeBloc
[humind bloc="generateur"]Le générateur de cadeaux.
[humind bloc="questions"]Les questions du produit affiché. Hors fiche produit, rien ne s'affiche.

Un code n'est rendu que dans le contenu de la page. Dans l'en-tête de la page ou à l'intérieur d'une balise (meta description, données structurées), il est retiré. Avec l'interrupteur du bloc désactivé, avec le chat désactivé, ou quand le bloc est déjà sur la page, le code n'affiche rien. Chaque carte affiche aussi le code de son bloc. Les codes sont retirés des descriptions et des pages envoyées à Humind : l'assistant ne les lit jamais.

Autres positions du thème ​

Dans Apparence > Positions, le module peut aussi être placé sur toute autre position de votre thème : il affiche les questions produit sur une fiche produit et le générateur de cadeaux ailleurs. Dans un gabarit, utilisez {widget name="humind" block="questions"} ou {widget name="humind" block="gift_finder"}.

Après un changement de thème ​

Activer un thème, même celui déjà actif, peut retirer tous les modules des hooks que le thème liste, comme le fait le thème classic de PrestaShop 8 sur displayHome et displayReassurance. Le module remet ses blocs et le chat juste après, sur cette boutique. Un retrait fait dans Apparence > Positions sur un hook que le thème ne touche pas reste en place. Sur un hook que le thème vide, PrestaShop a déjà effacé ce retrait : l'emplacement choisi sur la page du module revient, décochez-le là pour le retirer définitivement.

Quand un bloc ou le chat n'est plus rattaché à son emplacement (retiré dans Apparence > Positions ou par un thème), la page du module affiche un avertissement :

  • pour un bloc, cliquez sur Enregistrer pour le remettre ;
  • pour le chat, cliquez sur Remettre l'assistant. Les blocs qui en ont besoin reviennent avec lui.

Vérifier ​

  1. Sur la page du module, dans la carte Assistant de chat du panneau Sur votre boutique, cliquez sur Vérifier ma page d'accueil. Le module lit votre page d'accueil comme un visiteur la reçoit et vous dit si le chat s'y trouve.
  2. Ouvrez une page de votre boutique dans une fenêtre privée.
  3. Ouvrez les DevTools du navigateur, onglet Network. Vous devez voir GET https://embed.thehumind.com/loader.js renvoyer 200, et aucune erreur dans la console.
  4. Dans la console, document.querySelector('humind-widget') doit renvoyer l'élément, et le bouton de chat flottant apparaît en bas à droite de la page.
  5. Sur une page produit, le bouton flottant est masqué volontairement (le visiteur lance la conversation depuis le bloc questions produit). Vérifiez le même document.querySelector('humind-widget') et que l'élément porte un attribut product-id et integration="prestashop".
  6. Sur le paiement, aucun widget Humind n'est chargé.

Si le widget ne s'affiche pas ​

  • Vérifier ma page d'accueil dit que l'assistant manque. Videz le cache de PrestaShop et de tout module de cache ou d'optimisation, puis vérifiez à nouveau. S'il manque encore, votre thème ou l'un de ses modules le retire : envoyez le nom de votre thème à Humind.
  • Vérifier ma page d'accueil ne peut pas lire la page. Une page de maintenance ou un pare-feu peut donner ce résultat. Vérifiez la page d'accueil dans une fenêtre privée de votre navigateur.
  • La page du module indique que l'assistant de chat n'est plus rattaché à vos pages. Il a été retiré dans Apparence > Positions ou par un thème. Cliquez sur Remettre l'assistant.
  • La console du navigateur mentionne un domaine non autorisé. Le domaine de votre boutique n'est pas dans la liste blanche des URL. Ajoutez-le exactement comme le voient les visiteurs (avec ou sans www, comme dans la barre d'adresse).
  • Aucun élément humind-widget dans le code source de la page. Le module n'est pas connecté, l'interrupteur Assistant de chat est désactivé, ou un cache sert une ancienne version de la page. Videz le cache PrestaShop et tout cache de CDN ou de page placé devant la boutique.
  • L'élément est là mais rien n'apparaît. Un bloqueur de publicités, ou une politique de sécurité de contenu qui bloque embed.thehumind.com (et widgets.thehumind.com quand Questions produit ou Générateur de cadeaux sont actifs). Voir Dépannage.
  • Pas de contexte produit sur une page produit. Vérifiez que le produit a été synchronisé (voir Synchro catalogue PrestaShop) : le widget ne connaît que les produits qui existent dans Humind.
  • Le compteur du panier du thème ne bouge pas après un ajout depuis le chat. Le produit est bien dans le panier. Voir Limites.

Suite ​

Released under the proprietary Humind license.