Intégrer des pages dans votre mise en page
Les intégrations affichent vos pages publiques UserJot dans votre propre mise en page, plutôt que dans un widget flottant. Vous pouvez intégrer vos tableaux de retours, votre feuille de route, votre journal des modifications et votre centre d’aide. La section Messages de Conversations est disponible uniquement dans le widget et ne peut pas être intégrée.
Configuration de base
Ajoutez un élément conteneur à votre page :
<div data-userjot-embed style="height: 700px"></div>Initialisez ensuite le SDK et montez l’intégration :
uj.init('YOUR_PROJECT_ID', { widget: false });
uj.createEmbed();L’intégration occupe tout l’espace de son conteneur : définissez donc la hauteur du conteneur avec CSS. En transmettant widget: false, vous désactivez le widget flottant, ou laissez-le activé pour utiliser les deux en même temps.
Options et chemins pris en charge
uj.createEmbed({
container: '#my-container', // CSS selector or DOM element, default '[data-userjot-embed]'
path: '/roadmap', // initial page, default '/'
theme: 'auto' // 'auto', 'light', or 'dark'
});Valeurs path valides :
Chemin | Contenu affiché |
|---|---|
| Votre tableau de retours par défaut |
| Un tableau public spécifique |
| Une publication de retours spécifique |
| Feuille de route publique |
| Index du journal des modifications |
| Une mise à jour spécifique du journal des modifications |
| Page d’accueil du centre d’aide (lorsqu’il est publié) |
| Une collection spécifique du centre d’aide |
| Un article spécifique du centre d’aide |
Les chemins obsolètes /board/<board-slug> et /board/p/<post-slug> redirigent vers /feedback/<board-slug> et /feedback/p/<post-slug>.
Contrôler une intégration
uj.createEmbed renvoie un contrôleur une fois le script du SDK chargé :
const embed = uj.createEmbed({ path: '/' });
embed.navigate('/roadmap'); // switch to another page
embed.destroy(); // unmount the embedSynchronisation avec votre URL
Transmettez basePath pour que l’intégration synchronise l’URL de votre navigateur lorsque les utilisateurs naviguent :
uj.createEmbed({
container: '#feedback-page',
basePath: '/feedback'
});Avec basePath: '/feedback', la page de commentaires principale reste à /feedback, l’ouverture d’une publication met à jour l’URL de votre navigateur vers /feedback/feedback/p/<post-slug>, et le chargement direct de cette URL ouvre l’intégration sur cette publication.
Pour que les liens profonds fonctionnent, configurez le routeur de votre application afin que /feedback et /feedback/* affichent tous deux la page qui appelle uj.createEmbed.
L’identité est automatiquement transmise
L’appel de uj.identify connecte l’utilisateur à toutes les intégrations de la page (y compris celles créées ultérieurement), et uj.logout le déconnecte.
Comme la connexion des utilisateurs aux pages intégrées passe par la connexion automatique, assurez-vous que la connexion automatique est activée dans Paramètres → Connexion (offre Starter ou Professional). Sinon, les intégrations se chargeront avec une session déconnectée, même si vous transmettez une identité authentifiée.
uj.identify({ token: 'TOKEN_FROM_YOUR_SERVER' });
uj.createEmbed();Plusieurs intégrations
Montez plusieurs intégrations sur la même page en attribuant à chacune son propre conteneur et son propre chemin :
uj.createEmbed({ container: '#board', path: '/' });
uj.createEmbed({ container: '#roadmap', path: '/roadmap' });Intégration ou widget ?
Utilisez le widget si vous souhaitez que les retours, l’aide, les mises à jour et les messages soient accessibles en un clic, où que vous soyez dans votre application.
Utilisez une intégration si vous souhaitez une page dédiée dans votre propre mise en page, comme
yourapp.com/feedbackouyourapp.com/help.
De nombreux produits utilisent les deux. Consultez la référence du SDK pour découvrir toutes les options d’intégration.