/mod/quiz/settingslib.php
PHP | 197 lines | 110 code | 26 blank | 61 comment | 18 complexity | 95a8acb1618d88a16ed52ecfc4c805ed MD5 | raw file
Possible License(s): MIT, AGPL-3.0, MPL-2.0-no-copyleft-exception, LGPL-3.0, GPL-3.0, Apache-2.0, LGPL-2.1, BSD-3-Clause
- <?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/>.
- /**
- * This page is the entry page into the quiz UI. Displays information about the
- * quiz to students and teachers, and lets students see their previous attempts.
- *
- * @package mod
- * @subpackage quiz
- * @copyright 2008 Tim Hunt
- * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
- */
- defined('MOODLE_INTERNAL') || die();
- /**
- * Admin settings class for the quiz review opitions.
- *
- * @copyright 2008 Tim Hunt
- * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
- */
- class mod_quiz_admin_review_setting extends admin_setting {
- /**#@+
- * @var integer should match the constants defined in {@link mod_quiz_display_options}.
- * again, copied for performance reasons.
- */
- const DURING = 0x10000;
- const IMMEDIATELY_AFTER = 0x01000;
- const LATER_WHILE_OPEN = 0x00100;
- const AFTER_CLOSE = 0x00010;
- /**#@-*/
- /**
- * @var boolean|null forced checked / disabled attributes for the during time.
- */
- protected $duringstate;
- /**
- * This should match {@link mod_quiz_mod_form::$reviewfields} but copied
- * here because generating the admin tree needs to be fast.
- * @return array
- */
- public static function fields() {
- return array(
- 'attempt' => get_string('theattempt', 'quiz'),
- 'correctness' => get_string('whethercorrect', 'question'),
- 'marks' => get_string('marks', 'question'),
- 'specificfeedback' => get_string('specificfeedback', 'question'),
- 'generalfeedback' => get_string('generalfeedback', 'question'),
- 'rightanswer' => get_string('rightanswer', 'question'),
- 'overallfeedback' => get_string('overallfeedback', 'quiz'),
- );
- }
- public function __construct($name, $visiblename, $description,
- $defaultsetting, $duringstate = null) {
- $this->duringstate = $duringstate;
- parent::__construct($name, $visiblename, $description, $defaultsetting);
- }
- /**
- * @return int all times.
- */
- public static function all_on() {
- return self::DURING | self::IMMEDIATELY_AFTER | self::LATER_WHILE_OPEN |
- self::AFTER_CLOSE;
- }
- protected static function times() {
- return array(
- self::DURING => get_string('reviewduring', 'quiz'),
- self::IMMEDIATELY_AFTER => get_string('reviewimmediately', 'quiz'),
- self::LATER_WHILE_OPEN => get_string('reviewopen', 'quiz'),
- self::AFTER_CLOSE => get_string('reviewclosed', 'quiz'),
- );
- }
- protected function normalise_data($data) {
- $times = self::times();
- $value = 0;
- foreach ($times as $timemask => $name) {
- if ($timemask == self::DURING && !is_null($this->duringstate)) {
- if ($this->duringstate) {
- $value += $timemask;
- }
- } else if (!empty($data[$timemask])) {
- $value += $timemask;
- }
- }
- return $value;
- }
- public function get_setting() {
- return $this->config_read($this->name);
- }
- public function write_setting($data) {
- if (is_array($data) || empty($data)) {
- $data = $this->normalise_data($data);
- }
- $this->config_write($this->name, $data);
- return '';
- }
- public function output_html($data, $query = '') {
- if (is_array($data) || empty($data)) {
- $data = $this->normalise_data($data);
- }
- $return = '<div class="group"><input type="hidden" name="' .
- $this->get_full_name() . '[' . self::DURING . ']" value="0" />';
- foreach (self::times() as $timemask => $namestring) {
- $id = $this->get_id(). '_' . $timemask;
- $state = '';
- if ($data & $timemask) {
- $state = 'checked="checked" ';
- }
- if ($timemask == self::DURING && !is_null($this->duringstate)) {
- $state = 'disabled="disabled" ';
- if ($this->duringstate) {
- $state .= 'checked="checked" ';
- }
- }
- $return .= '<span><input type="checkbox" name="' .
- $this->get_full_name() . '[' . $timemask . ']" value="1" id="' . $id .
- '" ' . $state . '/> <label for="' . $id . '">' .
- $namestring . "</label></span>\n";
- }
- $return .= "</div>\n";
- return format_admin_setting($this, $this->visiblename, $return,
- $this->description, true, '', get_string('everythingon', 'quiz'), $query);
- }
- }
- /**
- * Admin settings class for the quiz grading method.
- *
- * Just so we can lazy-load the choices.
- *
- * @copyright 2011 The Open University
- * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
- */
- class mod_quiz_admin_setting_grademethod extends admin_setting_configselect_with_advanced {
- public function load_choices() {
- global $CFG;
- if (is_array($this->choices)) {
- return true;
- }
- require_once($CFG->dirroot . '/mod/quiz/locallib.php');
- $this->choices = quiz_get_grading_options();
- return true;
- }
- }
- /**
- * Admin settings class for the quiz browser security option.
- *
- * Just so we can lazy-load the choices.
- *
- * @copyright 2011 The Open University
- * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
- */
- class mod_quiz_admin_setting_browsersecurity extends admin_setting_configselect_with_advanced {
- public function load_choices() {
- global $CFG;
- if (is_array($this->choices)) {
- return true;
- }
- require_once($CFG->dirroot . '/mod/quiz/locallib.php');
- $this->choices = quiz_access_manager::get_browser_security_choices();
- return true;
- }
- }