Aller au contenu
Widgets

Intégrer le widget Plutôt là dans votre site

En bref
Pour qui
Chargés de mission web des offices, prestataires, développeurs.
Lecture
10 min
Mise à jour
12 novembre 2026

Les cinq étapes pour afficher le widget, le code à copier, la référence des attributs, la sécurité et une foire aux questions.

Données utilisées

Aucune : le widget calcule l'affluence dans le navigateur avec le jeu de données de Plutôt là.

Adresse du widget

Le widget est servi par https://sdk.hackathon-flux-touristique.vicode.fr. L'éditeur écrit lui-même cette adresse dans le code qu'il vous donne.

En bref : deux lignes

HTML
<script type="module" src="https://sdk.hackathon-flux-touristique.vicode.fr/embed/plutot-la-widget.js"></script> <plutot-la-widget partenaire="alpes-isere" lieu="le-lac-de-paladru-38082"></plutot-la-widget>

La première ligne charge le script, une fois par page. La seconde dit où placer le widget, pour quel partenaire (ses couleurs et ses réglages) et pour quel lieu. Le reste de la page explique comment obtenir ce code à vos couleurs.

Étape 1 : créer votre partenaire

  1. Ouvrez l'éditeur : https://sdk.hackathon-flux-touristique.vicode.fr/editor.
  2. Choisissez « Nouveau partenaire ». Donnez un nom (par exemple « Office de tourisme du Pays de … ») : l'éditeur en tire un identifiant d'adresse (le « slug »), en minuscules, chiffres et tirets, 48 caractères au plus, par exemple office-du-pays-de-x. Il sert d'adresse à votre page : https://sdk.hackathon-flux-touristique.vicode.fr/office-du-pays-de-x.
  3. Le nouveau partenaire part du thème « Les Éclaireurs », l'allure « autocollant » de l'application Plutôt là : carte crème, texte encre, trait et ombre décalée, bouton soleil, un petit Éclaireur à côté du verdict, Nunito. Dans l'onglet Thème, choisissez l'autre préréglage si vous voulez : « Sobre » (blanc, gris et noir, dans la police de votre site). Le widget est toujours clair. L'interrupteur « Allure autocollant » de l'onglet Thème le met à plat, sans trait, ombre ni personnage, s'il doit se fondre dans la page.

Raccourci : l'adresse https://sdk.hackathon-flux-touristique.vicode.fr/editor/<identifiant> d'un partenaire qui n'existe pas encore propose le bouton « Créer « identifiant » », avec le nom et l'identifiant déjà remplis.

Quelques identifiants sont réservés par l'application et refusés : editor, examples, embed, assets, api, index, nouveau.

L'éditeur, onglet Thème, pour le partenaire Plutôt là : en tête les boutons « Voir la page », « Exemples », « Télécharger », « Importer » et « Vider le cache » ; à gauche les six partenaires livrés ; au centre les deux préréglages « Les Éclaireurs » (choisi, avec une coche) et « Sobre », le contrôle « Contrastes lisibles » (13,1:1, 8,5:1 et 7,0:1) et les premières couleurs avec leur pastille et leur code (bouton soleil #FFC941, texte encre #0B3540, fonds blancs) ; à droite l'aperçu en direct de la carte blanche, en largeur mobile, sur la journée chargée de démonstration, avec le bouton soleil « Trouver un coin plus calme »

Source : packages/widget-editeur/src/editor/, page /editor, capture du 12 novembre 2026

Comment lire

Les partenaires à gauche, les réglages au centre, l'aperçu à droite. L'indicateur « Enregistré » confirme que le dernier changement est gardé dans le navigateur.

Étape 2 : régler le thème et le contenu

  • Thème : reprenez les couleurs de votre charte (accent, texte, fond), les arrondis et la police. Choisissez « Police du site » pour que le widget prenne la police de votre page.
  • Contenu : choisissez le lieu (tapez un nom ou une commune, par exemple « Paladru »), la variante (badge, carte ou bandeau) et sa disposition (verdict et jours, onglets, dépliable), un titre et un message, quand montrer les lieux plus calmes, ce qui s'affiche (courbe, meilleur moment, 7 jours, logo), le texte et l'adresse du bouton, la langue.

