Documentation du SDK JavaScript des sondages CrossTalk
Cette documentation vous aide à ajouter des sondages à votre page web avec le SDK JavaScript de CrossTalk.
Importer le SDK
Ajoutez la balise script ci-dessous dans votre fichier HTML. Vous pouvez l'ajouter dans la section
<head> ou <body> de votre fichier HTML.
<script src="https://unpkg.com/crosstalk-comments-js"></script>Ajouter la div CrossTalk à l'endroit où vous souhaitez afficher les sondages
Vous pouvez ajouter du style et des classes à cette div pour personnaliser son positionnement et ses marges dans votre page. Le contenu intérieur ne sera pas affecté par votre CSS.
<div data-crosstalk-poll data-poll-id="votre-id-de-sondage" data-wp="votre-nom-de-propriete-web" data-url="URL" data-theme="light"></div>
Inscrivez-vous pour un
compte CrossTalk
afin d'obtenir votre nom de propriété web unique et de créer un sondage à intégrer ou à tester.
Liste des paramètres pour les sondages CrossTalk :
| Nom de la variable | Définition | Valeurs attendues |
|---|---|---|
data-wp |
Votre nom de propriété web unique. Vous pouvez créer des propriétés web depuis le Tableau de bord. | Exemple : 'crosstalkDemo'. Valeur de type chaîne attendue. |
data-poll-id |
Insérez l'ID du sondage (UUID) que vous souhaitez intégrer. | UUID (sous forme de chaîne) attendu. |
data-url |
Si vous avez créé une règle de sondage sur le tableau de bord CrossTalk pour afficher un sondage spécifique en fonction d'une expression régulière d'URL, fournissez le paramètre URL. |
`${window.location.origin}${window.location.pathname}`
|
data-page-id |
Si vous avez créé une règle de sondage sur le tableau de bord CrossTalk pour afficher un sondage spécifique en fonction du pageID, fournissez le paramètre pageID. | PageID comme 'sports_news'. Chaîne attendue. |
data-theme |
Indique si le widget doit être chargé en mode clair ou sombre. Si votre site supporte les thèmes dynamiques, passez cette variable au widget pour qu'il s'intègre parfaitement. |
Soit light soit dark. Valeur de type chaîne attendue.
|
Utilisez la propriété web exemple
crosstalkDemo pour tester le widget immédiatement.
Ajoutez le code ci-dessous à votre page web pour des sondages CrossTalk fonctionnels :
<script src="https://unpkg.com/crosstalk-comments-js"></script><div data-crosstalk-poll data-wp="crosstalkDemo" data-poll-id="5c810b75-41ad-456b-bdf7-820db342030c" data-theme="dark"></div>