Aller au contenu
Documentation · React

Installer le widget

Installer Parlo dans une application React

Vite, Create React App ou toute application React monopage. Le widget suit tout seul vos changements de page.

1Ajoutez le script à votre page HTML

Avec Vite, dans index.html à la racine ; avec Create React App, dans public/index.html. Collez-le juste avant </body> :

HTML
<script async src="https://sayparlo.com/widget.js" data-site="VOTRE_CLÉ_DE_SITE"></script>
Votre clé de site (pk_…) se trouve dans Parlo : Sites → votre site → Installation. Le code affiché là-bas la contient déjà.

Vous préférez le charger depuis un composant ? Montez celui-ci une fois, à la racine de votre application :

TSX
import { useEffect } from 'react'

export function ParloWidget() {
  useEffect(() => {
    if (document.querySelector('script[data-site][src*="widget.js"]')) return
    const script = document.createElement('script')
    script.src = 'https://sayparlo.com/widget.js'
    script.async = true
    script.dataset.site = 'VOTRE_CLÉ_DE_SITE'
    document.body.appendChild(script)
  }, [])
  return null
}

2Indiquez qui est connecté

Quand votre utilisateur se connecte ou se déconnecte, prévenez le widget. Cette fonction marche que le widget soit déjà chargé ou non :

TypeScript
type ParloUser = { id: string; email?: string; name?: string; hash?: string }

declare global {
  interface Window {
    Parlo?: any
  }
}

export function parloIdentify(user: ParloUser | null) {
  const parlo = window.Parlo
  if (parlo && typeof parlo.identify === 'function') {
    if (user) parlo.identify(user)
    else parlo.logout()
  } else {
    // Not loaded yet: the widget reads window.Parlo when it starts.
    window.Parlo = { ...(parlo || {}), user: user || undefined }
  }
}
TSX
useEffect(() => {
  parloIdentify(
    currentUser
      ? { id: currentUser.id, email: currentUser.email, name: currentUser.name, hash: currentUser.parloHash }
      : null,
  )
}, [currentUser])

Le hash se calcule sur votre serveur : voir Identification des utilisateurs.

3Ouvrez le widget depuis vos boutons (facultatif)

TSX
<button data-parlo-open>Donner mon avis</button>

// ou depuis votre code, à côté d'un élément
<button onClick={(e) => window.Parlo?.open({ anchor: e.currentTarget })}>Un souci ?</button>

Pour n'utiliser que vos propres boutons, masquez le bouton flottant avec window.Parlo?.hide().

4Vérifiez l'installation

Publiez votre site, puis ouvrez une page où le code est présent. Le bouton « Donner mon avis » apparaît en bas de l'écran, et dans Parlo le statut du site passe à « Widget détecté » en quelques secondes.

Rien ne se passe ? Videz le cache de votre site, vérifiez que l'adresse du site correspond à celle enregistrée dans Parlo, et consultez la page Confidentialité et sécurité si votre site utilise une Content Security Policy.

Pour aller plus loin