Proyectos de Subversion Moodle

<?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/>.

/**

 * Events tests.

 *

 * @package core_message

 * @category test

 * @copyright 2014 Mark Nelson <markn@moodle.com>

 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 */

namespace core_message\event;

use core_message\tests\helper as testhelper;

/**

 * Class containing the tests for message related events.

 *

 * @package core_message

 * @category test

 * @copyright 2014 Mark Nelson <markn@moodle.com>

 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 */

final class events_test extends \advanced_testcase {

    /**

     * Test the message contact added event.

     */

    public function test_message_contact_added(): void {

        global $USER;

        $this->resetAfterTest();

        // Set this user as the admin.

        $this->setAdminUser();

        // Create a user to add to the admin's contact list.

        $user = $this->getDataGenerator()->create_user();

        // Trigger and capture the event when adding a contact.

        $sink = $this->redirectEvents();

        \core_message\api::add_contact($USER->id, $user->id);

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\message_contact_added', $event);

        $this->assertEquals(\context_user::instance(2), $event->get_context());

        $url = new \moodle_url('/message/index.php', ['user1' => $event->userid, 'user2' => $event->relateduserid]);

        $this->assertEquals($url, $event->get_url());

    }

    /**

     * Test the message contact removed event.

     */

    public function test_message_contact_removed(): void {

        global $USER;

        $this->resetAfterTest();

        // Set this user as the admin.

        $this->setAdminUser();

        // Create a user to add to the admin's contact list.

        $user = $this->getDataGenerator()->create_user();

        // Add the user to the admin's contact list.

        \core_message\api::add_contact($USER->id, $user->id);

        // Trigger and capture the event when adding a contact.

        $sink = $this->redirectEvents();

        \core_message\api::remove_contact($USER->id, $user->id);

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\message_contact_removed', $event);

        $this->assertEquals(\context_user::instance(2), $event->get_context());

        $url = new \moodle_url('/message/index.php', ['user1' => $event->userid, 'user2' => $event->relateduserid]);

        $this->assertEquals($url, $event->get_url());

    }

    /**

     * Test the message user blocked event.

     */

    public function test_message_user_blocked(): void {

        global $USER;

        $this->resetAfterTest();

        // Set this user as the admin.

        $this->setAdminUser();

        // Create a user to add to the admin's contact list.

        $user = $this->getDataGenerator()->create_user();

        // Add the user to the admin's contact list.

        \core_message\api::add_contact($USER->id, $user->id);

        // Trigger and capture the event when blocking a contact.

        $sink = $this->redirectEvents();

        \core_message\api::block_user($USER->id, $user->id);

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\message_user_blocked', $event);

        $this->assertEquals(\context_user::instance(2), $event->get_context());

    }

    /**

     * Test the message user unblocked event.

     */

    public function test_message_user_unblocked(): void {

        global $USER;

        $this->resetAfterTest();

        // Set this user as the admin.

        $this->setAdminUser();

        // Create a user to add to the admin's contact list.

        $user = $this->getDataGenerator()->create_user();

        // Add the user to the admin's contact list.

        \core_message\api::add_contact($USER->id, $user->id);

        // Block the user.

        \core_message\api::block_user($USER->id, $user->id);

        // Make sure that we have 1 blocked user.

        $this->assertEquals(1, \core_message\api::count_blocked_users());

        // Trigger and capture the event when unblocking a contact.

        $sink = $this->redirectEvents();

        \core_message\api::unblock_user($USER->id, $user->id);

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\message_user_unblocked', $event);

        $this->assertEquals(\context_user::instance(2), $event->get_context());

        // Make sure that we have no blocked users.

        $this->assertEmpty(\core_message\api::count_blocked_users());

    }

    /**

     * Test the message sent event.

     *

     * We can not use the message_send() function in the unit test to check that the event was fired as there is a

     * conditional check to ensure a fake message is sent during unit tests when calling that particular function.

     */

    public function test_message_sent(): void {

        $event = \core\event\message_sent::create([

            'objectid' => 3,

            'userid' => 1,

            'context'  => \context_system::instance(),

            'relateduserid' => 2,

            'other' => [

                'courseid' => 4,

            ],

        ]);

        // Trigger and capturing the event.

        $sink = $this->redirectEvents();

        $event->trigger();

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\message_sent', $event);

        $this->assertEquals(\context_system::instance(), $event->get_context());

        $url = new \moodle_url('/message/index.php', ['user1' => $event->userid, 'user2' => $event->relateduserid]);

        $this->assertEquals($url, $event->get_url());

        $this->assertEquals(3, $event->objectid);

        $this->assertEquals(4, $event->other['courseid']);

    }

