Documentation · Next.js
Installer le widget
Installer Parlo dans une application Next.js
App Router ou Pages Router, avec le composant Script de Next.js.
1Ajoutez le composant Script
Dans app/layout.tsx (App Router) ou pages/_app.tsx (Pages Router), à l'intérieur du <body> :
TSX
import Script from 'next/script'
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="fr">
<body>
{children}
<Script src="https://sayparlo.com/widget.js" data-site="VOTRE_CLÉ_DE_SITE" strategy="afterInteractive" />
</body>
</html>
)
}Votre clé de site (
pk_…) se trouve dans Parlo : Sites → votre site → Installation. Le code affiché là-bas la contient déjà.2Identifiez l'utilisateur connecté
Calculez le hash dans un composant serveur, puis passez l'utilisateur à un petit composant client :
TSX
// app/layout.tsx (composant serveur)
import { createHmac } from 'crypto'
import { ParloIdentify } from './parlo-identify'
const user = await getCurrentUser() // votre fonction
const parloUser = user
? {
id: user.id,
email: user.email,
name: user.name,
hash: createHmac('sha256', process.env.PARLO_IDENTITY_SECRET!).update(String(user.id)).digest('hex'),
}
: null
// dans le <body> :
<ParloIdentify user={parloUser} />TSX
// app/parlo-identify.tsx
'use client'
import { useEffect } from 'react'
type ParloUser = { id: string; email?: string; name?: string; hash?: string }
export function ParloIdentify({ user }: { user: ParloUser | null }) {
useEffect(() => {
const parlo = (window as any).Parlo
if (parlo && typeof parlo.identify === 'function') {
if (user) parlo.identify(user)
else parlo.logout()
} else {
;(window as any).Parlo = { ...(parlo || {}), user: user || undefined }
}
}, [user])
return null
}3Vé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.