Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.3.x will end 7 October 2024 (12 months).
  • Bug fixes for security issues in 4.3.x will end 21 April 2025 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.2.x is supported too.
<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

namespace mod_bigbluebuttonbn\external;

< use external_api;
> use core_external\external_api;
use mod_bigbluebuttonbn\instance;
< use mod_bigbluebuttonbn\local\config;
use mod_bigbluebuttonbn\test\testcase_helper_trait; use moodle_exception; defined('MOODLE_INTERNAL') || die(); global $CFG; require_once($CFG->dirroot . '/webservice/tests/helpers.php'); /** * Tests for the get_join_url class. * * @package mod_bigbluebuttonbn * @category test * @copyright 2021 - present, Blindside Networks Inc * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @author Laurent David (laurent@call-learning.fr) * @covers \mod_bigbluebuttonbn\external\get_join_url */ class get_join_url_test extends \externallib_advanced_testcase { use testcase_helper_trait; /** * Setup for test */ public function setUp(): void { parent::setUp(); $this->initialise_mock_server(); } /** * Helper * * @param mixed ...$params * @return mixed */ protected function get_join_url(...$params) { $getjoinurl = get_join_url::execute(...$params); return external_api::clean_returnvalue(get_join_url::execute_returns(), $getjoinurl); } /** * Test execute API CALL with no instance */ public function test_execute_no_instance() { $this->expectExceptionMessageMatches('/No such instance.*/'); $joinurl = $this->get_join_url(1234, 5678); $this->assertIsArray($joinurl); $this->assertArrayNotHasKey('join_url', $joinurl); $this->assertEquals(false, $joinurl['join_url']); } /** * Test execute API CALL without login */ public function test_execute_without_login() { $this->resetAfterTest(); $course = $this->getDataGenerator()->create_course(); $record = $this->getDataGenerator()->create_module('bigbluebuttonbn', ['course' => $course->id]); $instance = instance::get_from_instanceid($record->id); $this->expectException(moodle_exception::class); $this->get_join_url($instance->get_cm_id()); } /** * Test execute API CALL with invalid login */ public function test_execute_with_invalid_login() { $this->resetAfterTest(); $generator = $this->getDataGenerator(); $course = $generator->create_course(); $record = $generator->create_module('bigbluebuttonbn', ['course' => $course->id]); $instance = instance::get_from_instanceid($record->id); $user = $generator->create_user(); $this->setUser($user); $this->expectException(moodle_exception::class); $this->get_join_url($instance->get_cm_id()); } /** * When login as a student */ public function test_execute_with_valid_login() { $this->resetAfterTest(); $generator = $this->getDataGenerator(); $course = $generator->create_course(); $record = $generator->create_module('bigbluebuttonbn', ['course' => $course->id]); $instance = instance::get_from_instanceid($record->id); $user = $generator->create_and_enrol($course, 'student'); $bbbgenerator = $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn'); // Make sure the meeting is running (this is not the default with the mock server). $bbbgenerator->create_meeting([ 'instanceid' => $instance->get_instance_id(), 'groupid' => $instance->get_group_id() ]); $this->setUser($user); $joinurl = $this->get_join_url($instance->get_cm_id()); $this->assertIsArray($joinurl); $this->assertArrayHasKey('join_url', $joinurl); $this->assertEmpty($joinurl['warnings']); $this->assertNotNull($joinurl['join_url']); } /** * Check that URL are different depending on the group. */ public function test_execute_with_group() { $this->resetAfterTest(); $generator = $this->getDataGenerator(); $course = $generator->create_course(); $g1 = $generator->create_group(['courseid' => $course->id]); $g2 = $generator->create_group(['courseid' => $course->id]); $record = $generator->create_module('bigbluebuttonbn', ['course' => $course->id]); $instance = instance::get_from_instanceid($record->id); $user = $generator->create_and_enrol($course, 'student'); $bbbgenerator = $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn'); // Make sure the meeting is running (this is not the default with the mock server). $bbbgenerator->create_meeting([ 'instanceid' => $instance->get_instance_id(), 'groupid' => $instance->get_group_id() ]); $this->setUser($user); $joinurlnogroup = $this->get_join_url($instance->get_cm_id()); $joinurlnogroupv2 = $this->get_join_url($instance->get_cm_id()); $joinurlg1 = $this->get_join_url($instance->get_cm_id(), $g1->id); $joinurlg2 = $this->get_join_url($instance->get_cm_id(), $g2->id); foreach ([$joinurlnogroup, $joinurlnogroupv2, $joinurlg1, $joinurlg2] as $join) { $this->assertIsArray($join); $this->assertArrayHasKey('join_url', $join); $this->assertEmpty($join['warnings']); $this->assertNotNull($join['join_url']); } $this->assertNotEquals($joinurlnogroup['join_url'], $joinurlg1['join_url']); $this->assertNotEquals($joinurlg2['join_url'], $joinurlg1['join_url']); } /** * Check that we return the same URL once meeting is started. */ public function test_execute_with_same_url() { $this->resetAfterTest(); $generator = $this->getDataGenerator(); $course = $generator->create_course(); $record = $generator->create_module('bigbluebuttonbn', ['course' => $course->id]); $instance = instance::get_from_instanceid($record->id); $user = $generator->create_and_enrol($course, 'student'); $bbbgenerator = $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn'); // Make sure the meeting is running (this is not the default with the mock server). $bbbgenerator->create_meeting([ 'instanceid' => $instance->get_instance_id(), 'groupid' => $instance->get_group_id() ]); $this->setUser($user); $joinurl = $this->get_join_url($instance->get_cm_id()); $joinurlv2 = $this->get_join_url($instance->get_cm_id()); foreach ([$joinurl, $joinurlv2] as $join) { $this->assertIsArray($join); $this->assertArrayHasKey('join_url', $join); $this->assertEmpty($join['warnings']); $this->assertNotNull($join['join_url']); } $this->assertEquals($joinurl['join_url'], $joinurlv2['join_url']); } /** * Check that we return the same URL once meeting is started. */ public function test_user_limit() { $this->resetAfterTest(); set_config('bigbluebuttonbn_userlimit_editable', true); $generator = $this->getDataGenerator(); $course = $generator->create_course(); $record = $generator->create_module('bigbluebuttonbn', ['course' => $course->id, 'userlimit' => 2]); $user1 = $generator->create_and_enrol($course, 'student'); $user2 = $generator->create_and_enrol($course, 'student'); $instance = instance::get_from_instanceid($record->id); $bbbgenerator = $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn'); // Make sure the meeting is running (this is not the default with the mock server). $bbbgenerator->create_meeting([ 'instanceid' => $instance->get_instance_id(), 'groupid' => $instance->get_group_id(), 'participants' => 2 ]); $this->setUser($user1); $joinurl = $this->get_join_url($instance->get_cm_id()); $this->assertNotNull($joinurl['warnings']); $this->assertEquals('userlimitreached', $joinurl['warnings'][0]['warningcode']); } }