    public function test_mesage_sent_without_other_courseid(): void {

        // Creating a message_sent event without other[courseid] leads to exception.

        $this->expectException('coding_exception');

        $this->expectExceptionMessage('The \'courseid\' value must be set in other');

        $event = \core\event\message_sent::create([

            'userid' => 1,

            'context'  => \context_system::instance(),

            'relateduserid' => 2,

            'other' => [

                'messageid' => 3,

            ],

        ]);

    }

    public function test_mesage_sent_via_create_from_ids(): void {

        $this->resetAfterTest();

        // Containing courseid.

        $event = \core\event\message_sent::create_from_ids(1, 2, 3, 4);

        // Trigger and capturing the event.

        $sink = $this->redirectEvents();

        $event->trigger();

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\message_sent', $event);

        $this->assertEquals(\context_system::instance(), $event->get_context());

        $url = new \moodle_url('/message/index.php', ['user1' => $event->userid, 'user2' => $event->relateduserid]);

        $this->assertEquals($url, $event->get_url());

        $this->assertEquals(3, $event->objectid);

        $this->assertEquals(4, $event->other['courseid']);

    }

    /**

     * Test the group message sent event.

     *

     * We can't test events in any testing of the message_send() function as there is a conditional PHPUNIT check in message_send,

     * resulting in fake messages being generated and captured under test. As a result, none of the events code, nor message

     * processor code is called during testing.

     */

    public function test_group_message_sent(): void {

        $this->resetAfterTest();

        $event = \core\event\group_message_sent::create([

            'objectid' => 3,

            'userid' => 1,

            'context'  => \context_system::instance(),

            'other' => [

                'courseid' => 4,

                'conversationid' => 54,

            ],

        ]);

        // Trigger and capture the event.

        $sink = $this->redirectEvents();

        $event->trigger();

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\group_message_sent', $event);

        $this->assertEquals(\context_system::instance(), $event->get_context());

        $url = new \moodle_url('/message/index.php');

        $this->assertEquals($url, $event->get_url());

        $this->assertEquals(3, $event->objectid);

        $this->assertEquals(4, $event->other['courseid']);

        $this->assertEquals(54, $event->other['conversationid']);

    }

    /**

     * Test the group message sent event when created without a courseid.

     */

    public function test_group_message_sent_without_other_courseid(): void {

        // Creating a message_sent event without other[courseid] leads to exception.

        $this->expectException('coding_exception');

        $this->expectExceptionMessage('The \'courseid\' value must be set in other');

        $event = \core\event\group_message_sent::create([

            'userid' => 1,

            'objectid' => 3,

            'context'  => \context_system::instance(),

            'relateduserid' => 2,

            'other' => [

                'conversationid' => 34,

            ],

        ]);

    }

    /**

     * Test the group message sent event when created without a conversationid.

     */

    public function test_group_message_sent_without_other_conversationid(): void {

        // Creating a message_sent event without other[courseid] leads to exception.

        $this->expectException('coding_exception');

        $this->expectExceptionMessage('The \'conversationid\' value must be set in other');

        $event = \core\event\group_message_sent::create([

            'userid' => 1,

            'objectid' => 3,

            'context'  => \context_system::instance(),

            'relateduserid' => 2,

            'other' => [

                'courseid' => 44,

            ],

        ]);

    }

    /**

     * Test the group message sent event using the create_from_ids() method.

     */

    public function test_group_message_sent_via_create_from_ids(): void {

        $this->resetAfterTest();

        // Fields are: userfromid, conversationid, messageid, courseid.

        $event = \core\event\group_message_sent::create_from_ids(1, 2, 3, 4);

        // Trigger and capture the event.

        $sink = $this->redirectEvents();

        $event->trigger();

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\group_message_sent', $event);

        $this->assertEquals(\context_system::instance(), $event->get_context());

        $this->assertEquals(new \moodle_url('/message/index.php'), $event->get_url());

        $this->assertEquals(1, $event->userid);

        $this->assertEquals(2, $event->other['conversationid']);

        $this->assertEquals(3, $event->objectid);

        $this->assertEquals(4, $event->other['courseid']);

    }

    /**

     * Test the message viewed event.

     */

