Aller au contenu
Documentation · API JavaScript

Configurer

Piloter le widget depuis votre code

Toutes les options de window.Parlo, les méthodes et les attributs HTML reconnus par le widget.

Options de window.Parlo

À définir avant le script du widget. Vous pouvez aussi les passer plus tard avec Parlo.init({ … }).

OptionRôle
user: { id, email, name, hash }Utilisateur connecté
context: { … }Contexte joint aux retours
versionVersion de votre application
hideOn: ['/paiement', '/admin']Adresses (début du chemin) où le widget ne s’affiche pas
locale: 'de'Force la langue du widget (fr, en, es, de, it, pt, nl)

Méthodes

MéthodeEffet
Parlo.open()Ouvre le panneau.
Parlo.open({ anchor: element })Ouvre le panneau à côté d’un élément de votre page.
Parlo.open({ intent: 'support' })Ouvre directement en mode demande d'aide.
Parlo.close()Ferme le panneau.
Parlo.hide() / Parlo.show()Masque ou réaffiche le bouton flottant. Le panneau reste ouvrable par vos boutons.
Parlo.identify(user)Déclare l’utilisateur connecté, sans recharger la page.
Parlo.logout()Oublie l’utilisateur.
Parlo.setContext(objet)Remplace le contexte.
Parlo.setVersion('2.4.1')Change la version.
Parlo.init(options)Applique des options de window.Parlo après coup.

Attributs HTML

AttributEffet
data-parlo-openUn clic sur l’élément ouvre le widget, sans JavaScript.
data-parlo-open="support"Idem, en mode demande d’aide.
data-parlo-hideTant qu’un élément porte cet attribut (écran de chargement, vidéo plein écran…), le widget est masqué.
data-parlo-maskLa zone est recouverte dans les captures d’écran jointes aux retours.

Exemple : votre propre bouton

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

<script>
  window.Parlo = { hideOn: ['/paiement'] }
</script>
<script>
  // Une fois le widget chargé : seul votre bouton reste
  window.addEventListener('load', () => window.Parlo && window.Parlo.hide())
</script>

Le widget suit les changements de page des applications monopage (React, Vue, Next.js…) : règles de pages et questions se mettent à jour seules.