. /** * 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'); /** * A rule implementing the offlineattempts check. * * @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 { public static function make(quiz $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)); 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, MoodleQuickForm $mform, $attemptid) { global $DB; $timemodifiedoffline = $DB->get_field('quiz_attempts', 'timemodifiedoffline', array('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', ''); } } 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. if (!empty($data['allowofflineattempts']) and (!empty($data['timelimit']) or !empty($data['subnet']) or ($data['preferredbehaviour'] != 'deferredfeedback' and $data['preferredbehaviour'] != 'deferredcbm'))) { $errors['allowofflineattempts'] = get_string('offlineattemptserror', 'quizaccess_offlineattempts'); } } return $errors; } }