    public function test_message_viewed(): void {

        global $DB;

        $this->resetAfterTest();

        // Create users to send messages between.

        $user1 = $this->getDataGenerator()->create_user();

        $user2 = $this->getDataGenerator()->create_user();

        $messageid = testhelper::send_fake_message($user1, $user2);

        // Trigger and capture the event.

        $sink = $this->redirectEvents();

        $message = $DB->get_record('messages', ['id' => $messageid]);

        \core_message\api::mark_message_as_read($user1->id, $message);

        $events = $sink->get_events();

        $event = reset($events);

        // Get the usage action.

        $mua = $DB->get_record('message_user_actions', ['userid' => $user1->id, 'messageid' => $messageid,

            'action' => \core_message\api::MESSAGE_ACTION_READ, ]);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\message_viewed', $event);

        $this->assertEquals(\context_user::instance($user1->id), $event->get_context());

        $this->assertEquals($mua->id, $event->objectid);

        $this->assertEquals($messageid, $event->other['messageid']);

        $url = new \moodle_url('/message/index.php', ['user1' => $event->userid, 'user2' => $event->relateduserid]);

        $this->assertEquals($url, $event->get_url());

    }

    /**

     * Test the message deleted event.

     */

    public function test_message_deleted(): void {

        global $DB, $USER;

        $this->resetAfterTest();

        $this->setAdminUser();

        // Create users to send messages between.

        $user1 = $this->getDataGenerator()->create_user();

        $user2 = $this->getDataGenerator()->create_user();

        $messageid = testhelper::send_fake_message($user1, $user2);

        // Trigger and capture the event.

        $sink = $this->redirectEvents();

        \core_message\api::delete_message($user1->id, $messageid);

        $events = $sink->get_events();

        $event = reset($events);

        // Get the usage action.

        $mua = $DB->get_record('message_user_actions', ['userid' => $user1->id, 'messageid' => $messageid,

            'action' => \core_message\api::MESSAGE_ACTION_DELETED, ]);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\message_deleted', $event);

        $this->assertEquals($USER->id, $event->userid); // The user who deleted it.

        $this->assertEquals($user1->id, $event->relateduserid);

        $this->assertEquals($mua->id, $event->objectid);

        $this->assertEquals($messageid, $event->other['messageid']);

        $this->setUser($user1);

        // Create a read message.

        $messageid = testhelper::send_fake_message($user1, $user2);

        $m = $DB->get_record('messages', ['id' => $messageid]);

        \core_message\api::mark_message_as_read($user2->id, $m);

        // Trigger and capture the event.

        $sink = $this->redirectEvents();

        \core_message\api::delete_message($user2->id, $messageid);

        $events = $sink->get_events();

        $event = reset($events);

        // Get the usage action.

        $mua = $DB->get_record('message_user_actions', ['userid' => $user2->id, 'messageid' => $messageid,

            'action' => \core_message\api::MESSAGE_ACTION_DELETED, ]);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\message_deleted', $event);

        $this->assertEquals($user1->id, $event->userid);

        $this->assertEquals($user2->id, $event->relateduserid);

        $this->assertEquals($mua->id, $event->objectid);

        $this->assertEquals($messageid, $event->other['messageid']);

    }

    /**

     * Test the message deleted event is fired when deleting a conversation.

     */

