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> :
<script async src="https://sayparlo.com/widget.js" data-site="VOTRE_CLÉ_DE_SITE"></script>
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 :
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 :
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 }
}
}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)
<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
- Identifier vos utilisateurs connectés et vérifier leur identité.
- Transmettre le contexte et la version de votre application.
- Piloter le widget depuis votre code : votre propre bouton, masquage, ouverture.
- Recevoir des demandes d'aide en plus des avis.