Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.10.x will end 8 November 2021 (12 months).
  • Bug fixes for security issues in 3.10.x will end 9 May 2022 (18 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are 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/>.

/**
 * Tests for the quiz_attempt class.
 *
 * @package   mod_quiz
 * @category  test
 * @copyright 2014 Tim Hunt
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

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

global $CFG;
require_once($CFG->dirroot . '/mod/quiz/locallib.php');

/**
 * Tests for the quiz_attempt class.
 *
 * @copyright 2014 Tim Hunt
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class mod_quiz_attempt_testcase extends advanced_testcase {

    /**
     * Create quiz and attempt data with layout.
     *
     * @param string $layout layout to set. Like quiz attempt.layout. E.g. '1,2,0,3,4,0,'.
< * @param string $navmethod quiz navigation method (defaults to free)
* @return quiz_attempt the new quiz_attempt object */
< protected function create_quiz_and_attempt_with_layout($layout, $navmethod = QUIZ_NAVMETHOD_FREE) {
> protected function create_quiz_and_attempt_with_layout($layout) {
$this->resetAfterTest(true); // Make a user to do the quiz. $user = $this->getDataGenerator()->create_user(); $course = $this->getDataGenerator()->create_course(); // Make a quiz. $quizgenerator = $this->getDataGenerator()->get_plugin_generator('mod_quiz'); $quiz = $quizgenerator->create_instance(['course' => $course->id,
< 'grade' => 100.0, 'sumgrades' => 2, 'layout' => $layout, 'navmethod' => $navmethod]);
> 'grade' => 100.0, 'sumgrades' => 2, 'layout' => $layout]);
$quizobj = quiz::create($quiz->id, $user->id); $quba = question_engine::make_questions_usage_by_activity('mod_quiz', $quizobj->get_context()); $quba->set_preferred_behaviour($quizobj->get_quiz()->preferredbehaviour); $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question'); $cat = $questiongenerator->create_question_category(); $page = 1; foreach (explode(',', $layout) as $slot) { if ($slot == 0) { $page += 1; continue; } $question = $questiongenerator->create_question('shortanswer', null, ['category' => $cat->id]); quiz_add_quiz_question($question->id, $quiz, $page); } $timenow = time(); $attempt = quiz_create_attempt($quizobj, 1, false, $timenow, false, $user->id); quiz_start_new_attempt($quizobj, $quba, $attempt, 1, $timenow); quiz_attempt_save_started($quizobj, $quba, $attempt); return quiz_attempt::create($attempt->id); } public function test_attempt_url() { $attempt = $this->create_quiz_and_attempt_with_layout('1,2,0,3,4,0,5,6,0'); $attemptid = $attempt->get_attempt()->id; $cmid = $attempt->get_cmid(); $url = '/mod/quiz/attempt.php'; $params = ['attempt' => $attemptid, 'cmid' => $cmid, 'page' => 2]; $this->assertEquals(new moodle_url($url, $params), $attempt->attempt_url(null, 2)); $params['page'] = 1; $this->assertEquals(new moodle_url($url, $params), $attempt->attempt_url(3)); $questionattempt = $attempt->get_question_attempt(4); $expecteanchor = $questionattempt->get_outer_question_div_unique_id(); $this->assertEquals(new moodle_url($url, $params, $expecteanchor), $attempt->attempt_url(4)); $this->assertEquals(new moodle_url('#'), $attempt->attempt_url(null, 2, 2)); $this->assertEquals(new moodle_url('#'), $attempt->attempt_url(3, -1, 1)); $questionattempt = $attempt->get_question_attempt(4); $expecteanchor = $questionattempt->get_outer_question_div_unique_id(); $this->assertEquals(new moodle_url(null, null, $expecteanchor, null), $attempt->attempt_url(4, -1, 1)); // Summary page. $url = '/mod/quiz/summary.php'; unset($params['page']); $this->assertEquals(new moodle_url($url, $params), $attempt->summary_url()); // Review page. $url = '/mod/quiz/review.php'; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url()); $params['page'] = 1; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(3, -1, false)); $this->assertEquals(new moodle_url($url, $params, $expecteanchor), $attempt->review_url(4, -1, false)); unset($params['page']); $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 2, true)); $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(1, -1, true)); $params['page'] = 2; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 2, false)); unset($params['page']); $params['showall'] = 0; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 0, false)); $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(1, -1, false)); $params['page'] = 1; unset($params['showall']); $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(3, -1, false)); $params['page'] = 2; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 2)); $this->assertEquals(new moodle_url('#'), $attempt->review_url(null, -1, null, 0)); $questionattempt = $attempt->get_question_attempt(3); $expecteanchor = '#' . $questionattempt->get_outer_question_div_unique_id(); $this->assertEquals(new moodle_url($expecteanchor), $attempt->review_url(3, -1, null, 0)); $questionattempt = $attempt->get_question_attempt(4); $expecteanchor = '#' . $questionattempt->get_outer_question_div_unique_id(); $this->assertEquals(new moodle_url($expecteanchor), $attempt->review_url(4, -1, null, 0)); $this->assertEquals(new moodle_url('#'), $attempt->review_url(null, 2, true, 0)); $this->assertEquals(new moodle_url('#'), $attempt->review_url(1, -1, true, 0)); $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 2, false, 0)); $this->assertEquals(new moodle_url('#'), $attempt->review_url(null, 0, false, 0)); $this->assertEquals(new moodle_url('#'), $attempt->review_url(1, -1, false, 0)); $params['page'] = 1; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(3, -1, false, 0)); // Setup another attempt. $attempt = $this->create_quiz_and_attempt_with_layout( '1,2,3,4,5,6,7,8,9,10,0,11,12,13,14,15,16,17,18,19,20,0,' . '21,22,23,24,25,26,27,28,29,30,0,31,32,33,34,35,36,37,38,39,40,0,' . '41,42,43,44,45,46,47,48,49,50,0,51,52,53,54,55,56,57,58,59,60,0'); $attemptid = $attempt->get_attempt()->id; $cmid = $attempt->get_cmid(); $params = ['attempt' => $attemptid, 'cmid' => $cmid]; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url()); $params['page'] = 2; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 2)); $params['page'] = 1; unset($params['showall']); $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(11, -1, false)); $questionattempt = $attempt->get_question_attempt(12); $expecteanchor = $questionattempt->get_outer_question_div_unique_id(); $this->assertEquals(new moodle_url($url, $params, $expecteanchor), $attempt->review_url(12, -1, false)); $params['showall'] = 1; unset($params['page']); $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 2, true)); $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(1, -1, true)); $params['page'] = 2; unset($params['showall']); $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 2, false)); unset($params['page']); $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 0, false)); $params['page'] = 1; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(11, -1, false)); $this->assertEquals(new moodle_url($url, $params, $expecteanchor), $attempt->review_url(12, -1, false)); $params['page'] = 2; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 2)); $this->assertEquals(new moodle_url('#'), $attempt->review_url(null, -1, null, 0)); $questionattempt = $attempt->get_question_attempt(3); $expecteanchor = $questionattempt->get_outer_question_div_unique_id(); $this->assertEquals(new moodle_url(null, null, $expecteanchor), $attempt->review_url(3, -1, null, 0)); $questionattempt = $attempt->get_question_attempt(4); $expecteanchor = $questionattempt->get_outer_question_div_unique_id(); $this->assertEquals(new moodle_url(null, null, $expecteanchor), $attempt->review_url(4, -1, null, 0)); $this->assertEquals(new moodle_url('#'), $attempt->review_url(null, 2, true, 0)); $this->assertEquals(new moodle_url('#'), $attempt->review_url(1, -1, true, 0)); $params['page'] = 2; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(null, 2, false, 0)); $this->assertEquals(new moodle_url('#'), $attempt->review_url(null, 0, false, 0)); $this->assertEquals(new moodle_url('#'), $attempt->review_url(1, -1, false, 0)); $params['page'] = 1; $this->assertEquals(new moodle_url($url, $params), $attempt->review_url(11, -1, false, 0)); } /** * Tests attempt page titles when all questions are on a single page. */ public function test_attempt_titles_single() { $attempt = $this->create_quiz_and_attempt_with_layout('1,2,0'); // Attempt page. $this->assertEquals('Quiz 1', $attempt->attempt_page_title(0)); // Summary page. $this->assertEquals('Quiz 1: Attempt summary', $attempt->summary_page_title()); // Review page. $this->assertEquals('Quiz 1: Attempt review', $attempt->review_page_title(0)); } /** * Tests attempt page titles when questions are on multiple pages, but are reviewed on a single page. */ public function test_attempt_titles_multiple_single() { $attempt = $this->create_quiz_and_attempt_with_layout('1,2,0,3,4,0,5,6,0'); // Attempt page. $this->assertEquals('Quiz 1 (page 1 of 3)', $attempt->attempt_page_title(0)); $this->assertEquals('Quiz 1 (page 2 of 3)', $attempt->attempt_page_title(1)); $this->assertEquals('Quiz 1 (page 3 of 3)', $attempt->attempt_page_title(2)); // Summary page. $this->assertEquals('Quiz 1: Attempt summary', $attempt->summary_page_title()); // Review page. $this->assertEquals('Quiz 1: Attempt review', $attempt->review_page_title(0, true)); } /** * Tests attempt page titles when questions are on multiple pages, and they are reviewed on multiple pages as well. */ public function test_attempt_titles_multiple_multiple() { $attempt = $this->create_quiz_and_attempt_with_layout( '1,2,3,4,5,6,7,8,9,10,0,11,12,13,14,15,16,17,18,19,20,0,' . '21,22,23,24,25,26,27,28,29,30,0,31,32,33,34,35,36,37,38,39,40,0,' . '41,42,43,44,45,46,47,48,49,50,0,51,52,53,54,55,56,57,58,59,60,0'); // Attempt page. $this->assertEquals('Quiz 1 (page 1 of 6)', $attempt->attempt_page_title(0)); $this->assertEquals('Quiz 1 (page 2 of 6)', $attempt->attempt_page_title(1)); $this->assertEquals('Quiz 1 (page 6 of 6)', $attempt->attempt_page_title(5)); // Summary page. $this->assertEquals('Quiz 1: Attempt summary', $attempt->summary_page_title()); // Review page. $this->assertEquals('Quiz 1: Attempt review (page 1 of 6)', $attempt->review_page_title(0)); $this->assertEquals('Quiz 1: Attempt review (page 2 of 6)', $attempt->review_page_title(1)); $this->assertEquals('Quiz 1: Attempt review (page 6 of 6)', $attempt->review_page_title(5)); // When all questions are shown. $this->assertEquals('Quiz 1: Attempt review', $attempt->review_page_title(0, true)); $this->assertEquals('Quiz 1: Attempt review', $attempt->review_page_title(1, true)); } public function test_is_participant() { global $USER; $this->resetAfterTest(); $this->setAdminUser(); $course = $this->getDataGenerator()->create_course(); $student = $this->getDataGenerator()->create_and_enrol($course, 'student'); $student2 = $this->getDataGenerator()->create_and_enrol($course, 'student', [], 'manual', 0, 0, ENROL_USER_SUSPENDED); $quiz = $this->getDataGenerator()->create_module('quiz', array('course' => $course->id)); $quizobj = quiz::create($quiz->id); // Login as student. $this->setUser($student); // Convert to a lesson object. $this->assertEquals(true, $quizobj->is_participant($student->id), 'Student is enrolled, active and can participate'); // Login as student2. $this->setUser($student2); $this->assertEquals(false, $quizobj->is_participant($student2->id), 'Student is enrolled, suspended and can NOT participate'); // Login as an admin. $this->setAdminUser(); $this->assertEquals(false, $quizobj->is_participant($USER->id), 'Admin is not enrolled and can NOT participate'); $this->getDataGenerator()->enrol_user(2, $course->id); $this->assertEquals(true, $quizobj->is_participant($USER->id), 'Admin is enrolled and can participate'); $this->getDataGenerator()->enrol_user(2, $course->id, [], 'manual', 0, 0, ENROL_USER_SUSPENDED); $this->assertEquals(true, $quizobj->is_participant($USER->id), 'Admin is enrolled, suspended and can participate'); } /** * Test quiz_prepare_and_start_new_attempt function */ public function test_quiz_prepare_and_start_new_attempt() { global $USER; $this->resetAfterTest(); // Create course. $course = $this->getDataGenerator()->create_course(); // Create students. $student1 = $this->getDataGenerator()->create_and_enrol($course, 'student'); $student2 = $this->getDataGenerator()->create_and_enrol($course, 'student'); // Create quiz. $quizgenerator = $this->getDataGenerator()->get_plugin_generator('mod_quiz'); $quiz = $quizgenerator->create_instance(['course' => $course->id, 'grade' => 100.0, 'sumgrades' => 2, 'layout' => '1,0']); // Create question and add it to quiz. $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question'); $cat = $questiongenerator->create_question_category(); $question = $questiongenerator->create_question('shortanswer', null, ['category' => $cat->id]); quiz_add_quiz_question($question->id, $quiz, 1); $quizobj = quiz::create($quiz->id); // Login as student1. $this->setUser($student1); // Create attempt for student1. $attempt = quiz_prepare_and_start_new_attempt($quizobj, 1, null, false, [], []); $this->assertEquals($student1->id, $attempt->userid); $this->assertEquals(0, $attempt->preview); // Login as student2. $this->setUser($student2); // Create attempt for student2. $attempt = quiz_prepare_and_start_new_attempt($quizobj, 1, null, false, [], []); $this->assertEquals($student2->id, $attempt->userid); $this->assertEquals(0, $attempt->preview); // Login as admin. $this->setAdminUser(); // Create attempt for student1. $attempt = quiz_prepare_and_start_new_attempt($quizobj, 2, null, false, [], [], $student1->id); $this->assertEquals($student1->id, $attempt->userid); $this->assertEquals(0, $attempt->preview); $student1attempt = $attempt; // Save for extra verification below. // Create attempt for student2. $attempt = quiz_prepare_and_start_new_attempt($quizobj, 2, null, false, [], [], $student2->id); $this->assertEquals($student2->id, $attempt->userid); $this->assertEquals(0, $attempt->preview); // Create attempt for user id that the same with current $USER->id. $attempt = quiz_prepare_and_start_new_attempt($quizobj, 2, null, false, [], [], $USER->id); $this->assertEquals($USER->id, $attempt->userid); $this->assertEquals(1, $attempt->preview); // Check that the userid stored in the first step is the user the attempt is for, // not the user who triggered the creation. $quba = question_engine::load_questions_usage_by_activity($student1attempt->uniqueid); $step = $quba->get_question_attempt(1)->get_step(0); $this->assertEquals($student1->id, $step->get_user_id());
< } < < /** < * Test check_page_access function < * @covers \quiz_attempt::check_page_access < */ < public function test_check_page_access() { < $timenow = time(); < < // Free navigation. < $attempt = $this->create_quiz_and_attempt_with_layout('1,0,2,0,3,0,4,0,5,0', QUIZ_NAVMETHOD_FREE); < < // Check access. < $this->assertTrue($attempt->check_page_access(4)); < $this->assertTrue($attempt->check_page_access(3)); < $this->assertTrue($attempt->check_page_access(2)); < $this->assertTrue($attempt->check_page_access(1)); < $this->assertTrue($attempt->check_page_access(0)); < $this->assertTrue($attempt->check_page_access(2)); < < // Access page 2. < $attempt->set_currentpage(2); < $attempt = quiz_attempt::create($attempt->get_attempt()->id); < < // Check access. < $this->assertTrue($attempt->check_page_access(0)); < $this->assertTrue($attempt->check_page_access(1)); < $this->assertTrue($attempt->check_page_access(2)); < $this->assertTrue($attempt->check_page_access(3)); < $this->assertTrue($attempt->check_page_access(4)); < < // Sequential navigation. < $attempt = $this->create_quiz_and_attempt_with_layout('1,0,2,0,3,0,4,0,5,0', QUIZ_NAVMETHOD_SEQ); < < // Check access. < $this->assertTrue($attempt->check_page_access(0)); < $this->assertTrue($attempt->check_page_access(1)); < $this->assertFalse($attempt->check_page_access(2)); < $this->assertFalse($attempt->check_page_access(3)); < $this->assertFalse($attempt->check_page_access(4)); < < // Access page 1. < $attempt->set_currentpage(1); < $attempt = quiz_attempt::create($attempt->get_attempt()->id); < $this->assertTrue($attempt->check_page_access(1)); < < // Access page 2. < $attempt->set_currentpage(2); < $attempt = quiz_attempt::create($attempt->get_attempt()->id); < $this->assertTrue($attempt->check_page_access(2)); < < $this->assertTrue($attempt->check_page_access(3)); < $this->assertFalse($attempt->check_page_access(4)); < $this->assertFalse($attempt->check_page_access(1));
} }