پلیر امن XAPlayer در مودل

با یک افزونه‌ی محلی کوچک، ویدیوهای قفل‌شده‌ی XAPlayer را فقط برای دانشجویان ثبت‌نام‌شده در درس مودل نمایش دهید؛ سازگار با مودل ۴.

مودل اجازه نمی‌دهد کد سمت سرور را داخل یک برگه بنویسید، پس یک افزونه‌ی محلی سه‌فایلی می‌سازیم. این افزونه بررسی می‌کند دانشجو وارد شده و در درس ثبت‌نام کرده، بعد پلیر را نمایش می‌دهد.

پیش از شروع#

1. در پنل XAPlayer به «تنظیمات» بروید و در بخش «کلید API» یک کلید بسازید. کلید فقط یک بار نمایش داده می‌شود؛ همان لحظه کپی‌اش کنید.
2. در «سایت‌های مجاز برای نمایش پلیر» نشانی کامل سایت‌تان را اضافه کنید، مثلاً https://academy.example.com. اگر سایت با www هم باز می‌شود، آن را هم اضافه کنید.
3. شناسه‌ی دوره را بردارید: در «تنظیمات»، بخش «راهنمای نمایش پلیر در سایت شما» دوره را انتخاب کنید تا شناسه‌اش در نمونه‌کد نوشته شود. همان بخش آخر نشانی صفحه‌ی دوره در پنل هم هست.
4. به سرور مودل دسترسی فایل (FTP یا SSH) داشته باشید.

کلید را در config.php مودل بگذارید#

// config.php in your Moodle folder, before require_once(__DIR__ . '/lib/setup.php');
$CFG->xaplayer_api     = 'https://xaplayer.ir/api/v1';
$CFG->xaplayer_api_key = 'xap_sk_...';

سه فایل افزونه را بسازید#

فایل: local/xaplayer/یک پوشه‌ی تازه در پوشه‌ی local مودل

<?php
// local/xaplayer/version.php
defined('MOODLE_INTERNAL') || die();

$plugin->component = 'local_xaplayer';
$plugin->version   = 2026111400;
$plugin->requires  = 2022041900; // Moodle 4.0 or later

نصب و استفاده#

1. با حساب مدیر وارد مودل شوید؛ صفحه‌ی «اعلان‌ها» افزونه‌ی تازه را نشان می‌دهد. «ارتقای پایگاه داده» را بزنید.
2. در درس مودل یک منبع «نشانی اینترنتی» (URL) بسازید و نشانی زیر را بگذارید. id شناسه‌ی درس مودل است و course شناسه‌ی دوره در XAPlayer.
3. با یک حساب دانشجو پیوند را باز کنید.

https://moodle.example.com/local/xaplayer/view.php?id=MOODLE_COURSE_ID&course=XAPLAYER_COURSE_ID

اگر کار نکرد#