details.php

<?php
// This file is part of 3rd party created module for Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
 * Details.
 *
 * @package    mod_peerwork
 * @copyright  2013 LEARNING TECHNOLOGY SERVICES
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

use core\output\notification;
use mod_peerwork\event\submission_grade_form_viewed;

require_once(__DIR__ . '/../../config.php');
require_once($CFG->dirroot . '/mod/peerwork/lib.php');
require_once($CFG->dirroot . '/lib/grouplib.php');
require_once($CFG->dirroot . '/mod/peerwork/locallib.php');
require_once($CFG->dirroot . '/lib/gradelib.php');

$id = required_param('id', PARAM_INT);
$groupid = required_param('groupid', PARAM_INT);

$cm = get_coursemodule_from_id('peerwork', $id, 0, false, MUST_EXIST);
$course = $DB->get_record('course', ['id' => $cm->course], '*', MUST_EXIST);
$peerwork = $DB->get_record('peerwork', ['id' => $cm->instance], '*', MUST_EXIST);
$submission = $DB->get_record('peerwork_submission', ['peerworkid' => $peerwork->id, 'groupid' => $groupid]);
$members = groups_get_members($groupid);
$group = $DB->get_record('groups', ['id' => $groupid], '*', MUST_EXIST);
$status = peerwork_get_status($peerwork, $group);

// Print the standard page header and check access rights.
require_login($course, true, $cm);
$context = context_module::instance($cm->id);
$PAGE->set_url('/mod/peerwork/details.php', ['id' => $cm->id, 'groupid' => $groupid]);
$PAGE->set_title(format_string($peerwork->name));
$PAGE->set_heading(format_string($course->fullname));
$PAGE->set_context($context);
require_capability('mod/peerwork:grade', $context);

$plugin = 'peerworkcalculator_' . $peerwork->calculator;
$classname = '\\' . $plugin . '\calculator';
$calcmissing = !class_exists($classname);

// If the original calculator used no longer exists then just print a warning.
if ($peerwork->calculator && $calcmissing) {
    echo $OUTPUT->header();
    $error = 'calcmissing';
    $a = '';

    if ($submission && peerwork_was_submission_graded_from_status($status)) {
        $a = get_string('calcmissinggraded', 'mod_peerwork');
    }

    throw new moodle_exception($error, 'mod_peerwork', '', $a);

    echo $OUTPUT->footer();
    return;
}

// Start the form, initialise with some data.
$fileoptions = mod_peerwork_details_form::$fileoptions;
$draftitemid = file_get_submitted_draft_itemid('feedback_files');
file_prepare_draft_area($draftitemid, $context->id, 'mod_peerwork', 'feedback_files', $group->id, $fileoptions);
$data = [
    'paweighting' => $peerwork->paweighting,
    'feedback_files' => $draftitemid,
];

// Load the submission data.
if ($submission && peerwork_was_submission_graded_from_status($status)) {
    $data['grade'] = $submission->grade;
    $data['paweighting'] = $submission->paweighting;
    $data['feedback'] = [
        'text' => $submission->feedbacktext ?? '',
        'format' => $submission->feedbackformat ?? FORMAT_HTML,
    ];
}

// Get the justifications.
$justifications = [];
if ($peerwork->justification != MOD_PEERWORK_JUSTIFICATION_DISABLED) {
    $justifications = peerwork_get_justifications($peerwork->id, $group->id);
}

$lockedgraders = mod_peerwork_get_locked_graders($peerwork->id);
$isopen = peerwork_is_open($peerwork, $group->id);
$canunlock = !empty($isopen->code) && $submission && !$submission->timegraded;
$duedate = peerwork_due_date($peerwork);
$duedatenotpassed = $duedate !== PEERWORK_DUEDATE_PASSED;
$mform = new mod_peerwork_details_form($PAGE->url->out(false), [
    'peerwork' => $peerwork,
    'justifications' => $justifications,
    'submission' => $submission,
    'members' => $members,
    'canunlock' => $canunlock,
    'duedatenotpassed' => $duedatenotpassed,
]);
$data['groupname'] = $group->name;
$data['status'] = $status->text;
$submissionfiles = peerwork_submission_files($context, $group);
$data['submission'] = empty($submissionfiles) ? get_string('nothingsubmitted', 'peerwork') : implode('<br/>', $submissionfiles);