L'aperçu se met à jour à chaque réglage ; on peut le voir en badge, carte ou bandeau, sur aujourd'hui ou sur une journée chargée de démonstration, et à trois largeurs (mobile, site, large). Tout est enregistré dans votre navigateur ; le détail de chaque réglage est dans la page L'éditeur.

Étape 3 : copier le code

L'onglet Intégration de l'éditeur donne le code à copier, en deux modes.

ModeCe que contient le codeQuand le choisir
Configuration embarquée (recommandé)Le script et l'élément <plutot-la-widget> avec l'attribut config, qui contient tous vos réglages (thème, contenu, logo)Toujours, sur un vrai site : le widget n'a besoin de rien d'autre
Par slugLe script et l'élément avec seulement partenaire="…"Pour les partenaires livrés avec l'application (plutot-la, alpes-isere, chartreuse, grenoble-alpes-tourisme, pays-voironnais, societe-lac-paladru), avec leur réglage d'origine, et pour les pages servies par l'application du widget elle-même

Source : packages/widget/src/embed/snippet.ts, packages/stockage/src/partenaires.ts

Comment lire

Le mode par slug ne marche pas pour un partenaire créé dans votre éditeur : vos réglages restent dans votre navigateur, que le site de l'office ne peut pas lire. Le widget prend alors l'allure par défaut (partenaire plutot-la), avec un avertissement dans la console. Choisissez la configuration embarquée.

Code en configuration embarquée (extrait : l'éditeur ajoute des commentaires d'explication, et le code fait environ 2 600 caractères sans logo) :

HTML
<script type="module" src="https://sdk.hackathon-flux-touristique.vicode.fr/embed/plutot-la-widget.js"></script> <plutot-la-widget partenaire="office-du-pays-de-x" config="eyJ2ZXJzaW9uIjozLCJzbHVnIjoib2ZmaWNlLWR1LXBheXMtZGUteCIs…"></plutot-la-widget>

L'attribut config est la configuration du partenaire (le même contenu que le fichier exporté par l'éditeur), écrite en JSON puis encodée en base64url : un alphabet de lettres, de chiffres, de tirets et de soulignés, qui passe sans risque dans un attribut HTML et garde les accents. Si l'attribut dépasse 50 Ko, l'éditeur retire le logo et l'icône et le dit dans un commentaire du code : allégez les images pour les retrouver. Quand config est présent, c'est lui qui donne le partenaire ; l'attribut partenaire n'est alors qu'un repère pour vous.

Code par slug :

HTML
<script type="module" src="https://sdk.hackathon-flux-touristique.vicode.fr/embed/plutot-la-widget.js"></script> <plutot-la-widget partenaire="pays-voironnais"></plutot-la-widget>

L'éditeur, onglet Intégration, pour Alpes Isère (démo) : « Forme du code » avec le choix « Code court », choisi, ou « Code complet », l'explication « Ce code suit les réglages publiés » (le code court désigne le partenaire par son identifiant alpes-isere), puis « Le code », 760 caractères, avec le bouton « Copier le code » et le début du code dans une zone grise ; à droite l'aperçu du bandeau gris-bleu « Affluence au lac de Paladru », « Très fréquenté », sur la journée chargée de démonstration

Source : packages/widget-editeur/src/editor/OngletIntegration.tsx, packages/widget/src/embed/snippet.ts, capture du 12 novembre 2026

Comment lire

Des commentaires, la ligne du script, puis l'élément <plutot-la-widget> (ici par slug, donc court ; en configuration embarquée, avec son long attribut config). Sur la capture, prise sur un poste de développement, le script vient de http://127.0.0.1:5185 : l'éditeur écrit toujours l'adresse d'où il est servi.

Étape 4 : coller le code dans votre site

Le code se colle à l'endroit où le widget doit apparaître, dans la page du lieu. Le script peut aussi aller une seule fois dans l'en-tête du site ; il ne fait rien sur une page sans élément <plutot-la-widget>.

