Aller au contenu
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