Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.10.x will end 8 November 2021 (12 months).
  • Bug fixes for security issues in 3.10.x will end 9 May 2022 (18 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are 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/>.

< /** < * Test course_enrolment_manager parts. < * < * @package core_enrol < * @category test < * @copyright 2016 Ruslan Kabalin, Lancaster University < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < */ < < defined('MOODLE_INTERNAL') || die();
> namespace core_enrol;
> use context_course; > use course_enrolment_manager;
/** * Test course_enrolment_manager parts. *
< * @package core
> * @package core_enrol
* @category test * @copyright 2016 Ruslan Kabalin, Lancaster University * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
> * @covers \course_enrolment_manager
*/
< class core_course_enrolment_manager_testcase extends advanced_testcase {
> class course_enrolment_manager_test extends \advanced_testcase {
/**
< * The course context used in tests.
> * The course used in tests.
* @var stdClass */ private $course = null; /** * List of users used in tests. * @var array */ private $users = array(); /** * List of groups used in tests. * @var array */ private $groups = array(); /** * Tests set up */ protected function setUp(): void { global $CFG; require_once($CFG->dirroot . '/enrol/locallib.php'); $this->setAdminUser(); $users = array(); $groups = array(); // Create the course and the users. $course = $this->getDataGenerator()->create_course(); $users['user0'] = $this->getDataGenerator()->create_user( array('username' => 'user0', 'firstname' => 'user0')); // A user without group. $users['user1'] = $this->getDataGenerator()->create_user( array('username' => 'user1', 'firstname' => 'user1')); // User for group 1. $users['user21'] = $this->getDataGenerator()->create_user( array('username' => 'user21', 'firstname' => 'user21')); // Two users for group 2. $users['user22'] = $this->getDataGenerator()->create_user( array('username' => 'user22', 'firstname' => 'user22')); $users['userall'] = $this->getDataGenerator()->create_user( array('username' => 'userall', 'firstname' => 'userall')); // A user in all groups. $users['usertch'] = $this->getDataGenerator()->create_user( array('username' => 'usertch', 'firstname' => 'usertch')); // A user with teacher role. // Enrol the users in the course. $this->getDataGenerator()->enrol_user($users['user0']->id, $course->id, 'student'); // Student. $this->getDataGenerator()->enrol_user($users['user1']->id, $course->id, 'student'); // Student. $this->getDataGenerator()->enrol_user($users['user21']->id, $course->id, 'student'); // Student. $this->getDataGenerator()->enrol_user($users['user22']->id, $course->id, 'student', 'manual', 0, 0, ENROL_USER_SUSPENDED); // Suspended student. $this->getDataGenerator()->enrol_user($users['userall']->id, $course->id, 'student'); // Student. $this->getDataGenerator()->enrol_user($users['usertch']->id, $course->id, 'editingteacher'); // Teacher. // Create 2 groups. $groups['group1'] = $this->getDataGenerator()->create_group(array('courseid' => $course->id)); $groups['group2'] = $this->getDataGenerator()->create_group(array('courseid' => $course->id)); // Add the users to the groups. $this->getDataGenerator()->create_group_member( array('groupid' => $groups['group1']->id, 'userid' => $users['user1']->id)); $this->getDataGenerator()->create_group_member( array('groupid' => $groups['group2']->id, 'userid' => $users['user21']->id)); $this->getDataGenerator()->create_group_member( array('groupid' => $groups['group2']->id, 'userid' => $users['user22']->id)); $this->getDataGenerator()->create_group_member( array('groupid' => $groups['group1']->id, 'userid' => $users['userall']->id)); $this->getDataGenerator()->create_group_member( array('groupid' => $groups['group2']->id, 'userid' => $users['userall']->id)); // Make setup data accessible from test methods. $this->course = $course; $this->users = $users; $this->groups = $groups; // Make sample users and not enroll to any course. $this->getDataGenerator()->create_user([ 'username' => 'testapiuser1', 'firstname' => 'testapiuser 1' ]); $this->getDataGenerator()->create_user([ 'username' => 'testapiuser2', 'firstname' => 'testapiuser 2' ]); $this->getDataGenerator()->create_user([ 'username' => 'testapiuser3', 'firstname' => 'testapiuser 3' ]); } /** * Verify get_total_users() returned number of users expected in every situation. */ public function test_get_total_users() { global $PAGE; $this->resetAfterTest(); // All users filtering. $manager = new course_enrolment_manager($PAGE, $this->course); $totalusers = $manager->get_total_users(); $this->assertEquals(6, $totalusers, 'All users must be returned when no filtering is applied.'); // Student role filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 5); $totalusers = $manager->get_total_users(); $this->assertEquals(5, $totalusers, 'Only students must be returned when student role filtering is applied.'); // Teacher role filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 3); $totalusers = $manager->get_total_users(); $this->assertEquals(1, $totalusers, 'Only teacher must be returned when teacher role filtering is applied.'); // Search user filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, 'userall'); $totalusers = $manager->get_total_users(); $this->assertEquals(1, $totalusers, 'Only searchable user must be returned when search filtering is applied.'); // Group 1 filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, '', $this->groups['group1']->id); $totalusers = $manager->get_total_users(); $this->assertEquals(2, $totalusers, 'Only group members must be returned when group filtering is applied.'); // Group 2 filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, '', $this->groups['group2']->id); $totalusers = $manager->get_total_users(); $this->assertEquals(3, $totalusers, 'Only group members must be returned when group filtering is applied.'); // 'No groups' filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, '', -1); $totalusers = $manager->get_total_users(); $this->assertEquals(2, $totalusers, 'Only non-group members must be returned when \'no groups\' filtering is applied.'); // Active users filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, '', 0, ENROL_USER_ACTIVE); $totalusers = $manager->get_total_users(); $this->assertEquals(5, $totalusers, 'Only active users must be returned when active users filtering is applied.'); // Suspended users filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, '', 0, ENROL_USER_SUSPENDED); $totalusers = $manager->get_total_users(); $this->assertEquals(1, $totalusers, 'Only suspended users must be returned when suspended users filtering is applied.'); } /** * Verify get_users() returned number of users expected in every situation. */ public function test_get_users() { global $PAGE; $this->resetAfterTest(); // All users filtering. $manager = new course_enrolment_manager($PAGE, $this->course); $users = $manager->get_users('id'); $this->assertCount(6, $users, 'All users must be returned when no filtering is applied.'); $this->assertArrayHasKey($this->users['user0']->id, $users); $this->assertArrayHasKey($this->users['user1']->id, $users); $this->assertArrayHasKey($this->users['user21']->id, $users); $this->assertArrayHasKey($this->users['user22']->id, $users); $this->assertArrayHasKey($this->users['userall']->id, $users); $this->assertArrayHasKey($this->users['usertch']->id, $users); // Student role filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 5); $users = $manager->get_users('id'); $this->assertCount(5, $users, 'Only students must be returned when student role filtering is applied.'); $this->assertArrayHasKey($this->users['user0']->id, $users); $this->assertArrayHasKey($this->users['user1']->id, $users); $this->assertArrayHasKey($this->users['user21']->id, $users); $this->assertArrayHasKey($this->users['user22']->id, $users); $this->assertArrayHasKey($this->users['userall']->id, $users); // Teacher role filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 3); $users = $manager->get_users('id'); $this->assertCount(1, $users, 'Only teacher must be returned when teacher role filtering is applied.'); $this->assertArrayHasKey($this->users['usertch']->id, $users); // Search user filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, 'userall'); $users = $manager->get_users('id'); $this->assertCount(1, $users, 'Only searchable user must be returned when search filtering is applied.'); $this->assertArrayHasKey($this->users['userall']->id, $users); // Group 1 filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, '', $this->groups['group1']->id); $users = $manager->get_users('id'); $this->assertCount(2, $users, 'Only group members must be returned when group filtering is applied.'); $this->assertArrayHasKey($this->users['user1']->id, $users); $this->assertArrayHasKey($this->users['userall']->id, $users); // Group 2 filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, '', $this->groups['group2']->id); $users = $manager->get_users('id'); $this->assertCount(3, $users, 'Only group members must be returned when group filtering is applied.'); $this->assertArrayHasKey($this->users['user21']->id, $users); $this->assertArrayHasKey($this->users['user22']->id, $users); $this->assertArrayHasKey($this->users['userall']->id, $users); // 'No groups' filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, '', -1); $users = $manager->get_users('id'); $this->assertCount(2, $users, 'Only non-group members must be returned when \'no groups\' filtering is applied.'); $this->assertArrayHasKey($this->users['user0']->id, $users); $this->assertArrayHasKey($this->users['usertch']->id, $users); // Active users filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, '', 0, ENROL_USER_ACTIVE); $users = $manager->get_users('id'); $this->assertCount(5, $users, 'Only active users must be returned when active users filtering is applied.'); $this->assertArrayHasKey($this->users['user0']->id, $users); $this->assertArrayHasKey($this->users['user1']->id, $users); $this->assertArrayHasKey($this->users['user21']->id, $users); $this->assertArrayHasKey($this->users['userall']->id, $users); $this->assertArrayHasKey($this->users['usertch']->id, $users); // Suspended users filtering. $manager = new course_enrolment_manager($PAGE, $this->course, null, 0, '', 0, ENROL_USER_SUSPENDED); $users = $manager->get_users('id'); $this->assertCount(1, $users, 'Only suspended users must be returned when suspended users filtering is applied.'); $this->assertArrayHasKey($this->users['user22']->id, $users); } /**
> * Sets up a custom profile field and the showuseridentity option, and creates a test user * Test get_potential_users without returnexactcount param. > * with suitable values set. * > * * @dataProvider search_users_provider > * @return stdClass Test user * > */ * @param int $perpage Number of users per page. > protected function setup_for_user_identity_tests(): \stdClass { * @param bool $returnexactcount Return the exact count or not. > // Configure extra fields to include one normal user field and one profile field, and * @param int $expectedusers Expected number of users return. > // set the values for a new test user. * @param int $expectedtotalusers Expected total of users in database. > $generator = $this->getDataGenerator(); * @param bool $expectedmoreusers Expected for more users return or not. > $generator->create_custom_profile_field(['datatype' => 'text', */ > 'shortname' => 'researchtopic', 'name' => 'Research topic']); public function test_get_potential_users($perpage, $returnexactcount, $expectedusers, $expectedtotalusers, $expectedmoreusers) { > set_config('showuseridentity', 'email,department,profile_field_researchtopic'); global $DB, $PAGE; > return $generator->create_user( $this->resetAfterTest(); > ['username' => 'newuser', 'department' => 'Amphibian studies', 'email' => 'x@x.org', $this->setAdminUser(); > 'profile_field_researchtopic' => 'Frogs', 'imagealt' => 'Smart suit']); > } $enrol = $DB->get_record('enrol', array('courseid' => $this->course->id, 'enrol' => 'manual')); > $manager = new course_enrolment_manager($PAGE, $this->course); > /** $users = $manager->get_potential_users($enrol->id, > * Checks that the get_users function returns the correct user fields. 'testapiuser', > */ true, > public function test_get_users_fields() { 0, > global $PAGE; $perpage, > 0, > $this->resetAfterTest(); $returnexactcount); > $newuser = $this->setup_for_user_identity_tests(); > $this->assertCount($expectedusers, $users['users']); > // Enrol the user in test course. $this->assertEquals($expectedmoreusers, $users['moreusers']); > $this->getDataGenerator()->enrol_user($newuser->id, $this->course->id, 'student'); if ($returnexactcount) { > $this->assertArrayHasKey('totalusers', $users); > // Get all users and fish out the one we're interested in. $this->assertEquals($expectedtotalusers, $users['totalusers']); > $manager = new course_enrolment_manager($PAGE, $this->course); } else { > $users = $manager->get_users('id'); $this->assertArrayNotHasKey('totalusers', $users); > $user = $users[$newuser->id]; } > } > // Should include core required fields... > $this->assertEquals($newuser->id, $user->id); /** > * Test search_other_users with returnexactcount param. > // ...And the ones specified in showuseridentity (one of which is also needed for user pics). * > $this->assertEquals('Amphibian studies', $user->department); * @dataProvider search_users_provider > $this->assertEquals('Frogs', $user->profile_field_researchtopic); * > $this->assertEquals('x@x.org', $user->email); * @param int $perpage Number of users per page. > * @param bool $returnexactcount Return the exact count or not. > // And the ones necessary for user pics. * @param int $expectedusers Expected number of users return. > $this->assertEquals('Smart suit', $user->imagealt); * @param int $expectedtotalusers Expected total of users in database. > * @param bool $expectedmoreusers Expected for more users return or not. > // But not some random other field like city. */ > $this->assertObjectNotHasAttribute('city', $user); public function test_search_other_users($perpage, $returnexactcount, $expectedusers, $expectedtotalusers, $expectedmoreusers) { > } global $PAGE; > $this->resetAfterTest(); > /** $this->setAdminUser(); > * Checks that the get_other_users function returns the correct user fields. > */ $manager = new course_enrolment_manager($PAGE, $this->course); > public function test_get_other_users_fields() { $users = $manager->search_other_users( > global $PAGE, $DB; 'testapiuser', > true, > $this->resetAfterTest(); 0, > $perpage, > // Configure extra fields to include one normal user field and one profile field, and $returnexactcount); > // set the values for a new test user. > $newuser = $this->setup_for_user_identity_tests(); $this->assertCount($expectedusers, $users['users']); > $context = \context_course::instance($this->course->id); $this->assertEquals($expectedmoreusers, $users['moreusers']); > role_assign($DB->get_field('role', 'id', ['shortname' => 'manager']), $newuser->id, $context->id); if ($returnexactcount) { > $this->assertArrayHasKey('totalusers', $users); > // Get the 'other' (role but not enrolled) users and fish out the one we're interested in. $this->assertEquals($expectedtotalusers, $users['totalusers']); > $manager = new course_enrolment_manager($PAGE, $this->course); } else { > $users = array_values($manager->get_other_users('id')); $this->assertArrayNotHasKey('totalusers', $users); > $user = $users[0]; } > } > // Should include core required fields... > $this->assertEquals($newuser->id, $user->id); /** > * Test case for test_get_potential_users, test_search_other_users and test_search_users tests. > // ...And the ones specified in showuseridentity (one of which is also needed for user pics). * > $this->assertEquals('Amphibian studies', $user->department); * @return array Dataset > $this->assertEquals('Frogs', $user->profile_field_researchtopic); */ > $this->assertEquals('x@x.org', $user->email); public function search_users_provider() { > return [ > // And the ones necessary for user pics. [2, false, 2, 3, true], > $this->assertEquals('Smart suit', $user->imagealt); [5, false, 3, 3, false], > [2, true, 2, 3, true], > // But not some random other field like city. [5, true, 3, 3, false] > $this->assertObjectNotHasAttribute('city', $user); ]; > } } > > /** /** > * Checks that the get_potential_users function returns the correct user fields. * Test search_users function. > */ * > public function test_get_potential_users_fields() { * @dataProvider search_users_provider > global $PAGE; * > * @param int $perpage Number of users per page. > $this->resetAfterTest(); * @param bool $returnexactcount Return the exact count or not. > * @param int $expectedusers Expected number of users return. > // Configure extra fields to include one normal user field and one profile field, and * @param int $expectedtotalusers Expected total of users in database. > // set the values for a new test user. * @param bool $expectedmoreusers Expected for more users return or not. > $newuser = $this->setup_for_user_identity_tests(); */ > public function test_search_users($perpage, $returnexactcount, $expectedusers, $expectedtotalusers, $expectedmoreusers) { > // Get the 'potential' (not enrolled) users and fish out the one we're interested in. global $PAGE; > $manager = new course_enrolment_manager($PAGE, $this->course); $this->resetAfterTest(); > foreach (enrol_get_instances($this->course->id, true) as $enrolinstance) { > if ($enrolinstance->enrol === 'manual') { $this->getDataGenerator()->create_and_enrol($this->course, 'student', ['firstname' => 'sutest 1']); > $enrolid = $enrolinstance->id; $this->getDataGenerator()->create_and_enrol($this->course, 'student', ['firstname' => 'sutest 2']); > } $this->getDataGenerator()->create_and_enrol($this->course, 'student', ['firstname' => 'sutest 3']); > } > $users = array_values($manager->get_potential_users($enrolid)); $manager = new course_enrolment_manager($PAGE, $this->course); > $user = $users[0][$newuser->id]; $users = $manager->search_users( > 'sutest', > // Should include core required fields... true, > $this->assertEquals($newuser->id, $user->id); 0, > $perpage, > // ...And the ones specified in showuseridentity (one of which is also needed for user pics). $returnexactcount > $this->assertEquals('Amphibian studies', $user->department); ); > $this->assertEquals('Frogs', $user->profile_field_researchtopic); > $this->assertEquals('x@x.org', $user->email); $this->assertCount($expectedusers, $users['users']); > $this->assertEquals($expectedmoreusers, $users['moreusers']); > // And the ones necessary for user pics. if ($returnexactcount) { > $this->assertEquals('Smart suit', $user->imagealt); $this->assertArrayHasKey('totalusers', $users); > $this->assertEquals($expectedtotalusers, $users['totalusers']); > // But not some random other field like city. } else { > $this->assertObjectNotHasAttribute('city', $user); $this->assertArrayNotHasKey('totalusers', $users); > } } > } > /**
}
> * Tests get_potential_users when the search term includes a custom field. > */ > public function test_get_potential_users_search_fields() { > global $PAGE; > > $this->resetAfterTest(); > > // Configure extra fields to include one normal user field and one profile field, and > // set the values for a new test user. > $newuser = $this->setup_for_user_identity_tests(); > > // Set up the enrolment manager. > $manager = new course_enrolment_manager($PAGE, $this->course); > foreach (enrol_get_instances($this->course->id, true) as $enrolinstance) { > if ($enrolinstance->enrol === 'manual') { > $enrolid = $enrolinstance->id; > } > } > > // Search for text included in a 'standard' (user table) identity field. > $users = array_values($manager->get_potential_users($enrolid, 'Amphibian studies')); > $this->assertEquals([$newuser->id], array_keys($users[0])); > > // And for text included in a custom field. > $users = array_values($manager->get_potential_users($enrolid, 'Frogs')); > $this->assertEquals([$newuser->id], array_keys($users[0])); > > // With partial matches. > $users = array_values($manager->get_potential_users($enrolid, 'Amphibian')); > $this->assertEquals([$newuser->id], array_keys($users[0])); > $users = array_values($manager->get_potential_users($enrolid, 'Fro')); > $this->assertEquals([$newuser->id], array_keys($users[0])); > > // With partial in-the-middle matches. > $users = array_values($manager->get_potential_users($enrolid, 'phibian')); > $this->assertEquals([], array_keys($users[0])); > $users = array_values($manager->get_potential_users($enrolid, 'rog')); > $this->assertEquals([], array_keys($users[0])); > $users = array_values($manager->get_potential_users($enrolid, 'phibian', true)); > $this->assertEquals([$newuser->id], array_keys($users[0])); > $users = array_values($manager->get_potential_users($enrolid, 'rog', true)); > $this->assertEquals([$newuser->id], array_keys($users[0])); > > // If the current user doesn't have access to identity fields then these searches won't work. > $this->setUser($this->getDataGenerator()->create_user()); > $users = array_values($manager->get_potential_users($enrolid, 'Amphibian studies')); > $this->assertEquals([], array_keys($users[0])); > $users = array_values($manager->get_potential_users($enrolid, 'Frogs')); > $this->assertEquals([], array_keys($users[0])); > > // Search for username field (there is special handling for this one field). > set_config('showuseridentity', 'username'); > $this->setAdminUser(); > $users = array_values($manager->get_potential_users($enrolid, 'newuse')); > $this->assertEquals([$newuser->id], array_keys($users[0])); > } > > /**
> } > > /** > * Test that search_users observes course group mode restrictions correctly > */ > public function test_search_users_course_groupmode(): void { > global $DB, $PAGE; > > $this->resetAfterTest(); > > $teacher = $this->getDataGenerator()->create_and_enrol($this->course, 'teacher'); > $this->getDataGenerator()->create_group_member(['groupid' => $this->groups['group1']->id, 'userid' => $teacher->id]); > $this->setUser($teacher); > > $users = (new course_enrolment_manager($PAGE, $this->course))->search_users('', false, 0, 25, true); > $this->assertEqualsCanonicalizing([ > $teacher->username, > $this->users['user0']->username, > $this->users['user1']->username, > $this->users['user21']->username, > $this->users['user22']->username, > $this->users['userall']->username, > $this->users['usertch']->username, > ], array_column($users['users'], 'username')); > $this->assertEquals(7, $users['totalusers']); > > // Switch course to separate groups. > $this->course->groupmode = SEPARATEGROUPS; > update_course($this->course); > > $users = (new course_enrolment_manager($PAGE, $this->course))->search_users('', false, 0, 25, true); > $this->assertEqualsCanonicalizing([ > $teacher->username, > $this->users['user1']->username, > $this->users['userall']->username, > ], array_column($users['users'], 'username')); > $this->assertEquals(3, $users['totalusers']); > > // Allow teacher to access all groups. > $roleid = $DB->get_field('role', 'id', ['shortname' => 'teacher']); > assign_capability('moodle/site:accessallgroups', CAP_ALLOW, $roleid, context_course::instance($this->course->id)->id); > > $users = (new course_enrolment_manager($PAGE, $this->course))->search_users('', false, 0, 25, true); > $this->assertEqualsCanonicalizing([ > $teacher->username, > $this->users['user0']->username, > $this->users['user1']->username, > $this->users['user21']->username, > $this->users['user22']->username, > $this->users['userall']->username, > $this->users['usertch']->username, > ], array_column($users['users'], 'username')); > $this->assertEquals(7, $users['totalusers']);