تريد عرض عجلة في بث مباشر؟ اقرأ دليل عجلة OBS

ضمّن عجلة تدوير في موقعك

اكتب خياراتك، وحدد كيف يستخدم الزوار العجلة، وانسخ مقطع كود واحدا. يعمل على أي صفحة https تقبل HTML، من دون حساب أو إضافة أو رسوم.

تنشئ عجلات من خادمك؟ استخدم واجهة ChoiceSpin API للمطورين لحفظ العجلات وإنشاء روابط يمكن تشغيلها والتحكم في تدوير العجلات المضمنة.

أعدّ عجلتك

أضف الخيارات، وحدد أدوات التحكم، وراجع المعاينة.

1 الخيارات
من 2 إلى 100 خيار، بحد أقصى 80 حرفا لكل خيار 4 / 100
2 عناصر تحكم الزائر
3 المظهر
الخلفية
ألوان العجلة
5 ثوان
عنوان العجلة

معاينة مباشرة

هذه هي العجلة التي سيستخدمها زوارك. جرّب تدويرها.

تفاعلي

عجلة من ChoiceSpin

4 خيارات · انقر للتدوير افتح العجلة في صفحة مستقلة

انسخ الكود لموقعك

الصق هذا في كتلة HTML أو كتلة تضمين. يتكيّف حجم العجلة مع صفحتك.

تحفظ خياراتك داخل الكود، لا على خوادمنا. يستطيع كل من يعرض مصدر صفحتك قراءتها، لذا لا تدرج أسماء خاصة أو كلمات مرور أو تفاصيل حسابات.

كيفية تضمين عجلة تدوير

ثلاث خطوات لتعمل العجلة على صفحتك. يمكنك العودة وتغييرها في أي وقت.

  1. 01

    أضف خياراتك

    اكتب من 2 إلى 100 خيار أعلاه، كل خيار في سطر. اختر أدوات التحكم والألوان ومدة التدوير.

  2. 02

    أدر عجلة المعاينة

    تشغل المعاينة العجلة نفسها التي يحصل عليها زوارك، لذلك يبين تدوير تجريبي هنا كيف ستعمل على صفحتك.

  3. 03

    الصق الكود

    انسخ مقطع الكود إلى كتلة HTML أو تضمين في صفحتك، ثم انشر الصفحة كالمعتاد.

أين تلصق الكود

تحتوي معظم أدوات إنشاء المواقع على كتلة لـ HTML أو كود التضمين، لكن أسماءها تختلف. في صفحة تكتبها بنفسك، الصق المقطع داخل <body> حيث تريد ظهور العجلة. لا تحتاج إلى إضافة وسم سكربت أو ورقة أنماط أو مفتاح API.

WordPress

  1. في محرر الكتل، اكتب /html واختر كتلة Custom HTML.
  2. الصق الكود، ثم حدّث الصفحة أو انشرها.

في المحرر التقليدي، الصقه في تبويب Text. لا يحتفظ WordPress بكود التضمين إلا للمستخدمين المسموح لهم بنشر HTML من دون تصفية، وهم عادة أصحاب دوري Administrators وEditors. وعلى WordPress.com يتطلب ذلك خطة مدفوعة مع تفعيل ميزات الاستضافة.

Google Sites

  1. انقر Insert، ثم Embed، ثم تبويب Embed code.
  2. الصق الكود، وانقر Next، ثم Insert.
  3. اسحب حواف المربع حتى تظهر العجلة كاملة، ثم اختر Publish.

Wix

  1. انقر Add Elements، ثم Embed Code، ثم Embed HTML.
  2. انقر العنصر الجديد، واختر Enter Code، والصق الكود، ثم انقر Apply.
  3. اسحب حواف العنصر حتى تتسع للعجلة.

في Wix Studio، يوجد العنصر نفسه ضمن Add Elements، ثم Embed & Social، ثم Embed Code.

Squarespace

  1. انقر Add block، واختر Code، ثم انقر رمز القلم.
  2. الصق الكود، وحدد HTML، واترك Display Source غير مفعل.

