Ingin menampilkan roda dalam siaran langsung? Baca panduan roda OBS

Sematkan roda putar di situs web Anda

Ketik entri, pilih cara pengunjung menggunakan roda, lalu salin satu potongan kode. Kode ini bekerja pada halaman https apa pun yang menerima HTML, tanpa akun, plugin, atau biaya.

Membuat roda dari server Anda? Gunakan API pengembang ChoiceSpin untuk menyimpan roda, membuat tautan yang dapat dimainkan, dan mengendalikan putaran roda sematan.

Siapkan roda Anda

Tambahkan entri, pilih kontrol, lalu periksa pratinjau.

1 Entri
2 hingga 100 entri, masing-masing hingga 80 karakter 4 / 100
2 Kontrol pengunjung
3 Tampilan
Latar
Warna roda
5 detik
Judul roda

Pratinjau langsung

Inilah roda yang akan digunakan pengunjung. Coba putar.

Interaktif

Roda dari ChoiceSpin

4 entri · Klik untuk memutar Buka roda di halaman tersendiri

Salin kode untuk situs Anda

Tempel kode ini ke blok HTML atau blok sematan. Ukuran roda menyesuaikan halaman Anda.

Entri disimpan di dalam kode, bukan di server kami. Siapa pun yang dapat melihat kode sumber halaman dapat membacanya, jadi jangan masukkan nama yang perlu dirahasiakan, kata sandi, atau detail akun.

Cara menyematkan roda putar

Dalam tiga langkah, roda sudah aktif di halaman Anda. Anda dapat kembali dan mengubahnya kapan saja.

  1. 01

    Tambahkan entri Anda

    Ketik 2 hingga 100 entri di atas, satu per baris. Pilih kontrol, warna, dan durasi putaran.

  2. 02

    Putar roda pratinjau

    Pratinjau menjalankan roda yang sama dengan yang diterima pengunjung, sehingga putaran uji di sini menunjukkan cara roda bekerja di halaman Anda.

  3. 03

    Tempel kode

    Salin potongan kode ke blok HTML atau blok sematan pada halaman Anda, lalu publikasikan halaman seperti biasa.

Tempat menempelkan kode

Sebagian besar pembuat situs memiliki blok untuk HTML atau kode sematan, tetapi namanya berbeda-beda. Pada halaman yang Anda tulis sendiri, tempel potongan kode di dalam <body>, pada posisi roda yang diinginkan. Tidak perlu menambahkan tag skrip, stylesheet, atau kunci API.

WordPress

  1. Di editor blok, ketik /html lalu pilih blok Custom HTML.
  2. Tempel kode, lalu perbarui atau publikasikan halaman.

Di editor klasik, tempel pada tab Text. WordPress hanya mempertahankan kode sematan dari pengguna yang diizinkan memposting HTML tanpa penyaringan, biasanya Administrators dan Editors. Di WordPress.com, diperlukan paket berbayar dengan fitur hosting yang diaktifkan.

Google Sites

  1. Klik Insert, lalu Embed, kemudian tab Embed code.
  2. Tempel kode, klik Next, lalu Insert.
  3. Seret tepi kotak sampai seluruh roda terlihat, lalu pilih Publish.

Wix

  1. Klik Add Elements, lalu Embed Code, kemudian Embed HTML.
  2. Klik elemen baru, pilih Enter Code, tempel kode, lalu klik Apply.
  3. Seret tepi elemen sampai roda muat.

Di Wix Studio, elemen yang sama berada di Add Elements, lalu Embed & Social, kemudian Embed Code.

Squarespace

  1. Klik Add block, pilih Code, lalu klik ikon pensil.
  2. Tempel kode, atur ke HTML, dan biarkan Display Source nonaktif.

Kode sematan berjalan pada paket Core, Plus, dan Advanced serta paket lama Business dan Commerce, tetapi tidak pada Basic. Jika roda tidak muncul saat Anda sedang login, periksa halaman melalui Preview in Safe Mode.

Webflow

  1. Buka panel Add dan seret elemen Code Embed ke halaman.
  2. Tempel kode, lalu klik Save & Close.

Code Embed memerlukan paket Workspace atau Site berbayar.

Shopify

  1. Buka Online Store, lalu Pages, kemudian buka sebuah halaman.
  2. Klik Show HTML pada toolbar editor, tempel kode, lalu klik Save.

Jika ingin menempatkan roda pada bagian tema, bukan pada halaman, buka Edit theme, klik Add section, lalu pilih Custom Liquid.

Notion

  1. Alihkan keluaran di atas ke URL langsung, lalu salin tautannya.
  2. Di Notion, ketik /embed, pilih Embed link, lalu tempel tautannya.

Notion hanya menerima tautan, jadi menempelkan kode sematan tidak berfungsi di sana.

Canvas LMS

  1. Di Rich Content Editor, pilih Insert, lalu Embed.
  2. Tempel kode ke Embed Code dan klik Submit.

