Rev 1 | AutorÃa | Ultima modificación | Ver Log |
<?php// This file is part of Moodle - http://moodle.org///// Moodle is free software: you can redistribute it and/or modify// it under the terms of the GNU General Public License as published by// the Free Software Foundation, either version 3 of the License, or// (at your option) any later version.//// Moodle is distributed in the hope that it will be useful,// but WITHOUT ANY WARRANTY; without even the implied warranty of// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the// GNU General Public License for more details.//// You should have received a copy of the GNU General Public License// along with Moodle. If not, see <http://www.gnu.org/licenses/>./*** Contains class containing unit tests for mod/chat/lib.php.** @package mod_chat* @category test* @copyright 2017 Mark Nelson <markn@moodle.com>* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later*/namespace mod_chat;defined('MOODLE_INTERNAL') || die();/*** Class containing unit tests for mod/chat/lib.php.** @package mod_chat* @category test* @copyright 2017 Mark Nelson <markn@moodle.com>* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later*/class lib_test extends \advanced_testcase {public function setUp(): void {$this->resetAfterTest();// Chat module is disabled by default, enable it for testing.$manager = \core_plugin_manager::resolve_plugininfo_class('mod');$manager::enable_plugin('chat', 1);}/** 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(): void {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(): void {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(): void {$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(): void {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(): void {$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(): void {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(): void {$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(): void {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(): void {$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(): void {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(): void {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(): void {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(): void {$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);}}public function test_chat_core_calendar_provide_event_action_already_completed(): void {set_config('enablecompletion', 1);$this->setAdminUser();// Create the activity.$course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1));$chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id),array('completion' => 2, 'completionview' => 1, 'completionexpected' => time() + DAYSECS));// Get some additional data.$cm = get_coursemodule_from_instance('chat', $chat->id);// Create a calendar event.$event = $this->create_action_event($course->id, $chat->id,\core_completion\api::COMPLETION_EVENT_TYPE_DATE_COMPLETION_EXPECTED);// Mark the activity as completed.$completion = new \completion_info($course);$completion->set_module_viewed($cm);// Create an action factory.$factory = new \core_calendar\action_factory();// Decorate action event.$actionevent = mod_chat_core_calendar_provide_event_action($event, $factory);// Ensure result was null.$this->assertNull($actionevent);}public function test_chat_core_calendar_provide_event_action_already_completed_for_user(): void {set_config('enablecompletion', 1);$this->setAdminUser();// Create the activity.$course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1));$chat = $this->getDataGenerator()->create_module('chat', array('course' => $course->id),array('completion' => 2, 'completionview' => 1, 'completionexpected' => time() + DAYSECS));// Enrol a student in the course.$student = $this->getDataGenerator()->create_and_enrol($course, 'student');// Get some additional data.$cm = get_coursemodule_from_instance('chat', $chat->id);// Create a calendar event.$event = $this->create_action_event($course->id, $chat->id,\core_completion\api::COMPLETION_EVENT_TYPE_DATE_COMPLETION_EXPECTED);// Mark the activity as completed for the student.$completion = new \completion_info($course);$completion->set_module_viewed($cm, $student->id);// 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);// Ensure result was null.$this->assertNull($actionevent);}/*** 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(): void {$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);}}