Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.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/>.

< /** < * Implementaton of the quizaccess_offlineattempts plugin. < * < * @package quizaccess_offlineattempts < * @copyright 2016 Juan Leyva < * @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\form\preflight_check_form; > use mod_quiz\local\access_rule_base; > use mod_quiz\quiz_settings;
/** * A rule implementing the offlineattempts check. *
> * @package quizaccess_offlineattempts
* @copyright 2016 Juan Leyva * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later * @since Moodle 3.2 */
< class quizaccess_offlineattempts extends quiz_access_rule_base {
> class quizaccess_offlineattempts extends access_rule_base {
< public static function make(quiz $quizobj, $timenow, $canignoretimelimits) {
> public static function make(quiz_settings $quizobj, $timenow, $canignoretimelimits) {
global $CFG; // If mobile services are off, the user won't be able to use any external app. if (empty($CFG->enablemobilewebservice) or empty($quizobj->get_quiz()->allowofflineattempts)) { return null; } return new self($quizobj, $timenow); } public function is_preflight_check_required($attemptid) { global $SESSION, $DB; // First, check if the user did something offline. if (!empty($attemptid)) {
< $timemodifiedoffline = $DB->get_field('quiz_attempts', 'timemodifiedoffline', array('id' => $attemptid));
> $timemodifiedoffline = $DB->get_field('quiz_attempts', 'timemodifiedoffline', ['id' => $attemptid]);
if (empty($timemodifiedoffline)) { return false; } return empty($SESSION->offlineattemptscheckedquizzes[$this->quiz->id]); } else { // Starting a new attempt, we don't have to check anything here. return false; } }
< public function add_preflight_check_form_fields(mod_quiz_preflight_check_form $quizform,
> public function add_preflight_check_form_fields(preflight_check_form $quizform,
MoodleQuickForm $mform, $attemptid) { global $DB;
< $timemodifiedoffline = $DB->get_field('quiz_attempts', 'timemodifiedoffline', array('id' => $attemptid));
> $timemodifiedoffline = $DB->get_field('quiz_attempts', 'timemodifiedoffline', ['id' => $attemptid]);
$lasttime = format_time(time() - $timemodifiedoffline); $mform->addElement('header', 'offlineattemptsheader', get_string('mobileapp', 'quizaccess_offlineattempts')); $mform->addElement('static', 'offlinedatamessage', '', get_string('offlinedatamessage', 'quizaccess_offlineattempts', $lasttime)); $mform->addElement('advcheckbox', 'confirmdatasaved', null, get_string('confirmdatasaved', 'quizaccess_offlineattempts')); } public function validate_preflight_check($data, $files, $errors, $attemptid) { // The user confirmed that he doesn't have unsaved work. if (!empty($data['confirmdatasaved'])) { return $errors; } $errors['confirmdatasaved'] = get_string('pleaseconfirm', 'quizaccess_offlineattempts'); return $errors; } public function notify_preflight_check_passed($attemptid) { global $SESSION; $SESSION->offlineattemptscheckedquizzes[$this->quiz->id] = true; } public function current_attempt_finished() { global $SESSION; // Clear the flag in the session that says that the user has already agreed to the notice. if (!empty($SESSION->offlineattemptscheckedquizzes[$this->quiz->id])) { unset($SESSION->offlineattemptscheckedquizzes[$this->quiz->id]); } } public static function add_settings_form_fields( mod_quiz_mod_form $quizform, MoodleQuickForm $mform) { global $CFG; // Allow to enable the access rule only if the Mobile services are enabled. if ($CFG->enablemobilewebservice) { $mform->addElement('selectyesno', 'allowofflineattempts', get_string('allowofflineattempts', 'quizaccess_offlineattempts')); $mform->addHelpButton('allowofflineattempts', 'allowofflineattempts', 'quizaccess_offlineattempts'); $mform->setDefault('allowofflineattempts', 0); $mform->setAdvanced('allowofflineattempts'); $mform->disabledIf('allowofflineattempts', 'timelimit[number]', 'neq', 0); $mform->disabledIf('allowofflineattempts', 'subnet', 'neq', ''); $mform->disabledIf('allowofflineattempts', 'navmethod', 'eq', 'sequential'); } } public static function validate_settings_form_fields(array $errors, array $data, $files, mod_quiz_mod_form $quizform) { global $CFG; if ($CFG->enablemobilewebservice) { // Do not allow offline attempts if: // - The quiz uses a timer. // - The quiz is restricted by subnet. // - The question behaviour is not deferred feedback or deferred feedback with CBM. // - The quiz uses the sequential navigation. if (!empty($data['allowofflineattempts']) && (!empty($data['timelimit']) || !empty($data['subnet']) || $data['navmethod'] === 'sequential' || ($data['preferredbehaviour'] != 'deferredfeedback' && $data['preferredbehaviour'] != 'deferredcbm'))) { $errors['allowofflineattempts'] = get_string('offlineattemptserror', 'quizaccess_offlineattempts'); } } return $errors; } }