📃Document

Un widget de type Document vous permet d'intégrer à votre produit ou votre site internet un document de type Page pour délivrer de l’éducation contextuelle.

Créer un widget

Pour créer un widget de type Document, cliquez sur le bouton Nouveau en haut à droite puis sur Document. Un panneau latéral permettant de créer un nouveau widget s'ouvre :

• Choisissez le mode de rendu de votre widget :

  • Embed : le widget est sous forme d'embed, vous pouvez l'intégrer n'importe où sur votre site ou votre application.

  • Modale : le widget est dans une fenêtre qui s'ouvrira au clic sur un bouton.

  • Drawer : le widget est dans un panneau latéral qui s'ouvrira au clic sur un bouton.

• Donnez un titre. 💡 Ce titre ne sera pas visible dans le widget intégré au sein de votre application.

• Sélectionnez un document de type Page à l'aide la barre de recherche.

• Cliquez sur Créer : ça y est, votre widget est prêt à être intégré ! 👉 Plus d'information ici.

Modifier un widget

Vous pouvez modifier un widget depuis deux endroits différents :

• Depuis la liste des widgets, en cliquant sur les trois petits points à droite de la carte d'un widget puis sur Modifier.

• Depuis la fenêtre d'Aperçu du widget, en cliquant sur le bouton Modifier.

Le panneau latéral d'édition du widget s'ouvre, vous pouvez alors modifier :

• Le type de rendu du widget. Attention, changer le type de widget implique de devoir mettre à jour le code.

• Le titre du widget.

• Le document sélectionné : pour cela, il vous suffit de cliquer sur le bouton X en haut à droite du document sélectionné et d'utiliser la barre de recherche afin de trouver le document de votre choix.

Une fois toutes vos modifications faites, cliquez sur le bouton Enregistrer.

Aperçu d'un widget

L'aperçu du widget dépend du type de rendu de ce dernier :

• S'il s'agit d'un widget de type Embed ou Modale : Au clic sur la carte d’un widget, une fenêtre s'ouvre. Dans cette fenêtre, vous pouvez voir un aperçu du rendu du widget dans votre application ou site (dans le cas de l'embed, des zones grises matérialisent le contenu de votre site).

• S'il s'agit d'un widget de type Drawer : Au clic sur la carte d’un widget, un panneau latéral s'ouvre. Vous pouvez y voir un aperçu du rendu du widget dans votre application ou site.

Dans la zone du bas de la modale, il y a plusieurs boutons :

• Obtenir le code : vous donne le choix entre envoyer le code du widget directement par mail (avec le bouton Envoyer les instructions) ou récupérer et copier le code du widget (avec le bouton Copier le code)

• Modifier : vous permet d'ouvrir le panneau latéral d'édition.

Aperçu d'un widget modale

Affichage du widget

Dans votre site ou votre application, de nombreux membres pourront accéder à votre widget. Pas de panique, ils ne verront le document que s'ils y ont accès.

Pour avoir accès à un document, il faut que :

• Le membre soit connecté

• Le membre ait accès à la collection qui contient le document (soit parce que la collection est publique, soit parce qu'elle est privée, mais que le membre est invité à la collection).

• Le document soit publié (sauf si le membre est admin ou a la permission "gérer & créer les collections")

Si un membre affiche le widget document et y a accès, l'activité correspondante sera bien prise en compte et vous pourrez la retrouver dans la page Dashboard des paramètres de votre Spot.

Pour vous assurer que l'utilisateur voit le contenu du widget en étant connecté, nous vous recommandons de mettre en place une authentification SSO dans l'espace d'intégration du widget.

🔑Single Sign-On

Une fois le SSO configuré, il est possible de transmettre le token JWT authentifiant l'utilisateur directement dans le script du widget. Plus d'informations ici.

Supprimer un widget

Pour supprimer un widget, vous avez 2 possibilités :

• Depuis la carte d'un widget, en cliquant sur les trois petits points à droite puis sur Supprimer.

• Depuis le panneau latéral d'édition d'un widget, en cliquant sur les trois petits points en haut à droite puis sur Supprimer.

Au clic sur l'un de ces deux boutons, une fenêtre de confirmation s'ouvre.

Attention, toute suppression est définitive !

Si vous supprimez un widget dans les paramètres de votre Spot, il est conseillé de le supprimer aussi dans le code de votre application ou site - pas d'inquiétude si vous oubliez, vos membres ne verront qu'un encart vide 😉