Outil de publicationOù coller
WordPress (éditeur de blocs)Ajouter un bloc « HTML personnalisé » à l'endroit voulu, y coller le code, enregistrer. Le rôle « Administrateur » (ou le droit unfiltered_html) est nécessaire pour publier une balise <script>.
WordPress (éditeur classique, constructeurs de pages)Onglet « Texte » de l'éditeur, ou module « Code » / « HTML » du constructeur.
DrupalUn bloc personnalisé ou un champ dont le format de texte est « HTML complet » (un format filtré retire la balise <script>).
Wix« Ajouter » puis « Intégrer du code » puis « Code HTML personnalisé » ; choisir « Code », coller. Wix place le code dans un cadre : régler sa hauteur à celle de la variante.
WebflowÉlément « Embed » à l'endroit voulu (le script peut aller dans « Custom code » des réglages de la page).
Site produit par un prestataire, module ApidaeDemander au prestataire un emplacement « HTML libre » dans le gabarit de fiche, avec le lieu en paramètre.
Page statiqueColler les deux lignes dans le HTML, à l'endroit voulu.

Source : documentation de chaque outil ; pour les modules de fiches, Apidae

Comment lire

Les noms de menus peuvent changer selon la version de l'outil. Si l'outil retire les balises <script>, voyez la question « Mon site refuse le script » plus bas.

Étape 5 : vérifier

  1. Ouvrez la page publiée (pas l'aperçu de l'outil, qui bloque parfois les scripts).
  2. Le widget affiche d'abord « Calcul de la prévision… », puis le niveau d'affluence du lieu, à vos couleurs.
  3. Changez la largeur de la fenêtre : la carte et le bandeau s'adaptent jusqu'à la largeur d'un téléphone.
  4. Si l'allure ou le lieu ne sont pas les bons, ouvrez la console du navigateur (touche F12) : un avertissement commençant par [plutot-la-widget] dit ce qui a été ignoré (partenaire inconnu, configuration illisible, valeur d'attribut inconnue). Si rien ne s'affiche du tout, le script est sans doute bloqué : voyez la sécurité du contenu plus bas.
  5. Des repères discrets aident au diagnostic, dans l'inspecteur du navigateur :
    • l'élément <plutot-la-widget> reçoit l'attribut data-config, qui dit d'où vient la configuration affichée : attribut, script, stockage, integre (livrée avec le script) ou defaut ;
    • à l'intérieur (dans son « shadow root », voir plus bas), la racine du widget porte data-variante, data-etat (chargement, pret ou erreur) et la langue (lang).

Référence : l'élément <plutot-la-widget>

