Merge branch 'MDL-60819-35' of https://github.com/snake/moodle into MOODLE_35_STABLE
[moodle.git] / mod / assign / gradingtable.php
blobad5ba632160beb7afca9571338a09ec4ab713db7
1 <?php
2 // This file is part of Moodle - http://moodle.org/
3 //
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
8 //
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 // GNU General Public License for more details.
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle. If not, see <http://www.gnu.org/licenses/>.
17 /**
18 * This file contains the definition for the grading table which subclassses easy_table
20 * @package mod_assign
21 * @copyright 2012 NetSpot {@link http://www.netspot.com.au}
22 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
25 defined('MOODLE_INTERNAL') || die();
27 require_once($CFG->libdir.'/tablelib.php');
28 require_once($CFG->libdir.'/gradelib.php');
29 require_once($CFG->dirroot.'/mod/assign/locallib.php');
31 /**
32 * Extends table_sql to provide a table of assignment submissions
34 * @package mod_assign
35 * @copyright 2012 NetSpot {@link http://www.netspot.com.au}
36 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
38 class assign_grading_table extends table_sql implements renderable {
39 /** @var assign $assignment */
40 private $assignment = null;
41 /** @var int $perpage */
42 private $perpage = 10;
43 /** @var int $rownum (global index of current row in table) */
44 private $rownum = -1;
45 /** @var renderer_base for getting output */
46 private $output = null;
47 /** @var stdClass gradinginfo */
48 private $gradinginfo = null;
49 /** @var int $tablemaxrows */
50 private $tablemaxrows = 10000;
51 /** @var boolean $quickgrading */
52 private $quickgrading = false;
53 /** @var boolean $hasgrantextension - Only do the capability check once for the entire table */
54 private $hasgrantextension = false;
55 /** @var boolean $hasgrade - Only do the capability check once for the entire table */
56 private $hasgrade = false;
57 /** @var array $groupsubmissions - A static cache of group submissions */
58 private $groupsubmissions = array();
59 /** @var array $submissiongroups - A static cache of submission groups */
60 private $submissiongroups = array();
61 /** @var string $plugingradingbatchoperations - List of plugin supported batch operations */
62 public $plugingradingbatchoperations = array();
63 /** @var array $plugincache - A cache of plugin lookups to match a column name to a plugin efficiently */
64 private $plugincache = array();
65 /** @var array $scale - A list of the keys and descriptions for the custom scale */
66 private $scale = null;
68 /**
69 * overridden constructor keeps a reference to the assignment class that is displaying this table
71 * @param assign $assignment The assignment class
72 * @param int $perpage how many per page
73 * @param string $filter The current filter
74 * @param int $rowoffset For showing a subsequent page of results
75 * @param bool $quickgrading Is this table wrapped in a quickgrading form?
76 * @param string $downloadfilename
78 public function __construct(assign $assignment,
79 $perpage,
80 $filter,
81 $rowoffset,
82 $quickgrading,
83 $downloadfilename = null) {
84 global $CFG, $PAGE, $DB, $USER;
85 parent::__construct('mod_assign_grading');
86 $this->is_persistent(true);
87 $this->assignment = $assignment;
89 // Check permissions up front.
90 $this->hasgrantextension = has_capability('mod/assign:grantextension',
91 $this->assignment->get_context());
92 $this->hasgrade = $this->assignment->can_grade();
94 // Check if we have the elevated view capablities to see the blind details.
95 $this->hasviewblind = has_capability('mod/assign:viewblinddetails',
96 $this->assignment->get_context());
98 foreach ($assignment->get_feedback_plugins() as $plugin) {
99 if ($plugin->is_visible() && $plugin->is_enabled()) {
100 foreach ($plugin->get_grading_batch_operations() as $action => $description) {
101 if (empty($this->plugingradingbatchoperations)) {
102 $this->plugingradingbatchoperations[$plugin->get_type()] = array();
104 $this->plugingradingbatchoperations[$plugin->get_type()][$action] = $description;
108 $this->perpage = $perpage;
109 $this->quickgrading = $quickgrading && $this->hasgrade;
110 $this->output = $PAGE->get_renderer('mod_assign');
112 $urlparams = array('action'=>'grading', 'id'=>$assignment->get_course_module()->id);
113 $url = new moodle_url($CFG->wwwroot . '/mod/assign/view.php', $urlparams);
114 $this->define_baseurl($url);
116 // Do some business - then set the sql.
117 $currentgroup = groups_get_activity_group($assignment->get_course_module(), true);
119 if ($rowoffset) {
120 $this->rownum = $rowoffset - 1;
123 $users = array_keys( $assignment->list_participants($currentgroup, true));
124 if (count($users) == 0) {
125 // Insert a record that will never match to the sql is still valid.
126 $users[] = -1;
129 $params = array();
130 $params['assignmentid1'] = (int)$this->assignment->get_instance()->id;
131 $params['assignmentid2'] = (int)$this->assignment->get_instance()->id;
132 $params['assignmentid3'] = (int)$this->assignment->get_instance()->id;
133 $params['newstatus'] = ASSIGN_SUBMISSION_STATUS_NEW;
135 $extrauserfields = get_extra_user_fields($this->assignment->get_context());
137 $fields = user_picture::fields('u', $extrauserfields) . ', ';
138 $fields .= 'u.id as userid, ';
139 $fields .= 's.status as status, ';
140 $fields .= 's.id as submissionid, ';
141 $fields .= 's.timecreated as firstsubmission, ';
142 $fields .= "CASE WHEN status <> :newstatus THEN s.timemodified ELSE NULL END as timesubmitted, ";
143 $fields .= 's.attemptnumber as attemptnumber, ';
144 $fields .= 'g.id as gradeid, ';
145 $fields .= 'g.grade as grade, ';
146 $fields .= 'g.timemodified as timemarked, ';
147 $fields .= 'g.timecreated as firstmarked, ';
148 $fields .= 'uf.mailed as mailed, ';
149 $fields .= 'uf.locked as locked, ';
150 $fields .= 'uf.extensionduedate as extensionduedate, ';
151 $fields .= 'uf.workflowstate as workflowstate, ';
152 $fields .= 'uf.allocatedmarker as allocatedmarker';
154 $from = '{user} u
155 LEFT JOIN {assign_submission} s
156 ON u.id = s.userid
157 AND s.assignment = :assignmentid1
158 AND s.latest = 1
159 LEFT JOIN {assign_grades} g
160 ON u.id = g.userid
161 AND g.assignment = :assignmentid2 ';
163 // For group submissions we don't immediately create an entry in the assign_submission table for each user,
164 // instead the userid is set to 0. In this case we use a different query to retrieve the grade for the user.
165 if ($this->assignment->get_instance()->teamsubmission) {
166 $params['assignmentid4'] = (int) $this->assignment->get_instance()->id;
167 $grademaxattempt = 'SELECT mxg.userid, MAX(mxg.attemptnumber) AS maxattempt
168 FROM {assign_grades} mxg
169 WHERE mxg.assignment = :assignmentid4
170 GROUP BY mxg.userid';
171 $from .= 'LEFT JOIN (' . $grademaxattempt . ') gmx
172 ON u.id = gmx.userid
173 AND g.attemptnumber = gmx.maxattempt ';
174 } else {
175 $from .= 'AND g.attemptnumber = s.attemptnumber ';
178 $from .= 'LEFT JOIN {assign_user_flags} uf
179 ON u.id = uf.userid
180 AND uf.assignment = :assignmentid3 ';
182 $hasoverrides = $this->assignment->has_overrides();
184 if ($hasoverrides) {
185 $params['assignmentid5'] = (int)$this->assignment->get_instance()->id;
186 $params['assignmentid6'] = (int)$this->assignment->get_instance()->id;
187 $params['assignmentid7'] = (int)$this->assignment->get_instance()->id;
188 $params['assignmentid8'] = (int)$this->assignment->get_instance()->id;
189 $params['assignmentid9'] = (int)$this->assignment->get_instance()->id;
191 $fields .= ', priority.priority, ';
192 $fields .= 'effective.allowsubmissionsfromdate, ';
193 $fields .= 'effective.duedate, ';
194 $fields .= 'effective.cutoffdate ';
196 $from .= ' LEFT JOIN (
197 SELECT merged.userid, min(merged.priority) priority FROM (
198 ( SELECT u.id as userid, 9999999 AS priority
199 FROM {user} u
201 UNION
202 ( SELECT uo.userid, 0 AS priority
203 FROM {assign_overrides} uo
204 WHERE uo.assignid = :assignmentid5
206 UNION
207 ( SELECT gm.userid, go.sortorder AS priority
208 FROM {assign_overrides} go
209 JOIN {groups} g ON g.id = go.groupid
210 JOIN {groups_members} gm ON gm.groupid = g.id
211 WHERE go.assignid = :assignmentid6
213 ) merged
214 GROUP BY merged.userid
215 ) priority ON priority.userid = u.id
217 JOIN (
218 (SELECT 9999999 AS priority,
219 u.id AS userid,
220 a.allowsubmissionsfromdate,
221 a.duedate,
222 a.cutoffdate
223 FROM {user} u
224 JOIN {assign} a ON a.id = :assignmentid7
226 UNION
227 (SELECT 0 AS priority,
228 uo.userid,
229 uo.allowsubmissionsfromdate,
230 uo.duedate,
231 uo.cutoffdate
232 FROM {assign_overrides} uo
233 WHERE uo.assignid = :assignmentid8
235 UNION
236 (SELECT go.sortorder AS priority,
237 gm.userid,
238 go.allowsubmissionsfromdate,
239 go.duedate,
240 go.cutoffdate
241 FROM {assign_overrides} go
242 JOIN {groups} g ON g.id = go.groupid
243 JOIN {groups_members} gm ON gm.groupid = g.id
244 WHERE go.assignid = :assignmentid9
247 ) effective ON effective.priority = priority.priority AND effective.userid = priority.userid ';
250 if (!empty($this->assignment->get_instance()->blindmarking)) {
251 $from .= 'LEFT JOIN {assign_user_mapping} um
252 ON u.id = um.userid
253 AND um.assignment = :assignmentidblind ';
254 $params['assignmentidblind'] = (int)$this->assignment->get_instance()->id;
255 $fields .= ', um.id as recordid ';
258 $userparams = array();
259 $userindex = 0;
261 list($userwhere, $userparams) = $DB->get_in_or_equal($users, SQL_PARAMS_NAMED, 'user');
262 $where = 'u.id ' . $userwhere;
263 $params = array_merge($params, $userparams);
265 // The filters do not make sense when there are no submissions, so do not apply them.
266 if ($this->assignment->is_any_submission_plugin_enabled()) {
267 if ($filter == ASSIGN_FILTER_SUBMITTED) {
268 $where .= ' AND (s.timemodified IS NOT NULL AND
269 s.status = :submitted) ';
270 $params['submitted'] = ASSIGN_SUBMISSION_STATUS_SUBMITTED;
272 } else if ($filter == ASSIGN_FILTER_NOT_SUBMITTED) {
273 $where .= ' AND (s.timemodified IS NULL OR s.status <> :submitted) ';
274 $params['submitted'] = ASSIGN_SUBMISSION_STATUS_SUBMITTED;
275 } else if ($filter == ASSIGN_FILTER_REQUIRE_GRADING) {
276 $where .= ' AND (s.timemodified IS NOT NULL AND
277 s.status = :submitted AND
278 (s.timemodified >= g.timemodified OR g.timemodified IS NULL OR g.grade IS NULL';
280 if ($this->assignment->get_grade_item()->gradetype == GRADE_TYPE_SCALE) {
281 // Scale grades are set to -1 when not graded.
282 $where .= ' OR g.grade = -1';
285 $where .= '))';
286 $params['submitted'] = ASSIGN_SUBMISSION_STATUS_SUBMITTED;
288 } else if ($filter == ASSIGN_FILTER_GRANTED_EXTENSION) {
289 $where .= ' AND uf.extensionduedate > 0 ';
291 } else if (strpos($filter, ASSIGN_FILTER_SINGLE_USER) === 0) {
292 $userfilter = (int) array_pop(explode('=', $filter));
293 $where .= ' AND (u.id = :userid)';
294 $params['userid'] = $userfilter;
298 if ($this->assignment->get_instance()->markingworkflow &&
299 $this->assignment->get_instance()->markingallocation) {
300 if (has_capability('mod/assign:manageallocations', $this->assignment->get_context())) {
301 // Check to see if marker filter is set.
302 $markerfilter = (int)get_user_preferences('assign_markerfilter', '');
303 if (!empty($markerfilter)) {
304 if ($markerfilter == ASSIGN_MARKER_FILTER_NO_MARKER) {
305 $where .= ' AND (uf.allocatedmarker IS NULL OR uf.allocatedmarker = 0)';
306 } else {
307 $where .= ' AND uf.allocatedmarker = :markerid';
308 $params['markerid'] = $markerfilter;
314 if ($this->assignment->get_instance()->markingworkflow) {
315 $workflowstates = $this->assignment->get_marking_workflow_states_for_current_user();
316 if (!empty($workflowstates)) {
317 $workflowfilter = get_user_preferences('assign_workflowfilter', '');
318 if ($workflowfilter == ASSIGN_MARKING_WORKFLOW_STATE_NOTMARKED) {
319 $where .= ' AND (uf.workflowstate = :workflowstate OR uf.workflowstate IS NULL OR '.
320 $DB->sql_isempty('assign_user_flags', 'workflowstate', true, true).')';
321 $params['workflowstate'] = $workflowfilter;
322 } else if (array_key_exists($workflowfilter, $workflowstates)) {
323 $where .= ' AND uf.workflowstate = :workflowstate';
324 $params['workflowstate'] = $workflowfilter;
329 $this->set_sql($fields, $from, $where, $params);
331 if ($downloadfilename) {
332 $this->is_downloading('csv', $downloadfilename);
335 $columns = array();
336 $headers = array();
338 // Select.
339 if (!$this->is_downloading() && $this->hasgrade) {
340 $columns[] = 'select';
341 $headers[] = get_string('select') .
342 '<div class="selectall"><label class="accesshide" for="selectall">' . get_string('selectall') . '</label>
343 <input type="checkbox" id="selectall" name="selectall" title="' . get_string('selectall') . '"/></div>';
346 // User picture.
347 if ($this->hasviewblind || !$this->assignment->is_blind_marking()) {
348 if (!$this->is_downloading()) {
349 $columns[] = 'picture';
350 $headers[] = get_string('pictureofuser');
351 } else {
352 $columns[] = 'recordid';
353 $headers[] = get_string('recordid', 'assign');
356 // Fullname.
357 $columns[] = 'fullname';
358 $headers[] = get_string('fullname');
360 // Participant # details if can view real identities.
361 if ($this->assignment->is_blind_marking()) {
362 if (!$this->is_downloading()) {
363 $columns[] = 'recordid';
364 $headers[] = get_string('recordid', 'assign');
368 foreach ($extrauserfields as $extrafield) {
369 $columns[] = $extrafield;
370 $headers[] = get_user_field_name($extrafield);
372 } else {
373 // Record ID.
374 $columns[] = 'recordid';
375 $headers[] = get_string('recordid', 'assign');
378 // Submission status.
379 $columns[] = 'status';
380 $headers[] = get_string('status', 'assign');
382 if ($hasoverrides) {
383 // Allowsubmissionsfromdate.
384 $columns[] = 'allowsubmissionsfromdate';
385 $headers[] = get_string('allowsubmissionsfromdate', 'assign');
387 // Duedate.
388 $columns[] = 'duedate';
389 $headers[] = get_string('duedate', 'assign');
391 // Cutoffdate.
392 $columns[] = 'cutoffdate';
393 $headers[] = get_string('cutoffdate', 'assign');
396 // Team submission columns.
397 if ($assignment->get_instance()->teamsubmission) {
398 $columns[] = 'team';
399 $headers[] = get_string('submissionteam', 'assign');
401 // Allocated marker.
402 if ($this->assignment->get_instance()->markingworkflow &&
403 $this->assignment->get_instance()->markingallocation &&
404 has_capability('mod/assign:manageallocations', $this->assignment->get_context())) {
405 // Add a column for the allocated marker.
406 $columns[] = 'allocatedmarker';
407 $headers[] = get_string('marker', 'assign');
409 // Grade.
410 $columns[] = 'grade';
411 $headers[] = get_string('grade');
412 if ($this->is_downloading()) {
413 if ($this->assignment->get_instance()->grade >= 0) {
414 $columns[] = 'grademax';
415 $headers[] = get_string('maxgrade', 'assign');
416 } else {
417 // This is a custom scale.
418 $columns[] = 'scale';
419 $headers[] = get_string('scale', 'assign');
422 if ($this->assignment->get_instance()->markingworkflow) {
423 // Add a column for the marking workflow state.
424 $columns[] = 'workflowstate';
425 $headers[] = get_string('markingworkflowstate', 'assign');
427 // Add a column for the list of valid marking workflow states.
428 $columns[] = 'gradecanbechanged';
429 $headers[] = get_string('gradecanbechanged', 'assign');
431 if (!$this->is_downloading() && $this->hasgrade) {
432 // We have to call this column userid so we can use userid as a default sortable column.
433 $columns[] = 'userid';
434 $headers[] = get_string('edit');
437 // Submission plugins.
438 if ($assignment->is_any_submission_plugin_enabled()) {
439 $columns[] = 'timesubmitted';
440 $headers[] = get_string('lastmodifiedsubmission', 'assign');
442 foreach ($this->assignment->get_submission_plugins() as $plugin) {
443 if ($this->is_downloading()) {
444 if ($plugin->is_visible() && $plugin->is_enabled()) {
445 foreach ($plugin->get_editor_fields() as $field => $description) {
446 $index = 'plugin' . count($this->plugincache);
447 $this->plugincache[$index] = array($plugin, $field);
448 $columns[] = $index;
449 $headers[] = $plugin->get_name();
452 } else {
453 if ($plugin->is_visible() && $plugin->is_enabled() && $plugin->has_user_summary()) {
454 $index = 'plugin' . count($this->plugincache);
455 $this->plugincache[$index] = array($plugin);
456 $columns[] = $index;
457 $headers[] = $plugin->get_name();
463 // Time marked.
464 $columns[] = 'timemarked';
465 $headers[] = get_string('lastmodifiedgrade', 'assign');
467 // Feedback plugins.
468 foreach ($this->assignment->get_feedback_plugins() as $plugin) {
469 if ($this->is_downloading()) {
470 if ($plugin->is_visible() && $plugin->is_enabled()) {
471 foreach ($plugin->get_editor_fields() as $field => $description) {
472 $index = 'plugin' . count($this->plugincache);
473 $this->plugincache[$index] = array($plugin, $field);
474 $columns[] = $index;
475 $headers[] = $description;
478 } else if ($plugin->is_visible() && $plugin->is_enabled() && $plugin->has_user_summary()) {
479 $index = 'plugin' . count($this->plugincache);
480 $this->plugincache[$index] = array($plugin);
481 $columns[] = $index;
482 $headers[] = $plugin->get_name();
486 // Exclude 'Final grade' column in downloaded grading worksheets.
487 if (!$this->is_downloading()) {
488 // Final grade.
489 $columns[] = 'finalgrade';
490 $headers[] = get_string('finalgrade', 'grades');
493 // Load the grading info for all users.
494 $this->gradinginfo = grade_get_grades($this->assignment->get_course()->id,
495 'mod',
496 'assign',
497 $this->assignment->get_instance()->id,
498 $users);
500 if (!empty($CFG->enableoutcomes) && !empty($this->gradinginfo->outcomes)) {
501 $columns[] = 'outcomes';
502 $headers[] = get_string('outcomes', 'grades');
505 // Set the columns.
506 $this->define_columns($columns);
507 $this->define_headers($headers);
508 foreach ($extrauserfields as $extrafield) {
509 $this->column_class($extrafield, $extrafield);
511 $this->no_sorting('recordid');
512 $this->no_sorting('finalgrade');
513 $this->no_sorting('userid');
514 $this->no_sorting('select');
515 $this->no_sorting('outcomes');
517 if ($assignment->get_instance()->teamsubmission) {
518 $this->no_sorting('team');
521 $plugincolumnindex = 0;
522 foreach ($this->assignment->get_submission_plugins() as $plugin) {
523 if ($plugin->is_visible() && $plugin->is_enabled() && $plugin->has_user_summary()) {
524 $submissionpluginindex = 'plugin' . $plugincolumnindex++;
525 $this->no_sorting($submissionpluginindex);
528 foreach ($this->assignment->get_feedback_plugins() as $plugin) {
529 if ($plugin->is_visible() && $plugin->is_enabled() && $plugin->has_user_summary()) {
530 $feedbackpluginindex = 'plugin' . $plugincolumnindex++;
531 $this->no_sorting($feedbackpluginindex);
535 // When there is no data we still want the column headers printed in the csv file.
536 if ($this->is_downloading()) {
537 $this->start_output();
542 * Before adding each row to the table make sure rownum is incremented.
544 * @param array $row row of data from db used to make one row of the table.
545 * @return array one row for the table
547 public function format_row($row) {
548 if ($this->rownum < 0) {
549 $this->rownum = $this->currpage * $this->pagesize;
550 } else {
551 $this->rownum += 1;
554 return parent::format_row($row);
558 * Add a column with an ID that uniquely identifies this user in this assignment.
560 * @param stdClass $row
561 * @return string
563 public function col_recordid(stdClass $row) {
564 if (empty($row->recordid)) {
565 $row->recordid = $this->assignment->get_uniqueid_for_user($row->userid);
567 return get_string('hiddenuser', 'assign') . $row->recordid;
572 * Add the userid to the row class so it can be updated via ajax.
574 * @param stdClass $row The row of data
575 * @return string The row class
577 public function get_row_class($row) {
578 return 'user' . $row->userid;
582 * Return the number of rows to display on a single page.
584 * @return int The number of rows per page
586 public function get_rows_per_page() {
587 return $this->perpage;
591 * list current marking workflow state
593 * @param stdClass $row
594 * @return string
596 public function col_workflowstatus(stdClass $row) {
597 $o = '';
599 $gradingdisabled = $this->assignment->grading_disabled($row->id);
600 // The function in the assignment keeps a static cache of this list of states.
601 $workflowstates = $this->assignment->get_marking_workflow_states_for_current_user();
602 $workflowstate = $row->workflowstate;
603 if (empty($workflowstate)) {
604 $workflowstate = ASSIGN_MARKING_WORKFLOW_STATE_NOTMARKED;
606 if ($this->quickgrading && !$gradingdisabled) {
607 $notmarked = get_string('markingworkflowstatenotmarked', 'assign');
608 $name = 'quickgrade_' . $row->id . '_workflowstate';
609 $o .= html_writer::select($workflowstates, $name, $workflowstate, array('' => $notmarked));
610 // Check if this user is a marker that can't manage allocations and doesn't have the marker column added.
611 if ($this->assignment->get_instance()->markingworkflow &&
612 $this->assignment->get_instance()->markingallocation &&
613 !has_capability('mod/assign:manageallocations', $this->assignment->get_context())) {
615 $name = 'quickgrade_' . $row->id . '_allocatedmarker';
616 $o .= html_writer::empty_tag('input', array('type' => 'hidden', 'name' => $name,
617 'value' => $row->allocatedmarker));
619 } else {
620 $o .= $this->output->container(get_string('markingworkflowstate' . $workflowstate, 'assign'), $workflowstate);
622 return $o;
626 * For download only - list current marking workflow state
628 * @param stdClass $row - The row of data
629 * @return string The current marking workflow state
631 public function col_workflowstate($row) {
632 $state = $row->workflowstate;
633 if (empty($state)) {
634 $state = ASSIGN_MARKING_WORKFLOW_STATE_NOTMARKED;
637 return get_string('markingworkflowstate' . $state, 'assign');
641 * list current marker
643 * @param stdClass $row - The row of data
644 * @return id the user->id of the marker.
646 public function col_allocatedmarker(stdClass $row) {
647 static $markers = null;
648 static $markerlist = array();
649 if ($markers === null) {
650 list($sort, $params) = users_order_by_sql('u');
651 // Only enrolled users could be assigned as potential markers.
652 $markers = get_enrolled_users($this->assignment->get_context(), 'mod/assign:grade', 0, 'u.*', $sort);
653 $markerlist[0] = get_string('choosemarker', 'assign');
654 $viewfullnames = has_capability('moodle/site:viewfullnames', $this->assignment->get_context());
655 foreach ($markers as $marker) {
656 $markerlist[$marker->id] = fullname($marker, $viewfullnames);
659 if (empty($markerlist)) {
660 // TODO: add some form of notification here that no markers are available.
661 return '';
663 if ($this->is_downloading()) {
664 if (isset($markers[$row->allocatedmarker])) {
665 return fullname($markers[$row->allocatedmarker],
666 has_capability('moodle/site:viewfullnames', $this->assignment->get_context()));
667 } else {
668 return '';
672 if ($this->quickgrading && has_capability('mod/assign:manageallocations', $this->assignment->get_context()) &&
673 (empty($row->workflowstate) ||
674 $row->workflowstate == ASSIGN_MARKING_WORKFLOW_STATE_INMARKING ||
675 $row->workflowstate == ASSIGN_MARKING_WORKFLOW_STATE_NOTMARKED)) {
677 $name = 'quickgrade_' . $row->id . '_allocatedmarker';
678 return html_writer::select($markerlist, $name, $row->allocatedmarker, false);
679 } else if (!empty($row->allocatedmarker)) {
680 $output = '';
681 if ($this->quickgrading) { // Add hidden field for quickgrading page.
682 $name = 'quickgrade_' . $row->id . '_allocatedmarker';
683 $output .= html_writer::empty_tag('input', array('type'=>'hidden', 'name'=>$name, 'value'=>$row->allocatedmarker));
685 $output .= $markerlist[$row->allocatedmarker];
686 return $output;
690 * For download only - list all the valid options for this custom scale.
692 * @param stdClass $row - The row of data
693 * @return string A list of valid options for the current scale
695 public function col_scale($row) {
696 global $DB;
698 if (empty($this->scale)) {
699 $dbparams = array('id'=>-($this->assignment->get_instance()->grade));
700 $this->scale = $DB->get_record('scale', $dbparams);
703 if (!empty($this->scale->scale)) {
704 return implode("\n", explode(',', $this->scale->scale));
706 return '';
710 * Display a grade with scales etc.
712 * @param string $grade
713 * @param boolean $editable
714 * @param int $userid The user id of the user this grade belongs to
715 * @param int $modified Timestamp showing when the grade was last modified
716 * @return string The formatted grade
718 public function display_grade($grade, $editable, $userid, $modified) {
719 if ($this->is_downloading()) {
720 if ($this->assignment->get_instance()->grade >= 0) {
721 if ($grade == -1 || $grade === null) {
722 return '';
724 $gradeitem = $this->assignment->get_grade_item();
725 return format_float($grade, $gradeitem->get_decimals());
726 } else {
727 // This is a custom scale.
728 $scale = $this->assignment->display_grade($grade, false);
729 if ($scale == '-') {
730 $scale = '';
732 return $scale;
735 return $this->assignment->display_grade($grade, $editable, $userid, $modified);
739 * Get the team info for this user.
741 * @param stdClass $row
742 * @return string The team name
744 public function col_team(stdClass $row) {
745 $submission = false;
746 $group = false;
747 $this->get_group_and_submission($row->id, $group, $submission, -1);
748 if ($group) {
749 return $group->name;
750 } else if ($this->assignment->get_instance()->preventsubmissionnotingroup) {
751 $usergroups = $this->assignment->get_all_groups($row->id);
752 if (count($usergroups) > 1) {
753 return get_string('multipleteamsgrader', 'assign');
754 } else {
755 return get_string('noteamgrader', 'assign');
758 return get_string('defaultteam', 'assign');
762 * Use a static cache to try and reduce DB calls.
764 * @param int $userid The user id for this submission
765 * @param int $group The groupid (returned)
766 * @param stdClass|false $submission The stdClass submission or false (returned)
767 * @param int $attemptnumber Return a specific attempt number (-1 for latest)
769 protected function get_group_and_submission($userid, &$group, &$submission, $attemptnumber) {
770 $group = false;
771 if (isset($this->submissiongroups[$userid])) {
772 $group = $this->submissiongroups[$userid];
773 } else {
774 $group = $this->assignment->get_submission_group($userid, false);
775 $this->submissiongroups[$userid] = $group;
778 $groupid = 0;
779 if ($group) {
780 $groupid = $group->id;
783 // Static cache is keyed by groupid and attemptnumber.
784 // We may need both the latest and previous attempt in the same page.
785 if (isset($this->groupsubmissions[$groupid . ':' . $attemptnumber])) {
786 $submission = $this->groupsubmissions[$groupid . ':' . $attemptnumber];
787 } else {
788 $submission = $this->assignment->get_group_submission($userid, $groupid, false, $attemptnumber);
789 $this->groupsubmissions[$groupid . ':' . $attemptnumber] = $submission;
794 * Format a list of outcomes.
796 * @param stdClass $row
797 * @return string
799 public function col_outcomes(stdClass $row) {
800 $outcomes = '';
801 foreach ($this->gradinginfo->outcomes as $index => $outcome) {
802 $options = make_grades_menu(-$outcome->scaleid);
804 $options[0] = get_string('nooutcome', 'grades');
805 if ($this->quickgrading && !($outcome->grades[$row->userid]->locked)) {
806 $select = '<select name="outcome_' . $index . '_' . $row->userid . '" class="quickgrade">';
807 foreach ($options as $optionindex => $optionvalue) {
808 $selected = '';
809 if ($outcome->grades[$row->userid]->grade == $optionindex) {
810 $selected = 'selected="selected"';
812 $select .= '<option value="' . $optionindex . '"' . $selected . '>' . $optionvalue . '</option>';
814 $select .= '</select>';
815 $outcomes .= $this->output->container($outcome->name . ': ' . $select, 'outcome');
816 } else {
817 $name = $outcome->name . ': ' . $options[$outcome->grades[$row->userid]->grade];
818 if ($this->is_downloading()) {
819 $outcomes .= $name;
820 } else {
821 $outcomes .= $this->output->container($name, 'outcome');
826 return $outcomes;
831 * Format a user picture for display.
833 * @param stdClass $row
834 * @return string
836 public function col_picture(stdClass $row) {
837 return $this->output->user_picture($row);
841 * Format a user record for display (link to profile).
843 * @param stdClass $row
844 * @return string
846 public function col_fullname($row) {
847 if (!$this->is_downloading()) {
848 $courseid = $this->assignment->get_course()->id;
849 $link= new moodle_url('/user/view.php', array('id' =>$row->id, 'course'=>$courseid));
850 $fullname = $this->output->action_link($link, $this->assignment->fullname($row));
851 } else {
852 $fullname = $this->assignment->fullname($row);
855 if (!$this->assignment->is_active_user($row->id)) {
856 $suspendedstring = get_string('userenrolmentsuspended', 'grades');
857 $fullname .= ' ' . $this->output->pix_icon('i/enrolmentsuspended', $suspendedstring);
858 $fullname = html_writer::tag('span', $fullname, array('class' => 'usersuspended'));
860 return $fullname;
864 * Insert a checkbox for selecting the current row for batch operations.
866 * @param stdClass $row
867 * @return string
869 public function col_select(stdClass $row) {
870 $selectcol = '<label class="accesshide" for="selectuser_' . $row->userid . '">';
871 $selectcol .= get_string('selectuser', 'assign', $this->assignment->fullname($row));
872 $selectcol .= '</label>';
873 $selectcol .= '<input type="checkbox"
874 id="selectuser_' . $row->userid . '"
875 name="selectedusers"
876 value="' . $row->userid . '"/>';
877 $selectcol .= '<input type="hidden"
878 name="grademodified_' . $row->userid . '"
879 value="' . $row->timemarked . '"/>';
880 $selectcol .= '<input type="hidden"
881 name="gradeattempt_' . $row->userid . '"
882 value="' . $row->attemptnumber . '"/>';
883 return $selectcol;
887 * Return a users grades from the listing of all grade data for this assignment.
889 * @param int $userid
890 * @return mixed stdClass or false
892 private function get_gradebook_data_for_user($userid) {
893 if (isset($this->gradinginfo->items[0]) && $this->gradinginfo->items[0]->grades[$userid]) {
894 return $this->gradinginfo->items[0]->grades[$userid];
896 return false;
900 * Format a column of data for display.
902 * @param stdClass $row
903 * @return string
905 public function col_gradecanbechanged(stdClass $row) {
906 $gradingdisabled = $this->assignment->grading_disabled($row->id);
907 if ($gradingdisabled) {
908 return get_string('no');
909 } else {
910 return get_string('yes');
915 * Format a column of data for display
917 * @param stdClass $row
918 * @return string
920 public function col_grademax(stdClass $row) {
921 $gradeitem = $this->assignment->get_grade_item();
922 return format_float($this->assignment->get_instance()->grade, $gradeitem->get_decimals());
926 * Format a column of data for display.
928 * @param stdClass $row
929 * @return string
931 public function col_grade(stdClass $row) {
932 $o = '';
934 $link = '';
935 $separator = $this->output->spacer(array(), true);
936 $grade = '';
937 $gradingdisabled = $this->assignment->grading_disabled($row->id);
939 if (!$this->is_downloading() && $this->hasgrade) {
940 $urlparams = array('id' => $this->assignment->get_course_module()->id,
941 'rownum' => 0,
942 'action' => 'grader');
944 if ($this->assignment->is_blind_marking()) {
945 if (empty($row->recordid)) {
946 $row->recordid = $this->assignment->get_uniqueid_for_user($row->userid);
948 $urlparams['blindid'] = $row->recordid;
949 } else {
950 $urlparams['userid'] = $row->userid;
953 $url = new moodle_url('/mod/assign/view.php', $urlparams);
954 $link = '<a href="' . $url . '" class="btn btn-primary">' . get_string('grade') . '</a>';
955 $grade .= $link . $separator;
958 $grade .= $this->display_grade($row->grade,
959 $this->quickgrading && !$gradingdisabled,
960 $row->userid,
961 $row->timemarked);
963 return $grade;
967 * Format a column of data for display.
969 * @param stdClass $row
970 * @return string
972 public function col_finalgrade(stdClass $row) {
973 $o = '';
975 $grade = $this->get_gradebook_data_for_user($row->userid);
976 if ($grade) {
977 $o = $this->display_grade($grade->grade, false, $row->userid, $row->timemarked);
980 return $o;
984 * Format a column of data for display.
986 * @param stdClass $row
987 * @return string
989 public function col_timemarked(stdClass $row) {
990 $o = '-';
992 if ($row->timemarked && $row->grade !== null && $row->grade >= 0) {
993 $o = userdate($row->timemarked);
995 if ($row->timemarked && $this->is_downloading()) {
996 // Force it for downloads as it affects import.
997 $o = userdate($row->timemarked);
1000 return $o;
1004 * Format a column of data for display.
1006 * @param stdClass $row
1007 * @return string
1009 public function col_timesubmitted(stdClass $row) {
1010 $o = '-';
1012 $group = false;
1013 $submission = false;
1014 $this->get_group_and_submission($row->id, $group, $submission, -1);
1015 if ($submission && $submission->timemodified && $submission->status != ASSIGN_SUBMISSION_STATUS_NEW) {
1016 $o = userdate($submission->timemodified);
1017 } else if ($row->timesubmitted && $row->status != ASSIGN_SUBMISSION_STATUS_NEW) {
1018 $o = userdate($row->timesubmitted);
1021 return $o;
1025 * Format a column of data for display
1027 * @param stdClass $row
1028 * @return string
1030 public function col_status(stdClass $row) {
1031 $o = '';
1033 $instance = $this->assignment->get_instance();
1035 $due = $instance->duedate;
1036 if ($row->extensionduedate) {
1037 $due = $row->extensionduedate;
1038 } else if (!empty($row->duedate)) {
1039 // The override due date.
1040 $due = $row->duedate;
1043 $group = false;
1044 $submission = false;
1046 if ($instance->teamsubmission) {
1047 $this->get_group_and_submission($row->id, $group, $submission, -1);
1050 if ($instance->teamsubmission && !$group && !$instance->preventsubmissionnotingroup) {
1051 $group = true;
1054 if ($group && $submission) {
1055 $timesubmitted = $submission->timemodified;
1056 $status = $submission->status;
1057 } else {
1058 $timesubmitted = $row->timesubmitted;
1059 $status = $row->status;
1062 $displaystatus = $status;
1063 if ($displaystatus == 'new') {
1064 $displaystatus = '';
1067 if ($this->assignment->is_any_submission_plugin_enabled()) {
1069 $o .= $this->output->container(get_string('submissionstatus_' . $displaystatus, 'assign'),
1070 array('class'=>'submissionstatus' .$displaystatus));
1071 if ($due && $timesubmitted > $due && $status != ASSIGN_SUBMISSION_STATUS_NEW) {
1072 $usertime = format_time($timesubmitted - $due);
1073 $latemessage = get_string('submittedlateshort',
1074 'assign',
1075 $usertime);
1076 $o .= $this->output->container($latemessage, 'latesubmission');
1078 if ($row->locked) {
1079 $lockedstr = get_string('submissionslockedshort', 'assign');
1080 $o .= $this->output->container($lockedstr, 'lockedsubmission');
1083 // Add status of "grading" if markflow is not enabled.
1084 if (!$instance->markingworkflow) {
1085 if ($row->grade !== null && $row->grade >= 0) {
1086 $o .= $this->output->container(get_string('graded', 'assign'), 'submissiongraded');
1087 } else if (!$timesubmitted || $status == ASSIGN_SUBMISSION_STATUS_NEW) {
1088 $now = time();
1089 if ($due && ($now > $due)) {
1090 $overduestr = get_string('overdue', 'assign', format_time($now - $due));
1091 $o .= $this->output->container($overduestr, 'overduesubmission');
1097 if ($instance->markingworkflow) {
1098 $o .= $this->col_workflowstatus($row);
1100 if ($row->extensionduedate) {
1101 $userdate = userdate($row->extensionduedate);
1102 $extensionstr = get_string('userextensiondate', 'assign', $userdate);
1103 $o .= $this->output->container($extensionstr, 'extensiondate');
1106 if ($this->is_downloading()) {
1107 $o = strip_tags(rtrim(str_replace('</div>', ' - ', $o), '- '));
1110 return $o;
1114 * Format a column of data for display.
1116 * @param stdClass $row
1117 * @return string
1119 public function col_allowsubmissionsfromdate(stdClass $row) {
1120 $o = '';
1122 if ($row->allowsubmissionsfromdate) {
1123 $userdate = userdate($row->allowsubmissionsfromdate);
1124 $o = $this->output->container($userdate, 'allowsubmissionsfromdate');
1127 return $o;
1132 * Format a column of data for display.
1134 * @param stdClass $row
1135 * @return string
1137 public function col_duedate(stdClass $row) {
1138 $o = '';
1140 if ($row->duedate) {
1141 $userdate = userdate($row->duedate);
1142 $o = $this->output->container($userdate, 'duedate');
1145 return $o;
1150 * Format a column of data for display.
1152 * @param stdClass $row
1153 * @return string
1155 public function col_cutoffdate(stdClass $row) {
1156 $o = '';
1158 if ($row->cutoffdate) {
1159 $userdate = userdate($row->cutoffdate);
1160 $o = $this->output->container($userdate, 'cutoffdate');
1163 return $o;
1168 * Format a column of data for display.
1170 * @param stdClass $row
1171 * @return string
1173 public function col_userid(stdClass $row) {
1174 global $USER;
1176 $edit = '';
1178 $actions = array();
1180 $urlparams = array('id' => $this->assignment->get_course_module()->id,
1181 'rownum' => 0,
1182 'action' => 'grader');
1184 if ($this->assignment->is_blind_marking()) {
1185 if (empty($row->recordid)) {
1186 $row->recordid = $this->assignment->get_uniqueid_for_user($row->userid);
1188 $urlparams['blindid'] = $row->recordid;
1189 } else {
1190 $urlparams['userid'] = $row->userid;
1192 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1193 $noimage = null;
1195 if (!$row->grade) {
1196 $description = get_string('grade');
1197 } else {
1198 $description = get_string('updategrade', 'assign');
1200 $actions['grade'] = new action_menu_link_secondary(
1201 $url,
1202 $noimage,
1203 $description
1206 // Everything we need is in the row.
1207 $submission = $row;
1208 $flags = $row;
1209 if ($this->assignment->get_instance()->teamsubmission) {
1210 // Use the cache for this.
1211 $submission = false;
1212 $group = false;
1213 $this->get_group_and_submission($row->id, $group, $submission, -1);
1216 $submissionsopen = $this->assignment->submissions_open($row->id,
1217 true,
1218 $submission,
1219 $flags,
1220 $this->gradinginfo);
1221 $caneditsubmission = $this->assignment->can_edit_submission($row->id, $USER->id);
1223 // Hide for offline assignments.
1224 if ($this->assignment->is_any_submission_plugin_enabled()) {
1225 if (!$row->status ||
1226 $row->status == ASSIGN_SUBMISSION_STATUS_DRAFT ||
1227 !$this->assignment->get_instance()->submissiondrafts) {
1229 if (!$row->locked) {
1230 $urlparams = array('id' => $this->assignment->get_course_module()->id,
1231 'userid'=>$row->id,
1232 'action'=>'lock',
1233 'sesskey'=>sesskey(),
1234 'page'=>$this->currpage);
1235 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1237 $description = get_string('preventsubmissionsshort', 'assign');
1238 $actions['lock'] = new action_menu_link_secondary(
1239 $url,
1240 $noimage,
1241 $description
1243 } else {
1244 $urlparams = array('id' => $this->assignment->get_course_module()->id,
1245 'userid'=>$row->id,
1246 'action'=>'unlock',
1247 'sesskey'=>sesskey(),
1248 'page'=>$this->currpage);
1249 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1250 $description = get_string('allowsubmissionsshort', 'assign');
1251 $actions['unlock'] = new action_menu_link_secondary(
1252 $url,
1253 $noimage,
1254 $description
1259 if ($submissionsopen &&
1260 $USER->id != $row->id &&
1261 $caneditsubmission) {
1262 $urlparams = array('id' => $this->assignment->get_course_module()->id,
1263 'userid'=>$row->id,
1264 'action'=>'editsubmission',
1265 'sesskey'=>sesskey(),
1266 'page'=>$this->currpage);
1267 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1268 $description = get_string('editsubmission', 'assign');
1269 $actions['editsubmission'] = new action_menu_link_secondary(
1270 $url,
1271 $noimage,
1272 $description
1276 if (($this->assignment->get_instance()->duedate ||
1277 $this->assignment->get_instance()->cutoffdate) &&
1278 $this->hasgrantextension) {
1279 $urlparams = array('id' => $this->assignment->get_course_module()->id,
1280 'userid' => $row->id,
1281 'action' => 'grantextension',
1282 'sesskey' => sesskey(),
1283 'page' => $this->currpage);
1284 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1285 $description = get_string('grantextension', 'assign');
1286 $actions['grantextension'] = new action_menu_link_secondary(
1287 $url,
1288 $noimage,
1289 $description
1292 if ($row->status == ASSIGN_SUBMISSION_STATUS_SUBMITTED &&
1293 $this->assignment->get_instance()->submissiondrafts) {
1294 $urlparams = array('id' => $this->assignment->get_course_module()->id,
1295 'userid'=>$row->id,
1296 'action'=>'reverttodraft',
1297 'sesskey'=>sesskey(),
1298 'page'=>$this->currpage);
1299 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1300 $description = get_string('reverttodraftshort', 'assign');
1301 $actions['reverttodraft'] = new action_menu_link_secondary(
1302 $url,
1303 $noimage,
1304 $description
1307 if ($row->status == ASSIGN_SUBMISSION_STATUS_DRAFT &&
1308 $this->assignment->get_instance()->submissiondrafts &&
1309 $caneditsubmission &&
1310 $submissionsopen &&
1311 $row->id != $USER->id) {
1312 $urlparams = array('id' => $this->assignment->get_course_module()->id,
1313 'userid'=>$row->id,
1314 'action'=>'submitotherforgrading',
1315 'sesskey'=>sesskey(),
1316 'page'=>$this->currpage);
1317 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1318 $description = get_string('submitforgrading', 'assign');
1319 $actions['submitforgrading'] = new action_menu_link_secondary(
1320 $url,
1321 $noimage,
1322 $description
1326 $ismanual = $this->assignment->get_instance()->attemptreopenmethod == ASSIGN_ATTEMPT_REOPEN_METHOD_MANUAL;
1327 $hassubmission = !empty($row->status);
1328 $notreopened = $hassubmission && $row->status != ASSIGN_SUBMISSION_STATUS_REOPENED;
1329 $isunlimited = $this->assignment->get_instance()->maxattempts == ASSIGN_UNLIMITED_ATTEMPTS;
1330 $hasattempts = $isunlimited || $row->attemptnumber < $this->assignment->get_instance()->maxattempts - 1;
1332 if ($ismanual && $hassubmission && $notreopened && $hasattempts) {
1333 $urlparams = array('id' => $this->assignment->get_course_module()->id,
1334 'userid'=>$row->id,
1335 'action'=>'addattempt',
1336 'sesskey'=>sesskey(),
1337 'page'=>$this->currpage);
1338 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1339 $description = get_string('addattempt', 'assign');
1340 $actions['addattempt'] = new action_menu_link_secondary(
1341 $url,
1342 $noimage,
1343 $description
1347 $menu = new action_menu();
1348 $menu->set_owner_selector('.gradingtable-actionmenu');
1349 $menu->set_alignment(action_menu::TL, action_menu::BL);
1350 $menu->set_constraint('.gradingtable > .no-overflow');
1351 $menu->set_menu_trigger(get_string('edit'));
1352 foreach ($actions as $action) {
1353 $menu->add($action);
1356 // Prioritise the menu ahead of all other actions.
1357 $menu->prioritise = true;
1359 $edit .= $this->output->render($menu);
1361 return $edit;
1365 * Write the plugin summary with an optional link to view the full feedback/submission.
1367 * @param assign_plugin $plugin Submission plugin or feedback plugin
1368 * @param stdClass $item Submission or grade
1369 * @param string $returnaction The return action to pass to the
1370 * view_submission page (the current page)
1371 * @param string $returnparams The return params to pass to the view_submission
1372 * page (the current page)
1373 * @return string The summary with an optional link
1375 private function format_plugin_summary_with_link(assign_plugin $plugin,
1376 stdClass $item,
1377 $returnaction,
1378 $returnparams) {
1379 $link = '';
1380 $showviewlink = false;
1382 $summary = $plugin->view_summary($item, $showviewlink);
1383 $separator = '';
1384 if ($showviewlink) {
1385 $viewstr = get_string('view' . substr($plugin->get_subtype(), strlen('assign')), 'assign');
1386 $icon = $this->output->pix_icon('t/preview', $viewstr);
1387 $urlparams = array('id' => $this->assignment->get_course_module()->id,
1388 'sid'=>$item->id,
1389 'gid'=>$item->id,
1390 'plugin'=>$plugin->get_type(),
1391 'action'=>'viewplugin' . $plugin->get_subtype(),
1392 'returnaction'=>$returnaction,
1393 'returnparams'=>http_build_query($returnparams));
1394 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1395 $link = $this->output->action_link($url, $icon);
1396 $separator = $this->output->spacer(array(), true);
1399 return $link . $separator . $summary;
1404 * Format the submission and feedback columns.
1406 * @param string $colname The column name
1407 * @param stdClass $row The submission row
1408 * @return mixed string or NULL
1410 public function other_cols($colname, $row) {
1411 // For extra user fields the result is already in $row.
1412 if (empty($this->plugincache[$colname])) {
1413 return $row->$colname;
1416 // This must be a plugin field.
1417 $plugincache = $this->plugincache[$colname];
1419 $plugin = $plugincache[0];
1421 $field = null;
1422 if (isset($plugincache[1])) {
1423 $field = $plugincache[1];
1426 if ($plugin->is_visible() && $plugin->is_enabled()) {
1427 if ($plugin->get_subtype() == 'assignsubmission') {
1428 if ($this->assignment->get_instance()->teamsubmission) {
1429 $group = false;
1430 $submission = false;
1432 $this->get_group_and_submission($row->id, $group, $submission, -1);
1433 if ($submission) {
1434 if ($submission->status == ASSIGN_SUBMISSION_STATUS_REOPENED) {
1435 // For a newly reopened submission - we want to show the previous submission in the table.
1436 $this->get_group_and_submission($row->id, $group, $submission, $submission->attemptnumber-1);
1438 if (isset($field)) {
1439 return $plugin->get_editor_text($field, $submission->id);
1441 return $this->format_plugin_summary_with_link($plugin,
1442 $submission,
1443 'grading',
1444 array());
1446 } else if ($row->submissionid) {
1447 if ($row->status == ASSIGN_SUBMISSION_STATUS_REOPENED) {
1448 // For a newly reopened submission - we want to show the previous submission in the table.
1449 $submission = $this->assignment->get_user_submission($row->userid, false, $row->attemptnumber - 1);
1450 } else {
1451 $submission = new stdClass();
1452 $submission->id = $row->submissionid;
1453 $submission->timecreated = $row->firstsubmission;
1454 $submission->timemodified = $row->timesubmitted;
1455 $submission->assignment = $this->assignment->get_instance()->id;
1456 $submission->userid = $row->userid;
1457 $submission->attemptnumber = $row->attemptnumber;
1459 // Field is used for only for import/export and refers the the fieldname for the text editor.
1460 if (isset($field)) {
1461 return $plugin->get_editor_text($field, $submission->id);
1463 return $this->format_plugin_summary_with_link($plugin,
1464 $submission,
1465 'grading',
1466 array());
1468 } else {
1469 $grade = null;
1470 if (isset($field)) {
1471 return $plugin->get_editor_text($field, $row->gradeid);
1474 if ($row->gradeid) {
1475 $grade = new stdClass();
1476 $grade->id = $row->gradeid;
1477 $grade->timecreated = $row->firstmarked;
1478 $grade->timemodified = $row->timemarked;
1479 $grade->assignment = $this->assignment->get_instance()->id;
1480 $grade->userid = $row->userid;
1481 $grade->grade = $row->grade;
1482 $grade->mailed = $row->mailed;
1483 $grade->attemptnumber = $row->attemptnumber;
1485 if ($this->quickgrading && $plugin->supports_quickgrading()) {
1486 return $plugin->get_quickgrading_html($row->userid, $grade);
1487 } else if ($grade) {
1488 return $this->format_plugin_summary_with_link($plugin,
1489 $grade,
1490 'grading',
1491 array());
1495 return '';
1499 * Using the current filtering and sorting - load all rows and return a single column from them.
1501 * @param string $columnname The name of the raw column data
1502 * @return array of data
1504 public function get_column_data($columnname) {
1505 $this->setup();
1506 $this->currpage = 0;
1507 $this->query_db($this->tablemaxrows);
1508 $result = array();
1509 foreach ($this->rawdata as $row) {
1510 $result[] = $row->$columnname;
1512 return $result;
1516 * Return things to the renderer.
1518 * @return string the assignment name
1520 public function get_assignment_name() {
1521 return $this->assignment->get_instance()->name;
1525 * Return things to the renderer.
1527 * @return int the course module id
1529 public function get_course_module_id() {
1530 return $this->assignment->get_course_module()->id;
1534 * Return things to the renderer.
1536 * @return int the course id
1538 public function get_course_id() {
1539 return $this->assignment->get_course()->id;
1543 * Return things to the renderer.
1545 * @return stdClass The course context
1547 public function get_course_context() {
1548 return $this->assignment->get_course_context();
1552 * Return things to the renderer.
1554 * @return bool Does this assignment accept submissions
1556 public function submissions_enabled() {
1557 return $this->assignment->is_any_submission_plugin_enabled();
1561 * Return things to the renderer.
1563 * @return bool Can this user view all grades (the gradebook)
1565 public function can_view_all_grades() {
1566 $context = $this->assignment->get_course_context();
1567 return has_capability('gradereport/grader:view', $context) &&
1568 has_capability('moodle/grade:viewall', $context);
1572 * Always return a valid sort - even if the userid column is missing.
1573 * @return array column name => SORT_... constant.
1575 public function get_sort_columns() {
1576 $result = parent::get_sort_columns();
1578 $assignment = $this->assignment->get_instance();
1579 if (empty($assignment->blindmarking)) {
1580 $result = array_merge($result, array('userid' => SORT_ASC));
1581 } else {
1582 $result = array_merge($result, [
1583 'COALESCE(s.timecreated, ' . time() . ')' => SORT_ASC,
1584 'COALESCE(s.id, ' . PHP_INT_MAX . ')' => SORT_ASC,
1585 'um.id' => SORT_ASC,
1588 return $result;
1592 * Override the table show_hide_link to not show for select column.
1594 * @param string $column the column name, index into various names.
1595 * @param int $index numerical index of the column.
1596 * @return string HTML fragment.
1598 protected function show_hide_link($column, $index) {
1599 if ($index > 0 || !$this->hasgrade) {
1600 return parent::show_hide_link($column, $index);
1602 return '';
1606 * Overides setup to ensure it will only run a single time.
1608 public function setup() {
1609 // Check if the setup function has been called before, we should not run it twice.
1610 // If we do the sortorder of the table will be broken.
1611 if (!empty($this->setup)) {
1612 return;
1614 parent::setup();