كيفية تخصيص واجهة وشعار BigBlueButton

قد يشمل تغيير العلامة التجارية لـ BigBlueButton ثلاثة أمور مختلفة: تغيير الشعار على صفحة الويب الافتراضية للخادم، أو عرض الشعار داخل الاجتماع، أو إعادة تصميم برنامج الاجتماع نفسه. اختر التغيير الأنسب الذي يحقق هدفك. التغييران الأولان هما تغييرات موثقة في الإعدادات أو الأصول؛ أما تغيير نظام الألوان أو الصياغة أو تصميم البرنامج فيتطلب عادةً إنشاء برنامج HTML5 مخصص.

يتبع هذا الدليل وثائق إدارة BigBlueButton 4.0 المتوفرة بتاريخ 6 أكتوبر 2026. قد تختلف المسارات وحزم النشر باختلاف الإصدار أو مزود الاستضافة. تأكد من الإصدار المثبت على خادمك قبل تغيير الملفات، وقم بعمل نسخة احتياطية أولاً.

اختر التغيير الذي تحتاجه في علامتك التجارية

شعار صفحة الخادم الرئيسية وشعار الاجتماع منفصلان. استبدال أحدهما لا يستبدل الآخر تلقائيًا.

قبل تعديل الخادم

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

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

قم بتغيير شعار صفحة الويب الافتراضي

بالنسبة لبرنامج BigBlueButton 4.0، يُحدد دليل الإدارة الشعار الافتراضي في [رابط غير واضح /var/www/bigbluebutton-default/assets/images/logo.png]. يؤثر هذا على الموقع الإلكتروني الافتراضي الذي يُقدمه الخادم، ولكنه لا يُحدد الشعار المعروض داخل عميل اجتماع HTML5.

1. اتصل بالخادم وتأكد من وجود الملف في المسار الموثق. إذا كان المسار مختلفًا، فتوقف مؤقتًا وتحقق من وثائق الإصدار المثبت لديك بدلًا من نسخ الملف إلى مجلد مُخمن.
2. قم بعمل نسخة احتياطية من الملف الموجود. على سبيل المثال، يمكن للمسؤول نسخه إلى ملف احتياطي مؤرخ في نفس المجلد قبل استبداله. ضع في اعتبارك الأذونات والملكية الأصلية عند تثبيت الملف البديل.
3. ضع شعارك الجديد في الموقع المحدد باستخدام اسم الملف logo.png. تأكد من أن ملف الصورة بصيغة PNG وأن تباينه مع خلفية الصفحة كافٍ.
4. افتح صفحة BigBlueButton العامة في نافذة متصفح خاصة أو امسح ذاكرة التخزين المؤقت للمتصفح. تأكد من ظهور الشعار الجديد دون أن يكون مشوهاً أو مقصوصاً أو غير واضح.

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

اعرض شعارًا داخل الاجتماعات

يُتيح خيار العلامة التجارية لكل اجتماع، الموثق في BigBlueButton، وضع شعار في منطقة العلامة التجارية أعلى قائمة المشاركين. يجب استيفاء شرطين: displayBrandingAreaتفعيل إعدادات عميل HTML5، وإنشاء الاجتماع باستخدام logoرابط صورة. لن يؤدي إدخال مُعامل الشعار وحده إلى ظهور منطقة العلامة التجارية المخفية.

1. في إعدادات عميل HTML5، فعّل الخيار المناسب displayBrandingArea. في عمليات التثبيت الموثقة الحالية، /etc/bigbluebutton/bbb-html5.ymlيُعدّ ملف التجاوز المحلي الموصى به هو الملف المُوصى به؛ حيث تُستبدل إدخالات التكوين الموجودة فيه إعدادات العميل المُضمّنة. احتفظ بقيم YAML الأخرى الموجودة عند تعديل الملف.
2. أعد تشغيل BigBlueButton حتى يسري تغيير الإعدادات: sudo bbb-conf --restartحدد موعدًا لذلك خلال فترة صيانة مناسبة لأن إعادة التشغيل قد تقاطع الاجتماعات الجارية.
3. عند إنشاء تطبيقك أو عميل واجهة برمجة التطبيقات (API) للاجتماع، أضف مُعاملًا مُخصصًا في النموذج logo=https://your-domain.example/brand.png. يختلف مكان إدخال هذا المُعامل المُخصص باختلاف التكامل الذي يُرسل /createطلب BigBlueButton. اتبع تعليمات هذا التكامل، ولا تُفصح عن السر المُشترك لخادمك في كود جانب العميل.
4. أنشئ اجتماعًا تجريبيًا جديدًا وانضم إليه. تأكد من ظهور الشعار أعلى قائمة المشاركين، ومن تحميل الصورة للمشارك غير المسجل دخوله إلى خادم الصور.

