MDL-49324 grades: Create helper function for regrading on report view
[moodle.git] / grade / report / overview / index.php
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.
13 //
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  * The gradebook overview report
19  *
20  * @package   gradereport_overview
21  * @copyright 2007 Nicolas Connault
22  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23  */
25 require_once '../../../config.php';
26 require_once $CFG->libdir.'/gradelib.php';
27 require_once $CFG->dirroot.'/grade/lib.php';
28 require_once $CFG->dirroot.'/grade/report/overview/lib.php';
30 $courseid = optional_param('id', SITEID, PARAM_INT);
31 $userid   = optional_param('userid', $USER->id, PARAM_INT);
33 $PAGE->set_url(new moodle_url('/grade/report/overview/index.php', array('id' => $courseid, 'userid' => $userid)));
35 if (!$course = $DB->get_record('course', array('id' => $courseid))) {
36     print_error('nocourseid');
37 }
38 require_login(null, false);
39 $PAGE->set_course($course);
41 $context = context_course::instance($course->id);
42 $systemcontext = context_system::instance();
43 $personalcontext = null;
45 // If we are accessing the page from a site context then ignore this check.
46 if ($courseid != SITEID) {
47     require_capability('gradereport/overview:view', $context);
48 }
50 if (empty($userid)) {
51     require_capability('moodle/grade:viewall', $context);
53 } else {
54     if (!$DB->get_record('user', array('id'=>$userid, 'deleted'=>0)) or isguestuser($userid)) {
55         print_error('invaliduserid');
56     }
57     $personalcontext = context_user::instance($userid);
58 }
60 if (isset($personalcontext) && $courseid == SITEID) {
61     $PAGE->set_context($personalcontext);
62 } else {
63     $PAGE->set_context($context);
64 }
65 if ($userid == $USER->id) {
66     $settings = $PAGE->settingsnav->find('mygrades', null);
67     $settings->make_active();
68 } else if ($courseid != SITEID && $userid) {
69     // Show some other navbar thing.
70     $user = $DB->get_record('user', array('id' => $userid), '*', MUST_EXIST);
71     $PAGE->navigation->extend_for_user($user);
72 }
74 $access = false;
75 if (has_capability('moodle/grade:viewall', $systemcontext)) {
76     // Ok - can view all course grades.
77     $access = true;
79 } else if (has_capability('moodle/grade:viewall', $context)) {
80     // Ok - can view any grades in context.
81     $access = true;
83 } else if ($userid == $USER->id and ((has_capability('moodle/grade:view', $context) and $course->showgrades)
84         || $courseid == SITEID)) {
85     // Ok - can view own course grades.
86     $access = true;
88 } else if (has_capability('moodle/grade:viewall', $personalcontext) and $course->showgrades) {
89     // Ok - can view grades of this user - parent most probably.
90     $access = true;
91 } else if (has_capability('moodle/user:viewuseractivitiesreport', $personalcontext) and $course->showgrades) {
92     // Ok - can view grades of this user - parent most probably.
93     $access = true;
94 }
96 if (!$access) {
97     // no access to grades!
98     print_error('nopermissiontoviewgrades', 'error',  $CFG->wwwroot.'/course/view.php?id='.$courseid);
99 }
101 /// return tracking object
102 $gpr = new grade_plugin_return(array('type'=>'report', 'plugin'=>'overview', 'courseid'=>$course->id, 'userid'=>$userid));
104 /// last selected report session tracking
105 if (!isset($USER->grade_last_report)) {
106     $USER->grade_last_report = array();
108 $USER->grade_last_report[$course->id] = 'overview';
110 // First make sure we have proper final grades.
111 grade_regrade_final_grades_if_required($course);
113 if (has_capability('moodle/grade:viewall', $context) && $courseid != SITEID) {
114     // Please note this would be extremely slow if we wanted to implement this properly for all teachers.
115     $groupmode    = groups_get_course_groupmode($course);   // Groups are being used
116     $currentgroup = groups_get_course_group($course, true);
118     if (!$currentgroup) {      // To make some other functions work better later
119         $currentgroup = NULL;
120     }
122     $isseparategroups = ($course->groupmode == SEPARATEGROUPS and !has_capability('moodle/site:accessallgroups', $context));
124     if ($isseparategroups and (!$currentgroup)) {
125         // no separate group access, can view only self
126         $userid = $USER->id;
127         $user_selector = false;
128     } else {
129         $user_selector = true;
130     }
132     if (empty($userid)) {
133         // Add tabs
134         print_grade_page_head($courseid, 'report', 'overview');
136         groups_print_course_menu($course, $gpr->get_return_url('index.php?id='.$courseid, array('userid'=>0)));
138         if ($user_selector) {
139             $renderer = $PAGE->get_renderer('gradereport_overview');
140             echo $renderer->graded_users_selector('overview', $course, $userid, $currentgroup, false);
141         }
142         // do not list all users
144     } else { // Only show one user's report
145         $report = new grade_report_overview($userid, $gpr, $context);
146         print_grade_page_head($courseid, 'report', 'overview', get_string('pluginname', 'gradereport_overview') .
147                 ' - ' . fullname($report->user), false, false, true, null, null, $report->user);
148         groups_print_course_menu($course, $gpr->get_return_url('index.php?id='.$courseid, array('userid'=>0)));
150         if ($user_selector) {
151             $renderer = $PAGE->get_renderer('gradereport_overview');
152             echo $renderer->graded_users_selector('overview', $course, $userid, $currentgroup, false);
153         }
155         if ($currentgroup and !groups_is_member($currentgroup, $userid)) {
156             echo $OUTPUT->notification(get_string('groupusernotmember', 'error'));
157         } else {
158             if ($report->fill_table()) {
159                 echo '<br />'.$report->print_table(true);
160             }
161         }
162     }
163 } else { // Non-admins and users viewing from the site context can just see their own report.
165     // Create a report instance
166     $report = new grade_report_overview($userid, $gpr, $context);
168     if (!empty($report->studentcourseids)) {
169         // If the course id matches the site id then we don't have a course context to work with.
170         // Display a standard page.
171         if ($courseid == SITEID) {
172             $PAGE->set_pagelayout('standard');
173             $header = get_string('grades', 'grades') . ' - ' . fullname($report->user);
174             $PAGE->set_title($header);
175             $PAGE->set_heading(fullname($report->user));
177             if ($USER->id != $report->user->id) {
178                 $PAGE->navigation->extend_for_user($report->user);
179                 if ($node = $PAGE->settingsnav->get('userviewingsettings'.$report->user->id)) {
180                     $node->forceopen = true;
181                 }
182             } else if ($node = $PAGE->settingsnav->get('usercurrentsettings', navigation_node::TYPE_CONTAINER)) {
183                 $node->forceopen = true;
184             }
186             echo $OUTPUT->header();
187             if ($report->fill_table(true, true)) {
188                 echo html_writer::tag('h3', get_string('coursesiamtaking', 'grades'));
189                 echo '<br />' . $report->print_table(true);
190             }
191         } else { // We have a course context. We must be navigating from the gradebook.
192             print_grade_page_head($courseid, 'report', 'overview', get_string('pluginname', 'gradereport_overview')
193                     . ' - ' . fullname($report->user));
194             if ($report->fill_table()) {
195                 echo '<br />' . $report->print_table(true);
196             }
197         }
198     } else {
199         $PAGE->set_pagelayout('standard');
200         $header = get_string('grades', 'grades') . ' - ' . fullname($report->user);
201         $PAGE->set_title($header);
202         $PAGE->set_heading(fullname($report->user));
203         echo $OUTPUT->header();
204     }
206     if (count($report->teachercourses)) {
207         echo html_writer::tag('h3', get_string('coursesiamteaching', 'grades'));
208         $report->print_teacher_table();
209     }
211     if (empty($report->studentcourseids) && empty($report->teachercourses)) {
212         // We have no report to show the user. Let them know something.
213         echo $OUTPUT->notification(get_string('noreports', 'grades'), 'notifymessage');
214     }
217 $event = \gradereport_overview\event\grade_report_viewed::create(
218     array(
219         'context' => $context,
220         'courseid' => $courseid,
221         'relateduserid' => $userid,
222     )
223 );
224 $event->trigger();
226 echo $OUTPUT->footer();