3 // This file is part of Moodle - http://moodle.org/
5 // Moodle is free software: you can redistribute it and/or modify
6 // it under the terms of the GNU General Public License as published by
7 // the Free Software Foundation, either version 3 of the License, or
8 // (at your option) any later version.
10 // Moodle is distributed in the hope that it will be useful,
11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 // GNU General Public License for more details.
15 // You should have received a copy of the GNU General Public License
16 // along with Moodle. If not, see <http://www.gnu.org/licenses/>.
19 * Display user activity reports for a course
22 * @copyright 1999 onwards Martin Dougiamas {@link http://moodle.com}
23 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
26 require(__DIR__
.'/../../config.php');
27 require_once($CFG->dirroot
.'/mod/forum/lib.php');
28 require_once($CFG->dirroot
.'/rating/lib.php');
29 require_once($CFG->dirroot
.'/user/lib.php');
31 $courseid = optional_param('course', null, PARAM_INT
); // Limit the posts to just this course
32 $userid = optional_param('id', $USER->id
, PARAM_INT
); // User id whose posts we want to view
33 $mode = optional_param('mode', 'posts', PARAM_ALPHA
); // The mode to use. Either posts or discussions
34 $page = optional_param('page', 0, PARAM_INT
); // The page number to display
35 $perpage = optional_param('perpage', 5, PARAM_INT
); // The number of posts to display per page
44 $discussionsonly = ($mode !== 'posts');
45 $isspecificcourse = !is_null($courseid);
46 $iscurrentuser = ($USER->id
== $userid);
48 $url = new moodle_url('/mod/forum/user.php', array('id' => $userid));
49 if ($isspecificcourse) {
50 $url->param('course', $courseid);
52 if ($discussionsonly) {
53 $url->param('mode', 'discussions');
57 $PAGE->set_pagelayout('standard');
60 $url->param('page', $page);
63 $url->param('perpage', $perpage);
66 $user = $DB->get_record("user", array("id" => $userid), '*', MUST_EXIST
);
67 $usercontext = context_user
::instance($user->id
, MUST_EXIST
);
68 // Check if the requested user is the guest user
69 if (isguestuser($user)) {
70 // The guest user cannot post, so it is not possible to view any posts.
71 // May as well just bail aggressively here.
72 print_error('invaliduserid');
74 // Make sure the user has not been deleted
76 $PAGE->set_title(get_string('userdeleted'));
77 $PAGE->set_context(context_system
::instance());
78 echo $OUTPUT->header();
79 echo $OUTPUT->heading($PAGE->title
);
80 echo $OUTPUT->footer();
84 $isloggedin = isloggedin();
85 $isguestuser = $isloggedin && isguestuser();
86 $isparent = !$iscurrentuser && $DB->record_exists('role_assignments', array('userid'=>$USER->id
, 'contextid'=>$usercontext->id
));
87 $hasparentaccess = $isparent && has_all_capabilities(array('moodle/user:viewdetails', 'moodle/user:readuserposts'), $usercontext);
89 // Check whether a specific course has been requested
90 if ($isspecificcourse) {
91 // Get the requested course and its context
92 $course = $DB->get_record('course', array('id' => $courseid), '*', MUST_EXIST
);
93 $coursecontext = context_course
::instance($courseid, MUST_EXIST
);
94 // We have a specific course to search, which we will also assume we are within.
95 if ($hasparentaccess) {
96 // A `parent` role won't likely have access to the course so we won't attempt
97 // to enter it. We will however still make them jump through the normal
100 $PAGE->set_context($coursecontext);
101 $PAGE->set_course($course);
103 // Enter the course we are searching
104 require_login($course);
106 // Get the course ready for access checks
107 $courses = array($courseid => $course);
109 // We are going to search for all of the users posts in all courses!
110 // a general require login here as we arn't actually within any course.
112 $PAGE->set_context(context_user
::instance($user->id
));
114 // Now we need to get all of the courses to search.
115 // All courses where the user has posted within a forum will be returned.
116 $courses = forum_get_courses_user_posted_in($user, $discussionsonly);
120 'context' => $PAGE->context
,
121 'relateduserid' => $user->id
,
122 'other' => array('reportmode' => $mode),
124 $event = \mod_forum\event\user_report_viewed
::create($params);
127 // Get the posts by the requested user that the current user can access.
128 $result = forum_get_posts_by_user($user, $courses, $isspecificcourse, $discussionsonly, ($page * $perpage), $perpage);
130 // Check whether there are not posts to display.
131 if (empty($result->posts
)) {
132 // Ok no posts to display means that either the user has not posted or there
133 // are no posts made by the requested user that the current user is able to
135 // In either case we need to decide whether we can show personal information
136 // about the requested user to the current user so we will execute some checks
138 $canviewuser = user_can_view_profile($user, null, $usercontext);
140 // Prepare the page title
141 $pagetitle = get_string('noposts', 'mod_forum');
143 // Get the page heading
144 if ($isspecificcourse) {
145 $pageheading = format_string($course->fullname
, true, array('context' => $coursecontext));
147 $pageheading = get_string('pluginname', 'mod_forum');
150 // Next we need to set up the loading of the navigation and choose a message
151 // to display to the current user.
152 if ($iscurrentuser) {
153 // No need to extend the navigation it happens automatically for the
155 if ($discussionsonly) {
156 $notification = get_string('nodiscussionsstartedbyyou', 'forum');
158 $notification = get_string('nopostsmadebyyou', 'forum');
160 // These are the user's forum interactions.
161 // Shut down the navigation 'Users' node.
162 $usernode = $PAGE->navigation
->find('users', null);
163 $usernode->make_inactive();
165 if (isset($courseid) && $courseid != SITEID
) {
166 // Create as much of the navbar automatically.
167 $newusernode = $PAGE->navigation
->find('user' . $user->id
, null);
168 $newusernode->make_active();
169 // Check to see if this is a discussion or a post.
170 if ($mode == 'posts') {
171 $navbar = $PAGE->navbar
->add(get_string('posts', 'forum'), new moodle_url('/mod/forum/user.php',
172 array('id' => $user->id
, 'course' => $courseid)));
174 $navbar = $PAGE->navbar
->add(get_string('discussions', 'forum'), new moodle_url('/mod/forum/user.php',
175 array('id' => $user->id
, 'course' => $courseid, 'mode' => 'discussions')));
178 } else if ($canviewuser) {
179 $PAGE->navigation
->extend_for_user($user);
180 $PAGE->navigation
->set_userid_for_parent_checks($user->id
); // see MDL-25805 for reasons and for full commit reference for reversal when fixed.
183 if (isset($courseid) && $courseid != SITEID
) {
184 // Create as much of the navbar automatically.
185 $usernode = $PAGE->navigation
->find('user' . $user->id
, null);
186 $usernode->make_active();
187 // Check to see if this is a discussion or a post.
188 if ($mode == 'posts') {
189 $navbar = $PAGE->navbar
->add(get_string('posts', 'forum'), new moodle_url('/mod/forum/user.php',
190 array('id' => $user->id
, 'course' => $courseid)));
192 $navbar = $PAGE->navbar
->add(get_string('discussions', 'forum'), new moodle_url('/mod/forum/user.php',
193 array('id' => $user->id
, 'course' => $courseid, 'mode' => 'discussions')));
197 $fullname = fullname($user);
198 if ($discussionsonly) {
199 $notification = get_string('nodiscussionsstartedby', 'forum', $fullname);
201 $notification = get_string('nopostsmadebyuser', 'forum', $fullname);
204 // Don't extend the navigation it would be giving out information that
205 // the current uesr doesn't have access to.
206 $notification = get_string('cannotviewusersposts', 'forum');
207 if ($isspecificcourse) {
208 $url = new moodle_url('/course/view.php', array('id' => $courseid));
210 $url = new moodle_url('/');
212 navigation_node
::override_active_url($url);
215 // Display a page letting the user know that there's nothing to display;
216 $PAGE->set_title($pagetitle);
217 if ($isspecificcourse) {
218 $PAGE->set_heading($pageheading);
219 } else if ($canviewuser) {
220 $PAGE->set_heading(fullname($user));
222 $PAGE->set_heading($SITE->fullname
);
224 echo $OUTPUT->header();
225 if (!$isspecificcourse) {
226 echo $OUTPUT->heading($pagetitle);
228 $userheading = array(
229 'heading' => fullname($user),
231 'usercontext' => $usercontext
233 echo $OUTPUT->context_header($userheading, 2);
235 echo $OUTPUT->notification($notification);
236 if (!$url->compare($PAGE->url
)) {
237 echo $OUTPUT->continue_button($url);
239 echo $OUTPUT->footer();
243 // Post output will contain an entry containing HTML to display each post by the
245 $postoutput = array();
247 $discussions = array();
248 foreach ($result->posts
as $post) {
249 $discussions[] = $post->discussion
;
251 $discussions = $DB->get_records_list('forum_discussions', 'id', array_unique($discussions));
253 //todo Rather than retrieving the ratings for each post individually it would be nice to do them in groups
254 //however this requires creating arrays of posts with each array containing all of the posts from a particular forum,
255 //retrieving the ratings then reassembling them all back into a single array sorted by post.modified (descending)
256 $rm = new rating_manager();
257 $ratingoptions = new stdClass
;
258 $ratingoptions->component
= 'mod_forum';
259 $ratingoptions->ratingarea
= 'post';
260 foreach ($result->posts
as $post) {
261 if (!isset($result->forums
[$post->forum
]) ||
!isset($discussions[$post->discussion
])) {
262 // Something very VERY dodgy has happened if we end up here
265 $forum = $result->forums
[$post->forum
];
267 $discussion = $discussions[$post->discussion
];
268 $course = $result->courses
[$discussion->course
];
270 $forumurl = new moodle_url('/mod/forum/view.php', array('id' => $cm->id
));
271 $discussionurl = new moodle_url('/mod/forum/discuss.php', array('d' => $post->discussion
));
274 if ($forum->assessed
!= RATING_AGGREGATE_NONE
) {
275 $ratingoptions->context
= $cm->context
;
276 $ratingoptions->items
= array($post);
277 $ratingoptions->aggregate
= $forum->assessed
;//the aggregation method
278 $ratingoptions->scaleid
= $forum->scale
;
279 $ratingoptions->userid
= $user->id
;
280 $ratingoptions->assesstimestart
= $forum->assesstimestart
;
281 $ratingoptions->assesstimefinish
= $forum->assesstimefinish
;
282 if ($forum->type
== 'single' or !$post->discussion
) {
283 $ratingoptions->returnurl
= $forumurl;
285 $ratingoptions->returnurl
= $discussionurl;
288 $updatedpost = $rm->get_ratings($ratingoptions);
289 //updating the array this way because we're iterating over a collection and updating them one by one
290 $result->posts
[$updatedpost[0]->id
] = $updatedpost[0];
293 $courseshortname = format_string($course->shortname
, true, array('context' => context_course
::instance($course->id
)));
294 $forumname = format_string($forum->name
, true, array('context' => $cm->context
));
296 $fullsubjects = array();
297 if (!$isspecificcourse && !$hasparentaccess) {
298 $fullsubjects[] = html_writer
::link(new moodle_url('/course/view.php', array('id' => $course->id
)), $courseshortname);
299 $fullsubjects[] = html_writer
::link($forumurl, $forumname);
301 $fullsubjects[] = html_writer
::tag('span', $courseshortname);
302 $fullsubjects[] = html_writer
::tag('span', $forumname);
304 if ($forum->type
!= 'single') {
305 $discussionname = format_string($discussion->name
, true, array('context' => $cm->context
));
306 if (!$isspecificcourse && !$hasparentaccess) {
307 $fullsubjects[] .= html_writer
::link($discussionurl, $discussionname);
309 $fullsubjects[] .= html_writer
::tag('span', $discussionname);
311 if ($post->parent
!= 0) {
312 $postname = format_string($post->subject
, true, array('context' => $cm->context
));
313 if (!$isspecificcourse && !$hasparentaccess) {
314 $fullsubjects[] .= html_writer
::link(new moodle_url('/mod/forum/discuss.php', array('d' => $post->discussion
, 'parent' => $post->id
)), $postname);
316 $fullsubjects[] .= html_writer
::tag('span', $postname);
320 $post->subject
= join(' -> ', $fullsubjects);
321 // This is really important, if the strings are formatted again all the links
322 // we've added will be lost.
323 $post->subjectnoformat
= true;
324 $discussionurl->set_anchor('p'.$post->id
);
325 $fulllink = html_writer
::link($discussionurl, get_string("postincontext", "forum"));
327 $postoutput[] = forum_print_post($post, $discussion, $forum, $cm, $course, false, false, false, $fulllink, '', null, true, null, true);
330 $userfullname = fullname($user);
332 if ($discussionsonly) {
333 $inpageheading = get_string('discussionsstartedby', 'mod_forum', $userfullname);
335 $inpageheading = get_string('postsmadebyuser', 'mod_forum', $userfullname);
337 if ($isspecificcourse) {
339 $a->fullname
= $userfullname;
340 $a->coursename
= format_string($course->fullname
, true, array('context' => $coursecontext));
341 $pageheading = $a->coursename
;
342 if ($discussionsonly) {
343 $pagetitle = get_string('discussionsstartedbyuserincourse', 'mod_forum', $a);
345 $pagetitle = get_string('postsmadebyuserincourse', 'mod_forum', $a);
348 $pagetitle = $inpageheading;
349 $pageheading = $userfullname;
352 $PAGE->set_title($pagetitle);
353 $PAGE->set_heading($pageheading);
355 $PAGE->navigation
->extend_for_user($user);
356 $PAGE->navigation
->set_userid_for_parent_checks($user->id
); // see MDL-25805 for reasons and for full commit reference for reversal when fixed.
359 if (isset($courseid) && $courseid != SITEID
) {
360 $usernode = $PAGE->navigation
->find('user' . $user->id
, null);
361 $usernode->make_active();
362 // Check to see if this is a discussion or a post.
363 if ($mode == 'posts') {
364 $navbar = $PAGE->navbar
->add(get_string('posts', 'forum'), new moodle_url('/mod/forum/user.php',
365 array('id' => $user->id
, 'course' => $courseid)));
367 $navbar = $PAGE->navbar
->add(get_string('discussions', 'forum'), new moodle_url('/mod/forum/user.php',
368 array('id' => $user->id
, 'course' => $courseid, 'mode' => 'discussions')));
372 echo $OUTPUT->header();
373 echo html_writer
::start_tag('div', array('class' => 'user-content'));
375 if ($isspecificcourse) {
376 $userheading = array(
377 'heading' => fullname($user),
379 'usercontext' => $usercontext
381 echo $OUTPUT->context_header($userheading, 2);
383 echo $OUTPUT->heading($inpageheading);
386 if (!empty($postoutput)) {
387 echo $OUTPUT->paging_bar($result->totalcount
, $page, $perpage, $url);
388 foreach ($postoutput as $post) {
390 echo html_writer
::empty_tag('br');
392 echo $OUTPUT->paging_bar($result->totalcount
, $page, $perpage, $url);
393 } else if ($discussionsonly) {
394 echo $OUTPUT->heading(get_string('nodiscussionsstartedby', 'forum', $userfullname));
396 echo $OUTPUT->heading(get_string('noposts', 'forum'));
399 echo html_writer
::end_tag('div');
400 echo $OUTPUT->footer();