. /** * Contains class containing unit tests for mod/chat/lib.php. * * @package mod_chat * @category test * @copyright 2017 Mark Nelson * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); /** * Class containing unit tests for mod/chat/lib.php. * * @package mod_chat * @category test * @copyright 2017 Mark Nelson * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class mod_chat_lib_testcase extends advanced_testcase { public function setUp() { $this->resetAfterTest(); } /* * The chat's event should not be shown to a user when the user cannot view the chat at all. */ public function test_chat_core_calendar_provide_event_action_in_hidden_section() { global $CFG; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); // Create a student. $student = $this->getDataGenerator()->create_and_enrol($course, 'student'); // Create a chat. $chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => usergetmidnight(time()))); // Create a calendar event. $event = $this->create_action_event($course->id, $chat->id, CHAT_EVENT_TYPE_CHATTIME); // Set sections 0 as hidden. set_section_visible($course->id, 0, 0); // Now, log out. $CFG->forcelogin = true; // We don't want to be logged in as guest, as guest users might still have some capabilities. $this->setUser(); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event for the student. $actionevent = mod_chat_core_calendar_provide_event_action($event, $factory, $student->id); // Confirm the event is not shown at all. $this->assertNull($actionevent); } /* * The chat's event should not be shown to a user who does not have permission to view the chat at all. */ public function test_chat_core_calendar_provide_event_action_for_non_user() { global $CFG; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); // Create a chat. $chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => usergetmidnight(time()))); // Create a calendar event. $event = $this->create_action_event($course->id, $chat->id, CHAT_EVENT_TYPE_CHATTIME); // Now, log out. $CFG->forcelogin = true; // We don't want to be logged in as guest, as guest users might still have some capabilities. $this->setUser(); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event. $actionevent = mod_chat_core_calendar_provide_event_action($event, $factory); // Confirm the event is not shown at all. $this->assertNull($actionevent); } public function test_chat_core_calendar_provide_event_action_chattime_event_yesterday() { $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); // Create a chat. $chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => time() - DAYSECS)); // Create a calendar event. $event = $this->create_action_event($course->id, $chat->id, CHAT_EVENT_TYPE_CHATTIME); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event. $actionevent = mod_chat_core_calendar_provide_event_action($event, $factory); // Confirm the event is not shown at all. $this->assertNull($actionevent); } public function test_chat_core_calendar_provide_event_action_chattime_event_yesterday_for_user() { global $CFG; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); // Enrol a student in the course. $student = $this->getDataGenerator()->create_and_enrol($course, 'student'); // Create a chat. $chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => time() - DAYSECS)); // Create a calendar event. $event = $this->create_action_event($course->id, $chat->id, CHAT_EVENT_TYPE_CHATTIME); // Now, log out. $CFG->forcelogin = true; // We don't want to be logged in as guest, as guest users have mod/chat:view capability by default. $this->setUser(); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event for the student. $actionevent = mod_chat_core_calendar_provide_event_action($event, $factory, $student->id); // Confirm the event is not shown at all. $this->assertNull($actionevent); } public function test_chat_core_calendar_provide_event_action_chattime_event_today() { $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); // Create a chat. $chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => usergetmidnight(time()))); // Create a calendar event. $event = $this->create_action_event($course->id, $chat->id, CHAT_EVENT_TYPE_CHATTIME); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event. $actionevent = mod_chat_core_calendar_provide_event_action($event, $factory); // Confirm the event was decorated. $this->assertInstanceOf('\core_calendar\local\event\value_objects\action', $actionevent); $this->assertEquals(get_string('enterchat', 'chat'), $actionevent->get_name()); $this->assertInstanceOf('moodle_url', $actionevent->get_url()); $this->assertEquals(1, $actionevent->get_item_count()); $this->assertTrue($actionevent->is_actionable()); } public function test_chat_core_calendar_provide_event_action_chattime_event_today_for_user() { global $CFG; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); // Enrol a student in the course. $student = $this->getDataGenerator()->create_and_enrol($course, 'student'); // Create a chat. $chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => usergetmidnight(time()))); // Create a calendar event. $event = $this->create_action_event($course->id, $chat->id, CHAT_EVENT_TYPE_CHATTIME); // Now, log out. $CFG->forcelogin = true; // We don't want to be logged in as guest, as guest users have mod/chat:view capability by default. $this->setUser(); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event for the student. $actionevent = mod_chat_core_calendar_provide_event_action($event, $factory, $student->id); // Confirm the event was decorated. $this->assertInstanceOf('\core_calendar\local\event\value_objects\action', $actionevent); $this->assertEquals(get_string('enterchat', 'chat'), $actionevent->get_name()); $this->assertInstanceOf('moodle_url', $actionevent->get_url()); $this->assertEquals(1, $actionevent->get_item_count()); $this->assertTrue($actionevent->is_actionable()); } public function test_chat_core_calendar_provide_event_action_chattime_event_tonight() { $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); // Create a chat. $chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => usergetmidnight(time()) + (23 * HOURSECS))); // Create a calendar event. $event = $this->create_action_event($course->id, $chat->id, CHAT_EVENT_TYPE_CHATTIME); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event. $actionevent = mod_chat_core_calendar_provide_event_action($event, $factory); // Confirm the event was decorated. $this->assertInstanceOf('\core_calendar\local\event\value_objects\action', $actionevent); $this->assertEquals(get_string('enterchat', 'chat'), $actionevent->get_name()); $this->assertInstanceOf('moodle_url', $actionevent->get_url()); $this->assertEquals(1, $actionevent->get_item_count()); $this->assertTrue($actionevent->is_actionable()); } public function test_chat_core_calendar_provide_event_action_chattime_event_tonight_for_user() { global $CFG; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); // Enrol a student in the course. $student = $this->getDataGenerator()->create_and_enrol($course, 'student'); // Create a chat. $chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => usergetmidnight(time()) + (23 * HOURSECS))); // Create a calendar event. $event = $this->create_action_event($course->id, $chat->id, CHAT_EVENT_TYPE_CHATTIME); // Now, log out. $CFG->forcelogin = true; // We don't want to be logged in as guest, as guest users have mod/chat:view capability by default. $this->setUser(); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event for the student. $actionevent = mod_chat_core_calendar_provide_event_action($event, $factory, $student->id); // Confirm the event was decorated. $this->assertInstanceOf('\core_calendar\local\event\value_objects\action', $actionevent); $this->assertEquals(get_string('enterchat', 'chat'), $actionevent->get_name()); $this->assertInstanceOf('moodle_url', $actionevent->get_url()); $this->assertEquals(1, $actionevent->get_item_count()); $this->assertTrue($actionevent->is_actionable()); } public function test_chat_core_calendar_provide_event_action_chattime_event_tomorrow() { $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); // Create a chat. $chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => time() + DAYSECS)); // Create a calendar event. $event = $this->create_action_event($course->id, $chat->id, CHAT_EVENT_TYPE_CHATTIME); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event. $actionevent = mod_chat_core_calendar_provide_event_action($event, $factory); // Confirm the event was decorated. $this->assertInstanceOf('\core_calendar\local\event\value_objects\action', $actionevent); $this->assertEquals(get_string('enterchat', 'chat'), $actionevent->get_name()); $this->assertInstanceOf('moodle_url', $actionevent->get_url()); $this->assertEquals(1, $actionevent->get_item_count()); $this->assertFalse($actionevent->is_actionable()); } public function test_chat_core_calendar_provide_event_action_chattime_event_tomorrow_for_user() { global $CFG; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); // Enrol a student in the course. $student = $this->getDataGenerator()->create_and_enrol($course, 'student'); // Create a chat. $chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => time() + DAYSECS)); // Create a calendar event. $event = $this->create_action_event($course->id, $chat->id, CHAT_EVENT_TYPE_CHATTIME); // Now, log out. $CFG->forcelogin = true; // We don't want to be logged in as guest, as guest users have mod/chat:view capability by default. $this->setUser(); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event for the student. $actionevent = mod_chat_core_calendar_provide_event_action($event, $factory, $student->id); // Confirm the event was decorated. $this->assertInstanceOf('\core_calendar\local\event\value_objects\action', $actionevent); $this->assertEquals(get_string('enterchat', 'chat'), $actionevent->get_name()); $this->assertInstanceOf('moodle_url', $actionevent->get_url()); $this->assertEquals(1, $actionevent->get_item_count()); $this->assertFalse($actionevent->is_actionable()); } public function test_chat_core_calendar_provide_event_action_chattime_event_different_timezones() { global $CFG; $this->setAdminUser(); // Create a course. $course = $this->getDataGenerator()->create_course(); $hour = gmdate('H'); // This could have been much easier if MDL-37327 were implemented. // We don't know when this test is being ran and there is no standard way to // mock the time() function (MDL-37327 to handle that). if ($hour < 10) { $timezone1 = 'UTC'; // GMT. $timezone2 = 'Pacific/Pago_Pago'; // GMT -11:00. } else if ($hour < 11) { $timezone1 = 'Pacific/Kiritimati'; // GMT +14:00. $timezone2 = 'America/Sao_Paulo'; // GMT -03:00. } else { $timezone1 = 'Pacific/Kiritimati'; // GMT +14:00. $timezone2 = 'UTC'; // GMT. } $this->setTimezone($timezone2); // Enrol 2 students with different timezones in the course. $student1 = $this->getDataGenerator()->create_and_enrol($course, 'student', (object)['timezone' => $timezone1]); $student2 = $this->getDataGenerator()->create_and_enrol($course, 'student', (object)['timezone' => $timezone2]); // Create a chat. $chat1 = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => mktime(1, 0, 0))); // This is always yesterday in timezone1 time // and always today in timezone2 time. // Create a chat. $chat2 = $this->getDataGenerator()->create_module('chat', array('course' => $course->id, 'chattime' => mktime(1, 0, 0) + DAYSECS)); // This is always today in timezone1 time // and always tomorrow in timezone2 time. // Create calendar events for the 2 chats above. $event1 = $this->create_action_event($course->id, $chat1->id, CHAT_EVENT_TYPE_CHATTIME); $event2 = $this->create_action_event($course->id, $chat2->id, CHAT_EVENT_TYPE_CHATTIME); // Now, log out. $CFG->forcelogin = true; // We don't want to be logged in as guest, as guest users have mod/chat:view capability by default. $this->setUser(); // Create an action factory. $factory = new \core_calendar\action_factory(); // Decorate action event for student1. $actionevent11 = mod_chat_core_calendar_provide_event_action($event1, $factory, $student1->id); $actionevent12 = mod_chat_core_calendar_provide_event_action($event1, $factory, $student2->id); $actionevent21 = mod_chat_core_calendar_provide_event_action($event2, $factory, $student1->id); $actionevent22 = mod_chat_core_calendar_provide_event_action($event2, $factory, $student2->id); // Confirm event1 is not shown to student1 at all. $this->assertNull($actionevent11, 'Failed for UTC time ' . gmdate('H:i')); // Confirm event1 was decorated for student2 and it is actionable. $this->assertInstanceOf('\core_calendar\local\event\value_objects\action', $actionevent12); $this->assertEquals(get_string('enterchat', 'chat'), $actionevent12->get_name()); $this->assertInstanceOf('moodle_url', $actionevent12->get_url()); $this->assertEquals(1, $actionevent12->get_item_count()); $this->assertTrue($actionevent12->is_actionable()); // Confirm event2 was decorated for student1 and it is actionable. $this->assertInstanceOf('\core_calendar\local\event\value_objects\action', $actionevent21); $this->assertEquals(get_string('enterchat', 'chat'), $actionevent21->get_name()); $this->assertInstanceOf('moodle_url', $actionevent21->get_url()); $this->assertEquals(1, $actionevent21->get_item_count()); $this->assertTrue($actionevent21->is_actionable()); // Confirm event2 was decorated for student2 and it is not actionable. $this->assertInstanceOf('\core_calendar\local\event\value_objects\action', $actionevent22); $this->assertEquals(get_string('enterchat', 'chat'), $actionevent22->get_name()); $this->assertInstanceOf('moodle_url', $actionevent22->get_url()); $this->assertEquals(1, $actionevent22->get_item_count()); $this->assertFalse($actionevent22->is_actionable()); } /** * Test for chat_get_sessions(). */ public function test_chat_get_sessions() { global $DB; $this->resetAfterTest(); $generator = $this->getDataGenerator(); // Setup test data. $this->setAdminUser(); $course = $generator->create_course(); $chat = $generator->create_module('chat', ['course' => $course->id]); $user1 = $generator->create_user(); $user2 = $generator->create_user(); $studentrole = $DB->get_record('role', ['shortname' => 'student']); $generator->enrol_user($user1->id, $course->id, $studentrole->id); $generator->enrol_user($user2->id, $course->id, $studentrole->id); // Login as user 1. $this->setUser($user1); $chatsid = chat_login_user($chat->id, 'ajax', 0, $course); $chatuser = $DB->get_record('chat_users', ['sid' => $chatsid]); // Get the messages for this chat session. $messages = chat_get_session_messages($chat->id, false, 0, 0, 'timestamp DESC'); // We should have just 1 system (enter) messages. $this->assertCount(1, $messages); // This is when the session starts (when the first message - enter - has been sent). $sessionstart = reset($messages)->timestamp; // Send some messages. chat_send_chatmessage($chatuser, 'hello!'); chat_send_chatmessage($chatuser, 'bye bye!'); // Login as user 2. $this->setUser($user2); $chatsid = chat_login_user($chat->id, 'ajax', 0, $course); $chatuser = $DB->get_record('chat_users', ['sid' => $chatsid]); // Send a message and take note of this message ID. $messageid = chat_send_chatmessage($chatuser, 'greetings!'); // This is when the session ends (timestamp of the last message sent to the chat). $sessionend = $DB->get_field('chat_messages', 'timestamp', ['id' => $messageid]); // Get the messages for this chat session. $messages = chat_get_session_messages($chat->id, false, 0, 0, 'timestamp DESC'); // We should have 3 user and 2 system (enter) messages. $this->assertCount(5, $messages); // Fetch the chat sessions from the messages we retrieved. $sessions = chat_get_sessions($messages, true); // There should be only one session. $this->assertCount(1, $sessions); // Get this session. $session = reset($sessions); // Confirm that the start and end times of the session matches. $this->assertEquals($sessionstart, $session->sessionstart); $this->assertEquals($sessionend, $session->sessionend); // Confirm we have 2 participants in the chat. $this->assertCount(2, $session->sessionusers); } /** * Test for chat_get_sessions with messages belonging to multiple sessions. */ public function test_chat_get_sessions_multiple() { $messages = []; $gap = 5; // 5 secs. $now = time(); $timestamp = $now; // Messages belonging to 3 sessions. Session 1 has 10 messages, 2 has 15, 3 has 25. $sessionusers = []; $sessiontimes = []; $session = 0; // Incomplete session. for ($i = 1; $i <= 50; $i++) { // Take note of expected session times as we go through. switch ($i) { case 1: // Session 1 start time. $sessiontimes[0]['start'] = $timestamp; break; case 10: // Session 1 end time. $sessiontimes[0]['end'] = $timestamp; break; case 11: // Session 2 start time. $sessiontimes[1]['start'] = $timestamp; break; case 25: // Session 2 end time. $sessiontimes[1]['end'] = $timestamp; break; case 26: // Session 3 start time. $sessiontimes[2]['start'] = $timestamp; break; case 50: // Session 3 end time. $sessiontimes[2]['end'] = $timestamp; break; } // User 1 to 5. $user = rand(1, 5); // Let's also include system messages as well. Give them to pop in 1-in-10 chance. $issystem = rand(1, 10) == 10; if ($issystem) { $message = 'enter'; } else { $message = 'Message ' . $i; if (!isset($sessionusers[$session][$user])) { $sessionusers[$session][$user] = 1; } else { $sessionusers[$session][$user]++; } } $messages[] = (object)[ 'id' => $i, 'chatid' => 1, 'userid' => $user, 'message' => $message, 'issystem' => $issystem, 'timestamp' => $timestamp, ]; // Set the next timestamp. if ($i == 10 || $i == 25) { // New session. $session++; $timestamp += CHAT_SESSION_GAP + 1; } else { $timestamp += $gap; } } // Reverse sort the messages so they're in descending order. rsort($messages); // Get chat sessions showing only complete ones. $completesessions = chat_get_sessions($messages); // Session 1 is incomplete, so there should only be 2 sessions when $showall is false. $this->assertCount(2, $completesessions); // Reverse sort sessions so they are in ascending order matching our expected session times and users. $completesessions = array_reverse($completesessions); foreach ($completesessions as $index => $session) { // We increment index by 1 because the incomplete expected session (index=0) is not included. $expectedindex = $index + 1; // Check the session users. $users = $sessionusers[$expectedindex]; $this->assertCount(count($users), $session->sessionusers); // Check the message counts for each user in this session. foreach ($users as $userid => $messagecount) { $this->assertEquals($messagecount, $session->sessionusers[$userid]); } $sessionstart = $sessiontimes[$expectedindex]['start']; $sessionend = $sessiontimes[$expectedindex]['end']; $this->assertEquals($sessionstart, $session->sessionstart); $this->assertEquals($sessionend, $session->sessionend); } // Get all the chat sessions. $allsessions = chat_get_sessions($messages, true); // When showall is true, we should get 3 sessions. $this->assertCount(3, $allsessions); // Reverse sort sessions so they are in ascending order matching our expected session times and users. $allsessions = array_reverse($allsessions); foreach ($allsessions as $index => $session) { // Check the session users. $users = $sessionusers[$index]; $this->assertCount(count($users), $session->sessionusers); // Check the message counts for each user in this session. foreach ($users as $userid => $messagecount) { $this->assertEquals($messagecount, $session->sessionusers[$userid]); } $sessionstart = $sessiontimes[$index]['start']; $sessionend = $sessiontimes[$index]['end']; $this->assertEquals($sessionstart, $session->sessionstart); $this->assertEquals($sessionend, $session->sessionend); } } /** * Creates an action event. * * @param int $courseid * @param int $instanceid The chat id. * @param string $eventtype The event type. eg. ASSIGN_EVENT_TYPE_DUE. * @return bool|calendar_event */ private function create_action_event($courseid, $instanceid, $eventtype) { $event = new stdClass(); $event->name = 'Calendar event'; $event->modulename = 'chat'; $event->courseid = $courseid; $event->instance = $instanceid; $event->type = CALENDAR_EVENT_TYPE_ACTION; $event->eventtype = $eventtype; $event->timestart = time(); return calendar_event::create($event); } /** * A user who does not have capabilities to add events to the calendar should be able to create an chat. */ public function test_creation_with_no_calendar_capabilities() { $this->resetAfterTest(); $course = self::getDataGenerator()->create_course(); $context = context_course::instance($course->id); $user = self::getDataGenerator()->create_and_enrol($course, 'editingteacher'); $roleid = self::getDataGenerator()->create_role(); self::getDataGenerator()->role_assign($roleid, $user->id, $context->id); assign_capability('moodle/calendar:manageentries', CAP_PROHIBIT, $roleid, $context, true); $generator = self::getDataGenerator()->get_plugin_generator('mod_chat'); // Create an instance as a user without the calendar capabilities. $this->setUser($user); $params = array( 'course' => $course->id, 'chattime' => time() + 500, ); $generator->create_instance($params); } }