Vous affichez une roue dans un stream en direct ? Lisez le guide de la roue pour OBS

Intégrez une roue de la chance à votre site web

Saisissez vos entrées, choisissez comment les visiteurs utilisent la roue et copiez un seul extrait de code. Il fonctionne sur toute page https qui accepte le HTML, sans compte, sans plugin et sans frais.

Vous créez des roues depuis votre serveur ? Utilisez l’API ChoiceSpin pour développeurs pour enregistrer des roues, créer des liens vers des roues prêtes à tourner et piloter les tours des roues intégrées.

Configurez votre roue

Ajoutez les entrées, choisissez les commandes et vérifiez l’aperçu.

1 Entrées
De 2 à 100 entrées, 80 caractères maximum chacune 4 / 100
2 Commandes pour les visiteurs
3 Apparence
Arrière-plan
Couleurs de la roue
5 secondes
Titre de la roue

Aperçu en direct

Voici la roue que vos visiteurs utiliseront. Faites un tour d’essai.

Mode interactif

Roue proposée par ChoiceSpin

4 entrées · Cliquez pour tourner Ouvrir la roue sur sa propre page

Copiez le code pour votre site

Collez ce code dans un bloc HTML ou d’intégration. La roue se redimensionne avec votre page.

Vos entrées sont enregistrées dans le code, pas sur nos serveurs. Toute personne qui peut voir le code source de votre page peut les lire : n’y mettez donc ni noms privés, ni mots de passe, ni informations de compte.

Comment intégrer une roue de la chance

Trois étapes, et la roue est en ligne sur votre page. Vous pouvez revenir la modifier à tout moment.

  1. 01

    Ajoutez vos entrées

    Saisissez ci-dessus de 2 à 100 entrées, une par ligne. Choisissez les commandes, les couleurs et la durée de rotation.

  2. 02

    Faites tourner l’aperçu

    L’aperçu fait tourner la même roue que celle de vos visiteurs : un tour d’essai ici montre donc comment elle se comportera sur votre page.

  3. 03

    Collez le code

    Copiez l’extrait de code dans un bloc HTML ou un bloc d’intégration de votre page, puis publiez la page comme d’habitude.

Où coller le code

La plupart des créateurs de sites proposent un bloc pour le HTML ou le code d’intégration, mais chacun l’appelle différemment. Sur une page que vous écrivez vous-même, collez l’extrait de code dans <body>, à l’endroit où la roue doit apparaître. Il n’y a ni balise script, ni feuille de style, ni clé d’API à ajouter.

WordPress

  1. Dans l’éditeur de blocs, saisissez /html et choisissez le bloc « HTML personnalisé ».
  2. Collez le code, puis mettez à jour ou publiez la page.

Dans l’éditeur classique, collez-le dans l’onglet « Texte ». WordPress ne conserve le code d’intégration que s’il vient d’utilisateurs autorisés à publier du HTML non filtré, en général les administrateurs et les éditeurs. Sur WordPress.com, il faut un forfait payant avec les fonctionnalités d’hébergement activées.

Google Sites

  1. Cliquez sur « Insérer », puis sur « Intégrer », puis sur l’onglet « Intégrer le code ».
  2. Collez le code, cliquez sur « Suivant », puis sur « Insérer ».
  3. Faites glisser les bords de la zone jusqu’à ce que la roue entière soit visible, puis cliquez sur « Publier ».

Wix

  1. Cliquez sur « Ajouter des éléments », puis sur « Code d’intégration », puis sur « HTML intégré ».
  2. Cliquez sur le nouvel élément, choisissez « Saisir code », collez le code et cliquez sur « Appliquer ».
  3. Faites glisser les bords de l’élément jusqu’à ce que la roue tienne en entier.

Dans Wix Studio, le même élément se trouve dans « Ajouter des éléments », puis « Intégrer et social », puis « Code d’intégration ».

Squarespace

  1. Cliquez sur « Ajouter un bloc », choisissez « Code », puis cliquez sur l’icône en forme de crayon.
  2. Collez le code, choisissez le mode HTML et laissez « Afficher la source » désactivé.

