Intégrer le widget Plutôt là dans votre site
En bref : deux lignes
HTML
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
- Ouvrez l'éditeur :
https://.sdk. hackathon- flux- touristique. vicode. fr/ editor - 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-. Il sert d'adresse à votre page :du- pays- de- x https://.sdk. hackathon- flux- touristique. vicode. fr/ office- du- pays- de- x - 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:// 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.

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.
| Mode | Ce que contient le code | Quand le choisir |
|---|---|---|
| Configuration embarquée (recommandé) | Le script et l'élément <plutot- 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 slug | Le script et l'élément avec seulement partenaire= | Pour les partenaires livrés avec l'application (plutot-la, alpes-isere, chartreuse, grenoble-, pays-, societe-), 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
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

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- (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:// : 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-.
| Outil de publication | Où 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_) 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. |
| Drupal | Un 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 Apidae | Demander au prestataire un emplacement « HTML libre » dans le gabarit de fiche, avec le lieu en paramètre. |
| Page statique | Coller 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
- Ouvrez la page publiée (pas l'aperçu de l'outil, qui bloque parfois les scripts).
- Le widget affiche d'abord « Calcul de la prévision… », puis le niveau d'affluence du lieu, à vos couleurs.
- Changez la largeur de la fenêtre : la carte et le bandeau s'adaptent jusqu'à la largeur d'un téléphone.
- Si l'allure ou le lieu ne sont pas les bons, ouvrez la console du navigateur (touche F12) : un avertissement commençant par
[plutot-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.la- widget] - Des repères discrets aident au diagnostic, dans l'inspecteur du navigateur :
- l'élément
<plutot-reçoit l'attributla- widget> data-config, qui dit d'où vient la configuration affichée :attribut,script,stockage,integre(livrée avec le script) oudefaut; - à l'intérieur (dans son « shadow root », voir plus bas), la racine du widget porte
data-,variante data-etat(chargement,pretouerreur) et la langue (lang).
- l'élément
Référence : l'élément <plutot- la- widget>
| Attribut | Valeurs | Par défaut | Rôle |
|---|---|---|---|
partenaire | un identifiant (slug) | plutot-la | Le partenaire dont on prend le thème et le contenu |
lieu | un identifiant de lieu (lieuId) : minuscules, chiffres et tirets, de 2 à 120 caractères, par exemple le- | le lieu du partenaire | Le 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 |
variante | badge, carte ou bandeau | la variante du partenaire | L'allure du widget |
disposition | verdict-, onglets ou depliable | la disposition du partenaire | Ce qui suit le verdict dans la carte et le bandeau |
alternatives | si-charge, toujours, a-la-demande ou jamais | le réglage du partenaire | Quand montrer les lieux plus calmes à côté |
langue | fr ou en (seules les deux premières lettres comptent : en-GB est lu en) | la langue du partenaire | La langue des textes du widget |
config | la configuration du partenaire, JSON encodé en base64url (version 3 du format ; les versions 1 et 2 sont encore lues) | aucune | Les réglages complets ; c'est ce qu'écrit l'éditeur en configuration embarquée. Prioritaire sur tout le reste |
<script type= enfant | la configuration du partenaire, en JSON lisible | aucun | Mê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 :
- l'attribut
config; - le
<script type=placé dans l'élément ;"application/ json"> - 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) ; - le partenaire nommé par
partenaire, s'il est livré avec le script (plutot-laet les cinq partenaires de démonstration), dans son réglage d'origine ; - 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.
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
Un badge discret près du titre, et une carte plus bas sur la même page :
HTML
Une page en anglais, carte en onglets :
HTML
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
| Directive | Pourquoi |
|---|---|
script-src | Le script /embed/, puis les morceaux qu'il charge à la demande depuis /assets/ : le calcul et le jeu de données |
font-src | Seulement si le thème utilise Fredoka ou Nunito : les fichiers de police viennent de l'adresse du widget |
style- | 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- sur /embed/ et /assets/ (fichier widget/) : 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- 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- est un bloc qui prend la largeur disponible ; votre feuille de style peut régler sa boîte, par exemple plutot-. À 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_). 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- 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-.
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).