Chcesz pokazać koło na streamie? Przeczytaj poradnik o kole w OBS

Osadź koło losujące na swojej stronie

Wpisz opcje, wybierz, jak odwiedzający mają korzystać z koła, i skopiuj jeden fragment kodu. Działa na każdej stronie https, która przyjmuje HTML, bez konta, wtyczki i opłat.

Tworzysz koła po stronie serwera? Użyj API ChoiceSpin dla programistów, aby zapisywać koła, tworzyć linki do kół gotowych do zakręcenia i sterować losowaniem w osadzonych kołach.

Skonfiguruj koło

Dodaj opcje, wybierz sterowanie i sprawdź podgląd.

1 Opcje
Od 2 do 100 opcji, każda do 80 znaków 4 / 100
2 Sterowanie dla odwiedzających
3 Wygląd
Tło
Kolory koła
5 sekund
Tytuł koła

Podgląd na żywo

Tego koła będą używać twoi odwiedzający. Spróbuj zakręcić.

Tryb interaktywny

Koło z serwisu ChoiceSpin

4 opcje · Kliknij, aby zakręcić Otwórz koło na osobnej stronie

Skopiuj kod na swoją stronę

Wklej ten kod do bloku HTML lub bloku osadzania. Koło dopasowuje się do rozmiaru strony.

Twoje opcje są zapisane w kodzie, a nie na naszych serwerach. Każdy, kto widzi źródło twojej strony, może je odczytać, więc pomiń prywatne imiona i nazwiska, hasła oraz dane kont.

Jak osadzić koło losujące

Trzy kroki i koło działa na twojej stronie. W każdej chwili możesz tu wrócić i je zmienić.

  1. 01

    Dodaj opcje

    Wpisz powyżej od 2 do 100 opcji, po jednej w wierszu. Wybierz sterowanie, kolory i czas losowania.

  2. 02

    Zakręć kołem w podglądzie

    Podgląd uruchamia to samo koło, które dostaną odwiedzający, więc testowe zakręcenie pokaże, jak będzie działać na twojej stronie.

  3. 03

    Wklej kod

    Wklej fragment kodu do bloku HTML lub bloku osadzania na swojej stronie, a potem opublikuj stronę jak zwykle.

Gdzie wkleić kod

Większość kreatorów stron ma blok na HTML lub kod do osadzenia, ale każdy nazywa go inaczej. Na stronie, którą piszesz samodzielnie, wklej fragment kodu wewnątrz <body> w miejscu, w którym ma się pojawić koło. Nie trzeba dodawać tagu script, arkusza stylów ani klucza API.

WordPress

  1. W edytorze blokowym wpisz /html i wybierz blok „Custom HTML”.
  2. Wklej kod, a potem zaktualizuj lub opublikuj stronę.

W edytorze klasycznym wklej go na karcie „Text”. WordPress zachowuje kod do osadzenia tylko od użytkowników, którzy mogą publikować niefiltrowany HTML, zwykle od administratorów i redaktorów. W WordPress.com potrzebny jest płatny plan z włączonymi funkcjami hostingu.

Google Sites

  1. Kliknij „Insert”, potem „Embed”, a następnie kartę „Embed code”.
  2. Wklej kod, kliknij „Next”, a potem „Insert”.
  3. Przeciągaj krawędzie ramki, aż widać będzie całe koło, a potem kliknij „Publish”.

Wix

  1. Kliknij „Add Elements”, potem „Embed Code”, a następnie „Embed HTML”.
  2. Kliknij nowy element, wybierz „Enter Code”, wklej kod i kliknij „Apply”.
  3. Przeciągaj krawędzie elementu, aż koło się zmieści.

W Wix Studio ten sam element znajdziesz w „Add Elements”, potem „Embed & Social”, a następnie „Embed Code”.

Squarespace

  1. Kliknij „Add block”, wybierz „Code”, a potem kliknij ikonę ołówka.
  2. Wklej kod, ustaw tryb HTML i nie włączaj „Display Source”.