Le code d’intégration fonctionne avec les forfaits Essentiel, Plus et Advanced ainsi qu’avec les anciens forfaits Business et Commerce, mais pas avec le forfait Basic. Si la roue n’apparaît pas alors que vous êtes connecté, vérifiez la page avec « Aperçu en mode sécurisé ».

Webflow

  1. Ouvrez le panneau « Add » et faites glisser un élément « Code Embed » sur la page.
  2. Collez le code, puis cliquez sur « Save & Close ».

L’élément « Code Embed » nécessite un forfait Workspace ou Site payant.

Shopify

  1. Allez dans « Boutique en ligne », puis « Pages », et ouvrez une page.
  2. Dans la barre d’outils de l’éditeur, cliquez sur le bouton d’affichage du code HTML, collez le code et cliquez sur « Enregistrer ».

Pour placer plutôt la roue dans une section du thème, ouvrez l’éditeur de thème, cliquez sur « Ajouter une section » et choisissez « Liquid personnalisé ».

Notion

  1. Passez la sortie ci-dessus sur « URL directe » et copiez le lien.
  2. Dans Notion, saisissez /embed, choisissez « Embed link » et collez le lien.

Notion n’accepte que des liens : y coller le code d’intégration ne fonctionne donc pas.

Canvas LMS

  1. Dans le Rich Content Editor, choisissez « Insert », puis « Embed ».
  2. Collez le code dans « Embed Code » et cliquez sur « Submit ».

Si votre établissement a activé la politique de sécurité du contenu de Canvas, un administrateur devra peut-être ajouter choicespin.com à ses domaines autorisés.

Moodle

  1. Dans une ressource Page ou un bloc HTML, ouvrez le menu « Outils » de l’éditeur et choisissez « Code source ».
  2. Collez le code et enregistrez.

Les messages de forum suppriment le code d’intégration, de même que toutes les zones des sites où le réglage « Content cleaning everywhere » est activé.

Quand un forfait supprime le code d’intégration, ou qu’un outil n’accepte que des liens, passez la sortie ci-dessus sur « URL directe ». Collée comme lien ou sur un bouton, elle ouvre la même roue sur sa propre page.

Utiliser la roue dans Google Slides ou PowerPoint

Les applications de présentation n’exécutent pas le code d’intégration : la méthode fiable est donc un lien. Un clic pendant le diaporama ouvre la roue dans un onglet du navigateur, prête à tourner.

Google Slides

Sélectionnez du texte sur une diapositive, choisissez « Insertion », puis « Lien » (Ctrl+K, ou ⌘+K sur Mac), et collez l’URL directe. En mode présentation, cliquez sur le lien pour ouvrir la roue, faites-la tourner, puis revenez à vos diapositives.

PowerPoint

Sélectionnez du texte ou une forme, appuyez sur Ctrl+K (⌘+K sur Mac) et collez l’URL directe. Cliquez dessus pendant le diaporama pour ouvrir la roue dans votre navigateur. Microsoft a retiré son complément gratuit Web Viewer en décembre 2024. Des compléments payants d’autres éditeurs peuvent afficher des pages web dans une diapositive, mais nous ne les avons pas testés.

Modifier la taille

Le code occupe votre colonne de contenu jusqu’à 760 pixels de large, et la hauteur suit la largeur.

Réduire la largeur

Dans la première ligne, modifiez max-width:760px pour indiquer une largeur plus petite, par exemple 480px. La roue rétrécit en conséquence et reste centrée.

Garder la roue lisible sur téléphone

La valeur min-height empêche l’iframe de devenir trop court sur les écrans étroits : 460 pixels pour une roue seule, 560 avec le bouton pour faire tourner la roue et 760 quand les visiteurs peuvent la modifier. Conservez-la.

Créateurs de sites qui placent les intégrations dans une zone

