<?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 criteria.
*
* @package core_completion
* @category test
* @copyright 2021 Mikhail Golenkov <mikhailgolenkov@catalyst-au.net>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
< class core_completion_criteria_testcase extends \advanced_testcase {
> class completion_criteria_test extends \advanced_testcase {
/**
* Test setup.
*/
public function setUp(): void {
global $CFG;
require_once($CFG->dirroot.'/completion/criteria/completion_criteria_course.php');
require_once($CFG->dirroot.'/completion/criteria/completion_criteria_activity.php');
require_once($CFG->dirroot.'/completion/criteria/completion_criteria_duration.php');
require_once($CFG->dirroot.'/completion/criteria/completion_criteria_grade.php');
require_once($CFG->dirroot.'/completion/criteria/completion_criteria_date.php');
$this->setAdminUser();
$this->resetAfterTest();
}
/**
* Test that activity completion dates are used when activity criteria is marked as completed.
*/
public function test_completion_criteria_activity(): void {
global $DB;
$timestarted = time();
$timecompleted = 1620000000;
// Create a course, an activity and enrol a couple of users.
$course = $this->getDataGenerator()->create_course(['enablecompletion' => 1]);
$assign = $this->getDataGenerator()->create_module('assign', ['course' => $course->id], ['completion' => 1]);
$user1 = $this->getDataGenerator()->create_user();
$user2 = $this->getDataGenerator()->create_user();
$studentrole = $DB->get_record('role', ['shortname' => 'student']);
$this->getDataGenerator()->enrol_user($user1->id, $course->id, $studentrole->id);
$this->getDataGenerator()->enrol_user($user2->id, $course->id, $studentrole->id);
// Set completion criteria and mark both users to complete the criteria.
$criteriadata = (object) [
'id' => $course->id,
'criteria_activity' => [$assign->cmid => 1],
];
$criterion = new \completion_criteria_activity();
$criterion->update_config($criteriadata);
$cmassign = get_coursemodule_from_id('assign', $assign->cmid);
$completion = new \completion_info($course);
$completion->update_state($cmassign, COMPLETION_COMPLETE, $user1->id);
$completion->update_state($cmassign, COMPLETION_COMPLETE, $user2->id);
// Update User 1 to complete the activity at $timecompleted.
$params = ['coursemoduleid' => $assign->cmid, 'userid' => $user1->id];
$DB->set_field('course_modules_completion', 'timemodified', $timecompleted, $params);
// Run completion scheduled task.
$task = new \core\task\completion_regular_task();
$this->expectOutputRegex("/Marking complete/");
$task->execute();
// Hopefully, some day MDL-33320 will be fixed and all these sleeps
// and double cron calls in behat and unit tests will be removed.
sleep(1);
$task->execute();
// Completion criteria for User 1 is supposed to be marked as completed at $timecompleted.
$result = \core_completion_external::get_activities_completion_status($course->id, $user1->id);
$actual = reset($result['statuses']);
$this->assertEquals(1, $actual['state']);
$this->assertEquals($timecompleted, $actual['timecompleted']);
// And the whole course is marked as completed at $timecompleted for User 1 because
// it's the latest criteria completion date.
$ccompletion = new \completion_completion(['userid' => $user1->id, 'course' => $course->id]);
$this->assertEquals($timecompleted, $ccompletion->timecompleted);
$this->assertTrue($ccompletion->is_complete());
// Completion criteria for User 2 is supposed to be marked as completed at now().
$result = \core_completion_external::get_activities_completion_status($course->id, $user2->id);
$actual = reset($result['statuses']);
$this->assertEquals(1, $actual['state']);
$this->assertGreaterThanOrEqual($timestarted, $actual['timecompleted']);
// And the whole course is marked as completed at now() for User 2.
$ccompletion = new \completion_completion(['userid' => $user2->id, 'course' => $course->id]);
$this->assertGreaterThanOrEqual($timestarted, $ccompletion->timecompleted);
$this->assertTrue($ccompletion->is_complete());
}
/**
< * Test that enrolment timestart/timecreated are used when duration criteria is marked as completed.
> * Test that enrolment timestart are used when duration criteria is marked as completed.
*/
< public function test_completion_criteria_duration(): void {
> public function test_completion_criteria_duration_timestart(): void {
global $DB;
$timestarted = 1610000000;
< $timecreated = 1620000000;
$durationperiod = DAYSECS;
// Create a course and users.
$course = $this->getDataGenerator()->create_course(['enablecompletion' => 1]);
< $user1 = $this->getDataGenerator()->create_user();
< $user2 = $this->getDataGenerator()->create_user();
< $studentrole = $DB->get_record('role', ['shortname' => 'student']);
<
< // Enrol User 1 with time start = $timestarted.
< $this->getDataGenerator()->enrol_user($user1->id, $course->id, $studentrole->id, 'manual', $timestarted);
<
< // Enrol User 2 with an empty time start, but update the record like it was created at $timecreated.
< $this->getDataGenerator()->enrol_user($user2->id, $course->id, $studentrole->id);
< $DB->set_field('user_enrolments', 'timecreated', $timecreated, ['userid' => $user2->id]);
> $user = $this->getDataGenerator()->create_and_enrol($course, 'student', null, 'manual', $timestarted);
// Set completion criteria.
$criteriadata = (object) [
'id' => $course->id,
'criteria_duration' => 1,
'criteria_duration_days' => $durationperiod,
];
$criterion = new \completion_criteria_duration();
$criterion->update_config($criteriadata);
// Run completion scheduled task.
$task = new \core\task\completion_regular_task();
$this->expectOutputRegex("/Marking complete/");
$task->execute();
// Hopefully, some day MDL-33320 will be fixed and all these sleeps
// and double cron calls in behat and unit tests will be removed.
sleep(1);
$task->execute();
< // The course for User 1 is supposed to be marked as completed at $timestarted + $durationperiod.
< $ccompletion = new \completion_completion(['userid' => $user1->id, 'course' => $course->id]);
> // The course for User is supposed to be marked as completed at $timestarted + $durationperiod.
> $ccompletion = new \completion_completion(['userid' => $user->id, 'course' => $course->id]);
$this->assertEquals($timestarted + $durationperiod, $ccompletion->timecompleted);
$this->assertTrue($ccompletion->is_complete());
> }
< // The course for User 2 is supposed to be marked as completed at $timecreated + $durationperiod.
< $ccompletion = new \completion_completion(['userid' => $user2->id, 'course' => $course->id]);
> /**
> * Test that enrolment timecreated are used when duration criteria is marked as completed.
> */
> public function test_completion_criteria_duration_timecreated(): void {
> global $DB;
>
> $timecreated = 1620000000;
> $durationperiod = DAYSECS;
>
> // Create a course and users.
> $course = $this->getDataGenerator()->create_course(['enablecompletion' => 1]);
>
> // Create and enrol user with an empty time start, but update the record like it was created at $timecreated.
> $user = $this->getDataGenerator()->create_and_enrol($course);
> $DB->set_field('user_enrolments', 'timecreated', $timecreated, ['userid' => $user->id]);
>
> // Set completion criteria.
> $criteriadata = (object) [
> 'id' => $course->id,
> 'criteria_duration' => 1,
> 'criteria_duration_days' => $durationperiod,
> ];
> $criterion = new \completion_criteria_duration();
> $criterion->update_config($criteriadata);
>
> // Run completion scheduled task.
> $task = new \core\task\completion_regular_task();
> $this->expectOutputRegex("/Marking complete/");
> $task->execute();
>
> // Hopefully, some day MDL-33320 will be fixed and all these sleeps
> // and double cron calls in behat and unit tests will be removed.
> sleep(1);
> $task->execute();
>
> // The course for user is supposed to be marked as completed at $timecreated + $durationperiod.
> $ccompletion = new \completion_completion(['userid' => $user->id, 'course' => $course->id]);
$this->assertEquals($timecreated + $durationperiod, $ccompletion->timecompleted);
$this->assertTrue($ccompletion->is_complete());
}
/**
* Test that criteria date is used as a course completion date.
*/
public function test_completion_criteria_date(): void {
global $DB;
$timeend = 1610000000;
// Create a course and enrol a user.
$course = $this->getDataGenerator()->create_course(['enablecompletion' => 1]);
$user = $this->getDataGenerator()->create_user();
$studentrole = $DB->get_record('role', ['shortname' => 'student']);
$this->getDataGenerator()->enrol_user($user->id, $course->id, $studentrole->id);
// Set completion criteria.
$criteriadata = (object) [
'id' => $course->id,
'criteria_date' => 1,
'criteria_date_value' => $timeend,
];
$criterion = new \completion_criteria_date();
$criterion->update_config($criteriadata);
// Run completion scheduled task.
$task = new \core\task\completion_regular_task();
$this->expectOutputRegex("/Marking complete/");
$task->execute();
// Hopefully, some day MDL-33320 will be fixed and all these sleeps
// and double cron calls in behat and unit tests will be removed.
sleep(1);
$task->execute();
// The course is supposed to be marked as completed at $timeend.
$ccompletion = new \completion_completion(['userid' => $user->id, 'course' => $course->id]);
$this->assertEquals($timeend, $ccompletion->timecompleted);
$this->assertTrue($ccompletion->is_complete());
}
/**
* Test that grade timemodified is used when grade criteria is marked as completed.
*/
public function test_completion_criteria_grade(): void {
global $DB;
$timegraded = 1610000000;
// Create a course and enrol a couple of users.
$course = $this->getDataGenerator()->create_course(['enablecompletion' => 1]);
$user1 = $this->getDataGenerator()->create_user();
$user2 = $this->getDataGenerator()->create_user();
$studentrole = $DB->get_record('role', ['shortname' => 'student']);
$this->getDataGenerator()->enrol_user($user1->id, $course->id, $studentrole->id);
$this->getDataGenerator()->enrol_user($user2->id, $course->id, $studentrole->id);
// Set completion criteria.
$criteriadata = (object) [
'id' => $course->id,
'criteria_grade' => 1,
'criteria_grade_value' => 66,
];
$criterion = new \completion_criteria_grade();
$criterion->update_config($criteriadata);
$coursegradeitem = \grade_item::fetch_course_item($course->id);
// Grade User 1 with a passing grade.
$grade1 = new \grade_grade();
$grade1->itemid = $coursegradeitem->id;
$grade1->timemodified = $timegraded;
$grade1->userid = $user1->id;
$grade1->finalgrade = 80;
$grade1->insert();
// Grade User 2 with a non-passing grade.
$grade2 = new \grade_grade();
$grade2->itemid = $coursegradeitem->id;
$grade2->timemodified = $timegraded;
$grade2->userid = $user2->id;
$grade2->finalgrade = 40;
$grade2->insert();
// Run completion scheduled task.
$task = new \core\task\completion_regular_task();
$this->expectOutputRegex("/Marking complete/");
$task->execute();
// Hopefully, some day MDL-33320 will be fixed and all these sleeps
// and double cron calls in behat and unit tests will be removed.
sleep(1);
$task->execute();
// The course for User 1 is supposed to be marked as completed when the user was graded.
$ccompletion = new \completion_completion(['userid' => $user1->id, 'course' => $course->id]);
$this->assertEquals($timegraded, $ccompletion->timecompleted);
$this->assertTrue($ccompletion->is_complete());
// The course for User 2 is supposed to be marked as not completed.
$ccompletion = new \completion_completion(['userid' => $user2->id, 'course' => $course->id]);
$this->assertFalse($ccompletion->is_complete());
}
}