Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 3.9.x will end* 10 May 2021 (12 months).
  • Bug fixes for security issues in 3.9.x will end* 8 May 2023 (36 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/>.

/**
 * Capability definitions for the quiz module.
 *
 * @package    mod_quiz
 * @copyright  2006 The Open University
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

defined('MOODLE_INTERNAL') || die();

< $capabilities = array(
> $capabilities = [
// Ability to see that the quiz exists, and the basic information // about it, for example the start date and time limit.
< 'mod/quiz:view' => array(
> 'mod/quiz:view' => [
'captype' => 'read', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array(
> 'archetypes' => [
'guest' => CAP_ALLOW, 'student' => CAP_ALLOW, 'teacher' => CAP_ALLOW, 'editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW
< ) < ),
> ] > ],
// Ability to add a new quiz to the course.
< 'mod/quiz:addinstance' => array(
> 'mod/quiz:addinstance' => [
'riskbitmask' => RISK_XSS, 'captype' => 'write', 'contextlevel' => CONTEXT_COURSE,
< 'archetypes' => array(
> 'archetypes' => [
'editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW
< ),
> ],
'clonepermissionsfrom' => 'moodle/course:manageactivities'
< ),
> ],
// Ability to do the quiz as a 'student'.
< 'mod/quiz:attempt' => array(
> 'mod/quiz:attempt' => [
'riskbitmask' => RISK_SPAM, 'captype' => 'write', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array(
> 'archetypes' => [
'student' => CAP_ALLOW
< ) < ),
> ] > ],
// Ability for a 'Student' to review their previous attempts. Review by // 'Teachers' is controlled by mod/quiz:viewreports.
< 'mod/quiz:reviewmyattempts' => array(
> 'mod/quiz:reviewmyattempts' => [
'captype' => 'read', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array(
> 'archetypes' => [
'student' => CAP_ALLOW
< ),
> ],
'clonepermissionsfrom' => 'moodle/quiz:attempt'
< ),
> ],
// Edit the quiz settings, add and remove questions.
< 'mod/quiz:manage' => array(
> 'mod/quiz:manage' => [
'riskbitmask' => RISK_SPAM, 'captype' => 'write', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array(
> 'archetypes' => [
'editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW
< ) < ),
> ] > ],
// Edit the quiz overrides.
< 'mod/quiz:manageoverrides' => array(
> 'mod/quiz:manageoverrides' => [
'captype' => 'write', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array(
> 'archetypes' => [
'editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW
< ) < ),
> ] > ], > > // View the quiz overrides (only checked for users who don't have mod/quiz:manageoverrides. > 'mod/quiz:viewoverrides' => [ > 'captype' => 'read', > 'contextlevel' => CONTEXT_MODULE, > 'archetypes' => [ > 'teacher' => CAP_ALLOW, > 'editingteacher' => CAP_ALLOW, > 'manager' => CAP_ALLOW > ] > ],
// Preview the quiz.
< 'mod/quiz:preview' => array(
> 'mod/quiz:preview' => [
'captype' => 'write', // Only just a write. 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array(
> 'archetypes' => [
'teacher' => CAP_ALLOW, 'editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW
< ) < ),
> ] > ],
// Manually grade and comment on student attempts at a question.
< 'mod/quiz:grade' => array(
> 'mod/quiz:grade' => [
'riskbitmask' => RISK_SPAM | RISK_XSS, 'captype' => 'write', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array(
> 'archetypes' => [
'teacher' => CAP_ALLOW, 'editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW
< ) < ),
> ] > ],
// Regrade quizzes.
< 'mod/quiz:regrade' => array(
> 'mod/quiz:regrade' => [
'riskbitmask' => RISK_SPAM, 'captype' => 'write', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array(
> 'archetypes' => [
'teacher' => CAP_ALLOW, 'editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW
< ),
> ],
'clonepermissionsfrom' => 'mod/quiz:grade'
< ),
> ],
// View the quiz reports.
< 'mod/quiz:viewreports' => array(
> 'mod/quiz:viewreports' => [
'riskbitmask' => RISK_PERSONAL, 'captype' => 'read', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array(
> 'archetypes' => [
'teacher' => CAP_ALLOW, 'editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW
< ) < ),
> ] > ],
// Delete attempts using the overview report.
< 'mod/quiz:deleteattempts' => array(
> 'mod/quiz:deleteattempts' => [
'riskbitmask' => RISK_DATALOSS, 'captype' => 'write', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array(
> 'archetypes' => [
'editingteacher' => CAP_ALLOW, 'manager' => CAP_ALLOW
< ) < ),
> ] > ],
// Do not have the time limit imposed. Used for accessibility legislation compliance.
< 'mod/quiz:ignoretimelimits' => array(
> 'mod/quiz:ignoretimelimits' => [
'captype' => 'read', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array() < ),
> 'archetypes' => [] > ],
// Receive a confirmation message of own quiz submission.
< 'mod/quiz:emailconfirmsubmission' => array(
> 'mod/quiz:emailconfirmsubmission' => [
'captype' => 'read', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array() < ),
> 'archetypes' => [] > ],
// Receive a notification message of other peoples' quiz submissions.
< 'mod/quiz:emailnotifysubmission' => array(
> 'mod/quiz:emailnotifysubmission' => [
'captype' => 'read', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array() < ),
> 'archetypes' => [] > ],
// Receive a notification message when a quiz attempt becomes overdue.
< 'mod/quiz:emailwarnoverdue' => array(
> 'mod/quiz:emailwarnoverdue' => [
'captype' => 'read', 'contextlevel' => CONTEXT_MODULE,
< 'archetypes' => array() < ), < );
> 'archetypes' => [] > ], > ];