Sur Wix, Google Sites et les créateurs de sites similaires, le code se trouve dans une zone que vous pouvez redimensionner. Ajustez-la jusqu’à ce que la roue entière et la mention s’affichent sans barre de défilement.

Ce que vos visiteurs obtiennent

L’intégration fait tourner la même roue que ChoiceSpin lui-même, dans son propre iframe.

Un tirage équitable

Chaque entrée a la même chance à chaque tour. Dans les navigateurs récents, des nombres aléatoires issus de Web Crypto désignent le gagnant. Découvrez comment la roue choisit.

Clavier et lecteurs d’écran

Les visiteurs peuvent placer le focus sur la roue et appuyer sur Espace ou Entrée pour la lancer. Les lecteurs d’écran annoncent chaque résultat dès qu’il sort.

Ni cookies ni suivi

L’iframe est isolé (sandbox) : il ne peut donc ni déposer de cookies ni enregistrer quoi que ce soit dans le navigateur. Il ne charge ni publicité ni outil de mesure d’audience.

Une page légère

Le code demande au navigateur de ne charger la roue que lorsqu’un visiteur fait défiler la page jusqu’à ses abords : le haut de votre page reste donc rapide.

Piloter la roue avec JavaScript

Le code copié fonctionne tel quel. Si vous écrivez vous-même le code de votre page, vous pouvez aussi lancer des tours, modifier les entrées et lire chaque gagnant grâce à des messages entre fenêtres, sans assouplir le sandbox de l’iframe.

Lancer un tour et lire le gagnant

Ajoutez <button id="spin-from-page" type="button" disabled>Spin</button> à votre page et placez ce script après le code d’intégration. La roue ignore les commandes tant qu’elle n’a pas envoyé ready : le bouton reste donc désactivé jusque-là.

const frame = document.querySelector('iframe[src^="https://choicespin.com/e"]');
const spinButton = document.querySelector("#spin-from-page");

// Every message carries the same channel and version.
function send(action, extra = {}) {
  frame.contentWindow.postMessage(
    { channel: "choicespin.embed", version: 1, action, ...extra },
    "*"
  );
}

window.addEventListener("message", (event) => {
  if (event.source !== frame.contentWindow || event.origin !== "null") return;
  const data = event.data;
  if (data?.channel !== "choicespin.embed" || data?.version !== 1) return;
  if (data.event === "ready") spinButton.disabled = false;
  if (data.event === "spin-end") console.log("Winner:", data.winner);
});

spinButton.addEventListener("click", () => send("spin"));

Actions que vous pouvez envoyer

  • spin lance un tour
  • setEntries remplace les entrées par un tableau entries de 2 à 100 chaînes de caractères
  • addEntry ajoute une chaîne entry
  • removeWinner retire le dernier gagnant
  • reset rétablit les entrées du code d’intégration

Événements que vous recevez

ready, spin-start, spin-end avec winner et index, entries-changed et error. Chacun indique aussi le nombre actuel d’entrées dans count.

Trois règles à connaître

Envoyez les messages avec "*" comme cible, car un iframe isolé (sandbox) n’a pas d’origine que vous pourriez nommer. Le message n’est tout de même transmis qu’à ce seul iframe. Quand un message revient, son origine vaut "null" : ne lui faites donc confiance que si event.source est bien la fenêtre de l’iframe. La roue n’écoute que la page qui l’intègre et répond à une commande mal formée par un événement error. Conservez tels quels les attributs sandbox et referrerpolicy générés : les commandes ordinaires ont besoin de l’origine de la page parente, déduite du référent. Si un rechargement supprime ce référent, le script d’aide pour développeurs facultatif peut rétablir la connexion grâce à une poignée de main validée, émise par la véritable page parente en HTTPS.

Si la roue ne s’affiche pas

La plupart des problèmes viennent de l’endroit où le code a été collé. Vérifiez d’abord ces points.

Le code s’affiche sous forme de texte

Il a été collé dans un bloc de texte ordinaire. Supprimez-le et collez-le plutôt dans un bloc HTML, un bloc de code ou un bloc d’intégration.