راجع ملف التكوين الرسمي للاطلاع على مواقع التجاوز الموصى بها، ومرجع واجهة برمجة التطبيقات (API) لمعرفة معلمات إنشاء الاجتماعات. استخدم الوثائق المتوافقة مع إصدار خادمك إذا لم يكن الإصدار 4.0.

عندما تحتاج إلى إعادة تصميم كاملة للواجهة

إن وجود شعار في قسم العلامة التجارية للاجتماع لا يُعدّ بديلاً عن تطبيق اجتماعات ذي علامة تجارية خاصة. إذا كنت بحاجة إلى استبدال ألوان واجهة المستخدم، أو التسميات، أو أي عناصر أخرى مدمجة في التطبيق، فإن قسم الأسئلة الشائعة في BigBlueButton يرشد المسؤولين إلى إعداد بيئة التطوير وإنشاء نسختهم الخاصة من تطبيق HTML5. يُعدّ قسم الأسئلة الشائعة ودليل التطوير الخاصان بالعلامة التجارية للمشروع نقطة انطلاق جيدة.

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

تحقق من النتيجة وقم بحل المشكلة حسب الأعراض

• لم يتغير شعار الصفحة الرئيسية: تأكد من استبدال الملف في bigbluebutton-defaultمجلد الأصول الخاص بالخادم النشط، ثم تجاوز التخزين المؤقت للمتصفح. إذا كان خادم وكيل أو بوابة منفصلة تعرض الصفحة العامة، فتحقق من النظام الذي يمتلك تلك الصفحة.
• لا يظهر شعار الاجتماع: تحقق من تمكين إعداد منطقة العلامة التجارية، وإعادة تشغيل الخادم، وإنشاء الاجتماع الجديد باستخدام المعلمة logo، وأن عنوان URL للصورة يعمل لمتصفح غير مصادق عليه.
• يظهر الشعار ولكنه يبدو غير صحيح: تحقق من نسب الصورة الأصلية، والمناطق الشفافة، والتباين. عدّل الصورة الأصلية بدلاً من تمديدها في واجهة المستخدم.
• قد يرى بعض المشاركين منطقة فارغة: جرب رابط الصورة من شبكة وجهاز آخرين. قد يمنع جدار الحماية أو قيود الوصول أو شهادة TLS غير صالحة أو رابط الصورة منتهي الصلاحية متصفحات المشاركين من تحميلها.
• تبقى الألوان أو الصياغة دون تغيير: استبدال شعار الخادم لا يُغيّر مظهر برنامج الاجتماع. استخدم مسار تطوير العميل المخصص إذا كان لا بد من تغيير عناصر واجهة المستخدم هذه.

يُقاس النجاح بموقع النتيجة وثباتها: تظهر علامة الاستبدال في الصفحة الرئيسية؛ ويظهر شعار الاجتماع في منطقة العلامة التجارية الموثقة عند إنشاء اجتماع تجريبي جديد؛ وإذا أنشأتَ عميلًا مخصصًا، فستظل تغييرات واجهة المستخدم المطلوبة موجودة طوال عملية الانضمام والاجتماع. يُعدّ اجتماع تجريبي صغير نقطة تحقق أكثر أمانًا من فحص علامة تبويب واحدة مخزنة مؤقتًا في المتصفح.

خيارات العلامة التجارية لـ BigBlueButton محدودة عمدًا على مستوى التكوين. تغطي مسارات الشعار المدمجة احتياجات الهوية الشائعة، بينما تتطلب إعادة تصميم الواجهة بالكامل امتلاك عميل مخصص وصيانته المستمرة.