Jika sekolah mengaktifkan kebijakan keamanan konten Canvas, admin mungkin perlu menambahkan choicespin.com ke domain yang diizinkan.

Moodle

  1. Dalam sumber daya Page atau blok HTML, buka menu Tools pada editor lalu pilih Source code.
  2. Tempel kode lalu simpan.

Postingan forum menghapus kode sematan. Hal yang sama berlaku untuk semua area pada situs dengan Content cleaning everywhere diaktifkan.

Jika suatu paket menghapus kode sematan atau alat hanya menerima tautan, alihkan keluaran di atas ke URL langsung. Jika ditempel sebagai tautan atau tombol, URL itu membuka roda yang sama di halaman tersendiri.

Menggunakan roda di Google Slides atau PowerPoint

Aplikasi presentasi tidak menjalankan kode sematan, jadi cara yang andal adalah menggunakan tautan. Satu klik saat presentasi membuka roda di tab browser, siap diputar.

Google Slides

Pilih teks pada slide, pilih Insert, lalu Link (Ctrl+K, atau ⌘+K pada Mac), lalu tempel URL langsung. Dalam mode presentasi, klik tautan untuk membuka roda, putar, lalu kembali ke slide.

PowerPoint

Pilih teks atau bentuk, tekan Ctrl+K (⌘+K pada Mac), lalu tempel URL langsung. Klik tautan itu saat presentasi untuk membuka roda di browser. Microsoft menghentikan add-in Web Viewer gratisnya pada Desember 2024. Add-in berbayar dari perusahaan lain dapat menampilkan halaman web di dalam slide, tetapi kami belum mengujinya.

Ubah ukuran

Kode mengisi kolom konten hingga lebar 760 piksel, dan tingginya mengikuti lebar.

Buat lebih sempit

Ubah max-width:760px pada baris pertama ke lebar yang lebih kecil, misalnya 480px. Roda ikut mengecil dan tetap berada di tengah.

Jaga agar terbaca di ponsel

Nilai min-height mencegah frame menjadi terlalu pendek pada layar sempit: 460 piksel untuk roda biasa, 560 dengan tombol Putar roda, dan 760 jika pengunjung dapat mengedit. Pertahankan nilai tersebut.

Pembuat situs yang menempatkan sematan dalam kotak

Di Wix, Google Sites, dan pembuat situs serupa, kode ditempatkan dalam kotak yang dapat diubah ukurannya. Seret kotak sampai seluruh roda dan baris kredit terlihat tanpa bilah gulir.

Yang didapat pengunjung

Sematan menjalankan roda yang sama dengan ChoiceSpin, di dalam frame tersendiri.

Putaran yang adil

Setiap entri memiliki peluang yang sama pada setiap putaran. Di browser modern, angka acak Web Crypto memilih pemenang. Lihat cara roda memilih.

Keyboard dan pembaca layar

Pengunjung dapat memindahkan fokus ke roda dan menekan Spasi atau Enter untuk memutar. Pembaca layar mengumumkan setiap hasil saat terpilih.

Tanpa cookie atau pelacakan

Frame dibatasi sandbox, sehingga tidak dapat memasang cookie atau menyimpan apa pun di browser. Tidak ada iklan atau analitik yang dimuat.

Halaman yang ringan

Kode meminta browser memuat roda hanya saat pengunjung menggulir mendekatinya, sehingga bagian atas halaman tetap cepat.

Kendalikan roda dengan JavaScript

Kode yang disalin dapat bekerja sendiri. Jika menulis kode halaman sendiri, Anda juga dapat memulai putaran, mengubah entri, dan membaca setiap pemenang melalui pesan antarjendela, tanpa melonggarkan sandbox frame.

Mulai putaran dan baca pemenangnya

Tambahkan <button id="spin-from-page" type="button" disabled>Spin</button> ke halaman Anda dan letakkan skrip ini setelah kode sematan. Roda mengabaikan perintah sampai mengirim ready, jadi tombol tetap nonaktif hingga saat itu.

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

Tindakan yang dapat dikirim

  • spin memulai putaran
  • setEntries mengganti entri dengan array entries berisi 2 hingga 100 string
  • addEntry menambahkan satu string entry
  • removeWinner menghapus pemenang terbaru
  • reset mengembalikan entri dari kode

Peristiwa yang diterima

ready, spin-start, spin-end dengan winner dan index, entries-changed, serta error. Masing-masing juga melaporkan jumlah entri saat ini dalam count.

Tiga aturan yang perlu diketahui

