See Release Notes
Long Term Support Release
<?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 core_completion; /** * Test completion API. * * @package core_completion * @category test * @copyright 2017 Mark Nelson <markn@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class api_test extends \advanced_testcase { /** * Test setup. */ public function setUp(): void { $this->resetAfterTest(); } public function test_update_completion_date_event() { global $CFG, $DB; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1)); // Create an assign activity. $time = time(); $assign = $this->getDataGenerator()->create_module('assign', array('course' => $course->id)); // Create the completion event. $CFG->enablecompletion = true; \core_completion\api::update_completion_date_event($assign->cmid, 'assign', $assign, $time); // Check that there is now an event in the database. $events = $DB->get_records('event'); $this->assertCount(1, $events); // Get the event. $event = reset($events); // Confirm the event is correct. $this->assertEquals('assign', $event->modulename); $this->assertEquals($assign->id, $event->instance); $this->assertEquals(CALENDAR_EVENT_TYPE_ACTION, $event->type); $this->assertEquals(\core_completion\api::COMPLETION_EVENT_TYPE_DATE_COMPLETION_EXPECTED, $event->eventtype); $this->assertEquals($time, $event->timestart); $this->assertEquals($time, $event->timesort); require_once($CFG->dirroot . '/course/lib.php'); // Delete the module. course_delete_module($assign->cmid); // Check we don't get a failure when called on a deleted module. \core_completion\api::update_completion_date_event($assign->cmid, 'assign', null, $time); } public function test_update_completion_date_event_update() { global $CFG, $DB; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1)); // Create an assign activity. $time = time(); $assign = $this->getDataGenerator()->create_module('assign', array('course' => $course->id)); // Create the event. $CFG->enablecompletion = true; \core_completion\api::update_completion_date_event($assign->cmid, 'assign', $assign, $time); // Call it again, but this time with a different time. \core_completion\api::update_completion_date_event($assign->cmid, 'assign', $assign, $time + DAYSECS); // Check that there is still only one event in the database. $events = $DB->get_records('event'); $this->assertCount(1, $events); // Get the event. $event = reset($events); // Confirm that the event has been updated. $this->assertEquals('assign', $event->modulename); $this->assertEquals($assign->id, $event->instance); $this->assertEquals(CALENDAR_EVENT_TYPE_ACTION, $event->type); $this->assertEquals(\core_completion\api::COMPLETION_EVENT_TYPE_DATE_COMPLETION_EXPECTED, $event->eventtype); $this->assertEquals($time + DAYSECS, $event->timestart); $this->assertEquals($time + DAYSECS, $event->timesort); } public function test_update_completion_date_event_delete() { global $CFG, $DB; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1)); // Create an assign activity. $time = time(); $assign = $this->getDataGenerator()->create_module('assign', array('course' => $course->id)); // Create the event. $CFG->enablecompletion = true; \core_completion\api::update_completion_date_event($assign->cmid, 'assign', $assign, $time); // Call it again, but the time specified as null. \core_completion\api::update_completion_date_event($assign->cmid, 'assign', $assign, null); // Check that there is no event in the database. $this->assertEquals(0, $DB->count_records('event')); } public function test_update_completion_date_event_completion_disabled() { global $CFG, $DB; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1)); // Create an assign activity. $time = time(); $assign = $this->getDataGenerator()->create_module('assign', array('course' => $course->id)); // Try and create the completion event with completion disabled. $CFG->enablecompletion = false; \core_completion\api::update_completion_date_event($assign->cmid, 'assign', $assign, $time); // Check that there is no event in the database. $this->assertEquals(0, $DB->count_records('event')); } public function test_update_completion_date_event_update_completion_disabled() { global $CFG, $DB; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1)); // Create an assign activity. $time = time(); $assign = $this->getDataGenerator()->create_module('assign', array('course' => $course->id)); // Create the completion event. $CFG->enablecompletion = true; \core_completion\api::update_completion_date_event($assign->cmid, 'assign', $assign, $time); // Disable completion. $CFG->enablecompletion = false; // Try and update the completion date. \core_completion\api::update_completion_date_event($assign->cmid, 'assign', $assign, $time + DAYSECS); // Check that there is an event in the database. $events = $DB->get_records('event'); $this->assertCount(1, $events); // Get the event. $event = reset($events); // Confirm the event has not changed. $this->assertEquals('assign', $event->modulename); $this->assertEquals($assign->id, $event->instance); $this->assertEquals(CALENDAR_EVENT_TYPE_ACTION, $event->type); $this->assertEquals(\core_completion\api::COMPLETION_EVENT_TYPE_DATE_COMPLETION_EXPECTED, $event->eventtype); $this->assertEquals($time, $event->timestart); $this->assertEquals($time, $event->timesort); } public function test_update_completion_date_event_delete_completion_disabled() { global $CFG, $DB; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1)); // Create an assign activity. $time = time(); $assign = $this->getDataGenerator()->create_module('assign', array('course' => $course->id)); // Create the completion event. $CFG->enablecompletion = true; \core_completion\api::update_completion_date_event($assign->cmid, 'assign', $assign, $time); // Disable completion. $CFG->enablecompletion = false; // Should still be able to delete completion events even when completion is disabled. \core_completion\api::update_completion_date_event($assign->cmid, 'assign', $assign, null); // Check that there is now no event in the database. $this->assertEquals(0, $DB->count_records('event')); }> } > /** > * Test for mark_course_completions_activity_criteria(). > */ > public function test_mark_course_completions_activity_criteria() { > global $DB, $CFG; > require_once($CFG->dirroot.'/completion/criteria/completion_criteria_activity.php'); > $this->resetAfterTest(true); > > $course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1)); > $student1 = $this->getDataGenerator()->create_user(); > $student2 = $this->getDataGenerator()->create_user(); > > $teacher = $this->getDataGenerator()->create_user(); > $studentrole = $DB->get_record('role', array('shortname' => 'student')); > $teacherrole = $DB->get_record('role', array('shortname' => 'editingteacher')); > > $this->getDataGenerator()->enrol_user($teacher->id, $course->id, $teacherrole->id); > $this->getDataGenerator()->enrol_user($student1->id, $course->id, $studentrole->id); > $this->getDataGenerator()->enrol_user($student2->id, $course->id, $studentrole->id); > > $data = $this->getDataGenerator()->create_module('data', array('course' => $course->id), > array('completion' => 1)); > $cmdata = get_coursemodule_from_id('data', $data->cmid); > $cm = get_coursemodule_from_instance('data', $data->id); > $c = new \completion_info($course); > > // Add activity completion criteria. > $criteriadata = new \stdClass(); > $criteriadata->id = $course->id; > $criteriadata->criteria_activity = array(); > // Some activities. > $criteriadata->criteria_activity[$cmdata->id] = 1; > $criterion = new \completion_criteria_activity(); > $criterion->update_config($criteriadata); > > $this->setUser($teacher); > > // Mark activity complete for both users. > $completion = new \stdClass(); > $completion->coursemoduleid = $cm->id; > $completion->completionstate = COMPLETION_COMPLETE; > $completion->timemodified = time(); > $completion->viewed = COMPLETION_NOT_VIEWED; > $completion->overrideby = null; > > $completion->id = 0; > $completion->userid = $student1->id; > $c->internal_set_data($cm, $completion, true); > > $completion->id = 0; > $completion->userid = $student2->id; > $c->internal_set_data($cm, $completion, true); > > // Run instant course completions for student1. Only student1 will be marked as completed a course. > $userdata = ['userid' => $student1->id, 'courseid' => $course->id]; > $actual = $DB->get_records('course_completions'); > $this->assertEmpty($actual); > > $coursecompletionid = \core_completion\api::mark_course_completions_activity_criteria($userdata); > > $actual = $DB->get_records('course_completions'); > $this->assertEquals(reset($actual)->id, $coursecompletionid); > $this->assertEquals(1, count($actual)); > $this->assertEquals($student1->id, reset($actual)->userid); > > // Run course completions cron. Both students will be marked as completed a course. > $coursecompletionid = \core_completion\api::mark_course_completions_activity_criteria(); > $this->assertEquals(0, $coursecompletionid); > $actual = $DB->get_records('course_completions'); > $students = [$student1->id, $student2->id]; > $this->assertEquals(2, count($actual)); > $this->assertContains(reset($actual)->userid, $students); > $this->assertContains(end($actual)->userid, $students); > } > > /** > * Test for mark_course_completions_activity_criteria() with different completionpassgrade settings. > * @covers ::mark_course_completions_activity_criteria > */ > public function test_mark_course_completions_activity_criteria_completion_states() { > global $DB, $CFG; > require_once($CFG->dirroot . '/completion/criteria/completion_criteria_activity.php'); > $this->resetAfterTest(true); > > $courses[] = $this->getDataGenerator()->create_course(['shortname' => 'completionpassgradenotset', > 'enablecompletion' => 1]); > $courses[] = $this->getDataGenerator()->create_course(['shortname' => 'completionpassgradeset', > 'enablecompletion' => 1]); > > $student1 = $this->getDataGenerator()->create_user(); > $student2 = $this->getDataGenerator()->create_user(); > > $teacher = $this->getDataGenerator()->create_user(); > $studentrole = $DB->get_record('role', array('shortname' => 'student')); > $teacherrole = $DB->get_record('role', array('shortname' => 'editingteacher')); > > foreach ($courses as $course) { > $this->getDataGenerator()->enrol_user($teacher->id, $course->id, $teacherrole->id); > $this->getDataGenerator()->enrol_user($student1->id, $course->id, $studentrole->id); > $this->getDataGenerator()->enrol_user($student2->id, $course->id, $studentrole->id); > > $completioncriteria = [ > 'completionusegrade' => 1, > 'gradepass' => 50 > ]; > > if ($course->shortname == 'completionpassgradeset') { > $completioncriteria['completionpassgrade'] = 1; > } > > /** @var \mod_assign_generator $assigngenerator */ > $assigngenerator = $this->getDataGenerator()->get_plugin_generator('mod_assign'); > $assign = $assigngenerator->create_instance([ > 'course' => $course->id, > 'completion' => COMPLETION_ENABLED, > ] + $completioncriteria); > > $cmassing = get_coursemodule_from_id('assign', $assign->cmid); > $cm = get_coursemodule_from_instance('assign', $assign->id); > $c = new \completion_info($course); > > // Add activity completion criteria. > $criteriadata = new \stdClass(); > $criteriadata->id = $course->id; > $criteriadata->criteria_activity = array(); > // Some activities. > $criteriadata->criteria_activity[$cmassing->id] = 1; > $criterion = new \completion_criteria_activity(); > $criterion->update_config($criteriadata); > > $this->setUser($teacher); > > // Mark user completions. > $completion = new \stdClass(); > $completion->coursemoduleid = $cm->id; > $completion->timemodified = time(); > $completion->viewed = COMPLETION_NOT_VIEWED; > $completion->overrideby = null; > > // Student1 achieved passgrade. > $completion->id = 0; > $completion->completionstate = COMPLETION_COMPLETE_PASS; > $completion->userid = $student1->id; > $c->internal_set_data($cm, $completion, true); > > // Student2 has not achieved passgrade. > $completion->id = 0; > $completion->completionstate = COMPLETION_COMPLETE_FAIL; > $completion->userid = $student2->id; > $c->internal_set_data($cm, $completion, true); > > $actual = $DB->get_records('course_completions', ['course' => $course->id]); > $this->assertEmpty($actual); > > // Run course completions cron. > $coursecompletionid = \core_completion\api::mark_course_completions_activity_criteria(); > $this->assertEquals(0, $coursecompletionid); > $actual = $DB->get_records('course_completions', ['course' => $course->id]); > > if ($course->shortname == 'completionpassgradeset') { > // Only student1 has completed a course. > $this->assertEquals(1, count($actual)); > $this->assertEquals($student1->id, reset($actual)->userid); > } else { > // Both students completed a course. > $students = [$student1->id, $student2->id]; > $this->assertEquals(2, count($actual)); > $this->assertContains(reset($actual)->userid, $students); > $this->assertContains(end($actual)->userid, $students); > } > } > }