Kod do osadzenia działa w planach Core, Plus i Advanced oraz w starszych planach Business i Commerce, ale nie w planie Basic. Jeśli po zalogowaniu nie widzisz koła, sprawdź stronę za pomocą „Preview in Safe Mode”.

Webflow

  1. Otwórz panel „Add” i przeciągnij element „Code Embed” na stronę.
  2. Wklej kod, a potem kliknij „Save & Close”.

Element „Code Embed” wymaga płatnego planu Workspace lub Site.

Shopify

  1. Przejdź do „Online Store”, potem do „Pages” i otwórz stronę.
  2. Kliknij „Show HTML” na pasku narzędzi edytora, wklej kod i kliknij „Save”.

Aby zamiast tego umieścić koło w sekcji motywu, otwórz „Edit theme”, kliknij „Add section” i wybierz „Custom Liquid”.

Notion

  1. Przełącz powyżej kartę na „Bezpośredni adres URL” i skopiuj link.
  2. W Notion wpisz /embed, wybierz „Embed link” i wklej link.

Notion przyjmuje tylko linki, więc wklejenie tam kodu do osadzenia nie zadziała.

Canvas LMS

  1. W „Rich Content Editor” wybierz „Insert”, a potem „Embed”.
  2. Wklej kod w pole „Embed Code” i kliknij „Submit”.

Jeśli twoja szkoła włączyła w Canvas politykę bezpieczeństwa treści, administrator może musieć dodać choicespin.com do dozwolonych domen.

Moodle

  1. W zasobie „Page” lub bloku „HTML” otwórz w edytorze menu „Tools” i wybierz „Source code”.
  2. Wklej kod i zapisz.

Moodle usuwa kod do osadzenia z postów na forum, a w serwisach z włączoną opcją „Content cleaning everywhere” także ze wszystkich innych miejsc.

Jeśli twój plan usuwa kod do osadzenia albo narzędzie przyjmuje tylko link, przełącz powyżej kartę na „Bezpośredni adres URL”. Wklejony jako link lub przycisk otwiera to samo koło na osobnej stronie.

Koło w Prezentacjach Google lub w PowerPoincie

Programy do prezentacji nie uruchamiają kodu do osadzenia, więc najpewniejszym sposobem jest link. Jedno kliknięcie podczas pokazu slajdów otwiera koło w karcie przeglądarki, gotowe do zakręcenia.

Google Slides

Zaznacz tekst na slajdzie, wybierz „Insert”, a potem „Link” (Ctrl+K lub ⌘+K na Macu) i wklej bezpośredni adres URL. W trybie prezentacji kliknij link, aby otworzyć koło, zakręć nim, a potem wróć do slajdów.

PowerPoint

Zaznacz tekst lub kształt, naciśnij Ctrl+K (⌘+K na Macu) i wklej bezpośredni adres URL. Kliknij link podczas pokazu slajdów, aby otworzyć koło w przeglądarce. Microsoft wycofał swój darmowy dodatek Web Viewer w grudniu 2024 r. Płatne dodatki innych firm potrafią wyświetlać strony internetowe wewnątrz slajdu, ale ich nie testowaliśmy.

Zmień rozmiar

Kod wypełnia kolumnę z treścią do szerokości 760 pikseli, a wysokość dopasowuje się do szerokości.

Zwęż koło

Zmień max-width:760px w pierwszym wierszu na mniejszą szerokość, na przykład 480px. Koło zmniejszy się razem z nią i pozostanie wyśrodkowane.

Zadbaj o czytelność na telefonach

Wartość min-height nie pozwala, by ramka stała się zbyt niska na wąskich ekranach: 460 pikseli dla samego koła, 560 z przyciskiem losowania i 760, gdy odwiedzający mogą edytować. Nie usuwaj jej.

Kreatory, które otaczają osadzone elementy ramką

