Merge branch 'MDL-51579-master' of git://github.com/jleyva/moodle
[moodle.git] / message / index.php
bloba7e38e9f2e32585add722f39d888f4fe54ccd413
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 * A page displaying the user's contacts and messages
20 * @package core_message
21 * @copyright 2010 Andrew Davis
22 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
25 require_once('../config.php');
26 require_once('lib.php');
27 require_once('send_form.php');
29 require_login(0, false);
31 if (isguestuser()) {
32 redirect($CFG->wwwroot);
35 if (empty($CFG->messaging)) {
36 print_error('disabled', 'message');
39 //'viewing' is the preferred URL parameter but we'll still accept usergroup in case its referenced externally
40 $usergroup = optional_param('usergroup', MESSAGE_VIEW_UNREAD_MESSAGES, PARAM_ALPHANUMEXT);
41 $viewing = optional_param('viewing', $usergroup, PARAM_ALPHANUMEXT);
43 $history = optional_param('history', MESSAGE_HISTORY_SHORT, PARAM_INT);
44 $search = optional_param('search', '', PARAM_CLEAN); //TODO: use PARAM_RAW, but make sure we use s() and p() properly
46 //the same param as 1.9 and the param we have been logging. Use this parameter.
47 $user1id = optional_param('user1', $USER->id, PARAM_INT);
48 //2.0 shipped using this param. Retaining it only for compatibility. It should be removed.
49 $user1id = optional_param('user', $user1id, PARAM_INT);
51 //the same param as 1.9 and the param we have been logging. Use this parameter.
52 $user2id = optional_param('user2', 0, PARAM_INT);
53 //The class send_form supplies the receiving user id as 'id'
54 $user2id = optional_param('id', $user2id, PARAM_INT);
56 $addcontact = optional_param('addcontact', 0, PARAM_INT); // adding a contact
57 $removecontact = optional_param('removecontact', 0, PARAM_INT); // removing a contact
58 $blockcontact = optional_param('blockcontact', 0, PARAM_INT); // blocking a contact
59 $unblockcontact = optional_param('unblockcontact', 0, PARAM_INT); // unblocking a contact
60 $deletemessageid = optional_param('deletemessageid', 0, PARAM_INT);
61 $deletemessageconfirm = optional_param('deletemessageconfirm', 0, PARAM_BOOL);
62 if ($deletemessageid) {
63 $deletemessagetype = required_param('deletemessagetype', PARAM_ALPHAEXT);
66 //for search
67 $advancedsearch = optional_param('advanced', 0, PARAM_INT);
69 //if they have numerous contacts or are viewing course participants we might need to page through them
70 $page = optional_param('page', 0, PARAM_INT);
72 $url = new moodle_url('/message/index.php', array('user1' => $user1id));
74 if ($user2id !== 0) {
75 $url->param('user2', $user2id);
77 //Switch view back to contacts if:
78 //1) theyve searched and selected a user
79 //2) they've viewed recent messages or notifications and clicked through to a user
80 if ($viewing == MESSAGE_VIEW_SEARCH || $viewing == MESSAGE_VIEW_RECENT_NOTIFICATIONS) {
81 $viewing = MESSAGE_VIEW_CONTACTS;
85 if ($viewing != MESSAGE_VIEW_UNREAD_MESSAGES) {
86 $url->param('viewing', $viewing);
89 $PAGE->set_url($url);
91 // Disable message notification popups while the user is viewing their messages
92 $PAGE->set_popup_notification_allowed(false);
94 $user1 = null;
95 $currentuser = true;
96 $showactionlinks = true;
97 if ($user1id != $USER->id) {
98 $user1 = $DB->get_record('user', array('id' => $user1id));
99 if (!$user1) {
100 print_error('invaliduserid');
102 $currentuser = false;//if we're looking at someone else's messages we need to lock/remove some UI elements
103 $showactionlinks = false;
104 } else {
105 $user1 = $USER;
107 unset($user1id);
109 $user2 = null;
110 if (!empty($user2id)) {
111 $user2 = core_user::get_user($user2id);
112 if (!$user2) {
113 print_error('invaliduserid');
116 unset($user2id);
118 $user2realuser = !empty($user2) && core_user::is_real_user($user2->id);
119 $showactionlinks = $showactionlinks && $user2realuser;
120 $systemcontext = context_system::instance();
122 if ($currentuser === false && !has_capability('moodle/site:readallmessages', $systemcontext)) {
123 print_error('accessdenied','admin');
126 if (substr($viewing, 0, 7) == MESSAGE_VIEW_COURSE) {
127 $courseid = intval(substr($viewing, 7));
128 require_login($courseid);
129 require_capability('moodle/course:viewparticipants', context_course::instance($courseid));
130 $PAGE->set_pagelayout('incourse');
131 } else {
132 $PAGE->set_pagelayout('standard');
134 // Page context should always be set to user.
135 $PAGE->set_context(context_user::instance($user1->id));
136 if (!empty($user1->id) && $user1->id != $USER->id) {
137 $PAGE->navigation->extend_for_user($user1);
139 if (!empty($user2->id) && $user2realuser && ($user2->id != $USER->id)) {
140 $PAGE->navigation->extend_for_user($user2);
143 $strmessages = get_string('messages', 'message');
144 if ($user2realuser) {
145 $user2fullname = fullname($user2);
147 $PAGE->set_title("$strmessages: $user2fullname");
148 $PAGE->set_heading("$strmessages: $user2fullname");
149 } else {
150 $PAGE->set_title("{$SITE->shortname}: $strmessages");
151 $PAGE->set_heading("{$SITE->shortname}: $strmessages");
154 /// Process any contact maintenance requests there may be
155 if ($addcontact and confirm_sesskey()) {
156 message_add_contact($addcontact);
157 redirect($CFG->wwwroot . '/message/index.php?viewing=contacts&id='.$addcontact);
159 if ($removecontact and confirm_sesskey()) {
160 message_remove_contact($removecontact);
162 if ($blockcontact and confirm_sesskey()) {
163 message_block_contact($blockcontact);
165 if ($unblockcontact and confirm_sesskey()) {
166 message_unblock_contact($unblockcontact);
168 if ($deletemessageid and confirm_sesskey()) {
169 // Check that the message actually exists.
170 if ($message = $DB->get_record($deletemessagetype, array('id' => $deletemessageid))) {
171 // Check that we are allowed to delete this message.
172 if (message_can_delete_message($message, $user1->id)) {
173 if (!$deletemessageconfirm) {
174 $confirmurl = new moodle_url('/message/index.php', array('user1' => $user1->id, 'user2' => $user2->id,
175 'viewing' => $viewing, 'deletemessageid' => $message->id, 'deletemessagetype' => $deletemessagetype,
176 'deletemessageconfirm' => 1, 'sesskey' => sesskey()));
177 $confirmbutton = new single_button($confirmurl, get_string('delete'), 'post');
178 $strdeletemessage = get_string('deletemessage', 'message');
179 $PAGE->set_title($strdeletemessage);
180 echo $OUTPUT->header();
181 echo $OUTPUT->heading($strdeletemessage);
182 echo $OUTPUT->confirm(get_string('deletemessageconfirmation', 'message'), $confirmbutton, $url);
183 echo $OUTPUT->footer();
184 exit();
186 message_delete_message($message, $user1->id);
189 redirect($url);
192 //was a message sent? Do NOT allow someone looking at someone else's messages to send them.
193 $messageerror = null;
194 if ($currentuser && !empty($user2) && has_capability('moodle/site:sendmessage', $systemcontext)) {
195 // Check that the user is not blocking us!!
196 if ($contact = $DB->get_record('message_contacts', array('userid' => $user2->id, 'contactid' => $user1->id))) {
197 if ($contact->blocked and !has_capability('moodle/site:readallmessages', $systemcontext)) {
198 $messageerror = get_string('userisblockingyou', 'message');
201 $userpreferences = get_user_preferences(NULL, NULL, $user2->id);
203 if (!empty($userpreferences['message_blocknoncontacts'])) { // User is blocking non-contacts
204 if (empty($contact)) { // We are not a contact!
205 $messageerror = get_string('userisblockingyounoncontact', 'message', fullname($user2));
209 if (empty($messageerror)) {
210 $mform = new send_form();
211 $defaultmessage = new stdClass;
212 $defaultmessage->id = $user2->id;
213 $defaultmessage->viewing = $viewing;
214 $defaultmessage->message = '';
216 //Check if the current user has sent a message
217 $data = $mform->get_data();
218 if (!empty($data) && !empty($data->message)) {
219 if (!confirm_sesskey()) {
220 print_error('invalidsesskey');
222 $messageid = message_post_message($user1, $user2, $data->message, FORMAT_MOODLE);
223 if (!empty($messageid)) {
224 //including the id of the user sending the message in the logged URL so the URL works for admins
225 //note message ID may be misleading as the message may potentially get a different ID when moved from message to message_read
226 redirect($CFG->wwwroot . '/message/index.php?viewing='.$viewing.'&id='.$user2->id);
232 $strmessages = get_string('messages', 'message');
233 if ($user2realuser) {
234 $user2fullname = fullname($user2);
236 $PAGE->set_title("$strmessages: $user2fullname");
237 } else {
238 $PAGE->set_title("{$SITE->shortname}: $strmessages");
240 $PAGE->set_heading(fullname($user1));
242 // Remove the user node from the main navigation for this page.
243 $usernode = $PAGE->navigation->find('users', null);
244 $usernode->remove();
246 $settings = $PAGE->settingsnav->find('messages', null);
247 // Add the user we are contacting to the breadcrumb.
248 if (!empty($user2realuser)) {
249 $usernode = $settings->add(fullname($user2), $url);
250 $usernode->make_active();
251 } else {
252 $settings->make_active();
255 //now the page contents
256 echo $OUTPUT->header();
258 echo $OUTPUT->box_start('message');
260 $countunread = 0; //count of unread messages from $user2
261 $countunreadtotal = 0; //count of unread messages from all users
263 //we're dealing with unread messages early so the contact list will accurately reflect what is read/unread
264 $viewingnewmessages = false;
265 if (!empty($user2)) {
266 //are there any unread messages from $user2
267 $countunread = message_count_unread_messages($user1, $user2);
268 if ($countunread>0) {
269 //mark the messages we're going to display as read
270 message_mark_messages_read($user1->id, $user2->id);
271 if($viewing == MESSAGE_VIEW_UNREAD_MESSAGES) {
272 $viewingnewmessages = true;
276 $countunreadtotal = message_count_unread_messages($user1);
278 if ($currentuser && $countunreadtotal == 0 && $viewing == MESSAGE_VIEW_UNREAD_MESSAGES && empty($user2)) {
279 // If the user has no unread messages, show the search box.
280 // We don't do this when a user is viewing another user's messages as search doesn't
281 // handle user A searching user B's messages properly.
282 $viewing = MESSAGE_VIEW_SEARCH;
285 $blockedusers = message_get_blocked_users($user1, $user2);
286 $countblocked = count($blockedusers);
288 list($onlinecontacts, $offlinecontacts, $strangers) = message_get_contacts($user1, $user2);
290 message_print_contact_selector($countunreadtotal, $viewing, $user1, $user2, $blockedusers, $onlinecontacts, $offlinecontacts, $strangers, $showactionlinks, $page);
292 echo html_writer::start_tag('div', array('class' => 'messagearea mdl-align'));
293 if (!empty($user2)) {
295 echo html_writer::start_tag('div', array('class' => 'mdl-left messagehistory'));
297 $visible = 'visible';
298 $hidden = 'hiddenelement'; //cant just use hidden as mform adds that class to its fieldset for something else
300 $recentlinkclass = $recentlabelclass = $historylinkclass = $historylabelclass = $visible;
301 if ($history == MESSAGE_HISTORY_ALL) {
302 $displaycount = 0;
304 $recentlabelclass = $historylinkclass = $hidden;
305 } else if($viewingnewmessages) {
306 //if user is viewing new messages only show them the new messages
307 $displaycount = $countunread;
309 $recentlabelclass = $historylabelclass = $hidden;
310 } else {
311 //default to only showing the last few messages
312 $displaycount = MESSAGE_SHORTVIEW_LIMIT;
314 if ($countunread>MESSAGE_SHORTVIEW_LIMIT) {
315 $displaycount = $countunread;
318 $recentlinkclass = $historylabelclass = $hidden;
321 $messagehistorylink = html_writer::start_tag('div', array('class' => 'mdl-align messagehistorytype'));
322 $messagehistorylink .= html_writer::link($PAGE->url->out(false).'&history='.MESSAGE_HISTORY_ALL,
323 get_string('messagehistoryfull','message'),
324 array('class' => $historylinkclass));
326 $messagehistorylink .= html_writer::start_tag('span', array('class' => $historylabelclass));
327 $messagehistorylink .= get_string('messagehistoryfull','message');
328 $messagehistorylink .= html_writer::end_tag('span');
330 $messagehistorylink .= '&nbsp;|&nbsp;'.html_writer::link($PAGE->url->out(false).'&history='.MESSAGE_HISTORY_SHORT,
331 get_string('mostrecent','message'),
332 array('class' => $recentlinkclass));
334 $messagehistorylink .= html_writer::start_tag('span', array('class' => $recentlabelclass));
335 $messagehistorylink .= get_string('mostrecent','message');
336 $messagehistorylink .= html_writer::end_tag('span');
338 if ($viewingnewmessages) {
339 $messagehistorylink .= '&nbsp;|&nbsp;'.html_writer::start_tag('span');//, array('class' => $historyclass)
340 $messagehistorylink .= get_string('unreadnewmessages','message',$displaycount);
341 $messagehistorylink .= html_writer::end_tag('span');
344 $messagehistorylink .= html_writer::end_tag('div');
346 message_print_message_history($user1, $user2, $search, $displaycount, $messagehistorylink, $viewingnewmessages, $showactionlinks);
347 echo html_writer::end_tag('div');
349 //send message form
350 if ($currentuser && has_capability('moodle/site:sendmessage', $systemcontext) && $user2realuser) {
351 echo html_writer::start_tag('div', array('class' => 'mdl-align messagesend'));
352 if (!empty($messageerror)) {
353 echo html_writer::tag('span', $messageerror, array('id' => 'messagewarning'));
354 } else {
355 // Display a warning if the current user is blocking non-contacts and is about to message to a non-contact
356 // Otherwise they may wonder why they never get a reply
357 $blocknoncontacts = get_user_preferences('message_blocknoncontacts', '', $user1->id);
358 if (!empty($blocknoncontacts)) {
359 $contact = $DB->get_record('message_contacts', array('userid' => $user1->id, 'contactid' => $user2->id));
360 if (empty($contact)) {
361 $msg = get_string('messagingblockednoncontact', 'message', fullname($user2));
362 echo html_writer::tag('span', $msg, array('id' => 'messagewarning'));
366 $mform = new send_form();
367 $defaultmessage = new stdClass;
368 $defaultmessage->id = $user2->id;
369 $defaultmessage->viewing = $viewing;
370 $defaultmessage->message = '';
371 //$defaultmessage->messageformat = FORMAT_MOODLE;
372 $mform->set_data($defaultmessage);
373 $mform->display();
375 echo html_writer::end_tag('div');
377 } else if ($viewing == MESSAGE_VIEW_SEARCH) {
378 message_print_search($advancedsearch, $user1);
379 } else if ($viewing == MESSAGE_VIEW_RECENT_CONVERSATIONS) {
380 message_print_recent_conversations($user1, false, $showactionlinks);
381 } else if ($viewing == MESSAGE_VIEW_RECENT_NOTIFICATIONS) {
382 message_print_recent_notifications($user1);
384 echo html_writer::end_tag('div');
386 echo $OUTPUT->box_end();
388 echo $OUTPUT->footer();