2 // This file is part of Moodle - http://moodle.org/
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.
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/>.
18 * This file contains the definition for the grading table which subclassses easy_table
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');
32 * Extends table_sql to provide a table of assignment submissions
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) */
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;
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,
83 $downloadfilename = null) {
84 global $CFG, $PAGE, $DB, $USER;
86 parent
::__construct('mod_assign_grading-' . $assignment->get_context()->id
);
88 $this->is_persistent(true);
89 $this->assignment
= $assignment;
91 // Check permissions up front.
92 $this->hasgrantextension
= has_capability('mod/assign:grantextension',
93 $this->assignment
->get_context());
94 $this->hasgrade
= $this->assignment
->can_grade();
96 // Check if we have the elevated view capablities to see the blind details.
97 $this->hasviewblind
= has_capability('mod/assign:viewblinddetails',
98 $this->assignment
->get_context());
100 foreach ($assignment->get_feedback_plugins() as $plugin) {
101 if ($plugin->is_visible() && $plugin->is_enabled()) {
102 foreach ($plugin->get_grading_batch_operations() as $action => $description) {
103 if (empty($this->plugingradingbatchoperations
)) {
104 $this->plugingradingbatchoperations
[$plugin->get_type()] = array();
106 $this->plugingradingbatchoperations
[$plugin->get_type()][$action] = $description;
110 $this->perpage
= $perpage;
111 $this->quickgrading
= $quickgrading && $this->hasgrade
;
112 $this->output
= $PAGE->get_renderer('mod_assign');
114 $urlparams = array('action' => 'grading', 'id' => $assignment->get_course_module()->id
);
115 $url = new moodle_url($CFG->wwwroot
. '/mod/assign/view.php', $urlparams);
116 $this->define_baseurl($url);
118 // Do some business - then set the sql.
119 $currentgroup = groups_get_activity_group($assignment->get_course_module(), true);
122 $this->rownum
= $rowoffset - 1;
125 $users = array_keys( $assignment->list_participants($currentgroup, true));
126 if (count($users) == 0) {
127 // Insert a record that will never match to the sql is still valid.
132 $params['assignmentid1'] = (int)$this->assignment
->get_instance()->id
;
133 $params['assignmentid2'] = (int)$this->assignment
->get_instance()->id
;
134 $params['assignmentid3'] = (int)$this->assignment
->get_instance()->id
;
135 $params['newstatus'] = ASSIGN_SUBMISSION_STATUS_NEW
;
137 // TODO Does not support custom user profile fields (MDL-70456).
138 $userfieldsapi = \core_user\fields
::for_identity($this->assignment
->get_context(), false)->with_userpic();
139 $userfields = $userfieldsapi->get_sql('u', false, '', '', false)->selects
;
140 $extrauserfields = $userfieldsapi->get_required_fields([\core_user\fields
::PURPOSE_IDENTITY
]);
141 $fields = $userfields . ', ';
142 $fields .= 'u.id as userid, ';
143 $fields .= 's.status as status, ';
144 $fields .= 's.id as submissionid, ';
145 $fields .= 's.timecreated as firstsubmission, ';
146 $fields .= "CASE WHEN status <> :newstatus THEN s.timemodified ELSE NULL END as timesubmitted, ";
147 $fields .= 's.attemptnumber as attemptnumber, ';
148 $fields .= 'g.id as gradeid, ';
149 $fields .= 'g.grade as grade, ';
150 $fields .= 'g.timemodified as timemarked, ';
151 $fields .= 'g.timecreated as firstmarked, ';
152 $fields .= 'uf.mailed as mailed, ';
153 $fields .= 'uf.locked as locked, ';
154 $fields .= 'uf.extensionduedate as extensionduedate, ';
155 $fields .= 'uf.workflowstate as workflowstate, ';
156 $fields .= 'uf.allocatedmarker as allocatedmarker';
159 LEFT JOIN {assign_submission} s
161 AND s.assignment = :assignmentid1
164 // For group assignments, there can be a grade with no submission.
165 $from .= ' LEFT JOIN {assign_grades} g
166 ON g.assignment = :assignmentid2
168 AND (g.attemptnumber = s.attemptnumber OR s.attemptnumber IS NULL) ';
170 $from .= 'LEFT JOIN {assign_user_flags} uf
172 AND uf.assignment = :assignmentid3 ';
174 if ($this->assignment
->get_course()->relativedatesmode
) {
175 $params['courseid1'] = $this->assignment
->get_course()->id
;
176 $from .= ' LEFT JOIN (
177 SELECT ue1.userid as enroluserid,
178 CASE WHEN MIN(ue1.timestart - c2.startdate) < 0 THEN 0 ELSE MIN(ue1.timestart - c2.startdate) END as enrolstartoffset
180 JOIN {user_enrolments} ue1
181 ON (ue1.enrolid = e1.id AND ue1.status = 0)
183 ON c2.id = e1.courseid
184 WHERE e1.courseid = :courseid1 AND e1.status = 0
187 ON (enroloffset.enroluserid = u.id) ';
190 $hasoverrides = $this->assignment
->has_overrides();
191 $inrelativedatesmode = $this->assignment
->get_course()->relativedatesmode
;
194 $params['assignmentid5'] = (int)$this->assignment
->get_instance()->id
;
195 $params['assignmentid6'] = (int)$this->assignment
->get_instance()->id
;
196 $params['assignmentid7'] = (int)$this->assignment
->get_instance()->id
;
197 $params['assignmentid8'] = (int)$this->assignment
->get_instance()->id
;
198 $params['assignmentid9'] = (int)$this->assignment
->get_instance()->id
;
200 list($userwhere1, $userparams1) = $DB->get_in_or_equal($users, SQL_PARAMS_NAMED
, 'priorityuser');
201 list($userwhere2, $userparams2) = $DB->get_in_or_equal($users, SQL_PARAMS_NAMED
, 'effectiveuser');
203 $userwhere1 = "WHERE u.id {$userwhere1}";
204 $userwhere2 = "WHERE u.id {$userwhere2}";
205 $params = array_merge($params, $userparams1);
206 $params = array_merge($params, $userparams2);
208 $fields .= ', priority.priority, ';
209 $fields .= 'effective.allowsubmissionsfromdate, ';
211 if ($inrelativedatesmode) {
212 // If the priority is less than the 9999999 constant value it means it's an override
213 // and we should use that value directly. Otherwise we need to apply the uesr's course
214 // start date offset.
215 $fields .= 'CASE WHEN priority.priority < 9999999 THEN effective.duedate ELSE' .
216 ' effective.duedate + enroloffset.enrolstartoffset END as duedate, ';
218 $fields .= 'effective.duedate, ';
221 $fields .= 'effective.cutoffdate ';
223 $from .= ' LEFT JOIN (
224 SELECT merged.userid, min(merged.priority) priority FROM (
225 ( SELECT u.id as userid, 9999999 AS priority
226 FROM {user} u '.$userwhere1.'
229 ( SELECT uo.userid, 0 AS priority
230 FROM {assign_overrides} uo
231 WHERE uo.assignid = :assignmentid5
234 ( SELECT gm.userid, go.sortorder AS priority
235 FROM {assign_overrides} go
236 JOIN {groups} g ON g.id = go.groupid
237 JOIN {groups_members} gm ON gm.groupid = g.id
238 WHERE go.assignid = :assignmentid6
241 GROUP BY merged.userid
242 ) priority ON priority.userid = u.id
245 (SELECT 9999999 AS priority,
247 a.allowsubmissionsfromdate,
251 JOIN {assign} a ON a.id = :assignmentid7
255 (SELECT 0 AS priority,
257 uo.allowsubmissionsfromdate,
260 FROM {assign_overrides} uo
261 WHERE uo.assignid = :assignmentid8
264 (SELECT go.sortorder AS priority,
266 go.allowsubmissionsfromdate,
269 FROM {assign_overrides} go
270 JOIN {groups} g ON g.id = go.groupid
271 JOIN {groups_members} gm ON gm.groupid = g.id
272 WHERE go.assignid = :assignmentid9
275 ) effective ON effective.priority = priority.priority AND effective.userid = priority.userid ';
276 } else if ($inrelativedatesmode) {
277 // In relative dates mode and when we don't have overrides, include the
278 // duedate, cutoffdate and allowsubmissionsfrom date anyway as this information is useful and can vary.
279 $params['assignmentid5'] = (int)$this->assignment
->get_instance()->id
;
280 $fields .= ', a.duedate + enroloffset.enrolstartoffset as duedate, ';
281 $fields .= 'a.allowsubmissionsfromdate, ';
282 $fields .= 'a.cutoffdate ';
283 $from .= 'JOIN {assign} a ON a.id = :assignmentid5 ';
286 if (!empty($this->assignment
->get_instance()->blindmarking
)) {
287 $from .= 'LEFT JOIN {assign_user_mapping} um
289 AND um.assignment = :assignmentidblind ';
290 $params['assignmentidblind'] = (int)$this->assignment
->get_instance()->id
;
291 $fields .= ', um.id as recordid ';
294 $userparams3 = array();
297 list($userwhere3, $userparams3) = $DB->get_in_or_equal($users, SQL_PARAMS_NAMED
, 'user');
298 $where = 'u.id ' . $userwhere3;
299 $params = array_merge($params, $userparams3);
301 // The filters do not make sense when there are no submissions, so do not apply them.
302 if ($this->assignment
->is_any_submission_plugin_enabled()) {
303 if ($filter == ASSIGN_FILTER_SUBMITTED
) {
304 $where .= ' AND (s.timemodified IS NOT NULL AND
305 s.status = :submitted) ';
306 $params['submitted'] = ASSIGN_SUBMISSION_STATUS_SUBMITTED
;
308 } else if ($filter == ASSIGN_FILTER_NOT_SUBMITTED
) {
309 $where .= ' AND (s.timemodified IS NULL OR s.status <> :submitted) ';
310 $params['submitted'] = ASSIGN_SUBMISSION_STATUS_SUBMITTED
;
311 } else if ($filter == ASSIGN_FILTER_REQUIRE_GRADING
) {
312 $where .= ' AND (s.timemodified IS NOT NULL AND
313 s.status = :submitted AND
314 (s.timemodified >= g.timemodified OR g.timemodified IS NULL OR g.grade IS NULL';
316 // Assignment grade is set to the negative grade scale id when scales are used.
317 if ($this->assignment
->get_instance()->grade
< 0) {
318 // Scale grades are set to -1 when not graded.
319 $where .= ' OR g.grade = -1';
323 $params['submitted'] = ASSIGN_SUBMISSION_STATUS_SUBMITTED
;
325 } else if ($filter == ASSIGN_FILTER_GRANTED_EXTENSION
) {
326 $where .= ' AND uf.extensionduedate > 0 ';
328 } else if (strpos($filter, ASSIGN_FILTER_SINGLE_USER
) === 0) {
329 $userfilter = (int) array_pop(explode('=', $filter));
330 $where .= ' AND (u.id = :userid)';
331 $params['userid'] = $userfilter;
332 } else if ($filter == ASSIGN_FILTER_DRAFT
) {
333 $where .= ' AND (s.timemodified IS NOT NULL AND
334 s.status = :draft) ';
335 $params['draft'] = ASSIGN_SUBMISSION_STATUS_DRAFT
;
339 if ($this->assignment
->get_instance()->markingworkflow
&&
340 $this->assignment
->get_instance()->markingallocation
) {
341 if (has_capability('mod/assign:manageallocations', $this->assignment
->get_context())) {
342 // Check to see if marker filter is set.
343 $markerfilter = (int)get_user_preferences('assign_markerfilter', '');
344 if (!empty($markerfilter)) {
345 if ($markerfilter == ASSIGN_MARKER_FILTER_NO_MARKER
) {
346 $where .= ' AND (uf.allocatedmarker IS NULL OR uf.allocatedmarker = 0)';
348 $where .= ' AND uf.allocatedmarker = :markerid';
349 $params['markerid'] = $markerfilter;
355 if ($this->assignment
->get_instance()->markingworkflow
) {
356 $workflowstates = $this->assignment
->get_marking_workflow_states_for_current_user();
357 if (!empty($workflowstates)) {
358 $workflowfilter = get_user_preferences('assign_workflowfilter', '');
359 if ($workflowfilter == ASSIGN_MARKING_WORKFLOW_STATE_NOTMARKED
) {
360 $where .= ' AND (uf.workflowstate = :workflowstate OR uf.workflowstate IS NULL OR '.
361 $DB->sql_isempty('assign_user_flags', 'workflowstate', true, true).')';
362 $params['workflowstate'] = $workflowfilter;
363 } else if (array_key_exists($workflowfilter, $workflowstates)) {
364 $where .= ' AND uf.workflowstate = :workflowstate';
365 $params['workflowstate'] = $workflowfilter;
370 $this->set_sql($fields, $from, $where, $params);
372 if ($downloadfilename) {
373 $this->is_downloading('csv', $downloadfilename);
380 if (!$this->is_downloading() && $this->hasgrade
) {
381 $columns[] = 'select';
382 $headers[] = get_string('select') .
383 '<div class="selectall"><label class="accesshide" for="selectall">' . get_string('selectall') . '</label>
384 <input type="checkbox" id="selectall" name="selectall" title="' . get_string('selectall') . '"/></div>';
388 if ($this->hasviewblind ||
!$this->assignment
->is_blind_marking()) {
389 if (!$this->is_downloading()) {
390 $columns[] = 'picture';
391 $headers[] = get_string('pictureofuser');
393 $columns[] = 'recordid';
394 $headers[] = get_string('recordid', 'assign');
398 $columns[] = 'fullname';
399 $headers[] = get_string('fullname');
401 // Participant # details if can view real identities.
402 if ($this->assignment
->is_blind_marking()) {
403 if (!$this->is_downloading()) {
404 $columns[] = 'recordid';
405 $headers[] = get_string('recordid', 'assign');
409 foreach ($extrauserfields as $extrafield) {
410 $columns[] = $extrafield;
411 $headers[] = \core_user\fields
::get_display_name($extrafield);
415 $columns[] = 'recordid';
416 $headers[] = get_string('recordid', 'assign');
419 // Submission status.
420 $columns[] = 'status';
421 $headers[] = get_string('status', 'assign');
423 if ($hasoverrides ||
$inrelativedatesmode) {
424 // Allowsubmissionsfromdate.
425 $columns[] = 'allowsubmissionsfromdate';
426 $headers[] = get_string('allowsubmissionsfromdate', 'assign');
429 $columns[] = 'duedate';
430 $headers[] = get_string('duedate', 'assign');
433 $columns[] = 'cutoffdate';
434 $headers[] = get_string('cutoffdate', 'assign');
437 // Team submission columns.
438 if ($assignment->get_instance()->teamsubmission
) {
440 $headers[] = get_string('submissionteam', 'assign');
443 if ($this->assignment
->get_instance()->markingworkflow
&&
444 $this->assignment
->get_instance()->markingallocation
&&
445 has_capability('mod/assign:manageallocations', $this->assignment
->get_context())) {
446 // Add a column for the allocated marker.
447 $columns[] = 'allocatedmarker';
448 $headers[] = get_string('marker', 'assign');
451 $columns[] = 'grade';
452 $headers[] = get_string('gradenoun');
453 if ($this->is_downloading()) {
454 $gradetype = $this->assignment
->get_instance()->grade
;
455 if ($gradetype > 0) {
456 $columns[] = 'grademax';
457 $headers[] = get_string('maxgrade', 'assign');
458 } else if ($gradetype < 0) {
459 // This is a custom scale.
460 $columns[] = 'scale';
461 $headers[] = get_string('scale', 'assign');
464 if ($this->assignment
->get_instance()->markingworkflow
) {
465 // Add a column for the marking workflow state.
466 $columns[] = 'workflowstate';
467 $headers[] = get_string('markingworkflowstate', 'assign');
469 // Add a column to show if this grade can be changed.
470 $columns[] = 'gradecanbechanged';
471 $headers[] = get_string('gradecanbechanged', 'assign');
473 if (!$this->is_downloading() && $this->hasgrade
) {
474 // We have to call this column userid so we can use userid as a default sortable column.
475 $columns[] = 'userid';
476 $headers[] = get_string('edit');
479 // Submission plugins.
480 if ($assignment->is_any_submission_plugin_enabled()) {
481 $columns[] = 'timesubmitted';
482 $headers[] = get_string('lastmodifiedsubmission', 'assign');
484 foreach ($this->assignment
->get_submission_plugins() as $plugin) {
485 if ($this->is_downloading()) {
486 if ($plugin->is_visible() && $plugin->is_enabled()) {
487 foreach ($plugin->get_editor_fields() as $field => $description) {
488 $index = 'plugin' . count($this->plugincache
);
489 $this->plugincache
[$index] = array($plugin, $field);
491 $headers[] = $plugin->get_name();
495 if ($plugin->is_visible() && $plugin->is_enabled() && $plugin->has_user_summary()) {
496 $index = 'plugin' . count($this->plugincache
);
497 $this->plugincache
[$index] = array($plugin);
499 $headers[] = $plugin->get_name();
506 $columns[] = 'timemarked';
507 $headers[] = get_string('lastmodifiedgrade', 'assign');
510 foreach ($this->assignment
->get_feedback_plugins() as $plugin) {
511 if ($this->is_downloading()) {
512 if ($plugin->is_visible() && $plugin->is_enabled()) {
513 foreach ($plugin->get_editor_fields() as $field => $description) {
514 $index = 'plugin' . count($this->plugincache
);
515 $this->plugincache
[$index] = array($plugin, $field);
517 $headers[] = $description;
520 } else if ($plugin->is_visible() && $plugin->is_enabled() && $plugin->has_user_summary()) {
521 $index = 'plugin' . count($this->plugincache
);
522 $this->plugincache
[$index] = array($plugin);
524 $headers[] = $plugin->get_name();
528 // Exclude 'Final grade' column in downloaded grading worksheets.
529 if (!$this->is_downloading()) {
531 $columns[] = 'finalgrade';
532 $headers[] = get_string('finalgrade', 'grades');
535 // Load the grading info for all users.
536 $this->gradinginfo
= grade_get_grades($this->assignment
->get_course()->id
,
539 $this->assignment
->get_instance()->id
,
542 if (!empty($CFG->enableoutcomes
) && !empty($this->gradinginfo
->outcomes
)) {
543 $columns[] = 'outcomes';
544 $headers[] = get_string('outcomes', 'grades');
548 $this->define_columns($columns);
549 $this->define_headers($headers);
550 foreach ($extrauserfields as $extrafield) {
551 $this->column_class($extrafield, $extrafield);
553 $this->no_sorting('recordid');
554 $this->no_sorting('finalgrade');
555 $this->no_sorting('userid');
556 $this->no_sorting('select');
557 $this->no_sorting('outcomes');
559 if ($assignment->get_instance()->teamsubmission
) {
560 $this->no_sorting('team');
563 $plugincolumnindex = 0;
564 foreach ($this->assignment
->get_submission_plugins() as $plugin) {
565 if ($plugin->is_visible() && $plugin->is_enabled() && $plugin->has_user_summary()) {
566 $submissionpluginindex = 'plugin' . $plugincolumnindex++
;
567 $this->no_sorting($submissionpluginindex);
570 foreach ($this->assignment
->get_feedback_plugins() as $plugin) {
571 if ($plugin->is_visible() && $plugin->is_enabled() && $plugin->has_user_summary()) {
572 $feedbackpluginindex = 'plugin' . $plugincolumnindex++
;
573 $this->no_sorting($feedbackpluginindex);
577 // When there is no data we still want the column headers printed in the csv file.
578 if ($this->is_downloading()) {
579 $this->start_output();
584 * Before adding each row to the table make sure rownum is incremented.
586 * @param array $row row of data from db used to make one row of the table.
587 * @return array one row for the table
589 public function format_row($row) {
590 if ($this->rownum
< 0) {
591 $this->rownum
= $this->currpage
* $this->pagesize
;
596 return parent
::format_row($row);
600 * Add a column with an ID that uniquely identifies this user in this assignment.
602 * @param stdClass $row
605 public function col_recordid(stdClass
$row) {
606 if (empty($row->recordid
)) {
607 $row->recordid
= $this->assignment
->get_uniqueid_for_user($row->userid
);
609 return get_string('hiddenuser', 'assign') . $row->recordid
;
614 * Add the userid to the row class so it can be updated via ajax.
616 * @param stdClass $row The row of data
617 * @return string The row class
619 public function get_row_class($row) {
620 return 'user' . $row->userid
;
624 * Return the number of rows to display on a single page.
626 * @return int The number of rows per page
628 public function get_rows_per_page() {
629 return $this->perpage
;
633 * list current marking workflow state
635 * @param stdClass $row
638 public function col_workflowstatus(stdClass
$row) {
641 $gradingdisabled = $this->assignment
->grading_disabled($row->id
);
642 // The function in the assignment keeps a static cache of this list of states.
643 $workflowstates = $this->assignment
->get_marking_workflow_states_for_current_user();
644 $workflowstate = $row->workflowstate
;
645 if (empty($workflowstate)) {
646 $workflowstate = ASSIGN_MARKING_WORKFLOW_STATE_NOTMARKED
;
648 if ($this->quickgrading
&& !$gradingdisabled) {
649 $notmarked = get_string('markingworkflowstatenotmarked', 'assign');
650 $name = 'quickgrade_' . $row->id
. '_workflowstate';
651 $o .= html_writer
::select($workflowstates, $name, $workflowstate, array('' => $notmarked));
652 // Check if this user is a marker that can't manage allocations and doesn't have the marker column added.
653 if ($this->assignment
->get_instance()->markingworkflow
&&
654 $this->assignment
->get_instance()->markingallocation
&&
655 !has_capability('mod/assign:manageallocations', $this->assignment
->get_context())) {
657 $name = 'quickgrade_' . $row->id
. '_allocatedmarker';
658 $o .= html_writer
::empty_tag('input', array('type' => 'hidden', 'name' => $name,
659 'value' => $row->allocatedmarker
));
662 $o .= $this->output
->container(get_string('markingworkflowstate' . $workflowstate, 'assign'), $workflowstate);
668 * For download only - list current marking workflow state
670 * @param stdClass $row - The row of data
671 * @return string The current marking workflow state
673 public function col_workflowstate($row) {
674 $state = $row->workflowstate
;
676 $state = ASSIGN_MARKING_WORKFLOW_STATE_NOTMARKED
;
679 return get_string('markingworkflowstate' . $state, 'assign');
683 * list current marker
685 * @param stdClass $row - The row of data
686 * @return id the user->id of the marker.
688 public function col_allocatedmarker(stdClass
$row) {
689 static $markers = null;
690 static $markerlist = array();
691 if ($markers === null) {
692 list($sort, $params) = users_order_by_sql('u');
693 // Only enrolled users could be assigned as potential markers.
694 $markers = get_enrolled_users($this->assignment
->get_context(), 'mod/assign:grade', 0, 'u.*', $sort);
695 $markerlist[0] = get_string('choosemarker', 'assign');
696 $viewfullnames = has_capability('moodle/site:viewfullnames', $this->assignment
->get_context());
697 foreach ($markers as $marker) {
698 $markerlist[$marker->id
] = fullname($marker, $viewfullnames);
701 if (empty($markerlist)) {
702 // TODO: add some form of notification here that no markers are available.
705 if ($this->is_downloading()) {
706 if (isset($markers[$row->allocatedmarker
])) {
707 return fullname($markers[$row->allocatedmarker
],
708 has_capability('moodle/site:viewfullnames', $this->assignment
->get_context()));
714 if ($this->quickgrading
&& has_capability('mod/assign:manageallocations', $this->assignment
->get_context()) &&
715 (empty($row->workflowstate
) ||
716 $row->workflowstate
== ASSIGN_MARKING_WORKFLOW_STATE_INMARKING ||
717 $row->workflowstate
== ASSIGN_MARKING_WORKFLOW_STATE_NOTMARKED
)) {
719 $name = 'quickgrade_' . $row->id
. '_allocatedmarker';
720 return html_writer
::select($markerlist, $name, $row->allocatedmarker
, false);
721 } else if (!empty($row->allocatedmarker
)) {
723 if ($this->quickgrading
) { // Add hidden field for quickgrading page.
724 $name = 'quickgrade_' . $row->id
. '_allocatedmarker';
725 $attributes = ['type' => 'hidden', 'name' => $name, 'value' => $row->allocatedmarker
];
726 $output .= html_writer
::empty_tag('input', $attributes);
728 $output .= $markerlist[$row->allocatedmarker
];
733 * For download only - list all the valid options for this custom scale.
735 * @param stdClass $row - The row of data
736 * @return string A list of valid options for the current scale
738 public function col_scale($row) {
741 if (empty($this->scale
)) {
742 $dbparams = array('id' => -($this->assignment
->get_instance()->grade
));
743 $this->scale
= $DB->get_record('scale', $dbparams);
746 if (!empty($this->scale
->scale
)) {
747 return implode("\n", explode(',', $this->scale
->scale
));
753 * Display a grade with scales etc.
755 * @param string $grade
756 * @param boolean $editable
757 * @param int $userid The user id of the user this grade belongs to
758 * @param int $modified Timestamp showing when the grade was last modified
759 * @return string The formatted grade
761 public function display_grade($grade, $editable, $userid, $modified) {
762 if ($this->is_downloading()) {
763 if ($this->assignment
->get_instance()->grade
>= 0) {
764 if ($grade == -1 ||
$grade === null) {
767 $gradeitem = $this->assignment
->get_grade_item();
768 return format_float($grade, $gradeitem->get_decimals());
770 // This is a custom scale.
771 $scale = $this->assignment
->display_grade($grade, false);
778 return $this->assignment
->display_grade($grade, $editable, $userid, $modified);
782 * Get the team info for this user.
784 * @param stdClass $row
785 * @return string The team name
787 public function col_team(stdClass
$row) {
790 $this->get_group_and_submission($row->id
, $group, $submission, -1);
793 } else if ($this->assignment
->get_instance()->preventsubmissionnotingroup
) {
794 $usergroups = $this->assignment
->get_all_groups($row->id
);
795 if (count($usergroups) > 1) {
796 return get_string('multipleteamsgrader', 'assign');
798 return get_string('noteamgrader', 'assign');
801 return get_string('defaultteam', 'assign');
805 * Use a static cache to try and reduce DB calls.
807 * @param int $userid The user id for this submission
808 * @param int $group The groupid (returned)
809 * @param stdClass|false $submission The stdClass submission or false (returned)
810 * @param int $attemptnumber Return a specific attempt number (-1 for latest)
812 protected function get_group_and_submission($userid, &$group, &$submission, $attemptnumber) {
814 if (isset($this->submissiongroups
[$userid])) {
815 $group = $this->submissiongroups
[$userid];
817 $group = $this->assignment
->get_submission_group($userid, false);
818 $this->submissiongroups
[$userid] = $group;
823 $groupid = $group->id
;
826 // Static cache is keyed by groupid and attemptnumber.
827 // We may need both the latest and previous attempt in the same page.
828 if (isset($this->groupsubmissions
[$groupid . ':' . $attemptnumber])) {
829 $submission = $this->groupsubmissions
[$groupid . ':' . $attemptnumber];
831 $submission = $this->assignment
->get_group_submission($userid, $groupid, false, $attemptnumber);
832 $this->groupsubmissions
[$groupid . ':' . $attemptnumber] = $submission;
837 * Format a list of outcomes.
839 * @param stdClass $row
842 public function col_outcomes(stdClass
$row) {
844 foreach ($this->gradinginfo
->outcomes
as $index => $outcome) {
845 $options = make_grades_menu(-$outcome->scaleid
);
847 $options[0] = get_string('nooutcome', 'grades');
848 if ($this->quickgrading
&& !($outcome->grades
[$row->userid
]->locked
)) {
849 $select = '<select name="outcome_' . $index . '_' . $row->userid
. '" class="quickgrade">';
850 foreach ($options as $optionindex => $optionvalue) {
852 if ($outcome->grades
[$row->userid
]->grade
== $optionindex) {
853 $selected = 'selected="selected"';
855 $select .= '<option value="' . $optionindex . '"' . $selected . '>' . $optionvalue . '</option>';
857 $select .= '</select>';
858 $outcomes .= $this->output
->container($outcome->name
. ': ' . $select, 'outcome');
860 $name = $outcome->name
. ': ' . $options[$outcome->grades
[$row->userid
]->grade
];
861 if ($this->is_downloading()) {
864 $outcomes .= $this->output
->container($name, 'outcome');
874 * Format a user picture for display.
876 * @param stdClass $row
879 public function col_picture(stdClass
$row) {
880 return $this->output
->user_picture($row);
884 * Format a user record for display (link to profile).
886 * @param stdClass $row
889 public function col_fullname($row) {
890 if (!$this->is_downloading()) {
891 $courseid = $this->assignment
->get_course()->id
;
892 $link = new moodle_url('/user/view.php', array('id' => $row->id
, 'course' => $courseid));
893 $fullname = $this->output
->action_link($link, $this->assignment
->fullname($row));
895 $fullname = $this->assignment
->fullname($row);
898 if (!$this->assignment
->is_active_user($row->id
)) {
899 $suspendedstring = get_string('userenrolmentsuspended', 'grades');
900 $fullname .= ' ' . $this->output
->pix_icon('i/enrolmentsuspended', $suspendedstring);
901 $fullname = html_writer
::tag('span', $fullname, array('class' => 'usersuspended'));
907 * Insert a checkbox for selecting the current row for batch operations.
909 * @param stdClass $row
912 public function col_select(stdClass
$row) {
913 $selectcol = '<label class="accesshide" for="selectuser_' . $row->userid
. '">';
914 $selectcol .= get_string('selectuser', 'assign', $this->assignment
->fullname($row));
915 $selectcol .= '</label>';
916 $selectcol .= '<input type="checkbox"
917 id="selectuser_' . $row->userid
. '"
919 value="' . $row->userid
. '"/>';
920 $selectcol .= '<input type="hidden"
921 name="grademodified_' . $row->userid
. '"
922 value="' . $row->timemarked
. '"/>';
923 $selectcol .= '<input type="hidden"
924 name="gradeattempt_' . $row->userid
. '"
925 value="' . $row->attemptnumber
. '"/>';
930 * Return a users grades from the listing of all grade data for this assignment.
933 * @return mixed stdClass or false
935 private function get_gradebook_data_for_user($userid) {
936 if (isset($this->gradinginfo
->items
[0]) && $this->gradinginfo
->items
[0]->grades
[$userid]) {
937 return $this->gradinginfo
->items
[0]->grades
[$userid];
943 * Format a column of data for display.
945 * @param stdClass $row
948 public function col_gradecanbechanged(stdClass
$row) {
949 $gradingdisabled = $this->assignment
->grading_disabled($row->id
);
950 if ($gradingdisabled) {
951 return get_string('no');
953 return get_string('yes');
958 * Format a column of data for display
960 * @param stdClass $row
963 public function col_grademax(stdClass
$row) {
964 if ($this->assignment
->get_instance()->grade
> 0) {
965 $gradeitem = $this->assignment
->get_grade_item();
966 return format_float($this->assignment
->get_instance()->grade
, $gradeitem->get_decimals());
973 * Format a column of data for display.
975 * @param stdClass $row
978 public function col_grade(stdClass
$row) {
982 $separator = $this->output
->spacer(array(), true);
984 $gradingdisabled = $this->assignment
->grading_disabled($row->id
);
986 if (!$this->is_downloading() && $this->hasgrade
) {
987 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
989 'action' => 'grader');
991 if ($this->assignment
->is_blind_marking()) {
992 if (empty($row->recordid
)) {
993 $row->recordid
= $this->assignment
->get_uniqueid_for_user($row->userid
);
995 $urlparams['blindid'] = $row->recordid
;
997 $urlparams['userid'] = $row->userid
;
1000 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1001 $link = '<a href="' . $url . '" class="btn btn-primary">' . get_string('gradeverb') . '</a>';
1002 $grade .= $link . $separator;
1005 $grade .= $this->display_grade($row->grade
,
1006 $this->quickgrading
&& !$gradingdisabled,
1014 * Format a column of data for display.
1016 * @param stdClass $row
1019 public function col_finalgrade(stdClass
$row) {
1022 $grade = $this->get_gradebook_data_for_user($row->userid
);
1024 $o = $this->display_grade($grade->grade
, false, $row->userid
, $row->timemarked
);
1031 * Format a column of data for display.
1033 * @param stdClass $row
1036 public function col_timemarked(stdClass
$row) {
1039 if ($row->timemarked
&& $row->grade
!== null && $row->grade
>= 0) {
1040 $o = userdate($row->timemarked
);
1042 if ($row->timemarked
&& $this->is_downloading()) {
1043 // Force it for downloads as it affects import.
1044 $o = userdate($row->timemarked
);
1051 * Format a column of data for display.
1053 * @param stdClass $row
1056 public function col_timesubmitted(stdClass
$row) {
1060 $submission = false;
1061 $this->get_group_and_submission($row->id
, $group, $submission, -1);
1062 if ($submission && $submission->timemodified
&& $submission->status
!= ASSIGN_SUBMISSION_STATUS_NEW
) {
1063 $o = userdate($submission->timemodified
);
1064 } else if ($row->timesubmitted
&& $row->status
!= ASSIGN_SUBMISSION_STATUS_NEW
) {
1065 $o = userdate($row->timesubmitted
);
1072 * Format a column of data for display
1074 * @param stdClass $row
1077 public function col_status(stdClass
$row) {
1080 $instance = $this->assignment
->get_instance($row->userid
);
1082 $due = $instance->duedate
;
1083 if ($row->extensionduedate
) {
1084 $due = $row->extensionduedate
;
1085 } else if (!empty($row->duedate
)) {
1086 // The override due date.
1087 $due = $row->duedate
;
1091 $submission = false;
1093 if ($instance->teamsubmission
) {
1094 $this->get_group_and_submission($row->id
, $group, $submission, -1);
1097 if ($instance->teamsubmission
&& !$group && !$instance->preventsubmissionnotingroup
) {
1101 if ($group && $submission) {
1102 $timesubmitted = $submission->timemodified
;
1103 $status = $submission->status
;
1105 $timesubmitted = $row->timesubmitted
;
1106 $status = $row->status
;
1109 $displaystatus = $status;
1110 if ($displaystatus == 'new') {
1111 $displaystatus = '';
1114 if ($this->assignment
->is_any_submission_plugin_enabled()) {
1116 $o .= $this->output
->container(get_string('submissionstatus_' . $displaystatus, 'assign'),
1117 array('class' => 'submissionstatus' .$displaystatus));
1118 if ($due && $timesubmitted > $due && $status != ASSIGN_SUBMISSION_STATUS_NEW
) {
1119 $usertime = format_time($timesubmitted - $due);
1120 $latemessage = get_string('submittedlateshort',
1123 $o .= $this->output
->container($latemessage, 'latesubmission');
1126 $lockedstr = get_string('submissionslockedshort', 'assign');
1127 $o .= $this->output
->container($lockedstr, 'lockedsubmission');
1130 // Add status of "grading" if markflow is not enabled.
1131 if (!$instance->markingworkflow
) {
1132 if ($row->grade
!== null && $row->grade
>= 0) {
1133 if ($row->timemarked
< $row->timesubmitted
) {
1134 $o .= $this->output
->container(get_string('gradedfollowupsubmit', 'assign'), 'gradingreminder');
1136 $o .= $this->output
->container(get_string('graded', 'assign'), 'submissiongraded');
1138 } else if (!$timesubmitted ||
$status == ASSIGN_SUBMISSION_STATUS_NEW
) {
1140 if ($due && ($now > $due)) {
1141 $overduestr = get_string('overdue', 'assign', format_time($now - $due));
1142 $o .= $this->output
->container($overduestr, 'overduesubmission');
1148 if ($instance->markingworkflow
) {
1149 $o .= $this->col_workflowstatus($row);
1151 if ($row->extensionduedate
) {
1152 $userdate = userdate($row->extensionduedate
);
1153 $extensionstr = get_string('userextensiondate', 'assign', $userdate);
1154 $o .= $this->output
->container($extensionstr, 'extensiondate');
1157 if ($this->is_downloading()) {
1158 $o = strip_tags(rtrim(str_replace('</div>', ' - ', $o), '- '));
1165 * Format a column of data for display.
1167 * @param stdClass $row
1170 public function col_allowsubmissionsfromdate(stdClass
$row) {
1173 if ($row->allowsubmissionsfromdate
) {
1174 $userdate = userdate($row->allowsubmissionsfromdate
);
1175 $o = ($this->is_downloading()) ?
$userdate : $this->output
->container($userdate, 'allowsubmissionsfromdate');
1182 * Format a column of data for display.
1184 * @param stdClass $row
1187 public function col_duedate(stdClass
$row) {
1190 if ($row->duedate
) {
1191 $userdate = userdate($row->duedate
);
1192 $o = ($this->is_downloading()) ?
$userdate : $this->output
->container($userdate, 'duedate');
1199 * Format a column of data for display.
1201 * @param stdClass $row
1204 public function col_cutoffdate(stdClass
$row) {
1207 if ($row->cutoffdate
) {
1208 $userdate = userdate($row->cutoffdate
);
1209 $o = ($this->is_downloading()) ?
$userdate : $this->output
->container($userdate, 'cutoffdate');
1216 * Format a column of data for display.
1218 * @param stdClass $row
1221 public function col_userid(stdClass
$row) {
1228 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
1230 'action' => 'grader');
1232 if ($this->assignment
->is_blind_marking()) {
1233 if (empty($row->recordid
)) {
1234 $row->recordid
= $this->assignment
->get_uniqueid_for_user($row->userid
);
1236 $urlparams['blindid'] = $row->recordid
;
1238 $urlparams['userid'] = $row->userid
;
1240 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1244 $description = get_string('gradeverb');
1246 $description = get_string('updategrade', 'assign');
1248 $actions['grade'] = new action_menu_link_secondary(
1254 // Everything we need is in the row.
1257 if ($this->assignment
->get_instance()->teamsubmission
) {
1258 // Use the cache for this.
1259 $submission = false;
1261 $this->get_group_and_submission($row->id
, $group, $submission, -1);
1264 $submissionsopen = $this->assignment
->submissions_open($row->id
,
1268 $this->gradinginfo
);
1269 $caneditsubmission = $this->assignment
->can_edit_submission($row->id
, $USER->id
);
1271 // Hide for offline assignments.
1272 if ($this->assignment
->is_any_submission_plugin_enabled()) {
1273 if (!$row->status ||
1274 $row->status
== ASSIGN_SUBMISSION_STATUS_DRAFT ||
1275 !$this->assignment
->get_instance()->submissiondrafts
) {
1277 if (!$row->locked
) {
1278 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
1279 'userid' => $row->id
,
1281 'sesskey' => sesskey(),
1282 'page' => $this->currpage
);
1283 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1285 $description = get_string('preventsubmissionsshort', 'assign');
1286 $actions['lock'] = new action_menu_link_secondary(
1292 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
1293 'userid' => $row->id
,
1294 'action' => 'unlock',
1295 'sesskey' => sesskey(),
1296 'page' => $this->currpage
);
1297 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1298 $description = get_string('allowsubmissionsshort', 'assign');
1299 $actions['unlock'] = new action_menu_link_secondary(
1307 if ($submissionsopen &&
1308 $USER->id
!= $row->id
&&
1309 $caneditsubmission) {
1310 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
1311 'userid' => $row->id
,
1312 'action' => 'editsubmission',
1313 'sesskey' => sesskey(),
1314 'page' => $this->currpage
);
1315 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1316 $description = get_string('editsubmission', 'assign');
1317 $actions['editsubmission'] = new action_menu_link_secondary(
1323 if ($USER->id
!= $row->id
&&
1324 $caneditsubmission &&
1325 !empty($row->status
)) {
1326 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
1327 'userid' => $row->id
,
1328 'action' => 'removesubmissionconfirm',
1329 'sesskey' => sesskey(),
1330 'page' => $this->currpage
);
1331 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1332 $description = get_string('removesubmission', 'assign');
1333 $actions['removesubmission'] = new action_menu_link_secondary(
1340 if (($this->assignment
->get_instance()->duedate ||
1341 $this->assignment
->get_instance()->cutoffdate
) &&
1342 $this->hasgrantextension
) {
1343 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
1344 'userid' => $row->id
,
1345 'action' => 'grantextension',
1346 'sesskey' => sesskey(),
1347 'page' => $this->currpage
);
1348 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1349 $description = get_string('grantextension', 'assign');
1350 $actions['grantextension'] = new action_menu_link_secondary(
1356 if ($row->status
== ASSIGN_SUBMISSION_STATUS_SUBMITTED
&&
1357 $this->assignment
->get_instance()->submissiondrafts
) {
1358 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
1359 'userid' => $row->id
,
1360 'action' => 'reverttodraft',
1361 'sesskey' => sesskey(),
1362 'page' => $this->currpage
);
1363 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1364 $description = get_string('reverttodraftshort', 'assign');
1365 $actions['reverttodraft'] = new action_menu_link_secondary(
1371 if ($row->status
== ASSIGN_SUBMISSION_STATUS_DRAFT
&&
1372 $this->assignment
->get_instance()->submissiondrafts
&&
1373 $caneditsubmission &&
1375 $row->id
!= $USER->id
) {
1376 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
1377 'userid' => $row->id
,
1378 'action' => 'submitotherforgrading',
1379 'sesskey' => sesskey(),
1380 'page' => $this->currpage
);
1381 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1382 $description = get_string('submitforgrading', 'assign');
1383 $actions['submitforgrading'] = new action_menu_link_secondary(
1390 $ismanual = $this->assignment
->get_instance()->attemptreopenmethod
== ASSIGN_ATTEMPT_REOPEN_METHOD_MANUAL
;
1391 $hassubmission = !empty($row->status
);
1392 $notreopened = $hassubmission && $row->status
!= ASSIGN_SUBMISSION_STATUS_REOPENED
;
1393 $isunlimited = $this->assignment
->get_instance()->maxattempts
== ASSIGN_UNLIMITED_ATTEMPTS
;
1394 $hasattempts = $isunlimited ||
$row->attemptnumber
< $this->assignment
->get_instance()->maxattempts
- 1;
1396 if ($ismanual && $hassubmission && $notreopened && $hasattempts) {
1397 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
1398 'userid' => $row->id
,
1399 'action' => 'addattempt',
1400 'sesskey' => sesskey(),
1401 'page' => $this->currpage
);
1402 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1403 $description = get_string('addattempt', 'assign');
1404 $actions['addattempt'] = new action_menu_link_secondary(
1411 $menu = new action_menu();
1412 $menu->set_owner_selector('.gradingtable-actionmenu');
1413 $menu->set_alignment(action_menu
::TL
, action_menu
::BL
);
1414 $menu->set_constraint('.gradingtable > .no-overflow');
1415 $menu->set_menu_trigger(get_string('edit'));
1416 foreach ($actions as $action) {
1417 $menu->add($action);
1420 // Prioritise the menu ahead of all other actions.
1421 $menu->prioritise
= true;
1423 $edit .= $this->output
->render($menu);
1429 * Write the plugin summary with an optional link to view the full feedback/submission.
1431 * @param assign_plugin $plugin Submission plugin or feedback plugin
1432 * @param stdClass $item Submission or grade
1433 * @param string $returnaction The return action to pass to the
1434 * view_submission page (the current page)
1435 * @param string $returnparams The return params to pass to the view_submission
1436 * page (the current page)
1437 * @return string The summary with an optional link
1439 private function format_plugin_summary_with_link(assign_plugin
$plugin,
1444 $showviewlink = false;
1446 $summary = $plugin->view_summary($item, $showviewlink);
1448 if ($showviewlink) {
1449 $viewstr = get_string('view' . substr($plugin->get_subtype(), strlen('assign')), 'assign');
1450 $icon = $this->output
->pix_icon('t/preview', $viewstr);
1451 $urlparams = array('id' => $this->assignment
->get_course_module()->id
,
1454 'plugin' => $plugin->get_type(),
1455 'action' => 'viewplugin' . $plugin->get_subtype(),
1456 'returnaction' => $returnaction,
1457 'returnparams' => http_build_query($returnparams));
1458 $url = new moodle_url('/mod/assign/view.php', $urlparams);
1459 $link = $this->output
->action_link($url, $icon);
1460 $separator = $this->output
->spacer(array(), true);
1463 return $link . $separator . $summary;
1468 * Format the submission and feedback columns.
1470 * @param string $colname The column name
1471 * @param stdClass $row The submission row
1472 * @return mixed string or NULL
1474 public function other_cols($colname, $row) {
1475 // For extra user fields the result is already in $row.
1476 if (empty($this->plugincache
[$colname])) {
1477 return parent
::other_cols($colname, $row);
1480 // This must be a plugin field.
1481 $plugincache = $this->plugincache
[$colname];
1483 $plugin = $plugincache[0];
1486 if (isset($plugincache[1])) {
1487 $field = $plugincache[1];
1490 if ($plugin->is_visible() && $plugin->is_enabled()) {
1491 if ($plugin->get_subtype() == 'assignsubmission') {
1492 if ($this->assignment
->get_instance()->teamsubmission
) {
1494 $submission = false;
1496 $this->get_group_and_submission($row->id
, $group, $submission, -1);
1498 if ($submission->status
== ASSIGN_SUBMISSION_STATUS_REOPENED
) {
1499 // For a newly reopened submission - we want to show the previous submission in the table.
1500 $this->get_group_and_submission($row->id
, $group, $submission, $submission->attemptnumber
-1);
1502 if (isset($field)) {
1503 return $plugin->get_editor_text($field, $submission->id
);
1505 return $this->format_plugin_summary_with_link($plugin,
1510 } else if ($row->submissionid
) {
1511 if ($row->status
== ASSIGN_SUBMISSION_STATUS_REOPENED
) {
1512 // For a newly reopened submission - we want to show the previous submission in the table.
1513 $submission = $this->assignment
->get_user_submission($row->userid
, false, $row->attemptnumber
- 1);
1515 $submission = new stdClass();
1516 $submission->id
= $row->submissionid
;
1517 $submission->timecreated
= $row->firstsubmission
;
1518 $submission->timemodified
= $row->timesubmitted
;
1519 $submission->assignment
= $this->assignment
->get_instance()->id
;
1520 $submission->userid
= $row->userid
;
1521 $submission->attemptnumber
= $row->attemptnumber
;
1523 // Field is used for only for import/export and refers the the fieldname for the text editor.
1524 if (isset($field)) {
1525 return $plugin->get_editor_text($field, $submission->id
);
1527 return $this->format_plugin_summary_with_link($plugin,
1534 if (isset($field)) {
1535 return $plugin->get_editor_text($field, $row->gradeid
);
1538 if ($row->gradeid
) {
1539 $grade = new stdClass();
1540 $grade->id
= $row->gradeid
;
1541 $grade->timecreated
= $row->firstmarked
;
1542 $grade->timemodified
= $row->timemarked
;
1543 $grade->assignment
= $this->assignment
->get_instance()->id
;
1544 $grade->userid
= $row->userid
;
1545 $grade->grade
= $row->grade
;
1546 $grade->mailed
= $row->mailed
;
1547 $grade->attemptnumber
= $row->attemptnumber
;
1549 if ($this->quickgrading
&& $plugin->supports_quickgrading()) {
1550 return $plugin->get_quickgrading_html($row->userid
, $grade);
1551 } else if ($grade) {
1552 return $this->format_plugin_summary_with_link($plugin,
1563 * Using the current filtering and sorting - load all rows and return a single column from them.
1565 * @param string $columnname The name of the raw column data
1566 * @return array of data
1568 public function get_column_data($columnname) {
1570 $this->currpage
= 0;
1571 $this->query_db($this->tablemaxrows
);
1573 foreach ($this->rawdata
as $row) {
1574 $result[] = $row->$columnname;
1580 * Return things to the renderer.
1582 * @return string the assignment name
1584 public function get_assignment_name() {
1585 return $this->assignment
->get_instance()->name
;
1589 * Return things to the renderer.
1591 * @return int the course module id
1593 public function get_course_module_id() {
1594 return $this->assignment
->get_course_module()->id
;
1598 * Return things to the renderer.
1600 * @return int the course id
1602 public function get_course_id() {
1603 return $this->assignment
->get_course()->id
;
1607 * Return things to the renderer.
1609 * @return stdClass The course context
1611 public function get_course_context() {
1612 return $this->assignment
->get_course_context();
1616 * Return things to the renderer.
1618 * @return bool Does this assignment accept submissions
1620 public function submissions_enabled() {
1621 return $this->assignment
->is_any_submission_plugin_enabled();
1625 * Return things to the renderer.
1627 * @return bool Can this user view all grades (the gradebook)
1629 public function can_view_all_grades() {
1630 $context = $this->assignment
->get_course_context();
1631 return has_capability('gradereport/grader:view', $context) &&
1632 has_capability('moodle/grade:viewall', $context);
1636 * Always return a valid sort - even if the userid column is missing.
1637 * @return array column name => SORT_... constant.
1639 public function get_sort_columns() {
1640 $result = parent
::get_sort_columns();
1642 $assignment = $this->assignment
->get_instance();
1643 if (empty($assignment->blindmarking
)) {
1644 $result = array_merge($result, array('userid' => SORT_ASC
));
1646 $result = array_merge($result, [
1647 'COALESCE(s.timecreated, ' . time() . ')' => SORT_ASC
,
1648 'COALESCE(s.id, ' . PHP_INT_MAX
. ')' => SORT_ASC
,
1649 'um.id' => SORT_ASC
,
1656 * Override the table show_hide_link to not show for select column.
1658 * @param string $column the column name, index into various names.
1659 * @param int $index numerical index of the column.
1660 * @return string HTML fragment.
1662 protected function show_hide_link($column, $index) {
1663 if ($index > 0 ||
!$this->hasgrade
) {
1664 return parent
::show_hide_link($column, $index);
1670 * Overides setup to ensure it will only run a single time.
1672 public function setup() {
1673 // Check if the setup function has been called before, we should not run it twice.
1674 // If we do the sortorder of the table will be broken.
1675 if (!empty($this->setup
)) {