mirror of
https://github.com/moodle/moodle.git
synced 2025-02-12 11:32:04 +01:00
e3633dc719
Do not enclose \core_grades_renderer::user_heading() in $OUTPUT->heading() and enclose the user's name in the user heading in <h2> tags instead. - Having <div> inside <h2> results in errors in HTML validation. - Enclosing the whole user heading in <h2> results in the other elements in the user heading (Message, Add to contacts) to be announced to screen readers which can result in confusion.
214 lines
8.5 KiB
PHP
214 lines
8.5 KiB
PHP
<?php
|
|
// This file is part of Moodle - http://moodle.org/
|
|
//
|
|
// Moodle is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// Moodle is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
/**
|
|
* The gradebook user report
|
|
*
|
|
* @package gradereport_user
|
|
* @copyright 2007 Moodle Pty Ltd (http://moodle.com)
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
require_once '../../../config.php';
|
|
require_once $CFG->libdir.'/gradelib.php';
|
|
require_once $CFG->dirroot.'/grade/lib.php';
|
|
require_once $CFG->dirroot.'/grade/report/user/lib.php';
|
|
|
|
$courseid = required_param('id', PARAM_INT);
|
|
$userid = optional_param('userid', null, PARAM_INT);
|
|
$userview = optional_param('userview', 0, PARAM_INT);
|
|
|
|
$PAGE->set_url(new moodle_url('/grade/report/user/index.php', ['id' => $courseid]));
|
|
|
|
if ($userview == 0) {
|
|
$userview = get_user_preferences('gradereport_user_view_user', GRADE_REPORT_USER_VIEW_USER);
|
|
} else {
|
|
set_user_preference('gradereport_user_view_user', $userview);
|
|
}
|
|
|
|
// Basic access checks.
|
|
if (!$course = $DB->get_record('course', ['id' => $courseid])) {
|
|
throw new \moodle_exception('invalidcourseid');
|
|
}
|
|
require_login($course);
|
|
$PAGE->set_pagelayout('report');
|
|
|
|
$context = context_course::instance($course->id);
|
|
require_capability('gradereport/user:view', $context);
|
|
|
|
if ($userid === 0) {
|
|
require_capability('moodle/grade:viewall', $context);
|
|
} else if ($userid) {
|
|
if (!$DB->get_record('user', ['id' => $userid, 'deleted' => 0]) || isguestuser($userid)) {
|
|
throw new \moodle_exception('invaliduser');
|
|
}
|
|
}
|
|
|
|
$access = false;
|
|
if (has_capability('moodle/grade:viewall', $context)) {
|
|
// User can view all course grades.
|
|
$access = true;
|
|
} else if (($userid == $USER->id || is_null($userid)) && has_capability('moodle/grade:view', $context) && $course->showgrades) {
|
|
// User can view own grades.
|
|
$access = true;
|
|
} else if (has_capability('moodle/grade:viewall', context_user::instance($userid)) && $course->showgrades) {
|
|
// User can view grades of this user, The user is an parent most probably.
|
|
$access = true;
|
|
}
|
|
|
|
if (!$access) {
|
|
// The user has no access to grades.
|
|
throw new \moodle_exception('nopermissiontoviewgrades', 'error', $CFG->wwwroot.'/course/view.php?id='.$courseid);
|
|
}
|
|
|
|
// Initialise the grade tracking object.
|
|
$gpr = new grade_plugin_return(['type' => 'report', 'plugin' => 'user', 'courseid' => $courseid, 'userid' => $userid]);
|
|
|
|
// Infer the users previously selected report via session tracking.
|
|
if (!isset($USER->grade_last_report)) {
|
|
$USER->grade_last_report = [];
|
|
}
|
|
$USER->grade_last_report[$course->id] = 'user';
|
|
|
|
// First make sure we have proper final grades.
|
|
grade_regrade_final_grades_if_required($course);
|
|
|
|
$gradesrenderer = $PAGE->get_renderer('core_grades');
|
|
|
|
// Teachers will see all student reports.
|
|
if (has_capability('moodle/grade:viewall', $context)) {
|
|
// Verify if we are using groups or not.
|
|
$groupmode = groups_get_course_groupmode($course);
|
|
$currentgroup = $gpr->groupid;
|
|
// Conditionally add the group JS if we have groups enabled.
|
|
if ($groupmode) {
|
|
$PAGE->requires->js_call_amd('gradereport_user/group', 'init');
|
|
}
|
|
|
|
// To make some other functions work better later.
|
|
if (!$currentgroup) {
|
|
$currentgroup = null;
|
|
}
|
|
|
|
$isseparategroups = ($course->groupmode == SEPARATEGROUPS && !has_capability('moodle/site:accessallgroups', $context));
|
|
|
|
if ($isseparategroups && (!$currentgroup)) {
|
|
// No separate group access, The user can view only themselves.
|
|
$userid = $USER->id;
|
|
}
|
|
|
|
// If there is a stored (last viewed) user in a session variable, bypass the user select zero state and display the
|
|
// report for that user.
|
|
$lastvieweduserid = $SESSION->gradereport_user["useritem-{$context->id}"] ?? null;
|
|
if (is_null($userid) && !is_null($lastvieweduserid)) {
|
|
$userid = $lastvieweduserid;
|
|
}
|
|
|
|
$gradableusers = get_gradable_users($courseid, $currentgroup);
|
|
// Validate whether the requested user is a valid gradable user in this course. If, not display the user select
|
|
// zero state.
|
|
if (empty($gradableusers) || ($userid && !array_key_exists($userid, $gradableusers))) {
|
|
$userid = null;
|
|
}
|
|
|
|
$defaultgradeshowactiveenrol = !empty($CFG->grade_report_showonlyactiveenrol);
|
|
$showonlyactiveenrol = get_user_preferences('grade_report_showonlyactiveenrol', $defaultgradeshowactiveenrol);
|
|
$showonlyactiveenrol = $showonlyactiveenrol || !has_capability('moodle/course:viewsuspendedusers', $context);
|
|
|
|
if ($userview == GRADE_REPORT_USER_VIEW_USER) {
|
|
$viewasuser = true;
|
|
} else {
|
|
$viewasuser = false;
|
|
}
|
|
|
|
$gui = new graded_users_iterator($course, null, $currentgroup);
|
|
$gui->require_active_enrolment($showonlyactiveenrol);
|
|
$gui->init();
|
|
|
|
if (is_null($userid)) { // Zero state.
|
|
$actionbar = new \gradereport_user\output\action_bar($context, $userview, null, $currentgroup);
|
|
// Print header.
|
|
print_grade_page_head($courseid, 'report', 'user', false, false, null, true,
|
|
null, null, null, $actionbar);
|
|
|
|
if (empty($gradableusers)) { // There are no available gradable users, display a notification.
|
|
$message = $currentgroup ? get_string('nostudentsingroup') : get_string('nostudentsyet');
|
|
echo $OUTPUT->notification($message, 'warning', false);
|
|
} else { // Otherwise, display the zero state template.
|
|
$report = new gradereport_user\report\user($courseid, $gpr, $context, $USER->id, $viewasuser);
|
|
echo $report->output_report_zerostate();
|
|
}
|
|
} else if ($userid == 0) { // Show all reports.
|
|
// Store the id of the current user item in a session variable which represents the last viewed item.
|
|
$SESSION->gradereport_user["useritem-{$context->id}"] = $userid;
|
|
|
|
$actionbar = new \gradereport_user\output\action_bar($context, $userview, 0, $currentgroup);
|
|
print_grade_page_head($courseid, 'report', 'user', false, false, null, true,
|
|
null, null, null, $actionbar);
|
|
|
|
while ($userdata = $gui->next_user()) {
|
|
$user = $userdata->user;
|
|
$report = new gradereport_user\report\user($courseid, $gpr, $context, $user->id, $viewasuser);
|
|
$userheading = $gradesrenderer->user_heading($report->user, $courseid, false);
|
|
|
|
echo $userheading;
|
|
|
|
if ($report->fill_table()) {
|
|
echo $report->print_table(true);
|
|
}
|
|
}
|
|
$gui->close();
|
|
} else { // Show one user's report.
|
|
// Store the id of the current user item in a session variable which represents the last viewed item.
|
|
$SESSION->gradereport_user["useritem-{$context->id}"] = $userid;
|
|
|
|
$report = new gradereport_user\report\user($courseid, $gpr, $context, $userid, $viewasuser);
|
|
$actionbar = new \gradereport_user\output\action_bar($context, $userview, $report->user->id, $currentgroup);
|
|
|
|
print_grade_page_head($courseid, 'report', 'user', false, false, false, true, null, null, $report->user, $actionbar);
|
|
|
|
if ($currentgroup && !groups_is_member($currentgroup, $userid)) {
|
|
echo $OUTPUT->notification(get_string('groupusernotmember', 'error'));
|
|
} else {
|
|
if ($report->fill_table()) {
|
|
echo $report->print_table(true);
|
|
}
|
|
}
|
|
$userreportrenderer = $PAGE->get_renderer('gradereport_user');
|
|
// Render the user report (previous/next) navigation in a sticky footer.
|
|
$stickyfooter = new core\output\sticky_footer($userreportrenderer->user_navigation($gui, $userid, $courseid));
|
|
echo $OUTPUT->render($stickyfooter);
|
|
}
|
|
} else {
|
|
// Students will see just their own report.
|
|
// Create a report instance.
|
|
$report = new gradereport_user\report\user($courseid, $gpr, $context, $userid ?? $USER->id);
|
|
|
|
// Print the page.
|
|
print_grade_page_head($courseid, 'report', 'user', false, false, false, true, null, null, $report->user);
|
|
|
|
if ($report->fill_table()) {
|
|
echo $report->print_table(true);
|
|
}
|
|
}
|
|
|
|
if (isset($report)) {
|
|
// Trigger report viewed event.
|
|
$report->viewed();
|
|
}
|
|
|
|
echo $OUTPUT->footer();
|