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/>.

/**
 * Course related unit tests
 *
 * @package    core_course
 * @copyright  2014 Marina Glancy
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

defined('MOODLE_INTERNAL') || die();

global $CFG;
require_once($CFG->dirroot . '/course/lib.php');
require_once($CFG->dirroot . '/course/tests/fixtures/format_theunittest.php');

class core_course_courseformat_testcase extends advanced_testcase {
> public function test_available_hook() { > /** global $DB; > * Tests the save and load functionality. $this->resetAfterTest(); > * > * @author Jason den Dulk // Generate a course with two sections (0 and 1) and two modules. Course format is set to 'theunittest'. > */ $generator = $this->getDataGenerator(); > public function test_courseformat_saveandload() { $course1 = $generator->create_course(array('format' => 'theunittest')); > $this->resetAfterTest(); $this->assertEquals('theunittest', $course1->format); > course_create_sections_if_missing($course1, array(0, 1)); > $courseformatoptiondata = (object) [ $assign0 = $generator->create_module('assign', array('course' => $course1, 'section' => 0)); > "hideoddsections" => 1, $assign1 = $generator->create_module('assign', array('course' => $course1, 'section' => 1)); > 'summary_editor' => [ $assign2 = $generator->create_module('assign', array('course' => $course1, 'section' => 0, 'visible' => 0)); > 'text' => '<p>Somewhere over the rainbow</p><p>The <b>quick</b> brown fox jumpos over the lazy dog.</p>', > 'format' => 1 // Create a courseoverview role based on the student role. > ] $roleattr = array('name' => 'courseoverview', 'shortname' => 'courseoverview', 'archetype' => 'student'); > ]; $generator->create_role($roleattr); > $generator = $this->getDataGenerator(); > $course1 = $generator->create_course(array('format' => 'theunittest')); // Create user student, editingteacher, teacher and courseoverview. > $this->assertEquals('theunittest', $course1->format); $student = $generator->create_user(); > course_create_sections_if_missing($course1, array(0, 1)); $teacher = $generator->create_user(); > $editingteacher = $generator->create_user(); > $courseformat = course_get_format($course1); $courseoverviewuser = $generator->create_user(); > $courseformat->update_course_format_options($courseformatoptiondata); > // Enrol users into their roles. > $savedcourseformatoptiondata = $courseformat->get_format_options(); $roleids = $DB->get_records_menu('role', null, '', 'shortname, id'); > $generator->enrol_user($student->id, $course1->id, $roleids['student']); > $this->assertEqualsCanonicalizing($courseformatoptiondata, (object) $savedcourseformatoptiondata); $generator->enrol_user($teacher->id, $course1->id, $roleids['teacher']); > } $generator->enrol_user($editingteacher->id, $course1->id, $roleids['editingteacher']); >
$generator->enrol_user($courseoverviewuser->id, $course1->id, $roleids['courseoverview']); // Remove the ignoreavailabilityrestrictions from the teacher role. role_change_permission($roleids['teacher'], context_system::instance(0), 'moodle/course:ignoreavailabilityrestrictions', CAP_PREVENT); // Allow the courseoverview role to ingore available restriction. role_change_permission($roleids['courseoverview'], context_system::instance(0), 'moodle/course:ignoreavailabilityrestrictions', CAP_ALLOW); // Make sure that initially both sections and both modules are available and visible for a student. $modinfostudent = get_fast_modinfo($course1, $student->id); $this->assertTrue($modinfostudent->get_section_info(1)->available); $this->assertTrue($modinfostudent->get_cm($assign0->cmid)->available); $this->assertTrue($modinfostudent->get_cm($assign0->cmid)->uservisible); $this->assertTrue($modinfostudent->get_cm($assign1->cmid)->available); $this->assertTrue($modinfostudent->get_cm($assign1->cmid)->uservisible); $this->assertFalse($modinfostudent->get_cm($assign2->cmid)->uservisible); // Set 'hideoddsections' for the course to 1. // Section1 and assign1 will be unavailable, uservisible will be false for student and true for teacher. $data = (object)array('id' => $course1->id, 'hideoddsections' => 1); course_get_format($course1)->update_course_format_options($data); $modinfostudent = get_fast_modinfo($course1, $student->id); $this->assertFalse($modinfostudent->get_section_info(1)->available); $this->assertEmpty($modinfostudent->get_section_info(1)->availableinfo); $this->assertFalse($modinfostudent->get_section_info(1)->uservisible); $this->assertTrue($modinfostudent->get_cm($assign0->cmid)->available); $this->assertTrue($modinfostudent->get_cm($assign0->cmid)->uservisible); $this->assertFalse($modinfostudent->get_cm($assign1->cmid)->available); $this->assertFalse($modinfostudent->get_cm($assign1->cmid)->uservisible); $this->assertFalse($modinfostudent->get_cm($assign2->cmid)->uservisible); $modinfoteacher = get_fast_modinfo($course1, $teacher->id); $this->assertFalse($modinfoteacher->get_section_info(1)->available); $this->assertEmpty($modinfoteacher->get_section_info(1)->availableinfo); $this->assertFalse($modinfoteacher->get_section_info(1)->uservisible); $this->assertTrue($modinfoteacher->get_cm($assign0->cmid)->available); $this->assertTrue($modinfoteacher->get_cm($assign0->cmid)->uservisible); $this->assertFalse($modinfoteacher->get_cm($assign1->cmid)->available); $this->assertFalse($modinfoteacher->get_cm($assign1->cmid)->uservisible); $this->assertTrue($modinfoteacher->get_cm($assign2->cmid)->available); $this->assertTrue($modinfoteacher->get_cm($assign2->cmid)->uservisible); $modinfoteacher = get_fast_modinfo($course1, $editingteacher->id); $this->assertFalse($modinfoteacher->get_section_info(1)->available); $this->assertEmpty($modinfoteacher->get_section_info(1)->availableinfo); $this->assertTrue($modinfoteacher->get_section_info(1)->uservisible); $this->assertTrue($modinfoteacher->get_cm($assign0->cmid)->available); $this->assertTrue($modinfoteacher->get_cm($assign0->cmid)->uservisible); $this->assertFalse($modinfoteacher->get_cm($assign1->cmid)->available); $this->assertTrue($modinfoteacher->get_cm($assign1->cmid)->uservisible); $this->assertTrue($modinfoteacher->get_cm($assign2->cmid)->uservisible); $modinfocourseoverview = get_fast_modinfo($course1, $courseoverviewuser->id); $this->assertFalse($modinfocourseoverview->get_section_info(1)->available); $this->assertEmpty($modinfocourseoverview->get_section_info(1)->availableinfo); $this->assertTrue($modinfocourseoverview->get_section_info(1)->uservisible); $this->assertTrue($modinfocourseoverview->get_cm($assign0->cmid)->available); $this->assertTrue($modinfocourseoverview->get_cm($assign0->cmid)->uservisible); $this->assertFalse($modinfocourseoverview->get_cm($assign1->cmid)->available); $this->assertTrue($modinfocourseoverview->get_cm($assign1->cmid)->uservisible); $this->assertFalse($modinfocourseoverview->get_cm($assign2->cmid)->uservisible); // Set 'hideoddsections' for the course to 2. // Section1 and assign1 will be unavailable, uservisible will be false for student and true for teacher. // Property availableinfo will be not empty. $data = (object)array('id' => $course1->id, 'hideoddsections' => 2); course_get_format($course1)->update_course_format_options($data); $modinfostudent = get_fast_modinfo($course1, $student->id); $this->assertFalse($modinfostudent->get_section_info(1)->available); $this->assertNotEmpty($modinfostudent->get_section_info(1)->availableinfo); $this->assertFalse($modinfostudent->get_section_info(1)->uservisible); $this->assertTrue($modinfostudent->get_cm($assign0->cmid)->available); $this->assertTrue($modinfostudent->get_cm($assign0->cmid)->uservisible); $this->assertFalse($modinfostudent->get_cm($assign1->cmid)->available); $this->assertFalse($modinfostudent->get_cm($assign1->cmid)->uservisible); $modinfoteacher = get_fast_modinfo($course1, $editingteacher->id); $this->assertFalse($modinfoteacher->get_section_info(1)->available); $this->assertNotEmpty($modinfoteacher->get_section_info(1)->availableinfo); $this->assertTrue($modinfoteacher->get_section_info(1)->uservisible); $this->assertTrue($modinfoteacher->get_cm($assign0->cmid)->available); $this->assertTrue($modinfoteacher->get_cm($assign0->cmid)->uservisible); $this->assertFalse($modinfoteacher->get_cm($assign1->cmid)->available); $this->assertTrue($modinfoteacher->get_cm($assign1->cmid)->uservisible); } /** * Test for supports_news() with a course format plugin that doesn't define 'news_items' in default blocks. */ public function test_supports_news() { $this->resetAfterTest(); $format = course_get_format((object)['format' => 'testformat']); $this->assertFalse($format->supports_news()); } /** * Test for supports_news() for old course format plugins that defines 'news_items' in default blocks. */ public function test_supports_news_legacy() { $this->resetAfterTest(); $format = course_get_format((object)['format' => 'testlegacy']); $this->assertTrue($format->supports_news()); } /** * Test for get_view_url() to ensure that the url is only given for the correct cases */ public function test_get_view_url() { global $CFG; $this->resetAfterTest(); $linkcoursesections = $CFG->linkcoursesections; // Generate a course with two sections (0 and 1) and two modules. Course format is set to 'testformat'. // This will allow us to test the default implementation of get_view_url. $generator = $this->getDataGenerator(); $course1 = $generator->create_course(array('format' => 'testformat')); course_create_sections_if_missing($course1, array(0, 1)); $data = (object)['id' => $course1->id]; $format = course_get_format($course1); $format->update_course_format_options($data); // In page. $CFG->linkcoursesections = 0; $this->assertNotEmpty($format->get_view_url(null)); $this->assertNotEmpty($format->get_view_url(0)); $this->assertNotEmpty($format->get_view_url(1)); $CFG->linkcoursesections = 1; $this->assertNotEmpty($format->get_view_url(null)); $this->assertNotEmpty($format->get_view_url(0)); $this->assertNotEmpty($format->get_view_url(1)); // Navigation. $CFG->linkcoursesections = 0; $this->assertNull($format->get_view_url(1, ['navigation' => 1])); $this->assertNull($format->get_view_url(0, ['navigation' => 1])); $CFG->linkcoursesections = 1; $this->assertNotEmpty($format->get_view_url(1, ['navigation' => 1])); $this->assertNotEmpty($format->get_view_url(0, ['navigation' => 1])); } } /** * Class format_testformat. * * A test class that simulates a course format that doesn't define 'news_items' in default blocks. * * @copyright 2016 Jun Pataleta <jun@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class format_testformat extends format_base { /** * Returns the list of blocks to be automatically added for the newly created course. * * @return array */ public function get_default_blocks() { return [ BLOCK_POS_RIGHT => [], BLOCK_POS_LEFT => [] ]; } } /** * Class format_testlegacy. * * A test class that simulates old course formats that define 'news_items' in default blocks. * * @copyright 2016 Jun Pataleta <jun@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class format_testlegacy extends format_base { /** * Returns the list of blocks to be automatically added for the newly created course. * * @return array */ public function get_default_blocks() { return [ BLOCK_POS_RIGHT => ['news_items'], BLOCK_POS_LEFT => [] ]; } }