Proyectos de Subversion Moodle

<?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_courseformat;

/**

 * Tests for course

 *

 * @package    core_courseformat

 * @category   test

 * @copyright  2025 Ferran Recio <ferran@moodle.com>

 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 * @covers     \core_courseformat\activityoverviewbase

 */

final class activityoverviewbase_test extends \advanced_testcase {

    #[\Override()]

    public static function setUpBeforeClass(): void {

        global $CFG;

        require_once($CFG->libdir . '/completionlib.php');

        require_once($CFG->dirroot . '/course/format/tests/fixtures/fake_activityoverview.php');

        require_once($CFG->libdir . '/gradelib.php');

        parent::setUpBeforeClass();

    }

    /**

     * Test get_name_overview method.

     *

     * @covers ::get_name_overview

     */

    public function test_get_name_overview(): void {

        $this->resetAfterTest();

        $this->setAdminUser();

        $generator = $this->getDataGenerator();

        $course = $generator->create_course();

        $activity = $this->getDataGenerator()->create_module('assign', ['course' => $course->id, 'name' => 'Test!']);

        $modinfo = get_fast_modinfo($course);

        $cm = $modinfo->get_cm($activity->cmid);

        $overview = new \core_courseformat\fake_activityoverview($cm);

        $result = $overview->get_name_overview();

        $this->assertEquals(get_string('name'), $result->get_name());

        $this->assertEquals('Test!', $result->get_value());

        $this->assertInstanceOf(\core_courseformat\output\local\overview\activityname::class, $result->get_content());

    }

    /**

     * Test get_completion_overview method.

     *

     * @covers ::get_completion_overview

     * @dataProvider provider_get_completion_overview

     * @param int $setcompletion the completion status

     */

    public function test_get_completion_overview(

        int $setcompletion,

    ): void {

        $this->resetAfterTest();

        $this->setAdminUser();

        $generator = $this->getDataGenerator();

        $course = $generator->create_course(['enablecompletion' => 1]);

        $user = $generator->create_user();

        $generator->enrol_user($user->id, $course->id);

        $this->setAdminUser();

        $activity = $this->getDataGenerator()->create_module(

            'assign',

            ['course' => $course->id, 'completion' => \COMPLETION_TRACKING_AUTOMATIC]

        );

        rebuild_course_cache($course->id, true);

        $modinfo = get_fast_modinfo($course);

        $cm = $modinfo->get_cm($activity->cmid);

        $overview = new \core_courseformat\fake_activityoverview($cm);

        $completion = (object) [

            'coursemoduleid' => $cm->id,

            'timemodified' => time(),

            'viewed' => \COMPLETION_NOT_VIEWED,

            'overrideby' => null,

            'id' => 0,

            'completionstate' => $setcompletion,

            'userid' => $user->id,

        ];

        $comletioninfo = new \completion_info($course);

        $comletioninfo->internal_set_data($cm, $completion, true);

        $this->setUser($user);

        $result = $overview->get_completion_overview();

        $this->assertEquals(get_string('completion_status', 'completion'), $result->get_name());

        $this->assertEquals($setcompletion, $result->get_value());

        $this->assertInstanceOf(\core_courseformat\output\local\content\cm\completion::class, $result->get_content());

    }

    /**

     * Data provider for test_get_completion_overview.

     *

     * @return array the testing scenarios

     */

    public static function provider_get_completion_overview(): array {

        return [

            'complet' => [

                'setcompletion' => \COMPLETION_COMPLETE,

            ],

            'incomplete' => [

                'setcompletion' => \COMPLETION_INCOMPLETE,

            ],

            'complete pass' => [

                'setcompletion' => \COMPLETION_COMPLETE_PASS,

            ],

            'complete fail' => [

                'setcompletion' => \COMPLETION_COMPLETE_FAIL,

            ],

        ];

    }

    /**

     * Test get_completion_overview method on an activity with no completion.

     *

     * @covers ::get_completion_overview

     */

    public function test_get_completion_overview_no_completion(): void {

        $this->resetAfterTest();

        $this->setAdminUser();

        $generator = $this->getDataGenerator();

        $course = $generator->create_course(['enablecompletion' => 1]);

        $user = $generator->create_user();

        $generator->enrol_user($user->id, $course->id);

        $this->setAdminUser();

        $activity = $this->getDataGenerator()->create_module(

            'assign',

            ['course' => $course->id]

        );

        rebuild_course_cache($course->id, true);

        $modinfo = get_fast_modinfo($course);

        $cm = $modinfo->get_cm($activity->cmid);

        $overview = new \core_courseformat\fake_activityoverview($cm);

        $this->setUser($user);

        $result = $overview->get_completion_overview();

        $this->assertEquals(get_string('completion_status', 'completion'), $result->get_name());

        $this->assertEquals(null, $result->get_value());

        $this->assertEquals('-', $result->get_content());

    }

    /**

     * Test get_grades_overviews method.

     *

     * @covers ::get_grades_overviews

     */

