$string['emailnotifysubject'] = '$a->studentname has completed quiz $a->quizname';
$string['empty'] = 'Empty';
$string['endtest'] = 'End test ...';
+$string['erroraccessingreport'] = 'You cannot access this report';
$string['errorinquestion'] = 'Error in question';
$string['errormissingquestion'] = 'Error: The system is missing the question with id $a';
$string['errornotnumbers'] = 'Error - answers must be numeric';
$string['quiz:ignoretimelimits'] = 'Ignores time limit on quizzes';
$string['quiz:manage'] = 'Manage quizzes';
$string['quiz:preview'] = 'Preview quizzes';
+$string['quiz:regrade'] = 'Regrade quiz attempts';
$string['quiz:view'] = 'View quiz information';
$string['quiz:viewreports'] = 'View quiz reports';
$string['quizavailable'] = 'The quiz is available until: $a';
$string['statistics'] = 'Statistics';
+$string['statistics:view'] = 'View statistics report';
+$string['statistics:componentname'] = 'Quiz statistics report';
$string['statisticsreport'] = 'Statistics report';
$string['calculatefrom'] = 'Calculate statistics from';
$defpath = $CFG->dirroot.'/grade/report/'.$compparts[1].'/db/access.php';
$varprefix = $compparts[0].'_'.$compparts[1];
+ } else if ($compparts[0] == 'quizreport') {
+ $defpath = $CFG->dirroot.'/mod/quiz/report/'.$compparts[1].'/db/access.php';
+ $varprefix = $compparts[0].'_'.$compparts[1];
+
} else {
$defpath = $CFG->dirroot.'/'.$component.'/db/access.php';
$varprefix = str_replace('/', '_', $component);
$string = get_string($stringname, 'gradereport_'.$componentname);
break;
+ case 'quizreport':
+ $string = get_string($stringname, 'quiz_'.$componentname);
+ break;
+
default:
$string = get_string($stringname);
break;
break;
case CONTEXT_MODULE:
- $string = get_string('modulename', basename($component));
+ if (preg_match('|^quizreport/([a-z_]*)|', $component, $matches)){
+ $langname = 'quiz_'.$matches[1];
+ $string = get_string($matches[1].':componentname', $langname);
+ } else {
+ $string = get_string('modulename', basename($component));
+ }
break;
case CONTEXT_BLOCK:
)
),
- // Manually grade and comment on student attempts at a question, and regrade quizzes.
+ // Manually grade and comment on student attempts at a question.
'mod/quiz:grade' => array(
'riskbitmask' => RISK_SPAM | RISK_XSS,
'captype' => 'write',
)
),
+ // Regrade quizzes.
+ 'mod/quiz:regrade' => array(
+ 'riskbitmask' => RISK_SPAM | RISK_XSS,
+ 'captype' => 'write',
+ 'contextlevel' => CONTEXT_MODULE,
+ 'legacy' => array(
+ 'teacher' => CAP_ALLOW,
+ 'editingteacher' => CAP_ALLOW,
+ 'admin' => CAP_ALLOW
+ ),
+ 'clonepermissionsfrom' => 'mod/quiz:grade'
+ ),
+
// View the quiz reports.
'mod/quiz:viewreports' => array(
'riskbitmask' => RISK_PERSONAL,
<?xml version="1.0" encoding="UTF-8" ?>
-<XMLDB PATH="mod/quiz/db" VERSION="20080725" COMMENT="XMLDB file for Moodle mod/quiz"
+<XMLDB PATH="mod/quiz/db" VERSION="20081121" COMMENT="XMLDB file for Moodle mod/quiz"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="../../../lib/xmldb/xmldb.xsd"
>
<FIELD NAME="name" TYPE="char" LENGTH="255" NOTNULL="false" SEQUENCE="false" ENUM="false" COMMENT="name of the report, same as the directory name" PREVIOUS="id" NEXT="displayorder"/>
<FIELD NAME="displayorder" TYPE="int" LENGTH="10" NOTNULL="true" UNSIGNED="true" SEQUENCE="false" ENUM="false" COMMENT="display order for report tabs" PREVIOUS="name" NEXT="lastcron"/>
<FIELD NAME="lastcron" TYPE="int" LENGTH="10" NOTNULL="true" UNSIGNED="true" DEFAULT="0" SEQUENCE="false" ENUM="false" PREVIOUS="displayorder" NEXT="cron"/>
- <FIELD NAME="cron" TYPE="int" LENGTH="10" NOTNULL="true" UNSIGNED="true" DEFAULT="0" SEQUENCE="false" ENUM="false" COMMENT="0 if there is no cron for this report (default) or the time between crons otherwise." PREVIOUS="lastcron"/>
+ <FIELD NAME="cron" TYPE="int" LENGTH="10" NOTNULL="true" UNSIGNED="true" DEFAULT="0" SEQUENCE="false" ENUM="false" COMMENT="0 if there is no cron for this report (default) or the time between crons otherwise." PREVIOUS="lastcron" NEXT="capability"/>
+ <FIELD NAME="capability" TYPE="char" LENGTH="255" NOTNULL="false" SEQUENCE="false" ENUM="false" PREVIOUS="cron"/>
</FIELDS>
<KEYS>
<KEY NAME="primary" TYPE="primary" FIELDS="id"/>
<SENTENCES>
<SENTENCE TEXT="(name, displayorder) VALUES ('overview', '10000')" />
<SENTENCE TEXT="(name, displayorder) VALUES ('responses', '9000')" />
- <SENTENCE TEXT="(name, displayorder) VALUES ('statistics', '8000')" />
<SENTENCE TEXT="(name, displayorder) VALUES ('grading', '6000')" />
</SENTENCES>
</STATEMENT>
// question type, this is now a no-op.
upgrade_mod_savepoint($result, 2008082600, 'quiz');
}
+
+ if ($result && $oldversion < 2008112101) {
+
+ /// Define field lastcron to be added to quiz_report
+ $table = new xmldb_table('quiz_report');
+ $field = new xmldb_field('capability', XMLDB_TYPE_CHAR, '255', null, null, null, null, null, null, 'cron');
+
+ /// Conditionally launch add field lastcron
+ if (!$dbman->field_exists($table, $field)) {
+ $dbman->add_field($table, $field);
+ }
+
+ /// quiz savepoint reached
+ upgrade_mod_savepoint($result, 2008112101, 'quiz');
+ }
return $result;
}
* @return array all other caps used in module
*/
function quiz_get_extra_capabilities() {
+ global $DB;
$caps = question_get_all_capabilities();
+ $reportcaps = $DB->get_records_select_menu('capabilities', 'name LIKE ?', array('quizreport/%'), 'id,name');
+ $caps = array_merge($caps, $reportcaps);
$caps[] = 'moodle/site:accessallgroups';
return $caps;
}
$id = optional_param('id',0,PARAM_INT); // Course Module ID, or
$q = optional_param('q',0,PARAM_INT); // quiz ID
- $mode = optional_param('mode', 'overview', PARAM_ALPHA); // Report mode
+ $mode = optional_param('mode', '', PARAM_ALPHA); // Report mode
if ($id) {
if (! $cm = get_coursemodule_from_id('quiz', $id)) {
}
}
+
require_login($course, false, $cm);
$context = get_context_instance(CONTEXT_MODULE, $cm->id);
- require_capability('mod/quiz:viewreports', $context);
-
+
+ $reportlist = quiz_report_list($context);
+ if (count($reportlist)==0){
+ print_error('erroraccessingreport', 'quiz');
+ }
+ if ($mode == ''){
+ $mode = reset($reportlist);//first element in array
+ } elseif (!in_array($mode, $reportlist)){
+ print_error('erroraccessingreport', 'quiz');
+ }
+
// if no questions have been set up yet redirect to edit.php
if (!$quiz->questions and has_capability('mod/quiz:manage', $context)) {
redirect('edit.php?cmid='.$cm->id);
echo '<a href="javascript:deselect_all_in(\'DIV\',null,\'tablecontainer\');">'.
get_string('selectnone', 'quiz').'</a> ';
echo ' ';
- if (has_capability('mod/quiz:grade', $this->context)){
+ if (has_capability('mod/quiz:regrade', $this->context)){
echo '<input type="submit" name="regrade" value="'.get_string('regradeselected', 'quiz_overview').'"/>';
}
echo '<input type="submit" onclick="return confirm(\''.$strreallydel.'\');" name="delete" value="'.get_string('deleteselected', 'quiz_overview').'"/>';
}
}
$this->gradedstatesbyattempt = quiz_get_newgraded_states($attemptids, true, 'qs.id, qs.grade, qs.event, qs.question, qs.attempt');
- if (has_capability('mod/quiz:grade', $this->context)){
+ if (has_capability('mod/quiz:regrade', $this->context)){
$this->regradedqs = quiz_get_regraded_qs($attemptids);
}
} else {
$this->gradedstatesbyattempt = quiz_get_newgraded_states($this->sql, true, 'qs.id, qs.grade, qs.event, qs.question, qs.attempt');
- if (has_capability('mod/quiz:grade', $this->context)){
+ if (has_capability('mod/quiz:regrade', $this->context)){
$this->regradedqs = quiz_get_regraded_qs($this->sql);
}
}
$gm = '<span class="highlight">'.quiz_get_grading_option_name($this->_customdata['quiz']->grademethod).'</span>';
$showattemptsgrp[] =& $mform->createElement('advcheckbox', 'qmfilter', get_string('showattempts', 'quiz_overview'), get_string('optonlygradedattempts', 'quiz_overview', $gm), null, array(0,1));
}
- if (has_capability('mod/quiz:grade', $this->_customdata['context'])){
+ if (has_capability('mod/quiz:regrade', $this->_customdata['context'])){
$showattemptsgrp[] =& $mform->createElement('advcheckbox', 'regradefilter', get_string('showattempts', 'quiz_overview'), get_string('optonlyregradedattempts', 'quiz_overview'), null, array(0,1));
}
if ($showattemptsgrp){
$headers = array();
if (!$table->is_downloading()) { //do not print notices when downloading
//regrade buttons
- if (has_capability('mod/quiz:grade', $this->context)){
+ if (has_capability('mod/quiz:regrade', $this->context)){
$countregradeneeded = $this->count_regrade_all_needed($quiz, $groupstudents);
if ($currentgroup){
$a= new object();
$headers[] = $header;
}
}
- if (!$table->is_downloading() && has_capability('mod/quiz:grade', $this->context) && $regradedattempts){
+ if (!$table->is_downloading() && has_capability('mod/quiz:regrade', $this->context) && $regradedattempts){
$columns[] = 'regraded';
$headers[] = get_string('regrade', 'quiz_overview');
}
*/
function regrade_all($dry, $quiz, $groupstudents){
global $DB;
- if (!has_capability('mod/quiz:grade', $this->context)) {
+ if (!has_capability('mod/quiz:regrade', $this->context)) {
notify(get_string('regradenotallowed', 'quiz'));
return true;
}
}
function regrade_all_needed($quiz, $groupstudents){
global $DB;
- if (!has_capability('mod/quiz:grade', $this->context)) {
+ if (!has_capability('mod/quiz:regrade', $this->context)) {
notify(get_string('regradenotallowed', 'quiz'));
return;
}
}
function regrade_selected_attempts($quiz, $attemptids, $groupstudents){
global $DB;
- require_capability('mod/quiz:grade', $this->context);
+ require_capability('mod/quiz:regrade', $this->context);
if ($groupstudents){
list($usql, $params) = $DB->get_in_or_equal($groupstudents);
$where = "qa.userid $usql AND ";
}
return $grade.'%';
}
+/**
+ * Returns an array of reports to which the current user has access to.
+ * Reports are ordered as they should be for display in tabs.
+ */
+function quiz_report_list($context){
+ global $DB;
+ static $reportlist = null;
+ if (!is_null($reportlist)){
+ return $reportlist;
+ }
+ $reports = $DB->get_records('quiz_report', null, 'displayorder DESC', 'name, capability');
+
+ $reportdirs = get_list_of_plugins("mod/quiz/report");
+ //order the reports tab in descending order of displayorder
+ $reportcaps = array();
+ if ($reports){
+ foreach ($reports as $key => $obj) {
+ if (in_array($obj->name, $reportdirs)) {
+ $reportcaps[$obj->name]=$obj->capability;
+ }
+ }
+ }
+
+ //add any other reports on the end
+ foreach ($reportdirs as $reportname) {
+ if (!isset($reportcaps[$reportname])) {
+ $reportcaps[$reportname]= null;
+ }
+ }
+ $reportlist = array();
+ foreach ($reportcaps as $name => $capability){
+ if (empty($capability)){
+ $capability = 'mod/quiz:viewreports';
+ }
+ if ($has = has_capability($capability, $context)){
+ $reportlist[] = $name;
+ }
+ }
+ return $reportlist;
+}
+
?>
--- /dev/null
+<?php
+/**
+ * Capability definitions for the quiz statistics report.
+ *
+ * For naming conventions, see lib/db/access.php.
+ */
+$quizreport_statistics_capabilities = array(
+ 'quizreport/statistics:view' => array(
+ 'captype' => 'read',
+ 'contextlevel' => CONTEXT_MODULE,
+ 'legacy' => array(
+ 'teacher' => CAP_ALLOW,
+ 'editingteacher' => CAP_ALLOW,
+ 'admin' => CAP_ALLOW
+ ),
+ 'clonepermissionsfrom' => 'mod/quiz:viewreports'
+ )
+);
+?>
+
<?xml version="1.0" encoding="UTF-8" ?>
-<XMLDB PATH="mod/quiz/report/statistics/db" VERSION="20081110" COMMENT="XMLDB file for Moodle mod/quiz/report/statistics"
+<XMLDB PATH="mod/quiz/report/statistics/db" VERSION="20081118" COMMENT="XMLDB file for Moodle mod/quiz/report/statistics"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="../../../../../lib/xmldb/xmldb.xsd"
>
</KEYS>
</TABLE>
</TABLES>
+ <STATEMENTS>
+ <STATEMENT NAME="insert quiz_report" TYPE="insert" TABLE="quiz_report" COMMENT="Initial insert of records on table quiz_report">
+ <SENTENCES>
+ <SENTENCE TEXT="(name, displayorder, cron, capability) VALUES ('statistics', 8000, 18000, 'quizreport/statistics:view')" />
+ </SENTENCES>
+ </STATEMENT>
+ </STATEMENTS>
</XMLDB>
\ No newline at end of file
}
}
}
+
+
+ if ($result && $oldversion < 2008112100) {
+ $result = $result && $DB->set_field('quiz_report', 'capability', 'quizreport/statistics:view', array('name'=>'statistics'));
+ }
return $result;
}
}
}
$modcontext = get_context_instance(CONTEXT_MODULE, $cm->id);
-require_capability('mod/quiz:viewreports', $modcontext);
+require_capability('quizreport/statistics:view', $modcontext);
$line = new graph(800,600);
$line->parameter['title'] = '';
<?php
-$plugin->version = 2008111000; // The (date) version of this module
+$plugin->version = 2008112100; // The (date) version of this module
?>
\ No newline at end of file
require_once(dirname(__FILE__) . '/../../config.php');
require_once($CFG->dirroot . '/mod/quiz/locallib.php');
+ require_once($CFG->dirroot . '/mod/quiz/report/reportlib.php');
$attemptid = required_param('attempt', PARAM_INT);
$page = optional_param('page', 0, PARAM_INT);
if ($currenttab == 'info' && count($row) == 1) {
// Don't show only an info tab (e.g. to students).
} else {
+ //$reports is passed in from report.php
$tabs[] = $row;
}
if ($currenttab == 'reports' and isset($mode)) {
$activated[] = 'reports';
- // Standard reports we want to show first.
- $reportrs = $DB->get_recordset('quiz_report', null, 'displayorder DESC', 'id, name');
- // Reports that are restricted by capability.
- $reportrestrictions = array(
- 'regrade' => 'mod/quiz:grade',
- 'grading' => 'mod/quiz:grade'
- );
- $reportdirs = get_list_of_plugins("mod/quiz/report");
- //order the reports tab in descending order of displayorder
- $reportlist = array();
- foreach ($reportrs as $key => $rs) {
- if (in_array($rs->name, $reportdirs)) {
- $reportlist[]=$rs->name;
- }
- }
- //add any other reports on the end
- foreach ($reportdirs as $report) {
- if (!in_array($report, $reportlist)) {
- $reportlist[]=$report;
- }
- }
$row = array();
$currenttab = '';
+
+ $reportlist = quiz_report_list($context);
+
foreach ($reportlist as $report) {
- if (!isset($reportrestrictions[$report]) || has_capability($reportrestrictions[$report], $context)) {
- $row[] = new tabobject($report, "$CFG->wwwroot/mod/quiz/report.php?q=$quiz->id&mode=$report",
- get_string($report, 'quiz_'.$report));
- if ($report == $mode) {
- $currenttab = $report;
- }
+ $row[] = new tabobject($report, "$CFG->wwwroot/mod/quiz/report.php?q=$quiz->id&mode=$report",
+ get_string($report, 'quiz_'.$report));
+ if ($report == $mode) {
+ $currenttab = $report;
}
}
$tabs[] = $row;
// This fragment is called by moodle_needs_upgrading() and /admin/index.php
////////////////////////////////////////////////////////////////////////////////
-$module->version = 2008082600; // The (date) version of this module
+$module->version = 2008112101; // The (date) version of this module
$module->requires = 2008072401; // Requires this Moodle version
$module->cron = 0; // How often should cron check this module (seconds)?