W Wix, Google Sites i podobnych kreatorach kod znajduje się w ramce, której rozmiar możesz zmieniać. Przeciągaj ramkę, aż całe koło i linijka z podpisem będą widoczne bez paska przewijania.

Co dostają odwiedzający

Osadzony kod uruchamia to samo koło co ChoiceSpin, tylko we własnej ramce.

Uczciwe losowanie

Przy każdym zakręceniu każda opcja ma taką samą szansę. W nowoczesnych przeglądarkach zwycięzcę wybierają liczby losowe z Web Crypto. Zobacz, jak koło losuje.

Klawiatura i czytniki ekranu

Odwiedzający mogą ustawić fokus na kole i nacisnąć spację lub Enter, aby zakręcić. Czytniki ekranu odczytują każdy wynik, gdy tylko padnie.

Bez plików cookie i śledzenia

Ramka jest izolowana (sandbox), więc nie może ustawiać plików cookie ani niczego zapisywać w przeglądarce. Nie wczytuje reklam ani narzędzi analitycznych.

Lekka strona

Kod prosi przeglądarkę, aby wczytała koło dopiero wtedy, gdy odwiedzający przewinie stronę w jego pobliże, dzięki czemu górna część strony ładuje się szybko.

Steruj kołem za pomocą JavaScriptu

Skopiowany kod działa samodzielnie. Jeśli piszesz własny kod strony, możesz też uruchamiać losowanie, zmieniać opcje i odczytywać każdego zwycięzcę za pomocą komunikatów między oknami, bez osłabiania izolacji ramki.

Uruchom losowanie i odczytaj zwycięzcę

Dodaj <button id="spin-from-page" type="button" disabled>Spin</button> do swojej strony i umieść ten skrypt po kodzie do osadzenia. Koło ignoruje polecenia, dopóki nie wyśle ready, więc do tego czasu przycisk pozostaje wyłączony.

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"));

Akcje, które możesz wysłać

  • spin uruchamia losowanie
  • setEntries zastępuje opcje tablicą entries zawierającą od 2 do 100 ciągów znaków
  • addEntry dodaje jeden ciąg znaków entry
  • removeWinner usuwa ostatniego zwycięzcę
  • reset przywraca opcje z kodu

Zdarzenia, które otrzymujesz

ready, spin-start, spin-end z polami winner i index, entries-changed oraz error. Każde z nich podaje też aktualną liczbę opcji w polu count.

Trzy zasady, które warto znać

Wysyłaj komunikaty z "*" jako celem, bo izolowana ramka nie ma pochodzenia (origin), które dałoby się podać. Komunikat i tak trafia tylko do tej jednej ramki. Gdy przychodzi odpowiedź, jej pochodzenie ma wartość "null", więc ufaj jej tylko wtedy, gdy event.source jest też oknem tej ramki. Koło nasłuchuje tylko strony, która je osadza, a na nieprawidłowe polecenie odpowiada zdarzeniem error. Zachowaj wygenerowane atrybuty sandbox i referrerpolicy bez zmian: zwykłe polecenia wymagają pochodzenia strony nadrzędnej, odczytanego z referrera. Jeśli po odświeżeniu referrera zabraknie, opcjonalny skrypt pomocniczy dla programistów może ponownie nawiązać połączenie przez zweryfikowany handshake z rzeczywistej strony nadrzędnej HTTPS.

Jeśli koło się nie wyświetla

Większość problemów wynika z miejsca, w które wklejono kod. Najpierw sprawdź te punkty.

Kod wyświetla się jako tekst

Trafił do zwykłego bloku tekstowego. Usuń go i wklej do bloku HTML, bloku kodu lub bloku osadzania.

Pusta ramka

Koło wczytuje się tylko na stronach serwowanych przez https. Jeśli adres twojej strony zaczyna się od http albo twój plan usuwa kod do osadzenia, użyj bezpośredniego adresu URL jako linku.

