# منشئ الويدجت

> اصنع ويدجت خاصًا لبثك على Kick بـ HTML و CSS و JavaScript في منشئ الويدجت من KickBot، واختبره بأحداث تجريبية، وانشره في المكتبة.

Source: https://kickbot.com/ar/docs/widgets/widget-builder

يتيح لك منشئ الويدجت صنع أوفرلاي خاص لبثك على Kick بـ HTML و CSS و JavaScript. يرسل KickBot أحداث Kick المباشرة (المتابعات، والاشتراكات، والاشتراكات المُهداة، و KICKs، والرايد، ورسائل الدردشة وغيرها) إلى الكود الخاص بك، فلا تحتاج إلى الاتصال بأي API. يمكنك استخدام الويدجت على بثك، ويمكنك نشره ليثبّته مذيعون آخرون من مكتبة الويدجت. افتحه على [kickbot.com/dashboard/widget-builder](https://kickbot.com/dashboard/widget-builder).

المنشئ لمن يستطيع كتابة بعض الكود. إذا أردت أوفرلاي جاهزًا فقط، استخدم [مكتبة الويدجت](https://kickbot.com/ar/docs/widgets/widget-library). لمرجع الكود (الأحداث والبيانات والإعدادات)، راجع [مرجع منشئ الويدجت](https://kickbot.com/ar/docs/widgets/widget-builder-reference).

![الصفحة الرئيسية لمنشئ الويدجت في KickBot مع زر ويدجت جديد، وويدجت واحد برابط مخفي، وقسم المرجع](https://kickbot.com/docs/images/widgets/widget-builder/01-home.webp "يعرض منشئ الويدجت الويدجت الخاصة بك وروابطها لـ OBS.")

## اصنع ويدجت جديدًا

1. افتح [kickbot.com/dashboard/widget-builder](https://kickbot.com/dashboard/widget-builder) واضغط على **ويدجت جديد**.
2. اختر **فارغ**، أو ابدأ من قالب: **Viewer Count** أو **Simple Follower Goal** أو **Basic Chat Widget**. ينسخ القالب كود ويدجت KickBot هذا، فتستطيع تغييره.
3. اكتب **اسم الويدجت**. للويدجت الفارغ، اضبط أيضًا **العرض** و**الارتفاع** بالبكسل (800 × 600 افتراضيًا).
4. اضغط على **إنشاء ويدجت**. يُفتح المحرر.

![نافذة ويدجت جديد المنبثقة مع فارغ وقالبَي Viewer Count و Simple Follower Goal](https://kickbot.com/docs/images/widgets/widget-builder/02-new-widget.webp "ابدأ من ويدجت فارغ أو من قالب.")

> **Note:** في الخطة المجانية، يمكنك امتلاك حتى 10 ويدجت في منشئ الويدجت. مع Premium لا يوجد حد. الويدجت التي تثبّتها من المكتبة لا تُحتسب.

## المحرر

للمحرر ثلاثة أجزاء: الإعدادات على اليسار، والكود في الوسط، ومعاينة مباشرة على اليمين.

![محرر منشئ الويدجت مع الإعدادات الأساسية ومتغيرات المستخدم على اليسار، وتبويب كود HTML في الوسط، والمعاينة على اليمين](https://kickbot.com/docs/images/widgets/widget-builder/03-editor.webp "الإعدادات والكود والمعاينة في محرر منشئ الويدجت.")

- **الإعدادات الأساسية**: الاسم، والعرض والارتفاع اللذان يُعرض بهما الويدجت.
- **متغيرات المستخدم**: إعدادات يستطيع المذيعون تغييرها دون كود، مثل لون أو نص أو رقم هدف. راجع [متغيرات المستخدم](https://kickbot.com/ar/docs/widgets/widget-builder-reference#user-variables).
- **إرسال أحداث تجريبية**: أزرار ترسل حدثًا وهميًا (Sub و Sub مهداة و KICKs و Follow و Raid ورسالة وغيرها) إلى المعاينة.
- **الظهور**: يبيّن إن كان الويدجت خاصًا أو منشورًا، وفيه زر **نشر الـ widget**.
- **الكود**: تبويبات لـ **HTML** و **CSS** و **JavaScript**. استخدم **تخطيط المحرر** في الأعلى لعرض ملف واحد (**مفرد**) أو ملفين معًا (**جنباً إلى جنب** أو **متراكب**).
- **المعاينة**: تعرض الويدجت بحجمه، مصغّرًا ليناسب المساحة. تتحدّث أثناء الكتابة. استخدم زر إعادة التحميل لتشغيلها من جديد، أو زر الفتح في نافذة منفصلة لفتحها في نافذتها الخاصة (مفيد لفتح وحدة تحكم المتصفح).

يحفظ المحرر عملك تلقائيًا أثناء الكتابة. يحفظ **حفظ** كل شيء دفعة واحدة، ويبيّن النص تحته وقت آخر حفظ. يعيدك **خروج** إلى قائمة الويدجت.

يحتاج المحرر إلى شاشة عريضة. على الهاتف، يطلب منك KickBot فتحه على حاسوب. ويدجتك محفوظ، فتستطيع المتابعة من هناك.

## اختبر الويدجت

1. افتح **إرسال أحداث تجريبية**.
2. اضغط على حدث، مثلًا **Follow** أو **رسالة**.
3. شاهد تفاعل المعاينة.

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

## استخدم الويدجت على البث

كل ويدجت تصنعه يظهر أيضًا في [الويدجت المحفوظة](https://kickbot.com/dashboard/saved-widgets) مع «ويدجت خاص بك» تحت الاسم. رابطه يشغّل دائمًا أحدث كود لديك.

1. في صفحة منشئ الويدجت، اضغط على **نسخ الرابط** في ويدجتك.
2. في OBS، أضف مصدرًا من نوع **Browser** (المتصفح)، والصق الرابط، واضبط العرض والارتفاع على حجم الويدجت.
3. اضغط على **OK**.

إذا غيّرت الكود والويدجت في OBS، حدّث مصدر المتصفح ليحمّل الكود الجديد. عندما تغيّر قيمة متغير مستخدم في الويدجت المحفوظة وتضغط على **حفظ**، يعيد OBS تحميل الويدجت تلقائيًا. لمزيد من المساعدة، راجع [أضف مصدر متصفح إلى OBS](https://kickbot.com/ar/docs/getting-started/add-browser-source-obs).

> **Caution:** احتفظ بالرابط لنفسك. أي شخص لديه الرابط يستطيع عرض ويدجتك على شاشته.

## انشر في مكتبة الويدجت

انشر الويدجت عندما تريد أن يجده مذيعون آخرون ويثبّتوه.

1. في المحرر، افتح **الظهور** واضغط على **نشر الـ widget**.
2. أضف **الصورة الرئيسية** وصورة أخرى على الأقل. يمكنك إضافة حتى 10 صور إجمالًا، حجم كل منها حتى 10 ميغابايت. يناسب حجم 1920 × 1080 أكثر من غيره.
3. اكتب **الوصف**: ما يعرضه الويدجت وطريقة إعداده.
4. أرسله. تؤكد النافذة المنبثقة أنه أُرسل للمراجعة.

يراجع فريق KickBot كل ويدجت. إذا وافق عليه، يظهر في مكتبة الويدجت مع اسمك على Kick كصانع له. تستغرق المراجعة عادةً أقل من 24 ساعة.

> **Caution:** يمكنك نشر الويدجت مرة واحدة فقط. بعد ذلك يعرض المحرر «الـ widget منشور بالفعل. تواصل مع الدعم لأي تعديلات». اختبر ويدجتك جيدًا قبل نشره.

## احذف ويدجت

في صفحة منشئ الويدجت، افتح قائمة **⋯** في الويدجت واضغط على **حذف**. يزيل هذا كوده وإعداداته، ولا يمكن التراجع عنه.

## أعضاء الفريق

يحتاج أعضاء الفريق إلى صلاحية **أداة بناء Widget** لفتح المحرر وصنع الويدجت. ويحتاجون إلى **إعداد Widgets** لرؤية روابط الويدجت. راجع [إدارة الفريق](https://kickbot.com/ar/docs/account/team).

## الأسئلة الشائعة

**هل أحتاج إلى معرفة البرمجة؟**

نعم، بعض HTML و CSS و JavaScript. إذا كنت لا تبرمج، ثبّت ويدجت من [مكتبة الويدجت](https://kickbot.com/ar/docs/widgets/widget-library) وغيّر إعداداته بدلًا من ذلك.

**هل يمكنني تعديل ويدجت من KickBot في المكتبة؟**

لا يمكنك تغيير كود ويدجت من المكتبة. ابدأ ويدجت جديدًا من قالب **Viewer Count** أو **Simple Follower Goal** أو **Basic Chat Widget** لتحصل على نسخة من كوده تستطيع تغييرها.

**هل يستطيع ويدجتي تحميل خطوط أو صور أو سكربتات أخرى؟**

نعم. يعمل HTML و CSS و JavaScript الخاصة بك في صفحة ويب عادية داخل OBS، فتستطيع ربط خطوط ويب وصور وسكربتات من مواقع أخرى. استخدم متغيرات المستخدم من نوع **صورة/GIF** أو **فيديو** أو **صوت** ليرفع المذيعون ملفاتهم الخاصة.

**هل يمكنني صنع ويدجت باستخدام KickBot API؟**

نعم. يستطيع KickBot API عرض الويدجت الخاصة بك وإنشاءها وتحديثها. راجع [مرجع API للويدجت](https://kickbot.com/docs/api/reference/widgets).