يعمل كود التضمين على خطط Core وPlus وAdvanced وخطتي Business وCommerce الأقدم، لكنه لا يعمل على Basic. إذا لم تظهر العجلة وأنت مسجل الدخول، فتحقق من الصفحة باستخدام Preview in Safe Mode.

Webflow

  1. افتح لوحة Add واسحب عنصر Code Embed إلى الصفحة.
  2. الصق الكود، ثم انقر Save & Close.

يتطلب Code Embed خطة Workspace أو Site مدفوعة.

Shopify

  1. انتقل إلى Online Store، ثم Pages، وافتح صفحة.
  2. انقر Show HTML في شريط أدوات المحرر، والصق الكود، ثم انقر Save.

لوضع العجلة في قسم من قالب الموقع بدلا من ذلك، افتح Edit theme، وانقر Add section، ثم اختر Custom Liquid.

Notion

  1. بدّل المخرجات أعلاه إلى «الرابط المباشر» وانسخ الرابط.
  2. في Notion، اكتب /embed، واختر Embed link، والصق الرابط.

يقبل Notion الروابط فقط، لذلك لا يعمل لصق كود التضمين فيه.

Canvas LMS

  1. في Rich Content Editor، اختر Insert، ثم Embed.
  2. الصق الكود في Embed Code وانقر Submit.

إذا فعلت مدرستك سياسة أمان المحتوى في Canvas، فقد يحتاج مسؤول إلى إضافة choicespin.com إلى النطاقات المسموح بها.

Moodle

  1. في مورد Page أو كتلة HTML، افتح قائمة Tools في المحرر واختر Source code.
  2. الصق الكود واحفظ.

تحذف منشورات المنتديات كود التضمين، وكذلك كل المناطق في المواقع التي تفعل Content cleaning everywhere.

عندما تزيل خطة الموقع كود التضمين، أو لا تقبل الأداة إلا رابطا، بدّل المخرجات أعلاه إلى «الرابط المباشر». عند إضافته كرابط أو زر، يفتح العجلة نفسها في صفحة مستقلة.

استخدام العجلة في Google Slides أو PowerPoint

لا تشغل تطبيقات العروض التقديمية كود التضمين، لذا فالطريقة الموثوقة هي استخدام رابط. تفتح نقرة واحدة أثناء العرض العجلة في علامة تبويب بالمتصفح، جاهزة للتدوير.

Google Slides

حدد نصا في شريحة، واختر Insert، ثم Link (Ctrl+K، أو ⌘+K على Mac)، والصق «الرابط المباشر». في وضع العرض، انقر الرابط لفتح العجلة، وأدرها، ثم عد إلى شرائحك.

PowerPoint

حدد نصا أو شكلا، واضغط Ctrl+K (أو ⌘+K على Mac)، والصق «الرابط المباشر». انقره أثناء عرض الشرائح لفتح العجلة في متصفحك. أوقفت Microsoft إضافة Web Viewer المجانية في ديسمبر 2024. تستطيع إضافات مدفوعة من شركات أخرى عرض صفحات الويب داخل شريحة، لكننا لم نختبرها.

غيّر الحجم

يملأ الكود عمود المحتوى حتى عرض 760 بكسلا، ويتناسب الارتفاع مع العرض.

اجعلها أضيق

غيّر max-width:760px في السطر الأول إلى عرض أصغر، مثل 480px. تصغر العجلة معه وتبقى في الوسط.

حافظ على وضوحها على الهواتف

تمنع قيمة min-height الإطار من أن يصبح أقصر من اللازم على الشاشات الضيقة: 460 بكسلا للعجلة البسيطة، و560 مع زر التدوير، و760 عندما يستطيع الزوار التعديل. أبقها كما هي.

أدوات إنشاء المواقع التي تضع التضمين داخل مربع

في Wix وGoogle Sites والأدوات المشابهة، يوضع الكود داخل مربع يمكنك تغيير حجمه. وسّع المربع حتى تظهر العجلة كاملة وسطر الإشارة إلى المصدر من دون شريط تمرير.

ما يحصل عليه زوارك

