<?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\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_bigbluebuttons_by_courses 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_bigbluebuttonbns_by_courses
*/
class get_bigbluebuttons_by_courses_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_bigbluebuttons_by_courses(...$params) {
$returnvalue = get_bigbluebuttonbns_by_courses::execute(...$params);
return external_api::clean_returnvalue(get_bigbluebuttonbns_by_courses::execute_returns(), $returnvalue);
}
/**
* Test execute API CALL with no instance
*/
public function test_execute_no_instance() {
$bbbactivities = $this->get_bigbluebuttons_by_courses([1234, 5678]);
$this->assertIsArray($bbbactivities);
$this->assertArrayHasKey('bigbluebuttonbns', $bbbactivities);
$this->assertArrayHasKey('warnings', $bbbactivities);
$this->assertEmpty($bbbactivities['bigbluebuttonbns']);
}
/**
* 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_bigbluebuttons_by_courses($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_bigbluebuttons_by_courses($instance->get_cm_id());
}
/**
* Test get bbbactivities
*/
public function test_execute_with_valid_login() {
$this->resetAfterTest(true);
$generator = $this->getDataGenerator();
// Create a user.
$user = $generator->create_user();
// Create courses to add the modules.
$course1 = $generator->create_course();
$course2 = $generator->create_course();
$bbbs = [];
// First bbb activity.
$bbbs[] = $generator->create_module('bigbluebuttonbn', ['course' => $course1->id]);
// Second bbb activity.
$bbbs[] = $generator->create_module('bigbluebuttonbn', ['course' => $course2->id]);
$generator->enrol_user($user->id, $course1->id, null, 'manual');
$generator->enrol_user($user->id, $course2->id, null, 'manual');
// Set to the user.
self::setUser($user);
// Call the external function passing course ids.
$bbbactivities = $this->get_bigbluebuttons_by_courses([$course1->id, $course2->id]);
$this->assert_same_bbb_activities($bbbs, $bbbactivities['bigbluebuttonbns']);
// Call the external function without passing course id.
$bbbactivities = $this->get_bigbluebuttons_by_courses();
$this->assert_same_bbb_activities($bbbs, $bbbactivities['bigbluebuttonbns']);
// Unenrol user from second course and alter expected bbb activity.
$enrol = enrol_get_plugin('manual');
$enrolinstances = enrol_get_instances($course2->id, true);
foreach ($enrolinstances as $courseenrolinstance) {
if ($courseenrolinstance->enrol == "manual") {
$instance2 = $courseenrolinstance;
break;
}
}
$enrol->unenrol_user($instance2, $user->id);
// Call the external function without passing course id.
$bbbactivities = $this->get_bigbluebuttons_by_courses();
$this->assertCount(1, $bbbactivities['bigbluebuttonbns']);
$this->assertEquals($bbbs[0]->id, $bbbactivities['bigbluebuttonbns'][0]['id']);
// Call for the second course we unenrolled the user from.
$bbbactivities = $this->get_bigbluebuttons_by_courses([$course2->id]);
$this->assertCount(0, $bbbactivities['bigbluebuttonbns']);
}
/**
* Check if the two arrays containing the activities are the same.
*
* @param mixed $expected
* @param mixed $actual
*/
protected function assert_same_bbb_activities($expected, $actual) {
$this->assertCount(count($expected), $actual);
$getids = function($bbb) {
return is_array($bbb) ? $bbb['id'] : $bbb->id;
};
$expectedids = array_map($getids, $expected);
$actualid = array_map($getids, $actual);
sort($expectedids);
sort($actualid);
$this->assertEquals($expectedids, $actualid);
}
}