mirror of
https://github.com/moodle/moodle.git
synced 2025-03-03 15:29:08 +01:00
4141f88361
- Applies locked settings to many other quiz general options. For example, allows an admin to lock the browsersecurity level so it cannot be changed at an instance level, and will apply the 'default' option (which is currently None).
317 lines
14 KiB
PHP
317 lines
14 KiB
PHP
<?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/>.
|
|
|
|
/**
|
|
* Administration settings definitions for the quiz module.
|
|
*
|
|
* @package mod_quiz
|
|
* @copyright 2010 Petr Skoda
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
|
|
defined('MOODLE_INTERNAL') || die();
|
|
|
|
require_once($CFG->dirroot . '/mod/quiz/lib.php');
|
|
|
|
// First get a list of quiz reports with there own settings pages. If there none,
|
|
// we use a simpler overall menu structure.
|
|
$reports = core_component::get_plugin_list_with_file('quiz', 'settings.php', false);
|
|
$reportsbyname = array();
|
|
foreach ($reports as $report => $reportdir) {
|
|
$strreportname = get_string($report . 'report', 'quiz_'.$report);
|
|
$reportsbyname[$strreportname] = $report;
|
|
}
|
|
core_collator::ksort($reportsbyname);
|
|
|
|
// First get a list of quiz reports with there own settings pages. If there none,
|
|
// we use a simpler overall menu structure.
|
|
$rules = core_component::get_plugin_list_with_file('quizaccess', 'settings.php', false);
|
|
$rulesbyname = array();
|
|
foreach ($rules as $rule => $ruledir) {
|
|
$strrulename = get_string('pluginname', 'quizaccess_' . $rule);
|
|
$rulesbyname[$strrulename] = $rule;
|
|
}
|
|
core_collator::ksort($rulesbyname);
|
|
|
|
// Create the quiz settings page.
|
|
if (empty($reportsbyname) && empty($rulesbyname)) {
|
|
$pagetitle = get_string('modulename', 'quiz');
|
|
} else {
|
|
$pagetitle = get_string('generalsettings', 'admin');
|
|
}
|
|
$quizsettings = new admin_settingpage('modsettingquiz', $pagetitle, 'moodle/site:config');
|
|
|
|
if ($ADMIN->fulltree) {
|
|
// Introductory explanation that all the settings are defaults for the add quiz form.
|
|
$quizsettings->add(new admin_setting_heading('quizintro', '', get_string('configintro', 'quiz')));
|
|
|
|
// Time limit.
|
|
$setting = new admin_setting_configduration('quiz/timelimit',
|
|
get_string('timelimit', 'quiz'), get_string('configtimelimitsec', 'quiz'),
|
|
'0', 60);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, false);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Delay to notify graded attempts.
|
|
$quizsettings->add(new admin_setting_configduration('quiz/notifyattemptgradeddelay',
|
|
get_string('attemptgradeddelay', 'quiz'), get_string('attemptgradeddelay_desc', 'quiz'), 5 * HOURSECS, HOURSECS));
|
|
|
|
// What to do with overdue attempts.
|
|
$setting = new mod_quiz_admin_setting_overduehandling('quiz/overduehandling',
|
|
get_string('overduehandling', 'quiz'), get_string('overduehandling_desc', 'quiz'),
|
|
array('value' => 'autosubmit', 'adv' => false), null);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Grace period time.
|
|
$setting = new admin_setting_configduration('quiz/graceperiod',
|
|
get_string('graceperiod', 'quiz'), get_string('graceperiod_desc', 'quiz'),
|
|
'86400');
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, false);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Minimum grace period used behind the scenes.
|
|
$quizsettings->add(new admin_setting_configduration('quiz/graceperiodmin',
|
|
get_string('graceperiodmin', 'quiz'), get_string('graceperiodmin_desc', 'quiz'),
|
|
60, 1));
|
|
|
|
// Number of attempts.
|
|
$options = array(get_string('unlimited'));
|
|
for ($i = 1; $i <= QUIZ_MAX_ATTEMPT_OPTION; $i++) {
|
|
$options[$i] = $i;
|
|
}
|
|
$setting = new admin_setting_configselect('quiz/attempts',
|
|
get_string('attemptsallowed', 'quiz'), get_string('configattemptsallowed', 'quiz'),
|
|
0, $options);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, false);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Grading method.
|
|
$setting = new mod_quiz_admin_setting_grademethod('quiz/grademethod',
|
|
get_string('grademethod', 'quiz'), get_string('configgrademethod', 'quiz'),
|
|
array('value' => QUIZ_GRADEHIGHEST, 'adv' => false), null);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Maximum grade.
|
|
$setting = new admin_setting_configtext('quiz/maximumgrade',
|
|
get_string('maximumgrade'), get_string('configmaximumgrade', 'quiz'), 10, PARAM_INT);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Questions per page.
|
|
$perpage = array();
|
|
$perpage[0] = get_string('never');
|
|
$perpage[1] = get_string('aftereachquestion', 'quiz');
|
|
for ($i = 2; $i <= QUIZ_MAX_QPP_OPTION; ++$i) {
|
|
$perpage[$i] = get_string('afternquestions', 'quiz', $i);
|
|
}
|
|
$setting = new admin_setting_configselect('quiz/questionsperpage',
|
|
get_string('newpageevery', 'quiz'), get_string('confignewpageevery', 'quiz'),
|
|
1, $perpage);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, false);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Navigation method.
|
|
$setting = new admin_setting_configselect('quiz/navmethod',
|
|
get_string('navmethod', 'quiz'), get_string('confignavmethod', 'quiz'),
|
|
QUIZ_NAVMETHOD_FREE, quiz_get_navigation_options());
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, true);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Shuffle within questions.
|
|
$setting = new admin_setting_configcheckbox('quiz/shuffleanswers',
|
|
get_string('shufflewithin', 'quiz'), get_string('configshufflewithin', 'quiz'),
|
|
1);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, false);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Preferred behaviour.
|
|
$setting = new admin_setting_question_behaviour('quiz/preferredbehaviour',
|
|
get_string('howquestionsbehave', 'question'), get_string('howquestionsbehave_desc', 'quiz'),
|
|
'deferredfeedback');
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Can redo completed questions.
|
|
$setting = new admin_setting_configselect('quiz/canredoquestions',
|
|
get_string('canredoquestions', 'quiz'), get_string('canredoquestions_desc', 'quiz'),
|
|
0,
|
|
array(0 => get_string('no'), 1 => get_string('canredoquestionsyes', 'quiz')));
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, true);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Each attempt builds on last.
|
|
$setting = new admin_setting_configcheckbox('quiz/attemptonlast',
|
|
get_string('eachattemptbuildsonthelast', 'quiz'),
|
|
get_string('configeachattemptbuildsonthelast', 'quiz'),
|
|
0);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, true);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Review options.
|
|
$quizsettings->add(new admin_setting_heading('reviewheading',
|
|
get_string('reviewoptionsheading', 'quiz'), ''));
|
|
foreach (mod_quiz_admin_review_setting::fields() as $field => $name) {
|
|
$default = mod_quiz_admin_review_setting::all_on();
|
|
$forceduring = null;
|
|
if ($field == 'attempt') {
|
|
$forceduring = true;
|
|
} else if ($field == 'overallfeedback') {
|
|
$default = $default ^ mod_quiz_admin_review_setting::DURING;
|
|
$forceduring = false;
|
|
}
|
|
$quizsettings->add(new mod_quiz_admin_review_setting('quiz/review' . $field,
|
|
$name, '', $default, $forceduring));
|
|
}
|
|
|
|
// Show the user's picture.
|
|
$setting = new mod_quiz_admin_setting_user_image('quiz/showuserpicture',
|
|
get_string('showuserpicture', 'quiz'), get_string('configshowuserpicture', 'quiz'),
|
|
array('value' => 0, 'adv' => false), null);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Decimal places for overall grades.
|
|
$options = array();
|
|
for ($i = 0; $i <= QUIZ_MAX_DECIMAL_OPTION; $i++) {
|
|
$options[$i] = $i;
|
|
}
|
|
$setting = new admin_setting_configselect('quiz/decimalpoints',
|
|
get_string('decimalplaces', 'quiz'), get_string('configdecimalplaces', 'quiz'),
|
|
2, $options);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, false);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Decimal places for question grades.
|
|
$options = array(-1 => get_string('sameasoverall', 'quiz'));
|
|
for ($i = 0; $i <= QUIZ_MAX_Q_DECIMAL_OPTION; $i++) {
|
|
$options[$i] = $i;
|
|
}
|
|
$setting = new admin_setting_configselect('quiz/questiondecimalpoints',
|
|
get_string('decimalplacesquestion', 'quiz'),
|
|
get_string('configdecimalplacesquestion', 'quiz'),
|
|
-1, $options);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, false);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Show blocks during quiz attempts.
|
|
$setting = new admin_setting_configcheckbox('quiz/showblocks',
|
|
get_string('showblocks', 'quiz'), get_string('configshowblocks', 'quiz'),
|
|
0);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, true);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Password.
|
|
$setting = new admin_setting_configpasswordunmask('quiz/quizpassword',
|
|
get_string('requirepassword', 'quiz'), get_string('configrequirepassword', 'quiz'),
|
|
'');
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, false);
|
|
$setting->set_required_flag_options(admin_setting_flag::ENABLED, false);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// IP restrictions.
|
|
$setting = new admin_setting_configtext('quiz/subnet',
|
|
get_string('requiresubnet', 'quiz'), get_string('configrequiresubnet', 'quiz'),
|
|
'', PARAM_TEXT);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, true);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Enforced delay between attempts.
|
|
$setting = new admin_setting_configduration('quiz/delay1',
|
|
get_string('delay1st2nd', 'quiz'), get_string('configdelay1st2nd', 'quiz'),
|
|
0, 60);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, true);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
$setting = new admin_setting_configduration('quiz/delay2',
|
|
get_string('delaylater', 'quiz'), get_string('configdelaylater', 'quiz'),
|
|
0, 60);
|
|
$setting->set_advanced_flag_options(admin_setting_flag::ENABLED, true);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
// Browser security.
|
|
$setting = new mod_quiz_admin_setting_browsersecurity('quiz/browsersecurity',
|
|
get_string('showinsecurepopup', 'quiz'), get_string('configpopup', 'quiz'),
|
|
array('value' => '-', 'adv' => true), null);
|
|
$setting->set_locked_flag_options(admin_setting_flag::ENABLED, false);
|
|
$quizsettings->add($setting);
|
|
|
|
$quizsettings->add(new admin_setting_configtext('quiz/initialnumfeedbacks',
|
|
get_string('initialnumfeedbacks', 'quiz'), get_string('initialnumfeedbacks_desc', 'quiz'),
|
|
2, PARAM_INT, 5));
|
|
|
|
// Allow user to specify if setting outcomes is an advanced setting.
|
|
if (!empty($CFG->enableoutcomes)) {
|
|
$quizsettings->add(new admin_setting_configcheckbox('quiz/outcomes_adv',
|
|
get_string('outcomesadvanced', 'quiz'), get_string('configoutcomesadvanced', 'quiz'),
|
|
'0'));
|
|
}
|
|
|
|
// Autosave frequency.
|
|
$quizsettings->add(new admin_setting_configduration('quiz/autosaveperiod',
|
|
get_string('autosaveperiod', 'quiz'), get_string('autosaveperiod_desc', 'quiz'), 60, 1));
|
|
}
|
|
|
|
// Now, depending on whether any reports have their own settings page, add
|
|
// the quiz setting page to the appropriate place in the tree.
|
|
if (empty($reportsbyname) && empty($rulesbyname)) {
|
|
$ADMIN->add('modsettings', $quizsettings);
|
|
} else {
|
|
$ADMIN->add('modsettings', new admin_category('modsettingsquizcat',
|
|
get_string('modulename', 'quiz'), $module->is_enabled() === false));
|
|
$ADMIN->add('modsettingsquizcat', $quizsettings);
|
|
|
|
// Add settings pages for the quiz report subplugins.
|
|
foreach ($reportsbyname as $strreportname => $report) {
|
|
$reportname = $report;
|
|
|
|
$settings = new admin_settingpage('modsettingsquizcat'.$reportname,
|
|
$strreportname, 'moodle/site:config', $module->is_enabled() === false);
|
|
include($CFG->dirroot . "/mod/quiz/report/$reportname/settings.php");
|
|
if (!empty($settings)) {
|
|
$ADMIN->add('modsettingsquizcat', $settings);
|
|
}
|
|
}
|
|
|
|
// Add settings pages for the quiz access rule subplugins.
|
|
foreach ($rulesbyname as $strrulename => $rule) {
|
|
$settings = new admin_settingpage('modsettingsquizcat' . $rule,
|
|
$strrulename, 'moodle/site:config', $module->is_enabled() === false);
|
|
include($CFG->dirroot . "/mod/quiz/accessrule/$rule/settings.php");
|
|
if (!empty($settings)) {
|
|
$ADMIN->add('modsettingsquizcat', $settings);
|
|
}
|
|
}
|
|
}
|
|
|
|
$settings = null; // We do not want standard settings link.
|