MDL-49324 grades: Create helper function for regrading on report view
[moodle.git] / grade / report / user / 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 user report
19  *
20  * @package   gradereport_user
21  * @copyright 2007 Moodle Pty Ltd (http://moodle.com)
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/user/lib.php';
30 $courseid = required_param('id', PARAM_INT);
31 $userid   = optional_param('userid', $USER->id, PARAM_INT);
33 $PAGE->set_url(new moodle_url('/grade/report/user/index.php', array('id'=>$courseid)));
35 /// basic access checks
36 if (!$course = $DB->get_record('course', array('id' => $courseid))) {
37     print_error('nocourseid');
38 }
39 require_login($course);
40 $PAGE->set_pagelayout('report');
42 $context = context_course::instance($course->id);
43 require_capability('gradereport/user:view', $context);
45 if (empty($userid)) {
46     require_capability('moodle/grade:viewall', $context);
48 } else {
49     if (!$DB->get_record('user', array('id'=>$userid, 'deleted'=>0)) or isguestuser($userid)) {
50         print_error('invaliduser');
51     }
52 }
54 $access = false;
55 if (has_capability('moodle/grade:viewall', $context)) {
56     //ok - can view all course grades
57     $access = true;
59 } else if ($userid == $USER->id and has_capability('moodle/grade:view', $context) and $course->showgrades) {
60     //ok - can view own grades
61     $access = true;
63 } else if (has_capability('moodle/grade:viewall', context_user::instance($userid)) and $course->showgrades) {
64     // ok - can view grades of this user- parent most probably
65     $access = true;
66 }
68 if (!$access) {
69     // no access to grades!
70     print_error('nopermissiontoviewgrades', 'error',  $CFG->wwwroot.'/course/view.php?id='.$courseid);
71 }
73 /// return tracking object
74 $gpr = new grade_plugin_return(array('type'=>'report', 'plugin'=>'user', 'courseid'=>$courseid, 'userid'=>$userid));
76 /// last selected report session tracking
77 if (!isset($USER->grade_last_report)) {
78     $USER->grade_last_report = array();
79 }
80 $USER->grade_last_report[$course->id] = 'user';
82 // First make sure we have proper final grades.
83 grade_regrade_final_grades_if_required($course);
85 if (has_capability('moodle/grade:viewall', $context)) { //Teachers will see all student reports
86     $groupmode    = groups_get_course_groupmode($course);   // Groups are being used
87     $currentgroup = groups_get_course_group($course, true);
89     if (!$currentgroup) {      // To make some other functions work better later
90         $currentgroup = NULL;
91     }
93     $isseparategroups = ($course->groupmode == SEPARATEGROUPS and !has_capability('moodle/site:accessallgroups', $context));
95     if ($isseparategroups and (!$currentgroup)) {
96         // no separate group access, can view only self
97         $userid = $USER->id;
98         $user_selector = false;
99     } else {
100         $user_selector = true;
101     }
103     $defaultgradeshowactiveenrol = !empty($CFG->grade_report_showonlyactiveenrol);
104     $showonlyactiveenrol = get_user_preferences('grade_report_showonlyactiveenrol', $defaultgradeshowactiveenrol);
105     $showonlyactiveenrol = $showonlyactiveenrol || !has_capability('moodle/course:viewsuspendedusers', $context);
106     if (empty($userid)) {
107         $gui = new graded_users_iterator($course, null, $currentgroup);
108         $gui->require_active_enrolment($showonlyactiveenrol);
109         $gui->init();
110         // Add tabs
111         print_grade_page_head($courseid, 'report', 'user');
112         groups_print_course_menu($course, $gpr->get_return_url('index.php?id='.$courseid, array('userid'=>0)));
114         if ($user_selector) {
115             $renderer = $PAGE->get_renderer('gradereport_user');
116             echo $renderer->graded_users_selector('user', $course, $userid, $currentgroup, true);
117         }
119         while ($userdata = $gui->next_user()) {
120             $user = $userdata->user;
121             $report = new grade_report_user($courseid, $gpr, $context, $user->id);
123             $studentnamelink = html_writer::link(new moodle_url('/user/view.php', array('id' => $report->user->id, 'course' => $courseid)), fullname($report->user));
124             echo $OUTPUT->heading(get_string('pluginname', 'gradereport_user') . ' - ' . $studentnamelink);
126             if ($report->fill_table()) {
127                 echo '<br />'.$report->print_table(true);
128             }
129             echo "<p style = 'page-break-after: always;'></p>";
130         }
131         $gui->close();
132     } else { // Only show one user's report
133         $report = new grade_report_user($courseid, $gpr, $context, $userid);
135         $studentnamelink = html_writer::link(new moodle_url('/user/view.php', array('id' => $report->user->id, 'course' => $courseid)), fullname($report->user));
136         print_grade_page_head($courseid, 'report', 'user', get_string('pluginname', 'gradereport_user') . ' - ' . $studentnamelink,
137                 false, false, true, null, null, $report->user);
139         groups_print_course_menu($course, $gpr->get_return_url('index.php?id='.$courseid, array('userid'=>0)));
141         if ($user_selector) {
142             $renderer = $PAGE->get_renderer('gradereport_user');
143             $showallusersoptions = true;
144             echo $renderer->graded_users_selector('user', $course, $userid, $currentgroup, $showallusersoptions);
145         }
147         if ($currentgroup and !groups_is_member($currentgroup, $userid)) {
148             echo $OUTPUT->notification(get_string('groupusernotmember', 'error'));
149         } else {
150             if ($report->fill_table()) {
151                 echo '<br />'.$report->print_table(true);
152             }
153         }
154     }
155 } else { //Students will see just their own report
157     // Create a report instance
158     $report = new grade_report_user($courseid, $gpr, $context, $userid);
160     // print the page
161     print_grade_page_head($courseid, 'report', 'user', get_string('pluginname', 'gradereport_user'). ' - '.fullname($report->user));
163     if ($report->fill_table()) {
164         echo '<br />'.$report->print_table(true);
165     }
168 if (isset($report)) {
169     // Trigger report viewed event.
170     $report->viewed();
171 } else {
172     echo html_writer::tag('div', '', array('class' => 'clearfix'));
173     echo $OUTPUT->notification(get_string('nostudentsyet'));
176 echo $OUTPUT->footer();