Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.2.x will end 22 April 2024 (12 months).
  • Bug fixes for security issues in 4.2.x will end 7 October 2024 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.1.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 mod_quiz;

< use quiz; < < defined('MOODLE_INTERNAL') || die(); < < global $CFG; < require_once($CFG->dirroot . '/mod/quiz/attemptlib.php'); <
/** * Unit tests for quiz events. * * @package mod_quiz * @category test * @copyright 2013 Adrian Greeve * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class structure_test extends \advanced_testcase { /** * Create a course with an empty quiz. * @return array with three elements quiz, cm and course. */ protected function prepare_quiz_data() { $this->resetAfterTest(true); // Create a course. $course = $this->getDataGenerator()->create_course(); // Make a quiz. $quizgenerator = $this->getDataGenerator()->get_plugin_generator('mod_quiz');
< $quiz = $quizgenerator->create_instance(array('course' => $course->id, 'questionsperpage' => 0, < 'grade' => 100.0, 'sumgrades' => 2, 'preferredbehaviour' => 'immediatefeedback'));
> $quiz = $quizgenerator->create_instance(['course' => $course->id, 'questionsperpage' => 0, > 'grade' => 100.0, 'sumgrades' => 2, 'preferredbehaviour' => 'immediatefeedback']);
$cm = get_coursemodule_from_instance('quiz', $quiz->id, $course->id);
< return array($quiz, $cm, $course);
> return [$quiz, $cm, $course];
} /** * Creat a test quiz. * * $layout looks like this: * $layout = array( * 'Heading 1' * array('TF1', 1, 'truefalse'), * 'Heading 2*' * array('TF2', 2, 'truefalse'), * ); * That is, either a string, which represents a section heading, * or an array that represents a question. * * If the section heading ends with *, that section is shuffled. * * The elements in the question array are name, page number, and question type. * * @param array $layout as above.
< * @return quiz the created quiz.
> * @return quiz_settings the created quiz.
*/ protected function create_test_quiz($layout) { list($quiz, $cm, $course) = $this->prepare_quiz_data(); $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question'); $cat = $questiongenerator->create_question_category();
< $headings = array();
> $headings = [];
$slot = 1; $lastpage = 0; foreach ($layout as $item) { if (is_string($item)) { if (isset($headings[$lastpage + 1])) { throw new \coding_exception('Sections cannot be empty.'); } $headings[$lastpage + 1] = $item; } else { list($name, $page, $qtype) = $item; if ($page < 1 || !($page == $lastpage + 1 || (!isset($headings[$lastpage + 1]) && $page == $lastpage))) { throw new \coding_exception('Page numbers wrong.'); } $q = $questiongenerator->create_question($qtype, null,
< array('name' => $name, 'category' => $cat->id));
> ['name' => $name, 'category' => $cat->id]);
quiz_add_quiz_question($q->id, $quiz, $page); $lastpage = $page; } }
< $quizobj = new quiz($quiz, $cm, $course);
> $quizobj = new quiz_settings($quiz, $cm, $course);
$structure = structure::create_for_quiz($quizobj); if (isset($headings[1])) { list($heading, $shuffle) = $this->parse_section_name($headings[1]); $sections = $structure->get_sections(); $firstsection = reset($sections); $structure->set_section_heading($firstsection->id, $heading); $structure->set_section_shuffle($firstsection->id, $shuffle); unset($headings[1]); } foreach ($headings as $startpage => $heading) { list($heading, $shuffle) = $this->parse_section_name($heading); $id = $structure->add_section_heading($startpage, $heading); $structure->set_section_shuffle($id, $shuffle); } return $quizobj; } /** * Verify that the given layout matches that expected. * @param array $expectedlayout as for $layout in {@link create_test_quiz()}.
< * @param \mod_quiz\structure $structure the structure to test.
> * @param structure $structure the structure to test.
*/ protected function assert_quiz_layout($expectedlayout, structure $structure) { $sections = $structure->get_sections(); $slot = 1; foreach ($expectedlayout as $item) { if (is_string($item)) { list($heading, $shuffle) = $this->parse_section_name($item); $section = array_shift($sections); if ($slot > 1 && $section->heading == '' && $section->firstslot == 1) { // The array $expectedlayout did not contain default first quiz section, so skip over it. $section = array_shift($sections); } $this->assertEquals($slot, $section->firstslot); $this->assertEquals($heading, $section->heading); $this->assertEquals($shuffle, $section->shufflequestions); } else { list($name, $page, $qtype) = $item; $question = $structure->get_question_in_slot($slot); $this->assertEquals($name, $question->name); $this->assertEquals($slot, $question->slot, 'Slot number wrong for question ' . $name); $this->assertEquals($qtype, $question->qtype, 'Question type wrong for question ' . $name); $this->assertEquals($page, $question->page, 'Page number wrong for question ' . $name); $slot += 1; } } if ($slot - 1 != count($structure->get_slots())) { $this->fail('The quiz contains more slots than expected.'); } if (!empty($sections)) { $section = array_shift($sections); if ($section->heading != '' || $section->firstslot != 1) { $this->fail('Unexpected section (' . $section->heading .') found in the quiz.'); } } } /** * Parse the section name, optionally followed by a * to mean shuffle, as * used by create_test_quiz as assert_quiz_layout. * @param string $heading the heading. * @return array with two elements, the heading and the shuffle setting. */ protected function parse_section_name($heading) { if (substr($heading, -1) == '*') {
< return array(substr($heading, 0, -1), 1);
> return [substr($heading, 0, -1), 1];
} else {
< return array($heading, 0);
> return [$heading, 0];
} } public function test_get_quiz_slots() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); // Are the correct slots returned? $slots = $structure->get_slots(); $this->assertCount(2, $structure->get_slots()); } public function test_quiz_has_one_section_by_default() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $sections = $structure->get_sections(); $this->assertCount(1, $sections); $section = array_shift($sections); $this->assertEquals(1, $section->firstslot); $this->assertEquals('', $section->heading); $this->assertEquals(0, $section->shufflequestions); } public function test_get_sections() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1*',
< array('TF1', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'],
'Heading 2*',
< array('TF2', 2, 'truefalse'), < ));
> ['TF2', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $sections = $structure->get_sections(); $this->assertCount(2, $sections); $section = array_shift($sections); $this->assertEquals(1, $section->firstslot); $this->assertEquals('Heading 1', $section->heading); $this->assertEquals(1, $section->shufflequestions); $section = array_shift($sections); $this->assertEquals(2, $section->firstslot); $this->assertEquals('Heading 2', $section->heading); $this->assertEquals(1, $section->shufflequestions); } public function test_remove_section_heading() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'), < ));
> ['TF2', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $sections = $structure->get_sections(); $section = end($sections); $structure->remove_section_heading($section->id); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < ), $structure);
> ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ], $structure);
} public function test_cannot_remove_first_section() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'), < ));
> ['TF1', 1, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $sections = $structure->get_sections(); $section = reset($sections); $this->expectException(\coding_exception::class); $structure->remove_section_heading($section->id); } public function test_move_slot_to_the_same_place_does_nothing() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < array('TF3', 2, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(2)->slotid; $idmoveafter = $structure->get_question_in_slot(1)->slotid; $structure->move_slot($idtomove, $idmoveafter, '1'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < array('TF3', 2, 'truefalse'), < ), $structure);
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ['TF3', 2, 'truefalse'], > ], $structure);
} public function test_move_slot_end_of_one_page_to_start_of_next() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < array('TF3', 2, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(2)->slotid; $idmoveafter = $structure->get_question_in_slot(2)->slotid; $structure->move_slot($idtomove, $idmoveafter, '2'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < array('TF3', 2, 'truefalse'), < ), $structure);
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ['TF3', 2, 'truefalse'], > ], $structure);
} public function test_move_last_slot_to_previous_page_emptying_the_last_page() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(2)->slotid; $idmoveafter = $structure->get_question_in_slot(1)->slotid; $structure->move_slot($idtomove, $idmoveafter, '1'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < ), $structure);
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ], $structure);
} public function test_end_of_one_section_to_start_of_next() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'),
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'],
'Heading',
< array('TF3', 2, 'truefalse'), < ));
> ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(2)->slotid; $idmoveafter = $structure->get_question_in_slot(2)->slotid; $structure->move_slot($idtomove, $idmoveafter, '2'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'),
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'],
'Heading',
< array('TF2', 2, 'truefalse'), < array('TF3', 2, 'truefalse'), < ), $structure);
> ['TF2', 2, 'truefalse'], > ['TF3', 2, 'truefalse'], > ], $structure);
} public function test_start_of_one_section_to_end_of_previous() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'),
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'],
'Heading',
< array('TF2', 2, 'truefalse'), < array('TF3', 2, 'truefalse'), < ));
> ['TF2', 2, 'truefalse'], > ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(2)->slotid; $idmoveafter = $structure->get_question_in_slot(1)->slotid; $structure->move_slot($idtomove, $idmoveafter, '1'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'),
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'],
'Heading',
< array('TF3', 2, 'truefalse'), < ), $structure);
> ['TF3', 2, 'truefalse'], > ], $structure);
} public function test_move_slot_on_same_page() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < array('TF3', 1, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ['TF3', 1, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(2)->slotid; $idmoveafter = $structure->get_question_in_slot(3)->slotid; $structure->move_slot($idtomove, $idmoveafter, '1'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < array('TF3', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < ), $structure);
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ['TF3', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ], $structure);
} public function test_move_slot_up_onto_previous_page() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < array('TF3', 2, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(3)->slotid; $idmoveafter = $structure->get_question_in_slot(1)->slotid; $structure->move_slot($idtomove, $idmoveafter, '1'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < array('TF3', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < ), $structure);
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ['TF3', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ], $structure);
} public function test_move_slot_emptying_a_page_renumbers_pages() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < array('TF3', 3, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ['TF3', 3, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(2)->slotid; $idmoveafter = $structure->get_question_in_slot(3)->slotid; $structure->move_slot($idtomove, $idmoveafter, '3'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < array('TF3', 2, 'truefalse'), < array('TF2', 2, 'truefalse'), < ), $structure);
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ['TF3', 2, 'truefalse'], > ['TF2', 2, 'truefalse'], > ], $structure);
} public function test_move_slot_too_small_page_number_detected() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < array('TF3', 3, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ['TF3', 3, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(3)->slotid; $idmoveafter = $structure->get_question_in_slot(2)->slotid; $this->expectException(\coding_exception::class); $structure->move_slot($idtomove, $idmoveafter, '1'); } public function test_move_slot_too_large_page_number_detected() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < array('TF3', 3, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ['TF3', 3, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(1)->slotid; $idmoveafter = $structure->get_question_in_slot(2)->slotid; $this->expectException(\coding_exception::class); $structure->move_slot($idtomove, $idmoveafter, '4'); } public function test_move_slot_within_section() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'],
'Heading 2',
< array('TF3', 2, 'truefalse'), < ));
> ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(1)->slotid; $idmoveafter = $structure->get_question_in_slot(2)->slotid; $structure->move_slot($idtomove, $idmoveafter, '1'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF2', 1, 'truefalse'), < array('TF1', 1, 'truefalse'),
> ['TF2', 1, 'truefalse'], > ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF3', 2, 'truefalse'), < ), $structure);
> ['TF3', 2, 'truefalse'], > ], $structure);
} public function test_move_slot_to_new_section() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'],
'Heading 2',
< array('TF3', 2, 'truefalse'), < ));
> ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(2)->slotid; $idmoveafter = $structure->get_question_in_slot(3)->slotid; $structure->move_slot($idtomove, $idmoveafter, '2'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF1', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF3', 2, 'truefalse'), < array('TF2', 2, 'truefalse'), < ), $structure);
> ['TF3', 2, 'truefalse'], > ['TF2', 2, 'truefalse'], > ], $structure);
} public function test_move_slot_to_start() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'), < array('TF3', 2, 'truefalse'), < ));
> ['TF2', 2, 'truefalse'], > ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(3)->slotid; $structure->move_slot($idtomove, 0, '1'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF3', 1, 'truefalse'), < array('TF1', 1, 'truefalse'),
> ['TF3', 1, 'truefalse'], > ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'), < ), $structure);
> ['TF2', 2, 'truefalse'], > ], $structure);
} public function test_move_slot_down_to_start_of_second_section() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'],
'Heading 2',
< array('TF3', 2, 'truefalse'), < ));
> ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(2)->slotid; $idmoveafter = $structure->get_question_in_slot(2)->slotid; $structure->move_slot($idtomove, $idmoveafter, '2'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF1', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'), < array('TF3', 2, 'truefalse'), < ), $structure);
> ['TF2', 2, 'truefalse'], > ['TF3', 2, 'truefalse'], > ], $structure);
} public function test_move_first_slot_down_to_start_of_page_2() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < ));
> ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(1)->slotid; $structure->move_slot($idtomove, 0, '2'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < ), $structure);
> ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ], $structure);
} public function test_move_first_slot_to_same_place_on_page_1() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < ));
> ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(1)->slotid; $structure->move_slot($idtomove, 0, '1'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < ), $structure);
> ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ], $structure);
} public function test_move_first_slot_to_before_page_1() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < ));
> ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(1)->slotid; $structure->move_slot($idtomove, 0, ''); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < ), $structure);
> ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ], $structure);
} public function test_move_slot_up_to_start_of_second_section() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'),
> ['TF2', 2, 'truefalse'],
'Heading 3',
< array('TF3', 3, 'truefalse'), < array('TF4', 3, 'truefalse'), < ));
> ['TF3', 3, 'truefalse'], > ['TF4', 3, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(3)->slotid; $idmoveafter = $structure->get_question_in_slot(1)->slotid; $structure->move_slot($idtomove, $idmoveafter, '2'); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF1', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF3', 2, 'truefalse'), < array('TF2', 2, 'truefalse'),
> ['TF3', 2, 'truefalse'], > ['TF2', 2, 'truefalse'],
'Heading 3',
< array('TF4', 3, 'truefalse'), < ), $structure);
> ['TF4', 3, 'truefalse'], > ], $structure);
} public function test_move_slot_does_not_violate_heading_unique_key() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'),
> ['TF2', 2, 'truefalse'],
'Heading 3',
< array('TF3', 3, 'truefalse'), < array('TF4', 3, 'truefalse'), < ));
> ['TF3', 3, 'truefalse'], > ['TF4', 3, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $idtomove = $structure->get_question_in_slot(4)->slotid; $idmoveafter = $structure->get_question_in_slot(1)->slotid; $structure->move_slot($idtomove, $idmoveafter, 1); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF4', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'], > ['TF4', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'),
> ['TF2', 2, 'truefalse'],
'Heading 3',
< array('TF3', 3, 'truefalse'), < ), $structure);
> ['TF3', 3, 'truefalse'], > ], $structure);
} public function test_quiz_remove_slot() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'),
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'],
'Heading 2',
< array('TF3', 2, 'truefalse'), < ));
> ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $structure->remove_slot(2); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'),
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF3', 2, 'truefalse'), < ), $structure);
> ['TF3', 2, 'truefalse'], > ], $structure);
} public function test_quiz_removing_a_random_question_deletes_the_question() { global $DB; $this->resetAfterTest(true); $this->setAdminUser();
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ]);
$questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question'); $cat = $questiongenerator->create_question_category(); quiz_add_random_questions($quizobj->get_quiz(), 1, $cat->id, 1, false); $structure = structure::create_for_quiz($quizobj);
< $randomq = $DB->get_record('question', array('qtype' => 'random'));
> $sql = 'SELECT qsr.* > FROM {question_set_references} qsr > JOIN {quiz_slots} qs ON qs.id = qsr.itemid > WHERE qs.quizid = ? > AND qsr.component = ? > AND qsr.questionarea = ?'; > $randomq = $DB->get_record_sql($sql, [$quizobj->get_quizid(), 'mod_quiz', 'slot']);
$structure->remove_slot(2); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < ), $structure); < $this->assertFalse($DB->record_exists('question', array('id' => $randomq->id)));
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ], $structure); > $this->assertFalse($DB->record_exists('question_set_references', > ['id' => $randomq->id, 'component' => 'mod_quiz', 'questionarea' => 'slot']));
} /** * Unit test to make sue it is not possible to remove all slots in a section at once. */ public function test_cannot_remove_all_slots_in_a_section() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'),
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'],
'Heading 2',
< array('TF3', 2, 'truefalse'), < ));
> ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $structure->remove_slot(1); $this->expectException(\coding_exception::class); $structure->remove_slot(2); } public function test_cannot_remove_last_slot_in_a_section() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'),
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'],
'Heading 2',
< array('TF3', 2, 'truefalse'), < ));
> ['TF3', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $this->expectException(\coding_exception::class); $structure->remove_slot(3); } public function test_can_remove_last_question_in_a_quiz() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'), < ));
> ['TF1', 1, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $structure->remove_slot(1); $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question'); $cat = $questiongenerator->create_question_category(); $q = $questiongenerator->create_question('truefalse', null,
< array('name' => 'TF2', 'category' => $cat->id));
> ['name' => 'TF2', 'category' => $cat->id]);
quiz_add_quiz_question($q->id, $quizobj->get_quiz(), 0); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF2', 1, 'truefalse'), < ), $structure);
> ['TF2', 1, 'truefalse'], > ], $structure);
} public function test_add_question_updates_headings() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'),
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'), < ));
> ['TF2', 2, 'truefalse'], > ]);
$questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question'); $cat = $questiongenerator->create_question_category(); $q = $questiongenerator->create_question('truefalse', null,
< array('name' => 'TF3', 'category' => $cat->id));
> ['name' => 'TF3', 'category' => $cat->id]);
quiz_add_quiz_question($q->id, $quizobj->get_quiz(), 1); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < array('TF3', 1, 'truefalse'),
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ['TF3', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'), < ), $structure);
> ['TF2', 2, 'truefalse'], > ], $structure);
} public function test_add_question_updates_headings_even_with_one_question_sections() {
< $quizobj = $this->create_test_quiz(array(
> $quizobj = $this->create_test_quiz([
'Heading 1',
< array('TF1', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'),
> ['TF2', 2, 'truefalse'],
'Heading 3',
< array('TF3', 3, 'truefalse'), < ));
> ['TF3', 3, 'truefalse'], > ]);
$questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question'); $cat = $questiongenerator->create_question_category(); $q = $questiongenerator->create_question('truefalse', null,
< array('name' => 'TF4', 'category' => $cat->id));
> ['name' => 'TF4', 'category' => $cat->id]);
quiz_add_quiz_question($q->id, $quizobj->get_quiz(), 1); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array(
> $this->assert_quiz_layout([
'Heading 1',
< array('TF1', 1, 'truefalse'), < array('TF4', 1, 'truefalse'),
> ['TF1', 1, 'truefalse'], > ['TF4', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'),
> ['TF2', 2, 'truefalse'],
'Heading 3',
< array('TF3', 3, 'truefalse'), < ), $structure);
> ['TF3', 3, 'truefalse'], > ], $structure);
} public function test_add_question_at_end_does_not_update_headings() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'),
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'), < ));
> ['TF2', 2, 'truefalse'], > ]);
$questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question'); $cat = $questiongenerator->create_question_category(); $q = $questiongenerator->create_question('truefalse', null,
< array('name' => 'TF3', 'category' => $cat->id));
> ['name' => 'TF3', 'category' => $cat->id]);
quiz_add_quiz_question($q->id, $quizobj->get_quiz(), 0); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'),
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'],
'Heading 2',
< array('TF2', 2, 'truefalse'), < array('TF3', 2, 'truefalse'), < ), $structure);
> ['TF2', 2, 'truefalse'], > ['TF3', 2, 'truefalse'], > ], $structure);
} public function test_remove_page_break() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $slotid = $structure->get_question_in_slot(2)->slotid; $slots = $structure->update_page_break($slotid, repaginate::LINK); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < ), $structure);
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ], $structure);
} public function test_add_page_break() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); $slotid = $structure->get_question_in_slot(2)->slotid; $slots = $structure->update_page_break($slotid, repaginate::UNLINK); $structure = structure::create_for_quiz($quizobj);
< $this->assert_quiz_layout(array( < array('TF1', 1, 'truefalse'), < array('TF2', 2, 'truefalse'), < ), $structure);
> $this->assert_quiz_layout([ > ['TF1', 1, 'truefalse'], > ['TF2', 2, 'truefalse'], > ], $structure);
} public function test_update_question_dependency() {
< $quizobj = $this->create_test_quiz(array( < array('TF1', 1, 'truefalse'), < array('TF2', 1, 'truefalse'), < ));
> $quizobj = $this->create_test_quiz([ > ['TF1', 1, 'truefalse'], > ['TF2', 1, 'truefalse'], > ]);
$structure = structure::create_for_quiz($quizobj); // Test adding a dependency. $slotid = $structure->get_slot_id_for_slot(2); $structure->update_question_dependency($slotid, true); // Having called update page break, we need to reload $structure. $structure = structure::create_for_quiz($quizobj); $this->assertEquals(1, $structure->is_question_dependent_on_previous_slot(2)); // Test removing a dependency. $structure->update_question_dependency($slotid, false); // Having called update page break, we need to reload $structure. $structure = structure::create_for_quiz($quizobj); $this->assertEquals(0, $structure->is_question_dependent_on_previous_slot(2)); } /**
< * Data provider for the get_slot_tags_for_slot test. < */ < public function get_slot_tags_for_slot_test_cases() { < return [ < 'incorrect slot id' => [ < 'layout' => [ < ['TF1', 1, 'truefalse'], < ['TF2', 1, 'truefalse'], < ['TF3', 1, 'truefalse'] < ], < 'tagnames' => [ < ['foo'], < ['bar'], < ['baz'] < ], < 'slotnumber' => null, < 'expected' => [] < ], < 'no tags' => [ < 'layout' => [ < ['TF1', 1, 'truefalse'], < ['TF2', 1, 'truefalse'], < ['TF3', 1, 'truefalse'] < ], < 'tagnames' => [ < ['foo'], < [], < ['baz'] < ], < 'slotnumber' => 2, < 'expected' => [] < ], < 'one tag 1' => [ < 'layout' => [ < ['TF1', 1, 'truefalse'], < ['TF2', 1, 'truefalse'], < ['TF3', 1, 'truefalse'] < ], < 'tagnames' => [ < ['foo'], < ['bar'], < ['baz'] < ], < 'slotnumber' => 1, < 'expected' => ['foo'] < ], < 'one tag 2' => [ < 'layout' => [ < ['TF1', 1, 'truefalse'], < ['TF2', 1, 'truefalse'], < ['TF3', 1, 'truefalse'] < ], < 'tagnames' => [ < ['foo'], < ['bar'], < ['baz'] < ], < 'slotnumber' => 2, < 'expected' => ['bar'] < ], < 'multiple tags 1' => [ < 'layout' => [ < ['TF1', 1, 'truefalse'], < ['TF2', 1, 'truefalse'], < ['TF3', 1, 'truefalse'] < ], < 'tagnames' => [ < ['foo', 'bar'], < ['bar'], < ['baz'] < ], < 'slotnumber' => 1, < 'expected' => ['foo', 'bar'] < ], < 'multiple tags 2' => [ < 'layout' => [ < ['TF1', 1, 'truefalse'], < ['TF2', 1, 'truefalse'], < ['TF3', 1, 'truefalse'] < ], < 'tagnames' => [ < ['foo', 'bar'], < ['bar', 'baz'], < ['baz'] < ], < 'slotnumber' => 2, < 'expected' => ['bar', 'baz'] < ] < ]; < } < < /** < * @dataProvider get_slot_tags_for_slot_test_cases() < * @param array $layout Quiz layout for create_test_quiz function < * @param array $tagnames Tags to create for each question slot < * @param int $slotnumber The slot number to select tags from < * @param string[] $expected The tags expected for the given $slotnumber
> * Test for can_add_random_questions.
*/
< public function test_get_slot_tags_for_slot($layout, $tagnames, $slotnumber, $expected) { < global $DB;
> public function test_can_add_random_questions() {
$this->resetAfterTest();
< $quiz = $this->create_test_quiz($layout);
> $quiz = $this->create_test_quiz([]); > $course = $quiz->get_course(); > > $generator = $this->getDataGenerator(); > $teacher = $generator->create_and_enrol($course, 'editingteacher'); > $noneditingteacher = $generator->create_and_enrol($course, 'teacher'); > > $this->setUser($teacher);
$structure = structure::create_for_quiz($quiz);
< $collid = \core_tag_area::get_collection('core', 'question'); < $slottagrecords = [];
> $this->assertTrue($structure->can_add_random_questions());
< if (is_null($slotnumber)) { < // Null slot number means to create a non-existent slot id. < $slot = $structure->get_last_slot(); < $slotid = $slot->id + 100; < } else { < $slot = $structure->get_slot_by_number($slotnumber); < $slotid = $slot->id;
> $this->setUser($noneditingteacher); > $structure = structure::create_for_quiz($quiz); > $this->assertFalse($structure->can_add_random_questions());
}
< foreach ($tagnames as $index => $slottagnames) { < $tagslotnumber = $index + 1; < $tagslotid = $structure->get_slot_id_for_slot($tagslotnumber); < $tags = \core_tag_tag::create_if_missing($collid, $slottagnames); < $records = array_map(function($tag) use ($tagslotid) { < return (object) [ < 'slotid' => $tagslotid, < 'tagid' => $tag->id, < 'tagname' => $tag->name < ]; < }, array_values($tags)); < $slottagrecords = array_merge($slottagrecords, $records); < } < < $DB->insert_records('quiz_slot_tags', $slottagrecords); < < $actualslottags = $structure->get_slot_tags_for_slot_id($slotid); < $actual = array_map(function($slottag) { < return $slottag->tagname; < }, $actualslottags);
> /** > * Test to get the version information for a question to show in the version selection dropdown. > * > * @covers ::get_question_version_info > */ > public function test_get_version_choices_for_slot() { > $this->resetAfterTest();
< sort($expected); < sort($actual);
> $quizobj = $this->create_test_quiz([]);
< $this->assertEquals($expected, $actual);
> // Create a question with two versions. > $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question'); > $cat = $questiongenerator->create_question_category(['contextid' => $quizobj->get_context()->id]); > $q = $questiongenerator->create_question('essay', null, > ['category' => $cat->id, 'name' => 'This is the first version']); > $questiongenerator->update_question($q, null, ['name' => 'This is the second version']); > $questiongenerator->update_question($q, null, ['name' => 'This is the third version']); > quiz_add_quiz_question($q->id, $quizobj->get_quiz()); > > // Create the quiz object. > $structure = structure::create_for_quiz($quizobj); > $versiondata = $structure->get_version_choices_for_slot(1); > $this->assertEquals(4, count($versiondata)); > $this->assertEquals('Always latest', $versiondata[0]->versionvalue); > $this->assertEquals('v3 (latest)', $versiondata[1]->versionvalue); > $this->assertEquals('v2', $versiondata[2]->versionvalue); > $this->assertEquals('v1', $versiondata[3]->versionvalue); > $this->assertTrue($versiondata[0]->selected); > $this->assertFalse($versiondata[1]->selected); > $this->assertFalse($versiondata[2]->selected); > $this->assertFalse($versiondata[3]->selected);
} /**
< * Test for can_add_random_questions.
> * Test the current user have '...use' capability over the question(s) in a given slot. > * > * @covers ::has_use_capability
*/
< public function test_can_add_random_questions() {
> public function test_has_use_capability() {
$this->resetAfterTest();
< $quiz = $this->create_test_quiz([]); < $course = $quiz->get_course();
> // Create a quiz with question. > $quizobj = $this->create_test_quiz([]); > $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question'); > $cat = $questiongenerator->create_question_category(['contextid' => $quizobj->get_context()->id]); > $q = $questiongenerator->create_question('essay', null, > ['category' => $cat->id, 'name' => 'This is essay question']); > quiz_add_quiz_question($q->id, $quizobj->get_quiz()); > > // Create the quiz object. > $structure = structure::create_for_quiz($quizobj); > $slots = $structure->get_slots();
> // Get slot. $generator = $this->getDataGenerator(); > $slotid = array_pop($slots)->slot; $teacher = $generator->create_and_enrol($course, 'editingteacher'); > $noneditingteacher = $generator->create_and_enrol($course, 'teacher'); > $course = $quizobj->get_course();
< $noneditingteacher = $generator->create_and_enrol($course, 'teacher');
> $student = $generator->create_and_enrol($course);
$this->setUser($teacher);
< $structure = structure::create_for_quiz($quiz); < $this->assertTrue($structure->can_add_random_questions());
> $this->assertTrue($structure->has_use_capability($slotid));
< $this->setUser($noneditingteacher); < $structure = structure::create_for_quiz($quiz); < $this->assertFalse($structure->can_add_random_questions());
> $this->setUser($student); > $this->assertFalse($structure->has_use_capability($slotid));
} }