Une zone vide

La roue ne se charge que sur les pages servies en https. Si l’adresse de votre page commence par http, ou si votre forfait supprime le code d’intégration, utilisez l’URL directe comme lien.

La roue est coupée

La zone d’intégration est trop courte. Agrandissez-la en hauteur jusqu’à ce que la roue, ses boutons et la mention soient tous visibles. L’iframe seul demande au moins 460 pixels, 560 avec le bouton pour faire tourner la roue et 760 quand les visiteurs peuvent la modifier. La mention en ajoute environ 30.

Pas de son

Vérifiez que « Jouer un son de fin » est coché. Les navigateurs n’autorisent le son qu’après un clic ou l’appui sur une touche dans l’iframe : un tour lancé avant cela depuis votre propre code reste donc muet.

Questions fréquentes

Des réponses courtes avant d’ajouter la roue à une page publique.

La roue intégrée est-elle gratuite ?

Oui. Elle ne coûte rien, ne demande aucune inscription, et le même code peut être placé sur autant de pages que vous le souhaitez.

Comment modifier la roue après l’avoir intégrée ?

Pour une roue créée avec cet outil, créez ici la nouvelle version et remplacez l’ancien code sur votre page. Ses entrées sont stockées dans le code lui-même : il n’y a donc ni compte ni copie enregistrée à mettre à jour. Les roues créées par un serveur via l’API ont, elles, des enregistrements distincts.

Les visiteurs peuvent-ils modifier ma roue ?

Uniquement leur propre copie. Avec « Laisser les visiteurs modifier la roue », ils peuvent saisir de nouvelles entrées, et le bouton « Retirer le gagnant » ou l’option « Retirer chaque gagnant » enlève les gagnants. Leurs modifications ne changent ni votre roue d’origine ni la copie de quelqu’un d’autre, et un rechargement rétablit vos entrées.

La roue intégrée utilise-t-elle des cookies ou suit-elle les visiteurs ?

Non. La roue s’exécute dans un iframe isolé (sandbox) qui ne peut ni déposer de cookies ni stocker quoi que ce soit dans le navigateur, et elle ne charge ni publicité ni outil de mesure d’audience. Pour les roues générées par l’outil, les entrées font partie du code : toute personne qui consulte le code source de votre page peut donc les lire. Les instantanés créés via l’API sont stockés sur le serveur et peuvent être lus par toute personne disposant de leur lien.

Combien d’entrées une roue intégrée peut-elle contenir ?

De 2 à 100 entrées de 80 caractères maximum chacune. Comme les entrées sont transmises dans le lien lui-même, elles peuvent occuper au total environ 3 900 caractères, ou moins avec des écritures comme le japonais. Pour des listes plus longues, des pondérations ou des résultats enregistrés, utilisez la roue ChoiceSpin complète, qui accepte jusqu’à 2 000 entrées.

La roue intégrée fonctionne-t-elle sur téléphone ?

Oui. Elle occupe toute la largeur de votre colonne de contenu et sa hauteur ne descend jamais sous 460 pixels : les libellés restent donc lisibles sur les petits écrans. Les visiteurs la lancent d’un simple appui.

Puis-je retirer la mention ChoiceSpin ?

Oui. Décochez « Afficher une mention ChoiceSpin » avant de copier le code, ou supprimez ensuite du code la ligne de la mention. La roue fonctionne de la même façon dans les deux cas.

La page de la roue apparaîtra-t-elle dans Google à la place de ma page ?

Non. La page qui ne contient que la roue est marquée noindex : elle reste donc hors des résultats de recherche. La visibilité de votre page dans les moteurs de recherche dépend de son propre contenu et de ses propres réglages.

Besoin de plus de 100 entrées ?

La roue complète accepte jusqu’à 2 000 entrées, avec des pondérations, des images, des roues enregistrées et un historique des résultats. Les enseignants trouveront des idées pour la classe dans le guide pour les enseignants.

Ouvrir la roue complète