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({ … }).
| Option | Rôle |
|---|---|
user: { id, email, name, hash } | Utilisateur connecté |
context: { … } | Contexte joint aux retours |
version | Version 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éthode | Effet |
|---|---|
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
| Attribut | Effet |
|---|---|
data-parlo-open | Un clic sur l’élément ouvre le widget, sans JavaScript. |
data-parlo-open="support" | Idem, en mode demande d’aide. |
data-parlo-hide | Tant qu’un élément porte cet attribut (écran de chargement, vidéo plein écran…), le widget est masqué. |
data-parlo-mask | La 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.