    public function test_message_deleted_whole_conversation(): void {

        global $DB;

        $this->resetAfterTest();

        // Create some users.

        $user1 = self::getDataGenerator()->create_user();

        $user2 = self::getDataGenerator()->create_user();

        // The person doing the deletion.

        $this->setUser($user1);

        // Send some messages back and forth.

        $time = 1;

        $messages = [];

        $messages[] = testhelper::send_fake_message($user1, $user2, 'Yo!', 0, $time + 1);

        $messages[] = testhelper::send_fake_message($user2, $user1, 'Sup mang?', 0, $time + 2);

        $messages[] = testhelper::send_fake_message($user1, $user2, 'Writing PHPUnit tests!', 0, $time + 3);

        $messages[] = testhelper::send_fake_message($user2, $user1, 'Word.', 0, $time + 4);

        $messages[] = testhelper::send_fake_message($user1, $user2, 'You doing much?', 0, $time + 5);

        $messages[] = testhelper::send_fake_message($user2, $user1, 'Nah', 0, $time + 6);

        $messages[] = testhelper::send_fake_message($user1, $user2, 'You nubz0r!', 0, $time + 7);

        $messages[] = testhelper::send_fake_message($user2, $user1, 'Ouch.', 0, $time + 8);

        // Mark the last 4 messages as read.

        $m5 = $DB->get_record('messages', ['id' => $messages[4]]);

        $m6 = $DB->get_record('messages', ['id' => $messages[5]]);

        $m7 = $DB->get_record('messages', ['id' => $messages[6]]);

        $m8 = $DB->get_record('messages', ['id' => $messages[7]]);

        \core_message\api::mark_message_as_read($user2->id, $m5);

        \core_message\api::mark_message_as_read($user1->id, $m6);

        \core_message\api::mark_message_as_read($user2->id, $m7);

        \core_message\api::mark_message_as_read($user1->id, $m8);

        // Trigger and capture the event.

        $sink = $this->redirectEvents();

        $conversationid = \core_message\api::get_conversation_between_users([$user1->id, $user2->id]);

        \core_message\api::delete_conversation_by_id($user1->id, $conversationid);

        $events = $sink->get_events();

        // Get the user actions for the messages deleted by that user.

        $muas = $DB->get_records('message_user_actions', ['userid' => $user1->id,

            'action' => \core_message\api::MESSAGE_ACTION_DELETED, ], 'timecreated ASC');

        $this->assertCount(8, $muas);

        // Create a list we can use for testing.

        $muatest = [];

        foreach ($muas as $mua) {

            $muatest[$mua->messageid] = $mua;

        }

        // Check that there were the correct number of events triggered.

        $this->assertEquals(8, count($events));

        // Check that the event data is valid.

        $i = 1;

        foreach ($events as $event) {

            $messageid = $messages[$i - 1];

            $this->assertInstanceOf('\core\event\message_deleted', $event);

            $this->assertEquals($muatest[$messageid]->id, $event->objectid);

            $this->assertEquals($user1->id, $event->userid);

            $this->assertEquals($user1->id, $event->relateduserid);

            $this->assertEquals($messageid, $event->other['messageid']);

            $i++;

        }

    }

    /**

     * Test the notification sent event.

     */

    public function test_notification_sent(): void {

        $this->resetAfterTest();

        // Create a course.

        $course = $this->getDataGenerator()->create_course();

        // Create users to send notification between.

        $user1 = $this->getDataGenerator()->create_user();

        $user2 = $this->getDataGenerator()->create_user();

        // Send a notification.

        $notificationid = testhelper::send_fake_message($user1, $user2, 'Hello world!', 1);

        // Containing courseid.

        $event = \core\event\notification_sent::create_from_ids($user1->id, $user2->id, $notificationid, $course->id);

        // Trigger and capturing the event.

        $sink = $this->redirectEvents();

        $event->trigger();

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\notification_sent', $event);

        $this->assertEquals($notificationid, $event->objectid);

        $this->assertEquals($user1->id, $event->userid);

        $this->assertEquals($user2->id, $event->relateduserid);

        $this->assertEquals(\context_system::instance(), $event->get_context());

        $this->assertEquals($course->id, $event->other['courseid']);

        $url = new \moodle_url('/message/output/popup/notifications.php', ['notificationid' => $event->objectid]);

        $this->assertEquals($url, $event->get_url());

    }

    /**

     * Test the notification sent event when null passed as course.

     */

    public function test_notification_sent_with_null_course(): void {

        $event = \core\event\notification_sent::create_from_ids(1, 1, 1, null);

        $this->resetAfterTest();

        // Trigger and capture the event.

        $sink = $this->redirectEvents();

        $event->trigger();

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\notification_sent', $event);

        $this->assertEquals(SITEID, $event->other['courseid']);

    }

    /**

     * Test the notification viewed event.

     */

    public function test_notification_viewed(): void {

        global $DB;

        $this->resetAfterTest();

        // Create users to send notifications between.

        $user1 = $this->getDataGenerator()->create_user();

        $user2 = $this->getDataGenerator()->create_user();

        // Send a notification.

        $notificationid = testhelper::send_fake_message($user1, $user2, 'Hello world!', 1);

        // Trigger and capture the event.

        $sink = $this->redirectEvents();

        $notification = $DB->get_record('notifications', ['id' => $notificationid]);

        \core_message\api::mark_notification_as_read($notification);

        $events = $sink->get_events();

        $event = reset($events);

        // Check that the event data is valid.

        $this->assertInstanceOf('\core\event\notification_viewed', $event);

        $this->assertEquals($notificationid, $event->objectid);

        $this->assertEquals($user2->id, $event->userid);

        $this->assertEquals($user1->id, $event->relateduserid);

        $this->assertEquals(\context_user::instance($user2->id), $event->get_context());

        $url = new \moodle_url('/message/output/popup/notifications.php', ['notificationid' => $event->objectid]);

        $this->assertEquals($url, $event->get_url());

    }

}