Implémentation
Dernière mise à jour
Cet article vous a-t-il été utile ?
Dernière mise à jour
Cet article vous a-t-il été utile ?
Une fois votre widget créé sur MeltingSpot, vous pouvez l'intégrer dans la page de votre choix. Selon le type de widget que vous avez choisi (embed
, drawer
ou modale
), votre widget ne s'intégrera pas de la même façon. A vous de choisir le mode de rendu qui vous convient le mieux !
Vous pouvez récupérer le code d'un widget en cliquant sur le bouton Récupérer le code
, depuis 2 endroits différents :
La fenêtre d'aperçu du widget.
La carte d'un widget dans la liste des widgets.
Un menu s'ouvre. Ce menu vous propose 2 façons différentes de récupérer le code :
Envoyer les instructions
: permet d'ouvrir votre boite mail avec un email pré-rédigé contenant le code de votre widget.
Copier le code
: permet d'ouvrir une fenêtre contenant le code de votre widget. Vous pouvez copier les 2 morceaux du code en cliquant sur Copier
.
Ce code est en deux parties et va vous permettre d'intégrer votre widget à votre application ou site internet.
Copiez le premier script présenté et collez le dans la section <head>
de votre page.
Copiez le second script présenté et ajoutez-le à une section (un frame) contenue dans le <body>
de votre page.
Vous pouvez être amenés à éditer plusieurs éléments de ce script pour paramétrer l'apparence de votre widget et son intégration :
La taille du frame. Par défaut, le style="width:100%;height:100%"
fait prendre au frame 100% de l'espace disponible dans son élément parent. Vous pouvez changer ce paramètre mais nous recommandons de modifier le style de l'élément parent pour changer la taille de votre widget.
Le mode d'apparence du frame (widget clair ou sombre). Par défaut le themeMode
prend la valeur Auto
, mais vous pouvez éditer sa valeur pour lui faire prendre l'une des 4 options suivantes :
auto
Reprend le mode de l'appareil de l'utilisateur, sauf lorsque celui-ci indique une autre préférence dans ses paramètres profil.
system
Reprend le mode de l'appareil de l'utilisateur.
light
Tous les utilisateurs verront le widget en mode clair.
dark
Tous les utilisateurs verront le widget en mode sombre.
Par exemple, si l'interface dans laquelle vous intégrez le frame est blanche, nous recommandons de paramétrer le themeMode
sur light
.
Le domaine de redirection de l'utilisateur : ce paramètre concerne uniquement les Spots pour lesquels un embed a été effectué sur plusieurs domaines. Si vous nous avez transmis via token JWT ou via API une ou plusieurs clés de domaines, cette fonctionnalité vous est accessible. (Plus de détails sur le multi-domaines ici). Redirigez l'utilisateur qui cliquera sur un widget vers le domaine de votre choix en indiquant la clé du domaine dans le script, de cette manière :