// Get the peer grades awarded so far, then for each criteria
// output a HTML tabulation of the peers and the grades awarded and received.
// TODO instead of HTML fragment can we build this with form elments?
$grades = peerwork_get_peer_grades($peerwork, $group, $members, false);
$pac = new mod_peerwork_criteria($peerwork->id);
$data['peergradesawarded'] = '';
// Is there per criteria justification enabled?
$justenabled = $peerwork->justification != MOD_PEERWORK_JUSTIFICATION_DISABLED;
$justcrit = $peerwork->justificationtype == MOD_PEERWORK_JUSTIFICATION_CRITERIA;
$justenabledcrit = $justenabled && $justcrit;
$criterion = $pac->get_criteria();
$summary = new mod_peerwork\output\peerwork_detail_summary(
    $criterion,
    $grades,
    $justifications,
    $members,
    $lockedgraders,
    $peerwork,
    $canunlock,
    $justenabledcrit,
    $cm->id,
    $groupid
);
$renderer = $PAGE->get_renderer('mod_peerwork');
$data['peergradesawarded'] .= $renderer->render($summary);

// If assignment has been graded then pass the required data to create a table showing calculated grades.
if (peerwork_was_submission_graded_from_status($status)) {
    $result = peerwork_get_pa_result($peerwork, $group);
    $canoverridepeergrades = get_config('peerwork', 'overridepeergrades');
    $localgrades = peerwork_get_local_grades($peerwork->id, $submission->id);

    if ($canoverridepeergrades) {
        $overiddenresult = peerwork_get_pa_result($peerwork, $group, null, true);
    }

    $gradinginfo = grade_get_grades(
        $course->id,
        'mod',
        'peerwork',
        $peerwork->id,
        array_keys($members)
    );

    $data['finalgrades'] = [];

    foreach ($members as $member) {
        $overriddenweightedgrade = null;
        // Check if the grade has been overridden in the gradebook.
        $grade = $gradinginfo->items[0]->grades[$member->id];

        // Format mixed bool/integer parameters.
        $grade->overridden = (empty($grade->overridden)) ? 0 : $grade->overridden;
        $grade->locked = (empty($grade->locked)) ? 0 : $grade->locked;

        if ($grade->overridden || $grade->locked) {
            $localgrades[$member->id]->revisedgrade = $grade->grade;
        }

        // Check if the grade has been adjusted due to peer grade overrides.
        if ($canoverridepeergrades) {
            $overriddenweightedgrade = $overiddenresult->get_grade($member->id);
        }

        $data['finalgrades'][] = [
            'memberid' => $member->id,
            'fullname' => fullname($member),
            'contribution' => $result->get_score($member->id),
            'calcgrade' => $result->get_preliminary_grade($member->id),
            'penalty' => $result->get_non_completion_penalty($member->id),
            'finalweightedgrade' => $result->get_grade($member->id),
            'overriddenweightedgrade' => $overriddenweightedgrade,
            'revisedgrade' => $localgrades[$member->id]->revisedgrade ?? null,
            'overridden' => $grade->overridden,
            'locked' => $grade->locked,
        ];
    }
} else if ($duedatenotpassed) {
    $duedatehtml = html_writer::tag('div', get_string('duedatenotpassed', 'mod_peerwork'), ['class' => 'alert alert-danger']);
    $data['duedatenotpassed'] = $duedatehtml;
}

$mform->set_data($data);

if ($mform->is_cancelled()) {
    // Form cancelled, redirect.
    redirect(new moodle_url('view.php', ['id' => $cm->id]));

} else if (($data = $mform->get_data())) {

    // We only save anything when the grade was given.
    if ($data->grade !== null) {
        $grader = new mod_peerwork\group_grader($peerwork, $groupid, $submission);
        $grader->set_grade($data->grade, $data->paweighting);
        $grader->set_revised_grades($data->revisedgrades);
        $grader->set_feedback($data->feedback['text'], $data->feedback['format'], $draftitemid);
        $grader->commit();

        redirect(new moodle_url('details.php', ['id' => $id, 'groupid' => $groupid]),
            get_string('gradesandfeedbacksaved', 'mod_peerwork'), null, notification::NOTIFY_SUCCESS);
    }

    // Redirect to home page because there were no changes.
    redirect(new moodle_url('view.php', ['id' => $cm->id]));
}

//
// Form should now be setup to display, so do the output.
//
$params = [
    'objectid' => $cm->id,
    'context' => $context,
    'other' => ['groupid' => $group->id],
];
$event = submission_grade_form_viewed::create($params);
$event->trigger();

echo $OUTPUT->header();
$mform->display();
echo $OUTPUT->footer();