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

< /** < * Implementaton of the quizaccess_delaybetweenattempts plugin. < * < * @package quizaccess < * @subpackage delaybetweenattempts < * @copyright 2011 The Open University < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < */ < < < defined('MOODLE_INTERNAL') || die(); < < require_once($CFG->dirroot . '/mod/quiz/accessrule/accessrulebase.php'); <
> use mod_quiz\local\access_rule_base; > use mod_quiz\quiz_settings;
/** * A rule imposing the delay between attempts settings. *
> * @package quizaccess_delaybetweenattempts
* @copyright 2009 Tim Hunt * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */
< class quizaccess_delaybetweenattempts extends quiz_access_rule_base {
> class quizaccess_delaybetweenattempts extends access_rule_base {
< public static function make(quiz $quizobj, $timenow, $canignoretimelimits) {
> public static function make(quiz_settings $quizobj, $timenow, $canignoretimelimits) {
if (empty($quizobj->get_quiz()->delay1) && empty($quizobj->get_quiz()->delay2)) { return null; } return new self($quizobj, $timenow); } public function prevent_new_attempt($numprevattempts, $lastattempt) { if ($this->quiz->attempts > 0 && $numprevattempts >= $this->quiz->attempts) { // No more attempts allowed anyway. return false; } if ($this->quiz->timeclose != 0 && $this->timenow > $this->quiz->timeclose) { // No more attempts allowed anyway. return false; } $nextstarttime = $this->compute_next_start_time($numprevattempts, $lastattempt); if ($this->timenow < $nextstarttime) { if ($this->quiz->timeclose == 0 || $nextstarttime <= $this->quiz->timeclose) { return get_string('youmustwait', 'quizaccess_delaybetweenattempts', userdate($nextstarttime)); } else { return get_string('youcannotwait', 'quizaccess_delaybetweenattempts'); } } return false; } /** * Compute the next time a student would be allowed to start an attempt, * according to this rule. * @param int $numprevattempts number of previous attempts.
< * @param object $lastattempt information about the previous attempt.
> * @param stdClass $lastattempt information about the previous attempt.
* @return number the time. */ protected function compute_next_start_time($numprevattempts, $lastattempt) { if ($numprevattempts == 0) { return 0; } $lastattemptfinish = $lastattempt->timefinish; if ($this->quiz->timelimit > 0) { $lastattemptfinish = min($lastattemptfinish, $lastattempt->timestart + $this->quiz->timelimit); } if ($numprevattempts == 1 && $this->quiz->delay1) { return $lastattemptfinish + $this->quiz->delay1; } else if ($numprevattempts > 1 && $this->quiz->delay2) { return $lastattemptfinish + $this->quiz->delay2; } return 0; } public function is_finished($numprevattempts, $lastattempt) { $nextstarttime = $this->compute_next_start_time($numprevattempts, $lastattempt); return $this->timenow <= $nextstarttime && $this->quiz->timeclose != 0 && $nextstarttime >= $this->quiz->timeclose; } }