Kirim pesan dengan "*" sebagai target, karena frame yang dibatasi sandbox tidak memiliki origin yang dapat disebutkan. Pesan tetap hanya dikirim ke frame tersebut. Saat pesan kembali, origin-nya terbaca "null", jadi percayai hanya jika event.source juga merupakan jendela frame itu. Roda hanya mendengarkan halaman yang menyematkannya dan menjawab perintah dengan format salah melalui peristiwa error. Biarkan atribut sandbox dan referrerpolicy yang dihasilkan tetap apa adanya: perintah biasa memerlukan origin halaman induk yang diketahui dari referrer. Jika pemuatan ulang menghilangkan referrer tersebut, helper pengembang opsional dapat menghubungkan kembali melalui handshake tervalidasi dari halaman induk HTTPS yang sebenarnya.

Jika roda tidak muncul

Sebagian besar masalah berasal dari lokasi penempelan kode. Periksa hal berikut terlebih dahulu.

Kode tampil sebagai teks

Kode ditempel ke blok teks biasa. Hapus lalu tempel ke blok HTML, kode, atau sematan.

Kotak kosong

Roda hanya dimuat pada halaman yang disajikan melalui https. Jika alamat halaman dimulai dengan http, atau paket Anda menghapus kode sematan, gunakan URL langsung sebagai tautan.

Roda terpotong

Kotak sematan terlalu pendek. Tarik agar lebih tinggi sampai roda, tombol, dan baris kredit terlihat seluruhnya. Frame saja memerlukan sedikitnya 460 piksel, 560 dengan tombol Putar roda, dan 760 jika pengunjung dapat mengedit. Baris kredit menambah sekitar 30 piksel lagi.

Tidak ada suara

Pastikan Putar suara saat selesai dicentang. Browser hanya mengizinkan suara setelah pengunjung mengeklik atau menekan tombol keyboard di dalam frame, jadi putaran yang dimulai dari kode Anda sebelum itu tidak bersuara.

Pertanyaan umum

Jawaban singkat sebelum menambahkan roda ke halaman publik.

Apakah roda sematan gratis?

Ya. Tidak berbayar, tidak perlu mendaftar, dan kode yang sama dapat dipasang di semua halaman yang Anda inginkan.

Bagaimana cara mengubah roda setelah disematkan?

Untuk roda yang dibuat dengan alat ini, buat versi baru di sini lalu ganti kode lama pada halaman Anda. Entrinya tersimpan di dalam kode itu sendiri, jadi tidak ada akun atau salinan tersimpan yang perlu diperbarui. Roda API yang dibuat di server memiliki catatan tersimpan terpisah.

Bisakah pengunjung mengubah roda saya?

Hanya salinan mereka sendiri. Dengan opsi Izinkan pengunjung mengedit, mereka dapat mengetik entri baru. Tombol Hapus pemenang atau opsi Hapus setiap pemenang mengeluarkan pemenang dari roda. Perubahan mereka tidak mengubah roda asli Anda atau salinan orang lain, dan memuat ulang akan mengembalikan entri Anda.

Apakah roda sematan menggunakan cookie atau melacak pengunjung?

Tidak. Roda berjalan dalam frame yang dibatasi sandbox, sehingga tidak dapat memasang cookie atau menyimpan apa pun di browser, serta tidak memuat iklan atau analitik. Untuk roda yang dibuat dengan pembuat sematan, entri merupakan bagian dari kode, sehingga siapa pun yang melihat kode sumber halaman dapat membacanya. Salinan roda yang dibuat melalui API disimpan di server dan dapat dibaca siapa pun yang memiliki tautannya.

Berapa banyak entri yang dapat dimuat roda sematan?

Dari 2 hingga 100 entri, masing-masing hingga 80 karakter. Karena entri dimuat di dalam tautan, jumlah keseluruhannya dapat mencapai sekitar 3.900 karakter, atau lebih sedikit untuk sistem tulisan seperti bahasa Jepang. Untuk daftar lebih besar, bobot, atau hasil tersimpan, gunakan roda ChoiceSpin lengkap yang menerima hingga 2.000 entri.

Apakah roda sematan berfungsi di ponsel?

Ya. Lebarnya mengikuti kolom konten dan tingginya tidak pernah kurang dari 460 piksel, sehingga label tetap terbaca pada layar kecil. Pengunjung memutarnya dengan satu ketukan.

Bisakah saya menghapus kredit ChoiceSpin?

Ya. Hapus centang Tampilkan kredit ChoiceSpin sebelum menyalin kode, atau hapus baris kredit dari kode setelahnya. Roda tetap berfungsi sama dalam kedua keadaan.

Apakah halaman roda akan muncul di Google menggantikan halaman saya?

Tidak. Halaman yang hanya berisi roda ditandai noindex, sehingga tidak muncul dalam hasil pencarian. Visibilitas halaman Anda sendiri dalam pencarian bergantung pada konten dan pengaturannya.

Perlu lebih dari 100 entri?

Roda lengkap menerima hingga 2.000 entri, dengan bobot, gambar, roda tersimpan, dan riwayat hasil. Guru dapat menemukan ide kegiatan kelas di panduan untuk guru.

Buka roda lengkap