Merge branch 'MDL-70789-311' of git://github.com/paulholden/moodle into MOODLE_311_STABLE
[moodle.git] / lib / myprofilelib.php
blobe55d95da660fa08330b4035868209583ffb8c101
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.
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 * Defines core nodes for my profile navigation tree.
20 * @package core
21 * @copyright 2015 onwards Ankit Agarwal
22 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
25 defined('MOODLE_INTERNAL') || die();
27 /**
28 * Defines core nodes for my profile navigation tree.
30 * @param \core_user\output\myprofile\tree $tree Tree object
31 * @param stdClass $user user object
32 * @param bool $iscurrentuser is the user viewing profile, current user ?
33 * @param stdClass $course course object
35 * @return bool
37 function core_myprofile_navigation(core_user\output\myprofile\tree $tree, $user, $iscurrentuser, $course) {
38 global $CFG, $USER, $DB, $PAGE, $OUTPUT;
40 $usercontext = context_user::instance($user->id, MUST_EXIST);
41 $systemcontext = context_system::instance();
42 $courseorusercontext = !empty($course) ? context_course::instance($course->id) : $usercontext;
43 $courseorsystemcontext = !empty($course) ? context_course::instance($course->id) : $systemcontext;
44 $courseid = !empty($course) ? $course->id : SITEID;
46 $contactcategory = new core_user\output\myprofile\category('contact', get_string('userdetails'));
47 // No after property specified intentionally. It is a hack to make administration block appear towards the end. Refer MDL-49928.
48 $coursedetailscategory = new core_user\output\myprofile\category('coursedetails', get_string('coursedetails'));
49 $miscategory = new core_user\output\myprofile\category('miscellaneous', get_string('miscellaneous'), 'coursedetails');
50 $reportcategory = new core_user\output\myprofile\category('reports', get_string('reports'), 'miscellaneous');
51 $admincategory = new core_user\output\myprofile\category('administration', get_string('administration'), 'reports');
52 $loginactivitycategory = new core_user\output\myprofile\category('loginactivity', get_string('loginactivity'), 'administration');
54 // Add categories.
55 $tree->add_category($contactcategory);
56 $tree->add_category($coursedetailscategory);
57 $tree->add_category($miscategory);
58 $tree->add_category($reportcategory);
59 $tree->add_category($admincategory);
60 $tree->add_category($loginactivitycategory);
62 // Add core nodes.
63 // Full profile node.
64 if (!empty($course)) {
65 if (user_can_view_profile($user, null, $usercontext)) {
66 $url = new moodle_url('/user/profile.php', array('id' => $user->id));
67 $node = new core_user\output\myprofile\node('miscellaneous', 'fullprofile', get_string('fullprofile'), null, $url);
68 $tree->add_node($node);
72 // Edit profile.
73 if (isloggedin() && !isguestuser($user) && !is_mnet_remote_user($user)) {
74 if (($iscurrentuser || is_siteadmin($USER) || !is_siteadmin($user)) && has_capability('moodle/user:update',
75 $systemcontext)) {
76 $url = new moodle_url('/user/editadvanced.php', array('id' => $user->id, 'course' => $courseid,
77 'returnto' => 'profile'));
78 $node = new core_user\output\myprofile\node('contact', 'editprofile', get_string('editmyprofile'), null, $url,
79 null, null, 'editprofile');
80 $tree->add_node($node);
81 } else if ((has_capability('moodle/user:editprofile', $usercontext) && !is_siteadmin($user))
82 || ($iscurrentuser && has_capability('moodle/user:editownprofile', $systemcontext))) {
83 $userauthplugin = false;
84 if (!empty($user->auth)) {
85 $userauthplugin = get_auth_plugin($user->auth);
87 if ($userauthplugin && $userauthplugin->can_edit_profile()) {
88 $url = $userauthplugin->edit_profile_url();
89 if (empty($url)) {
90 if (empty($course)) {
91 $url = new moodle_url('/user/edit.php', array('id' => $user->id, 'returnto' => 'profile'));
92 } else {
93 $url = new moodle_url('/user/edit.php', array('id' => $user->id, 'course' => $course->id,
94 'returnto' => 'profile'));
97 $node = new core_user\output\myprofile\node('contact', 'editprofile',
98 get_string('editmyprofile'), null, $url, null, null, 'editprofile');
99 $tree->add_node($node);
104 // Preference page.
105 if (!$iscurrentuser && $PAGE->settingsnav->can_view_user_preferences($user->id)) {
106 $url = new moodle_url('/user/preferences.php', array('userid' => $user->id));
107 $title = get_string('preferences', 'moodle');
108 $node = new core_user\output\myprofile\node('administration', 'preferences', $title, null, $url);
109 $tree->add_node($node);
112 // Login as ...
113 if (!$user->deleted && !$iscurrentuser &&
114 !\core\session\manager::is_loggedinas() && has_capability('moodle/user:loginas',
115 $courseorsystemcontext) && !is_siteadmin($user->id)) {
116 $url = new moodle_url('/course/loginas.php',
117 array('id' => $courseid, 'user' => $user->id, 'sesskey' => sesskey()));
118 $node = new core_user\output\myprofile\node('administration', 'loginas', get_string('loginas'), null, $url);
119 $tree->add_node($node);
122 // Contact details.
123 if (has_capability('moodle/user:viewhiddendetails', $courseorusercontext)) {
124 $hiddenfields = array();
125 } else {
126 $hiddenfields = array_flip(explode(',', $CFG->hiddenuserfields));
128 // TODO Does not support custom user profile fields (MDL-70456).
129 $identityfields = array_flip(\core\user_fields::get_identity_fields($courseorusercontext, false));
131 if (is_mnet_remote_user($user)) {
132 $sql = "SELECT h.id, h.name, h.wwwroot,
133 a.name as application, a.display_name
134 FROM {mnet_host} h, {mnet_application} a
135 WHERE h.id = ? AND h.applicationid = a.id";
137 $remotehost = $DB->get_record_sql($sql, array($user->mnethostid));
138 $remoteuser = new stdclass();
139 $remoteuser->remotetype = $remotehost->display_name;
140 $hostinfo = new stdclass();
141 $hostinfo->remotename = $remotehost->name;
142 $hostinfo->remoteurl = $remotehost->wwwroot;
144 $node = new core_user\output\myprofile\node('contact', 'mnet', get_string('remoteuser', 'mnet', $remoteuser), null, null,
145 get_string('remoteuserinfo', 'mnet', $hostinfo), null, 'remoteuserinfo');
146 $tree->add_node($node);
149 if ($iscurrentuser
150 or (!isset($hiddenfields['email']) and (
151 $user->maildisplay == core_user::MAILDISPLAY_EVERYONE
152 or ($user->maildisplay == core_user::MAILDISPLAY_COURSE_MEMBERS_ONLY and enrol_sharing_course($user, $USER))
153 or has_capability('moodle/course:useremail', $courseorusercontext) // TODO: Deprecate/remove for MDL-37479.
155 or (isset($identityfields['email']))
157 $maildisplay = obfuscate_mailto($user->email, '');
158 if ($iscurrentuser) {
159 if ($user->maildisplay == core_user::MAILDISPLAY_EVERYONE) {
160 $maildisplay .= ' ' . get_string('emaildisplayeveryone');
161 } else if ($user->maildisplay == core_user::MAILDISPLAY_COURSE_MEMBERS_ONLY) {
162 $maildisplay .= ' ' . get_string('emaildisplaycoursemembersonly');
163 } else {
164 $maildisplay .= ' ' . get_string('emaildisplayhide');
167 $node = new core_user\output\myprofile\node('contact', 'email', get_string('email'),
168 null, null, $maildisplay);
169 $tree->add_node($node);
172 if (!isset($hiddenfields['moodlenetprofile']) && $user->moodlenetprofile) {
173 $node = new core_user\output\myprofile\node('contact', 'moodlenetprofile', get_string('moodlenetprofile', 'user'), null,
174 null, $user->moodlenetprofile);
175 $tree->add_node($node);
178 if (!isset($hiddenfields['country']) && $user->country) {
179 $node = new core_user\output\myprofile\node('contact', 'country', get_string('country'), null, null,
180 get_string($user->country, 'countries'));
181 $tree->add_node($node);
184 if (!isset($hiddenfields['city']) && $user->city) {
185 $node = new core_user\output\myprofile\node('contact', 'city', get_string('city'), null, null, $user->city);
186 $tree->add_node($node);
189 if (isset($identityfields['address']) && $user->address) {
190 $node = new core_user\output\myprofile\node('contact', 'address', get_string('address'), null, null, $user->address);
191 $tree->add_node($node);
194 if (isset($identityfields['phone1']) && $user->phone1) {
195 $node = new core_user\output\myprofile\node('contact', 'phone1', get_string('phone1'), null, null, $user->phone1);
196 $tree->add_node($node);
199 if (isset($identityfields['phone2']) && $user->phone2) {
200 $node = new core_user\output\myprofile\node('contact', 'phone2', get_string('phone2'), null, null, $user->phone2);
201 $tree->add_node($node);
204 if (isset($identityfields['institution']) && $user->institution) {
205 $node = new core_user\output\myprofile\node('contact', 'institution', get_string('institution'), null, null,
206 $user->institution);
207 $tree->add_node($node);
210 if (isset($identityfields['department']) && $user->department) {
211 $node = new core_user\output\myprofile\node('contact', 'department', get_string('department'), null, null,
212 $user->department);
213 $tree->add_node($node);
216 if (isset($identityfields['idnumber']) && $user->idnumber) {
217 $node = new core_user\output\myprofile\node('contact', 'idnumber', get_string('idnumber'), null, null,
218 s($user->idnumber));
219 $tree->add_node($node);
222 if ($user->url && !isset($hiddenfields['webpage'])) {
223 $url = $user->url;
224 if (strpos($user->url, '://') === false) {
225 $url = 'http://'. $url;
227 $webpageurl = new moodle_url($url);
228 $node = new core_user\output\myprofile\node('contact', 'webpage', get_string('webpage'), null, null,
229 html_writer::link($url, $webpageurl));
230 $tree->add_node($node);
233 // Printing tagged interests. We want this only for full profile.
234 if (empty($course) && ($interests = core_tag_tag::get_item_tags('core', 'user', $user->id))) {
235 $node = new core_user\output\myprofile\node('contact', 'interests', get_string('interests'), null, null,
236 $OUTPUT->tag_list($interests, ''));
237 $tree->add_node($node);
240 if ($iscurrentuser || !isset($hiddenfields['mycourses'])) {
241 $showallcourses = optional_param('showallcourses', 0, PARAM_INT);
242 if ($mycourses = enrol_get_all_users_courses($user->id, true, null)) {
243 $shown = 0;
244 $courselisting = html_writer::start_tag('ul');
245 foreach ($mycourses as $mycourse) {
246 if ($mycourse->category) {
247 context_helper::preload_from_record($mycourse);
248 $ccontext = context_course::instance($mycourse->id);
249 if (!isset($course) || $mycourse->id != $course->id) {
250 $linkattributes = null;
251 if ($mycourse->visible == 0) {
252 if (!has_capability('moodle/course:viewhiddencourses', $ccontext)) {
253 continue;
255 $linkattributes['class'] = 'dimmed';
257 $params = array('id' => $user->id, 'course' => $mycourse->id);
258 if ($showallcourses) {
259 $params['showallcourses'] = 1;
261 $url = new moodle_url('/user/view.php', $params);
262 $courselisting .= html_writer::tag('li', html_writer::link($url, $ccontext->get_context_name(false),
263 $linkattributes));
264 } else {
265 $courselisting .= html_writer::tag('li', $ccontext->get_context_name(false));
268 $shown++;
269 if (!$showallcourses && $shown == $CFG->navcourselimit) {
270 $url = null;
271 if (isset($course)) {
272 $url = new moodle_url('/user/view.php',
273 array('id' => $user->id, 'course' => $course->id, 'showallcourses' => 1));
274 } else {
275 $url = new moodle_url('/user/profile.php', array('id' => $user->id, 'showallcourses' => 1));
277 $courselisting .= html_writer::tag('li', html_writer::link($url, get_string('viewmore'),
278 array('title' => get_string('viewmore'))), array('class' => 'viewmore'));
279 break;
282 $courselisting .= html_writer::end_tag('ul');
283 if (!empty($mycourses)) {
284 // Add this node only if there are courses to display.
285 $node = new core_user\output\myprofile\node('coursedetails', 'courseprofiles',
286 get_string('courseprofiles'), null, null, rtrim($courselisting, ', '));
287 $tree->add_node($node);
292 if (!empty($course)) {
294 // Show roles in this course.
295 if ($rolestring = get_user_roles_in_course($user->id, $course->id)) {
296 $node = new core_user\output\myprofile\node('coursedetails', 'roles', get_string('roles'), null, null, $rolestring);
297 $tree->add_node($node);
300 // Show groups this user is in.
301 if (!isset($hiddenfields['groups']) && !empty($course)) {
302 $accessallgroups = has_capability('moodle/site:accessallgroups', $courseorsystemcontext);
303 if ($usergroups = groups_get_all_groups($course->id, $user->id)) {
304 $groupstr = '';
305 foreach ($usergroups as $group) {
306 if ($course->groupmode == SEPARATEGROUPS and !$accessallgroups and $user->id != $USER->id) {
307 if (!groups_is_member($group->id, $user->id)) {
308 continue;
312 if ($course->groupmode != NOGROUPS) {
313 $groupstr .= ' <a href="'.$CFG->wwwroot.'/user/index.php?id='.$course->id.'&amp;group='.$group->id.'">'
314 .format_string($group->name).'</a>,';
315 } else {
316 // The user/index.php shows groups only when course in group mode.
317 $groupstr .= ' '.format_string($group->name);
320 if ($groupstr !== '') {
321 $node = new core_user\output\myprofile\node('coursedetails', 'groups',
322 get_string('group'), null, null, rtrim($groupstr, ', '));
323 $tree->add_node($node);
328 if (!isset($hiddenfields['suspended'])) {
329 if ($user->suspended) {
330 $node = new core_user\output\myprofile\node('coursedetails', 'suspended',
331 null, null, null, get_string('suspended', 'auth'));
332 $tree->add_node($node);
337 if ($user->icq && !isset($hiddenfields['icqnumber'])) {
338 $imurl = new moodle_url('https://web.icq.com/wwp', array('uin' => $user->icq) );
339 $iconurl = new moodle_url('https://web.icq.com/whitepages/online', array('icq' => $user->icq, 'img' => '5'));
340 $statusicon = html_writer::tag('img', '',
341 array('src' => $iconurl, 'class' => 'icon icon-post', 'alt' => get_string('status')));
342 $node = new core_user\output\myprofile\node('contact', 'icqnumber', get_string('icqnumber'), null, null,
343 html_writer::link($imurl, s($user->icq) . $statusicon));
344 $tree->add_node($node);
347 if ($user->skype && !isset($hiddenfields['skypeid'])) {
348 $imurl = 'skype:' . urlencode($user->skype) . '?call';
349 $node = new core_user\output\myprofile\node('contact', 'skypeid', get_string('skypeid'), null, null,
350 html_writer::link($imurl, s($user->skype)));
351 $tree->add_node($node);
353 if ($user->yahoo && !isset($hiddenfields['yahooid'])) {
354 $node = new core_user\output\myprofile\node('contact', 'yahooid', get_string('yahooid'), null, null,
355 s($user->yahoo));
356 $tree->add_node($node);
358 if ($user->aim && !isset($hiddenfields['aimid'])) {
359 $node = new core_user\output\myprofile\node('contact', 'aimid', get_string('aimid'), null, null,
360 s($user->aim));
361 $tree->add_node($node);
363 if ($user->msn && !isset($hiddenfields['msnid'])) {
364 $node = new core_user\output\myprofile\node('contact', 'msnid', get_string('msnid'), null, null,
365 s($user->msn));
366 $tree->add_node($node);
369 $categories = profile_get_user_fields_with_data_by_category($user->id);
370 foreach ($categories as $categoryid => $fields) {
371 foreach ($fields as $formfield) {
372 if ($formfield->is_visible() and !$formfield->is_empty()) {
373 $node = new core_user\output\myprofile\node('contact', 'custom_field_' . $formfield->field->shortname,
374 format_string($formfield->field->name), null, null, $formfield->display_data());
375 $tree->add_node($node);
380 // First access. (Why only for sites ?)
381 if (!isset($hiddenfields['firstaccess']) && empty($course)) {
382 if ($user->firstaccess) {
383 $datestring = userdate($user->firstaccess)."&nbsp; (".format_time(time() - $user->firstaccess).")";
384 } else {
385 $datestring = get_string("never");
387 $node = new core_user\output\myprofile\node('loginactivity', 'firstaccess', get_string('firstsiteaccess'), null, null,
388 $datestring);
389 $tree->add_node($node);
392 // Last access.
393 if (!isset($hiddenfields['lastaccess'])) {
394 if (empty($course)) {
395 $string = get_string('lastsiteaccess');
396 if ($user->lastaccess) {
397 $datestring = userdate($user->lastaccess) . "&nbsp; (" . format_time(time() - $user->lastaccess) . ")";
398 } else {
399 $datestring = get_string("never");
401 } else {
402 $string = get_string('lastcourseaccess');
403 if ($lastaccess = $DB->get_record('user_lastaccess', array('userid' => $user->id, 'courseid' => $course->id))) {
404 $datestring = userdate($lastaccess->timeaccess)."&nbsp; (".format_time(time() - $lastaccess->timeaccess).")";
405 } else {
406 $datestring = get_string("never");
410 $node = new core_user\output\myprofile\node('loginactivity', 'lastaccess', $string, null, null,
411 $datestring);
412 $tree->add_node($node);
415 // Last ip.
416 if (has_capability('moodle/user:viewlastip', $usercontext) && !isset($hiddenfields['lastip'])) {
417 if ($user->lastip) {
418 $iplookupurl = new moodle_url('/iplookup/index.php', array('ip' => $user->lastip, 'user' => $user->id));
419 $ipstring = html_writer::link($iplookupurl, $user->lastip);
420 } else {
421 $ipstring = get_string("none");
423 $node = new core_user\output\myprofile\node('loginactivity', 'lastip', get_string('lastip'), null, null,
424 $ipstring);
425 $tree->add_node($node);