يشغل التضمين العجلة نفسها المستخدمة في ChoiceSpin، داخل إطار مستقل.

تدوير عادل

لكل خيار الفرصة نفسها في كل تدوير. في المتصفحات الحديثة، تختار أرقام Web Crypto العشوائية الفائز. تعرف على كيفية اختيار العجلة.

لوحة المفاتيح وقارئات الشاشة

يمكن للزوار نقل التركيز إلى العجلة والضغط على مفتاح المسافة أو Enter لتدويرها. تعلن قارئات الشاشة كل نتيجة عند استقرار العجلة عليها.

بلا ملفات تعريف ارتباط أو تتبع

الإطار معزول، لذلك لا يستطيع إنشاء ملفات تعريف ارتباط أو حفظ أي شيء في المتصفح. ولا يحمّل إعلانات أو تحليلات.

صفحة خفيفة

يطلب الكود من المتصفح تحميل العجلة فقط عندما يمرر الزائر الصفحة مقتربا منها، ليبقى الجزء العلوي من صفحتك سريعا.

تحكم في العجلة باستخدام JavaScript

يعمل الكود المنسوخ بمفرده. وإذا كنت تكتب كود صفحتك، فيمكنك أيضا بدء التدوير وتغيير الخيارات وقراءة كل فائز عبر رسائل النوافذ، من دون تخفيف قيود عزل الإطار.

ابدأ تدويرا واقرأ الفائز

أضف <button id="spin-from-page" type="button" disabled>Spin</button> إلى صفحتك، وضع هذا السكربت بعد كود التضمين. تتجاهل العجلة الأوامر حتى ترسل ready، لذلك يبقى الزر معطلا حتى ذلك الحين.

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

الإجراءات التي يمكنك إرسالها

  • يبدأ spin تدويرا
  • يستبدل setEntries الخيارات بمصفوفة entries تضم من 2 إلى 100 سلسلة نصية
  • يضيف addEntry سلسلة نصية واحدة عبر الحقل entry
  • يزيل removeWinner آخر فائز
  • يعيد reset الخيارات الموجودة في الكود

الأحداث التي تتلقاها

ready وspin-start وspin-end مع winner وindex، وكذلك entries-changed وerror. يرسل كل حدث أيضا عدد الخيارات الحالي في count.

ثلاث قواعد ينبغي معرفتها

أرسل الرسائل مع "*" كوجهة، لأن الإطار المعزول ليس له أصل يمكنك تسميته. تظل الرسالة موجهة إلى ذلك الإطار وحده. عندما تعود رسالة، تظهر قيمة أصلها على أنها "null"، لذلك لا تثق بها إلا إذا كان event.source أيضا هو نافذة الإطار. لا تستمع العجلة إلا إلى الصفحة التي تتضمنها، وترد على الأمر غير السليم بحدث error. أبق خاصيتي sandbox وreferrerpolicy المنشأتين كما هما: تحتاج الأوامر المعتادة إلى أصل الصفحة الأم الذي يستخلص من المحيل. إذا أزالت إعادة التحميل ذلك المحيل، فيمكن أن تعيد أداة المطور المساعدة الاختيارية الاتصال عبر مصافحة صادرة من الصفحة الأم الفعلية التي تعمل عبر HTTPS، بعد التحقق من صحة هذه المصافحة.

إذا لم تظهر العجلة

تنشأ معظم المشكلات من مكان لصق الكود. تحقق من هذه النقاط أولا.

يظهر الكود كنص

لقد وُضع في كتلة نصية عادية. احذفه والصقه في كتلة HTML أو كود أو تضمين بدلا من ذلك.

مربع فارغ

لا تُحمّل العجلة إلا على صفحات تقدم عبر https. إذا بدأ عنوان صفحتك بـ http، أو كانت خطتك تزيل كود التضمين، فاستخدم «الرابط المباشر» كرابط.

جزء من العجلة مقطوع