Koło jest ucięte

Ramka z osadzonym kołem jest za niska. Przeciągnij ją w dół, aż widać będzie koło, jego przyciski i linijkę z podpisem. Sama ramka potrzebuje co najmniej 460 pikseli, 560 z przyciskiem losowania i 760, gdy odwiedzający mogą edytować. Linijka z podpisem dodaje około 30 pikseli.

Brak dźwięku

Sprawdź, czy opcja „Odtwarzaj dźwięk zakończenia” jest zaznaczona. Przeglądarki pozwalają na dźwięk dopiero wtedy, gdy odwiedzający kliknie w ramce lub naciśnie w niej klawisz, więc losowanie uruchomione wcześniej z twojego kodu odbędzie się bez dźwięku.

Częste pytania

Krótkie odpowiedzi, zanim dodasz koło na publiczną stronę.

Czy osadzone koło jest darmowe?

Tak. Nic nie kosztuje, nie wymaga rejestracji, a ten sam kod możesz wstawić na dowolnie wielu stronach.

Jak zmienić koło po osadzeniu?

Jeśli koło powstało w tym kreatorze, przygotuj tutaj nową wersję i zastąp stary kod na swojej stronie. Opcje są zapisane w samym kodzie, więc nie ma konta ani zapisanej kopii do aktualizacji. Koła tworzone na serwerze przez API mają osobne zapisane rekordy.

Czy odwiedzający mogą zmienić moje koło?

Tylko własną kopię. Gdy włączysz „Pozwól odwiedzającym edytować”, mogą wpisywać nowe opcje, a przycisk „Usuń zwycięzcę” lub ustawienie „Usuwaj każdego zwycięzcę” usuwa zwycięzców. Ich zmiany nie wpływają na twoje oryginalne koło ani na kopie innych osób, a odświeżenie strony przywraca twoje opcje.

Czy osadzone koło używa plików cookie lub śledzi odwiedzających?

Nie. Koło działa w izolowanej ramce (sandbox), która nie może ustawiać plików cookie ani niczego zapisywać w przeglądarce, i nie wczytuje reklam ani narzędzi analitycznych. W kołach wygenerowanych w kreatorze opcje są częścią kodu, więc może je odczytać każdy, kto obejrzy źródło twojej strony. Migawki utworzone przez API są przechowywane na serwerze i może je odczytać każdy, kto ma do nich link.

Ile opcji może mieć osadzone koło?

Od 2 do 100 opcji, każda do 80 znaków. Opcje są przesyłane w samym linku, więc razem mogą zająć około 3900 znaków lub mniej, jeśli używasz pisma takiego jak japońskie. Przy większych listach, wagach lub zapisywaniu wyników użyj pełnego koła ChoiceSpin, które przyjmuje do 2000 opcji.

Czy osadzone koło działa na telefonach?

Tak. Wypełnia szerokość kolumny z treścią i nigdy nie jest niższe niż 460 pikseli, więc etykiety pozostają czytelne na małych ekranach. Odwiedzający kręcą nim jednym dotknięciem.

Czy mogę usunąć podpis ChoiceSpin?

Tak. Przed skopiowaniem kodu odznacz „Pokaż podpis ChoiceSpin” albo później usuń z kodu linijkę z podpisem. Koło działa tak samo w obu przypadkach.

Czy strona z kołem pojawi się w Google zamiast mojej strony?

Nie. Strona z samym kołem ma oznaczenie noindex, więc nie pojawia się w wynikach wyszukiwania. Widoczność twojej strony w wyszukiwarce zależy od jej własnej treści i ustawień.

Potrzebujesz więcej niż 100 opcji?

Pełne koło przyjmuje do 2000 opcji i oferuje wagi, obrazy, zapisane koła oraz historię wyników. Nauczyciele znajdą pomysły na lekcje w poradniku dla nauczycieli.

Otwórz pełne koło