    public function test_get_grades_overviews(): void {

        $this->resetAfterTest();

        $this->setAdminUser();

        $generator = $this->getDataGenerator();

        $course = $this->getDataGenerator()->create_course();

        $teacher = $this->getDataGenerator()->create_and_enrol($course, 'teacher');

        $student = $this->getDataGenerator()->create_and_enrol($course, 'student');

        // Create some modules.

        $assign = $this->getDataGenerator()->create_module(

            'assign',

            ['course' => $course->id]

        );

        $workshop = $this->getDataGenerator()->create_module(

            'workshop',

            ['course' => $course->id],

            ['grade' => 100.0],

        );

        $page = $this->getDataGenerator()->create_module(

            'page',

            ['course' => $course->id]

        );

        // Assignments have one grade item.

        $assignitems = \grade_item::fetch_all([

            'itemtype' => 'mod',

            'itemmodule' => 'assign',

            'iteminstance' => (int) $assign->id,

            'courseid' => $course->id,

        ]);

        $gradegrade = new \grade_grade();

        $gradegrade->itemid = reset($assignitems)->id;

        $gradegrade->userid = (int) $student->id;

        $gradegrade->rawgrade = 88;

        $gradegrade->finalgrade = 88;

        $gradegrade->insert();

        // Workshops have two grade items.

        $workshopitems = array_values(

            \grade_item::fetch_all([

                'itemtype' => 'mod',

                'itemmodule' => 'workshop',

                'iteminstance' => (int) $workshop->id,

                'courseid' => $course->id,

                ['grade' => 100.0],

            ])

        );

        $gradegrade = new \grade_grade();

        $gradegrade->itemid = reset($workshopitems)->id;

        $gradegrade->userid = (int) $student->id;

        $gradegrade->rawgrade = 77;

        $gradegrade->finalgrade = 77;

        $gradegrade->insert();

        // Validate student grades.

        $this->setUser($student);

        $modinfo = get_fast_modinfo($course);

        // Validate assign gradeitems.

        $cm = $modinfo->get_cm($assign->cmid);

        $overview = new \core_courseformat\fake_activityoverview($cm);

        $result = $overview->get_grades_overviews();

        $this->assertCount(1, $result);

        $this->assertEquals(get_string('gradenoun'), $result[0]->get_name());

        $this->assertEquals(88, $result[0]->get_value());

        $this->assertEquals('88.00', $result[0]->get_content());

        // Validate workshop gradeitems (having two grade, they should return an empty array).

        $cm = $modinfo->get_cm($workshop->cmid);

        $overview = new \core_courseformat\fake_activityoverview($cm);

        $result = $overview->get_grades_overviews();

        $this->assertEmpty($result);

        // Validate page has no gradeitems.

        $cm = $modinfo->get_cm($page->cmid);

        $overview = new \core_courseformat\fake_activityoverview($cm);

        $result = $overview->get_grades_overviews();

        $this->assertEmpty($result);

        // Validate teacher does not has grade overiviews items.

        $this->setUser($teacher);

        $modinfo = get_fast_modinfo($course);

        // Validate assign gradeitems.

        $cm = $modinfo->get_cm($assign->cmid);

        $overview = new \core_courseformat\fake_activityoverview($cm);

        $result = $overview->get_grades_overviews();

        $this->assertEmpty($result);;

        // Validate workshop gradeitems (having two grade, they should return an empty array).

        $cm = $modinfo->get_cm($workshop->cmid);

        $overview = new \core_courseformat\fake_activityoverview($cm);

        $result = $overview->get_grades_overviews();

        $this->assertEmpty($result);

        // Validate page has no gradeitems.

        $cm = $modinfo->get_cm($page->cmid);

        $overview = new \core_courseformat\fake_activityoverview($cm);

        $result = $overview->get_grades_overviews();

        $this->assertEmpty($result);

    }

    /**

     * Test get_grades_overviews when the grade item is hidden.

     *

     * @covers ::get_grades_overviews

     */

    /**

     * Test get_grades_overviews method.

     *

     * @covers ::get_grades_overviews

     */

    public function test_get_grades_overviews_hidden(): void {

        $this->resetAfterTest();

        $this->setAdminUser();

        $generator = $this->getDataGenerator();

        $course = $this->getDataGenerator()->create_course();

        $student = $this->getDataGenerator()->create_and_enrol($course, 'student');

        // Create some modules.

        $assign = $this->getDataGenerator()->create_module(

            'assign',

            ['course' => $course->id]

        );

        // Assignments have one grade item.

        $assignitems = \grade_item::fetch_all([

            'itemtype' => 'mod',

            'itemmodule' => 'assign',

            'iteminstance' => (int) $assign->id,

            'courseid' => $course->id,

        ]);

        $gradeitem = reset($assignitems);

        $gradegrade = new \grade_grade();

        $gradegrade->itemid = $gradeitem->id;

        $gradegrade->userid = (int) $student->id;

        $gradegrade->rawgrade = 88;

        $gradegrade->finalgrade = 88;

        $gradegrade->insert();

        // Hide some grades.

        $gradeitem->set_hidden(1, true);

        // Validate student grades.

        $this->setUser($student);

        $modinfo = get_fast_modinfo($course);

        // Validate assign gradeitems.

        $cm = $modinfo->get_cm($assign->cmid);

        $overview = new \core_courseformat\fake_activityoverview($cm);

        $result = $overview->get_grades_overviews();

        $this->assertCount(1, $result);

        $this->assertEquals(get_string('gradenoun'), $result[0]->get_name());

        $this->assertEquals('-', $result[0]->get_value());

        $this->assertEquals('-', $result[0]->get_content());

    }

}