مربع التضمين أقصر من اللازم. زد ارتفاعه حتى تظهر العجلة وأزرارها وسطر الإشارة إلى المصدر كاملة. يحتاج الإطار وحده إلى 460 بكسلا على الأقل، و560 مع زر التدوير، و760 عندما يستطيع الزوار التعديل. ويضيف سطر الإشارة نحو 30 بكسلا أخرى.

لا يوجد صوت

تأكد من تحديد «تشغيل صوت عند الانتهاء». لا تسمح المتصفحات بالصوت إلا بعد أن ينقر الزائر أو يضغط مفتاحا داخل الإطار، لذلك يبقى أي تدوير يبدأ من كودك قبل ذلك صامتا.

أسئلة شائعة

إجابات قصيرة قبل إضافة العجلة إلى صفحة عامة.

هل العجلة المضمنة مجانية؟

نعم. لا تكلف شيئا ولا تتطلب التسجيل، ويمكنك وضع الكود نفسه في أي عدد من الصفحات.

كيف أغير العجلة بعد تضمينها؟

إذا أنشأت العجلة بهذه الأداة، فأنشئ النسخة الجديدة هنا واستبدل الكود القديم في صفحتك. تحفظ خياراتها داخل الكود نفسه، لذلك لا يوجد حساب أو نسخة محفوظة لتحديثها. أما عجلات API المنشأة من الخادم فلها سجلات محفوظة مستقلة.

هل يستطيع الزوار تغيير عجلتي؟

نسختهم فقط. يتيح لهم إعداد «السماح للزوار بالتعديل» كتابة خيارات جديدة، ويزيل زر إزالة الفائز أو إعداد «إزالة كل فائز» الفائزين. لا تغير تعديلاتهم عجلتك الأصلية أو نسخة أي شخص آخر، وتعود خياراتك الأصلية عند إعادة التحميل.

هل تستخدم العجلة المضمنة ملفات تعريف الارتباط أو تتبع الزوار؟

لا. تعمل العجلة داخل إطار معزول لا يستطيع إنشاء ملفات تعريف ارتباط أو تخزين أي شيء في المتصفح، ولا يحمّل إعلانات أو تحليلات. في العجلات المنشأة بهذه الأداة، تكون الخيارات جزءا من الكود، لذلك يستطيع كل من يعرض مصدر صفحتك قراءتها. أما النسخ الثابتة المنشأة عبر API فتحفظ على الخادم ويمكن لكل من يحمل رابطها قراءتها.

كم خيارا يمكن أن تحتوي عليه العجلة المضمنة؟

من 2 إلى 100 خيار، بحد أقصى 80 حرفا لكل خيار. ولأن الخيارات تنتقل داخل الرابط، يمكن أن يبلغ مجموعها نحو 3,900 حرف، أو أقل في أنظمة كتابة مثل اليابانية. للقوائم الأكبر أو الأوزان أو النتائج المحفوظة، استخدم عجلة ChoiceSpin الكاملة التي تقبل ما يصل إلى 2,000 خيار.

هل تعمل العجلة المضمنة على الهواتف؟

نعم. تملأ عرض عمود المحتوى، ولا يقل ارتفاعها عن 460 بكسلا، لتظل التسميات مقروءة على الشاشات الصغيرة. يديرها الزوار بلمسة.

هل يمكنني إزالة الإشارة إلى ChoiceSpin؟

نعم. ألغ تحديد «إظهار رابط إلى ChoiceSpin» قبل نسخ الكود، أو احذف سطر الإشارة من الكود لاحقا. تعمل العجلة بالطريقة نفسها في الحالتين.

هل ستظهر صفحة العجلة في Google بدلا من صفحتي؟

لا. تحمل الصفحة المخصصة للعجلة وحدها تعليمة noindex، لذلك تبقى خارج نتائج البحث. أما ظهور صفحتك في البحث فيعتمد على محتواها وإعداداتها.

تحتاج إلى أكثر من 100 خيار؟

تقبل العجلة الكاملة ما يصل إلى 2,000 خيار، مع الأوزان والصور والعجلات المحفوظة وسجل النتائج. يجد المعلمون أفكارا صفية في دليل المعلمين.

افتح العجلة الكاملة