Rev 1 | Ir a la última revisión | Autoría | Comparar con el anterior | Ultima modificación | Ver Log |
<?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;use completion_completion;/*** Test completion progress 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 progress_test extends \advanced_testcase {/*** Test setup.*/public function setUp(): void {global $CFG;$CFG->enablecompletion = true;$this->resetAfterTest();}/*** Tests that the course progress percentage is returned correctly when we have only activity completion.*/public function test_course_progress_percentage_with_just_activities(): void {global $DB;// Add a course that supports completion.$course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1));// Enrol a user in the course.$user = $this->getDataGenerator()->create_user();$studentrole = $DB->get_record('role', array('shortname' => 'student'));$this->getDataGenerator()->enrol_user($user->id, $course->id, $studentrole->id);// Add four activities that use completion.$assign = $this->getDataGenerator()->create_module('assign', array('course' => $course->id),array('completion' => 1));$data = $this->getDataGenerator()->create_module('data', array('course' => $course->id),array('completion' => 1));$this->getDataGenerator()->create_module('forum', array('course' => $course->id),array('completion' => 1));$this->getDataGenerator()->create_module('forum', array('course' => $course->id),array('completion' => 1));// Add an activity that does *not* use completion.$this->getDataGenerator()->create_module('assign', array('course' => $course->id));// Mark two of them as completed for a user.$cmassign = get_coursemodule_from_id('assign', $assign->cmid);$cmdata = get_coursemodule_from_id('data', $data->cmid);$completion = new \completion_info($course);$completion->update_state($cmassign, COMPLETION_COMPLETE, $user->id);$completion->update_state($cmdata, COMPLETION_COMPLETE, $user->id);// Check we have received valid data.// Note - only 4 out of the 5 activities support completion, and the user has completed 2 of those.$this->assertEquals('50', \core_completion\progress::get_course_progress_percentage($course, $user->id));}/*** Tests that the course progress percentage is returned correctly when we have a course and activity completion.*/public function test_course_progress_percentage_with_activities_and_course(): void {global $DB;// Add a course that supports completion.$course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1));// Enrol a user in the course.$user = $this->getDataGenerator()->create_user();$studentrole = $DB->get_record('role', array('shortname' => 'student'));$this->getDataGenerator()->enrol_user($user->id, $course->id, $studentrole->id);// Add four activities that use completion.$assign = $this->getDataGenerator()->create_module('assign', array('course' => $course->id),array('completion' => 1));$data = $this->getDataGenerator()->create_module('data', array('course' => $course->id),array('completion' => 1));$this->getDataGenerator()->create_module('forum', array('course' => $course->id),array('completion' => 1));$this->getDataGenerator()->create_module('forum', array('course' => $course->id),array('completion' => 1));// Add an activity that does *not* use completion.$this->getDataGenerator()->create_module('assign', array('course' => $course->id));// Mark two of them as completed for a user.$cmassign = get_coursemodule_from_id('assign', $assign->cmid);$cmdata = get_coursemodule_from_id('data', $data->cmid);$completion = new \completion_info($course);$completion->update_state($cmassign, COMPLETION_COMPLETE, $user->id);$completion->update_state($cmdata, COMPLETION_COMPLETE, $user->id);// Now, mark the course as completed.$ccompletion = new completion_completion(array('course' => $course->id, 'userid' => $user->id));$ccompletion->mark_complete();// Check we have received valid data.// The course completion takes priority, so should return 100.$this->assertEquals('100', \core_completion\progress::get_course_progress_percentage($course, $user->id));}/*** Tests that the course progress percentage is returned correctly for various grade to pass settings** @covers \core_completion\progress::get_course_progress_percentage.*/public function test_course_progress_percentage_completion_state(): void {global $DB, $CFG;require_once("{$CFG->dirroot}/completion/criteria/completion_criteria_activity.php");// Add a course that supports completion.$course = $this->getDataGenerator()->create_course(['enablecompletion' => 1]);// Enrol a user in the course.$teacher = $this->getDataGenerator()->create_user();$user = $this->getDataGenerator()->create_user();$studentrole = $DB->get_record('role', ['shortname' => 'student']);$teacherrole = $DB->get_record('role', array('shortname' => 'editingteacher'));$this->getDataGenerator()->enrol_user($user->id, $course->id, $studentrole->id);$this->getDataGenerator()->enrol_user($teacher->id, $course->id, $teacherrole->id);// Add three activities that use completion./** @var \mod_assign_generator $assigngenerator */$assigngenerator = $this->getDataGenerator()->get_plugin_generator('mod_assign');$assign['passgragepassed'] = $assigngenerator->create_instance(['course' => $course->id,'completion' => COMPLETION_ENABLED,'completionusegrade' => 1,'gradepass' => 50,'completionpassgrade' => 1]);$assign['passgragefailed'] = $assigngenerator->create_instance(['course' => $course->id,'completion' => COMPLETION_ENABLED,'completionusegrade' => 1,'gradepass' => 50,'completionpassgrade' => 1]);$assign['passgragenotused'] = $assigngenerator->create_instance(['course' => $course->id,'completion' => COMPLETION_ENABLED,'completionusegrade' => 1,'gradepass' => 50,]);$assign['nograde'] = $assigngenerator->create_instance(['course' => $course->id,'completion' => COMPLETION_ENABLED,]);$c = new \completion_info($course);foreach ($assign as $item) {$cmassing = get_coursemodule_from_id('assign', $item->cmid);// Add activity completion criteria.$criteriadata = new \stdClass();$criteriadata->id = $course->id;$criteriadata->criteria_activity = [];// Some activities.$criteriadata->criteria_activity[$cmassing->id] = 1;$criterion = new \completion_criteria_activity();$criterion->update_config($criteriadata);}$this->setUser($teacher);foreach ($assign as $key => $item) {$cm = get_coursemodule_from_instance('assign', $item->id);// Mark user completions.$completion = new \stdClass();$completion->coursemoduleid = $cm->id;$completion->timemodified = time();$completion->viewed = COMPLETION_NOT_VIEWED;$completion->overrideby = null;if ($key == 'passgragepassed') {$completion->id = 0;$completion->completionstate = COMPLETION_COMPLETE_PASS;$completion->userid = $user->id;$c->internal_set_data($cm, $completion, true);} else if ($key == 'passgragefailed') {$completion->id = 0;$completion->completionstate = COMPLETION_COMPLETE_FAIL;$completion->userid = $user->id;$c->internal_set_data($cm, $completion, true);} else if ($key == 'passgragenotused') {$completion->id = 0;$completion->completionstate = COMPLETION_COMPLETE;$completion->userid = $user->id;$c->internal_set_data($cm, $completion, true);} else if ($key == 'nograde') {$completion->id = 0;$completion->completionstate = COMPLETION_COMPLETE;$completion->userid = $user->id;$c->internal_set_data($cm, $completion, true);}}// Run course completions cron.\core_completion\api::mark_course_completions_activity_criteria();// Check we have received valid data.// Only assign2 is not completed.$this->assertEquals('75', \core_completion\progress::get_course_progress_percentage($course, $user->id));}/*** Tests that the course progress returns null when the course does not support it.*/public function test_course_progress_course_not_using_completion(): void {// Create a course that does not use completion.$course = $this->getDataGenerator()->create_course();// Check that the result was null.$this->assertNull(\core_completion\progress::get_course_progress_percentage($course));}/*** Tests that the course progress returns null when there are no activities that support it.*/public function test_course_progress_no_activities_using_completion(): void {// Create a course that does support completion.$course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1));// Add an activity that does *not* support completion.$this->getDataGenerator()->create_module('assign', array('course' => $course->id));// Check that the result was null.$this->assertNull(\core_completion\progress::get_course_progress_percentage($course));}/*** Tests that the course progress returns null for a not tracked for completion user in a course.*/public function test_course_progress_not_tracked_user(): void {global $DB;// Add a course that supports completion.$course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1));// Enrol a user in the course.$user = $this->getDataGenerator()->create_user();$studentrole = $DB->get_record('role', array('shortname' => 'student'));$this->getDataGenerator()->enrol_user($user->id, $course->id, $studentrole->id);// Now, mark the course as completed.$ccompletion = new completion_completion(array('course' => $course->id, 'userid' => $user->id));$ccompletion->mark_complete();// The course completion should return 100.$this->assertEquals('100', \core_completion\progress::get_course_progress_percentage($course, $user->id));// Now make the user's role to be not tracked for completion.unassign_capability('moodle/course:isincompletionreports', $studentrole->id);// Check that the result is null now.$this->assertNull(\core_completion\progress::get_course_progress_percentage($course, $user->id));}}