اتصال وردپرس، مودل و جوملا به پورتال (API سازگار با BigBlueButton)

این پورتال یک Endpoint کاملاً سازگار با BigBlueButton ارائه می‌دهد. یعنی هر افزونه یا کامپوننتی که از قبل برای اتصال به یک سرور BigBlueButton طراحی شده — چه در وردپرس، چه در مودل (Moodle)، چه در جوملا، یا حتی Nextcloud Talk — می‌تواند دقیقاً همان‌طور که به یک سرور واقعی BBB وصل می‌شود، به این پورتال هم وصل شود؛ هیچ افزونه‌ی مخصوصی لازم نیست و کد افزونه هم نیازی به تغییر ندارد.

نمای کلی اتصال افزونه BigBlueButton به پورتال

تنها کاری که باید انجام دهید، وارد کردن دو مقدار در تنظیمات همان افزونه است:

  • BigBlueButton Server URL (یا Server URL): https://portal.teamcall.ir/bigbluebutton/
  • Shared Secret: رمزی که هنگام ساخت کلید API از صفحه‌ی «کلیدهای API» به شما نمایش داده می‌شود (به آن «Portal API Secret» می‌گوییم).

مراحل کامل:

  1. وارد صفحه‌ی «کلیدهای API» در همین پورتال شوید.
  2. یک عنوان دلخواه بزنید (مثلاً «سایت وردپرس مدرسه» یا «مودل آموزشگاه») و روی «تولید API Key» کلیک کنید.
  3. دو مقدار نمایش‌داده‌شده را کپی کنید: BBB Server URL و Portal API Secret. این رمز فقط همین یک‌بار نمایش داده می‌شود؛ آن را جایی امن ذخیره کنید.
  4. وارد پیشخوان همان سایت/LMS شوید و به تنظیمات افزونه‌ی BigBlueButton بروید.
  5. مقدار اول را در فیلد «Server URL» و مقدار دوم را در فیلد «Shared Secret» جای‌گذاری کنید و ذخیره کنید.
  6. یک جلسه‌ی آزمایشی از همان افزونه بسازید؛ اگر اتصال درست باشد، جلسه بلافاصله در همین پورتال (صفحه‌ی «مدیریت جلسات») هم قابل مشاهده خواهد بود.
نمونه: وردپرس

افزونه‌های رایج BigBlueButton برای وردپرس، این دو فیلد را زیر «تنظیمات» یا «Settings» افزونه نمایش می‌دهند:

نمونه‌ی تنظیمات افزونه BigBlueButton در وردپرس
نمونه: مودل (Moodle)

افزونه‌ی رسمی و پیش‌فرض مودل برای این کار BigBlueButtonBN نام دارد و از مسیر Site administration ▸ Plugins ▸ Activity modules ▸ BigBlueButtonBN تنظیم می‌شود:

نمونه‌ی تنظیمات افزونه BigBlueButtonBN در مودل
نمونه: جوملا

در جوملا، بسته به کامپوننت BigBlueButton نصب‌شده، این دو فیلد معمولاً زیر «Options» همان کامپوننت قرار دارند:

نمونه‌ی تنظیمات کامپوننت BigBlueButton در جوملا

تصاویر بالا شمای کلی محل قرارگیری فیلدها را نشان می‌دهند؛ نام دقیق منو و فیلدها بسته به نسخه و افزونه‌ی انتخابی‌تان ممکن است کمی متفاوت باشد — اما همیشه دقیقاً همین دو مقدار (Server URL و Shared Secret) از شما خواسته می‌شود.

نکات مهم
  • جلسات ساخته‌شده از طریق یک کلید API، فقط متعلق به همان کاربری هستند که کلید را ساخته؛ سایت شما فقط به جلسات خودتان دسترسی دارد.
  • سقف شرکت‌کننده، وب‌کم و اتاق هم‌زمان، حتی برای جلسات ساخته‌شده از طریق API، بر اساس همان پلن فعلی شما در پورتال اعمال می‌شود.
  • اگر رمز (Secret) لو رفت یا گم شد، همان کلید را از صفحه‌ی «کلیدهای API» غیرفعال/حذف کنید و یک کلید جدید بسازید — نیازی به تماس با پشتیبانی نیست.
  • می‌توانید برای هر سایت/LMS یک کلید جداگانه بسازید تا در صورت لزوم بتوانید فقط همان یکی را جداگانه غیرفعال کنید.