Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.11.x will end 14 Nov 2022 (12 months plus 6 months extension).
  • Bug fixes for security issues in 3.11.x will end 13 Nov 2023 (18 months plus 12 months extension).
  • PHP version: minimum PHP 7.3.0 Note: minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is 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/>.

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() {
        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() {
        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 * Tests that the course progress returns null when the course does not support it. > * */ > * @covers \core_completion\progress::get_course_progress_percentage. public function test_course_progress_course_not_using_completion() { > */ // Create a course that does not use completion. > public function test_course_progress_percentage_completion_state() { $course = $this->getDataGenerator()->create_course(); > global $DB, $CFG; > // Check that the result was null. > require_once("{$CFG->dirroot}/completion/criteria/completion_criteria_activity.php"); $this->assertNull(\core_completion\progress::get_course_progress_percentage($course)); > } > // Add a course that supports completion. > $course = $this->getDataGenerator()->create_course(['enablecompletion' => 1]); /** > * Tests that the course progress returns null when there are no activities that support it. > // Enrol a user in the course. */ > $teacher = $this->getDataGenerator()->create_user(); public function test_course_progress_no_activities_using_completion() { > $user = $this->getDataGenerator()->create_user(); // Create a course that does support completion. > $studentrole = $DB->get_record('role', ['shortname' => 'student']); $course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1)); > $teacherrole = $DB->get_record('role', array('shortname' => 'editingteacher')); > $this->getDataGenerator()->enrol_user($user->id, $course->id, $studentrole->id); // Add an activity that does *not* support completion. > $this->getDataGenerator()->enrol_user($teacher->id, $course->id, $teacherrole->id); $this->getDataGenerator()->create_module('assign', array('course' => $course->id)); > > // Add three activities that use completion. // Check that the result was null. > /** @var \mod_assign_generator $assigngenerator */ $this->assertNull(\core_completion\progress::get_course_progress_percentage($course)); > $assigngenerator = $this->getDataGenerator()->get_plugin_generator('mod_assign'); } > $assign['passgragepassed'] = $assigngenerator->create_instance([ > 'course' => $course->id, /** > 'completion' => COMPLETION_ENABLED, * Tests that the course progress returns null for a not tracked for completion user in a course. > 'completionusegrade' => 1, */ > 'gradepass' => 50, public function test_course_progress_not_tracked_user() { > 'completionpassgrade' => 1 global $DB; > ]); > // Add a course that supports completion. > $assign['passgragefailed'] = $assigngenerator->create_instance([ $course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1)); > 'course' => $course->id, > 'completion' => COMPLETION_ENABLED, // Enrol a user in the course. > 'completionusegrade' => 1, $user = $this->getDataGenerator()->create_user(); > 'gradepass' => 50, $studentrole = $DB->get_record('role', array('shortname' => 'student')); > 'completionpassgrade' => 1 > ]); $this->getDataGenerator()->enrol_user($user->id, $course->id, $studentrole->id); > > $assign['passgragenotused'] = $assigngenerator->create_instance([ // Now, mark the course as completed. > 'course' => $course->id, $ccompletion = new completion_completion(array('course' => $course->id, 'userid' => $user->id)); > 'completion' => COMPLETION_ENABLED, $ccompletion->mark_complete(); > 'completionusegrade' => 1, > 'gradepass' => 50, // The course completion should return 100. > ]); $this->assertEquals('100', \core_completion\progress::get_course_progress_percentage($course, $user->id)); > > $assign['nograde'] = $assigngenerator->create_instance([ // Now make the user's role to be not tracked for completion. > 'course' => $course->id, unassign_capability('moodle/course:isincompletionreports', $studentrole->id); > 'completion' => COMPLETION_ENABLED, > ]); // Check that the result is null now. > $this->assertNull(\core_completion\progress::get_course_progress_percentage($course, $user->id)); > $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)); > } > > /**