AttributValeursPar défautRôle
partenaireun identifiant (slug)plutot-laLe partenaire dont on prend le thème et le contenu
lieuun identifiant de lieu (lieuId) : minuscules, chiffres et tirets, de 2 à 120 caractères, par exemple le-lac-de-paladru-38082le lieu du partenaireLe lieu affiché ; permet un seul partenaire pour toutes les fiches de lieu. Un identifiant bien écrit mais absent du jeu de données affiche un message d'erreur clair dans le widget
variantebadge, carte ou bandeaula variante du partenaireL'allure du widget
dispositionverdict-jours, onglets ou depliablela disposition du partenaireCe qui suit le verdict dans la carte et le bandeau
alternativessi-charge, toujours, a-la-demande ou jamaisle réglage du partenaireQuand montrer les lieux plus calmes à côté
languefr ou en (seules les deux premières lettres comptent : en-GB est lu en)la langue du partenaireLa langue des textes du widget
configla configuration du partenaire, JSON encodé en base64url (version 3 du format ; les versions 1 et 2 sont encore lues)aucuneLes réglages complets ; c'est ce qu'écrit l'éditeur en configuration embarquée. Prioritaire sur tout le reste
<script type="application/json"> enfantla configuration du partenaire, en JSON lisibleaucunMême rôle que config, pour une configuration écrite ou produite à la main (par exemple par le gabarit d'un site)

Source : packages/widget/src/embed/element.tsx, packages/widget/src/embed/resolution.ts

Comment lire

Seule la ligne <script src=…> est obligatoire avec l'élément ; tous les attributs sont facultatifs. Une valeur inconnue est ignorée, avec un avertissement dans la console. L'ancien attribut mode n'est plus lu : sur un code déjà copié, il reste sans effet.

Ordre de résolution

Le widget cherche la configuration du partenaire dans cet ordre, et s'arrête à la première trouvée :

  1. l'attribut config ;
  2. le <script type="application/json"> placé dans l'élément ;
  3. le partenaire nommé par partenaire, enregistré dans le navigateur par l'éditeur, quand la page est servie par la même adresse que l'éditeur (pages d'exemple, page du partenaire) ;
  4. le partenaire nommé par partenaire, s'il est livré avec le script (plutot-la et les cinq partenaires de démonstration), dans son réglage d'origine ;
  5. sinon, le partenaire par défaut plutot-la (thème « Les Éclaireurs »), avec l'avertissement « partenaire … inconnu sur cette page ».

Puis les attributs lieu, variante, disposition, alternatives et langue, s'ils sont présents, remplacent le réglage correspondant de la configuration trouvée. L'ancien attribut mode n'est plus lu, et les champs retirés d'une configuration en version 1 ou 2 (theme.mode, couleursSombre, ombre) sont ignorés : tout est relu en clair. Une configuration illisible (base64url ou JSON cassé, forme inattendue, version du format inconnue) est ignorée, avec un avertissement dans la console, et le widget passe à la source suivante.

Diagramme

Source : packages/widget/src/embed/resolution.ts

Comment lire

Chaque losange est une source possible de la configuration, essayée dans l'ordre. Dès qu'une source répond « oui », on passe à la case du bas, où les attributs simples ont le dernier mot.

Exemples de code

Un seul partenaire, plusieurs fiches de lieu : collez la configuration une fois dans le gabarit de fiche, et changez seulement lieu.

HTML
<plutot-la-widget partenaire="alpes-isere" lieu="le-lac-de-paladru-38082"></plutot-la-widget>

Un badge discret près du titre, et une carte plus bas sur la même page :

HTML
<script type="module" src="https://sdk.hackathon-flux-touristique.vicode.fr/embed/plutot-la-widget.js"></script> <plutot-la-widget partenaire="pays-voironnais" variante="badge"></plutot-la-widget> <!-- … description du lieu … --> <plutot-la-widget partenaire="pays-voironnais" variante="carte"></plutot-la-widget>

Une page en anglais, carte en onglets :

HTML
<plutot-la-widget partenaire="alpes-isere" langue="en" variante="carte" disposition="onglets"></plutot-la-widget>

Sécurité du contenu (CSP)

Certains sites déclarent une politique de sécurité du contenu (en anglais Content Security Policy, CSP) : une liste des adresses d'où la page peut charger des scripts, des styles et des polices. Si la vôtre en a une, ajoutez l'adresse du widget :

Code
Content-Security-Policy: script-src 'self' https://sdk.hackathon-flux-touristique.vicode.fr; font-src 'self' https://sdk.hackathon-flux-touristique.vicode.fr; style-src 'self' 'unsafe-inline'
DirectivePourquoi
script-srcLe script /embed/plutot-la-widget.js, puis les morceaux qu'il charge à la demande depuis /assets/ : le calcul et le jeu de données
font-srcSeulement si le thème utilise Fredoka ou Nunito : les fichiers de police viennent de l'adresse du widget
style-src 'unsafe-inline'Seulement si le thème utilise Fredoka ou Nunito : le script ajoute dans l'en-tête de la page une courte balise de style qui déclare la police (une police déclarée dans le Shadow DOM n'est pas prise en compte par les navigateurs). Le style du widget lui-même passe par une feuille construite, que la CSP ne bloque pas ; seuls les navigateurs anciens (Safari avant 16.4) utilisent une balise de style à la place

Source : packages/widget/src/embed/styles.ts, packages/widget/src/embed/polices.ts

Comment lire

Avec « Police du site » ou « Système » dans le thème, script-src suffit sur les navigateurs récents. Le widget ne fait aucune autre requête : ni connect-src vers un serveur de données, ni frame-src.

L'adresse du widget répond avec l'en-tête Access-Control-Allow-Origin: * sur /embed/ et /assets/ (fichier widget/vercel.json) : un site d'une autre adresse peut donc charger le script en module et les polices.

Questions fréquentes

Peut-on mettre plusieurs widgets sur une page ? Oui. Collez la ligne <script> une seule fois, puis autant d'éléments <plutot-la-widget> que voulu, avec des lieux ou des variantes différents. Le jeu de données n'est chargé qu'une fois. Si le script est collé deux fois par erreur, l'élément n'est défini qu'une fois : rien ne casse.

Le style de mon site va-t-il dérégler le widget ? Non. Le widget est dessiné dans un Shadow DOM : un sous-arbre de la page isolé de sa feuille de style (son « shadow root »). Les règles CSS du site n'y entrent pas, et celles du widget n'en sortent pas. Seules quelques propriétés héritées traversent, et le widget les remet à zéro : la casse (un site tout en majuscules n'y touche pas), l'interligne, l'alignement. La taille du texte ne dépend pas non plus de celle du site : le widget garde une base de 16 px, même sur un site réglé à 10 px. Seule la police est reprise, quand le thème choisit « Police du site ».

Comment régler la largeur et les marges ? L'élément <plutot-la-widget> est un bloc qui prend la largeur disponible ; votre feuille de style peut régler sa boîte, par exemple plutot-la-widget { max-width: 480px; margin-block: 24px; }. À l'intérieur, la carte s'arrête d'elle-même à 480 px et le badge à 360 px ; le bandeau prend toute la largeur.

Comment mettre à jour le widget ? Rien à faire pour le calcul et les données : le script est servi depuis l'adresse du widget, qui est mise à jour à chaque nouvelle version (le navigateur le garde 5 minutes en cache). Sur une page restée ouverte, le widget refait son calcul toutes les 10 minutes : le niveau « maintenant » suit l'heure. Pour changer vos couleurs ou votre contenu, refaites le réglage dans l'éditeur et recollez le code : en configuration embarquée, vos réglages sont dans votre page. Seule exception : une page servie par la même adresse que l'éditeur (les pages d'exemple, la page du partenaire) suit les enregistrements de l'éditeur aussitôt, sans rechargement, si elle n'a pas d'attribut config.

Est-ce que ça ralentit ma page ? Le script est un module, chargé sans bloquer l'affichage de la page. Il est léger ; le jeu de données de Plutôt là (environ 300 Ko compressés, d'après le paquet @flux/data) arrive ensuite, à la demande, une seule fois pour tous les widgets de la page, puis vient du cache du navigateur. Pendant ce temps, le widget affiche « Calcul de la prévision… ».

Le widget est-il accessible ? Le niveau d'affluence est toujours écrit en mots, jamais seulement en couleur, et il se lit aussi au nombre de crans pleins d'une jauge (un à quatre) ; le widget est une région nommée pour les lecteurs d'écran ; la courbe est accompagnée d'une phrase qui résume la journée ; le bouton annonce qu'il ouvre un nouvel onglet et se manie au clavier. Les préréglages respectent le contraste AA (le niveau courant des règles d'accessibilité du web, 4,5:1 pour un texte), et l'éditeur prévient quand une couleur choisie est trop peu contrastée. L'outil axe n'a relevé aucune violation des règles A et AA sur les pages du widget (vérification du 10 novembre 2026).

Quelles données sont envoyées ? Faut-il un bandeau de cookies ? Aucune donnée n'est envoyée, à personne : le calcul se fait dans le navigateur du visiteur. Le widget ne pose aucun cookie, ne lit pas la position et ne compte pas les visites. Il n'ajoute donc rien à votre bandeau de consentement. Seul le téléchargement du script laisse, comme toute ressource, une trace technique dans les journaux de l'hébergeur du widget.

Mon site refuse le script. Certains outils retirent les balises <script> des contenus (Drupal en format filtré, WordPress sans le droit unfiltered_html). Mettez le script dans l'en-tête du site (réglage du thème ou extension « en-tête et pied de page ») et gardez seulement l'élément <plutot-la-widget> dans la page. Si l'élément lui-même est retiré, demandez au prestataire de l'autoriser.

Que voit un visiteur sans JavaScript ? Rien de cassé : l'élément reste vide. Vous pouvez y écrire un lien de repli : il s'affiche sans JavaScript, et le widget prend sa place quand le script se charge : <plutot-la-widget partenaire="…"><a href="…">Voir l'affluence sur Plutôt là</a></plutot-la-widget>.

Limites

À garder en tête

  • Le mode « par slug » ne sert qu'aux partenaires livrés avec l'application et aux pages de l'application elle-même ; pour un vrai site, la configuration embarquée est la seule qui garde vos réglages.
  • Le code en configuration embarquée est long (plusieurs milliers de caractères, davantage avec un logo) : certains champs d'outils de publication limitent la taille.
  • Les chemins de menus des outils (WordPress, Drupal, Wix, Webflow) sont donnés à titre indicatif, sans essai sur chaque version.
Toutes les limites (5)
  • Le widget n'a été essayé que dans les deux copies locales de pages d'exemple, pas dans un vrai site d'office de tourisme.
  • Les niveaux sont des prévisions (déduit), pas des mesures en direct (voir la vue d'ensemble).