Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.0.x will end 8 May 2023 (12 months).
  • Bug fixes for security issues in 4.0.x will end 13 November 2023 (18 months).
  • PHP version: minimum PHP 7.3.0 Note: the minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is also supported.
<?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_blog
 * @category   test
 * @copyright  2016 Stephen Bourget
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace core_blog\event;

defined('MOODLE_INTERNAL') || die();

global $CFG;
require_once($CFG->dirroot . '/blog/locallib.php');
require_once($CFG->dirroot . '/blog/lib.php');

/**
 * Unit tests for the blog events.
 *
 * @copyright  2016 Stephen Bourget
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class events_test extends \advanced_testcase {

    /** @var $courseid */
    private $courseid;

    /** @var $cmid */
    private $cmid;

    /** @var $groupid */
    private $groupid;

    /** @var $userid */
    private $userid;

    /** @var $tagid */
    private $tagid;

    /** @var $postid */
    private $postid;

    /**
     * Setup the tests.
     */
    protected function setUp(): void {
        global $DB;
        parent::setUp();

        $this->resetAfterTest();

        // Create default course.
        $course = $this->getDataGenerator()->create_course(array('category' => 1, 'shortname' => 'ANON'));
        $this->assertNotEmpty($course);
        $page = $this->getDataGenerator()->create_module('page', array('course' => $course->id));
        $this->assertNotEmpty($page);

        // Create default group.
        $group = new \stdClass();
        $group->courseid = $course->id;
        $group->name = 'ANON';
        $group->id = $DB->insert_record('groups', $group);

        // Create default user.
        $user = $this->getDataGenerator()->create_user(array(
                'username' => 'testuser',
                'firstname' => 'Jimmy',
                'lastname' => 'Kinnon'
        ));

        // Create default tag.
        $tag = $this->getDataGenerator()->create_tag(array('userid' => $user->id,
            'rawname' => 'Testtagname', 'isstandard' => 1));

        // Create default post.
        $post = new \stdClass();
        $post->userid = $user->id;
        $post->groupid = $group->id;
        $post->content = 'test post content text';
        $post->module = 'blog';
        $post->id = $DB->insert_record('post', $post);

        // Grab important ids.
        $this->courseid = $course->id;
        $this->cmid = $page->cmid;
        $this->groupid  = $group->id;
        $this->userid  = $user->id;
        $this->tagid  = $tag->id;
        $this->postid = $post->id;
    }

    /**
     * Test various blog related events.
     */
    public function test_blog_entry_created_event() {
        global $USER;

        $this->setAdminUser();
        $this->resetAfterTest();

        // Create a blog entry for another user as Admin.
        $sink = $this->redirectEvents();
        $blog = new \blog_entry();
        $blog->subject = "Subject of blog";
        $blog->userid = $this->userid;
        $states = \blog_entry::get_applicable_publish_states();
        $blog->publishstate = reset($states);
        $blog->add();
        $events = $sink->get_events();
        $sink->close();
        $event = reset($events);
        $sitecontext = \context_system::instance();

        // Validate event data.
        $this->assertInstanceOf('\core\event\blog_entry_created', $event);
        $url = new \moodle_url('/blog/index.php', array('entryid' => $event->objectid));
        $this->assertEquals($url, $event->get_url());
        $this->assertEquals($sitecontext->id, $event->contextid);
        $this->assertEquals($blog->id, $event->objectid);
        $this->assertEquals($USER->id, $event->userid);
        $this->assertEquals($this->userid, $event->relateduserid);
        $this->assertEquals("post", $event->objecttable);
< $arr = array(SITEID, 'blog', 'add', 'index.php?userid=' . $this->userid . '&entryid=' . $blog->id, $blog->subject); < $this->assertEventLegacyLogData($arr, $event); < $this->assertEquals("blog_entry_added", $event->get_legacy_eventname()); < $this->assertEventLegacyData($blog, $event);
$this->assertEventContextNotUsed($event); } /** * Tests for event blog_entry_updated. */ public function test_blog_entry_updated_event() { global $USER; $this->setAdminUser(); $this->resetAfterTest(); $sitecontext = \context_system::instance(); // Edit a blog entry as Admin. $blog = new \blog_entry($this->postid); $sink = $this->redirectEvents(); $blog->summary_editor = array('text' => 'Something', 'format' => FORMAT_MOODLE); $blog->edit(array(), null, array(), array()); $events = $sink->get_events(); $event = array_pop($events); $sink->close(); // Validate event data. $this->assertInstanceOf('\core\event\blog_entry_updated', $event); $url = new \moodle_url('/blog/index.php', array('entryid' => $event->objectid)); $this->assertEquals($url, $event->get_url()); $this->assertEquals($sitecontext->id, $event->contextid); $this->assertEquals($blog->id, $event->objectid); $this->assertEquals($USER->id, $event->userid); $this->assertEquals($this->userid, $event->relateduserid); $this->assertEquals("post", $event->objecttable);
< $this->assertEquals("blog_entry_edited", $event->get_legacy_eventname()); < $this->assertEventLegacyData($blog, $event); < $arr = array (SITEID, 'blog', 'update', 'index.php?userid=' . $this->userid . '&entryid=' . $blog->id, $blog->subject); < $this->assertEventLegacyLogData($arr, $event);
$this->assertEventContextNotUsed($event); } /** * Tests for event blog_entry_deleted. */ public function test_blog_entry_deleted_event() { global $USER, $DB; $this->setAdminUser(); $this->resetAfterTest(); $sitecontext = \context_system::instance(); // Delete a user blog entry as Admin. $blog = new \blog_entry($this->postid); $sink = $this->redirectEvents(); $record = $DB->get_record('post', array('id' => $blog->id)); $blog->delete(); $events = $sink->get_events(); $event = array_pop($events); $sink->close(); // Validate event data. $this->assertInstanceOf('\core\event\blog_entry_deleted', $event); $this->assertEquals(null, $event->get_url()); $this->assertEquals($sitecontext->id, $event->contextid); $this->assertEquals($blog->id, $event->objectid); $this->assertEquals($USER->id, $event->userid); $this->assertEquals($this->userid, $event->relateduserid); $this->assertEquals("post", $event->objecttable); $this->assertEquals($record, $event->get_record_snapshot("post", $blog->id));
< $this->assertSame('blog_entry_deleted', $event->get_legacy_eventname()); < $arr = array(SITEID, 'blog', 'delete', 'index.php?userid=' . $blog->userid, 'deleted blog entry with entry id# ' . < $blog->id); < $this->assertEventLegacyLogData($arr, $event); < $this->assertEventLegacyData($blog, $event);
$this->assertEventContextNotUsed($event); } /** * Tests for event blog_association_deleted. */ public function test_blog_association_deleted_event() { global $USER; $this->setAdminUser(); $this->resetAfterTest(); $sitecontext = \context_system::instance(); $coursecontext = \context_course::instance($this->courseid); $contextmodule = \context_module::instance($this->cmid); // Add blog associations with a course. $blog = new \blog_entry($this->postid); $blog->add_association($coursecontext->id); $sink = $this->redirectEvents(); $blog->remove_associations(); $events = $sink->get_events(); $event = reset($events); $sink->close(); // Validate event data. $this->assertInstanceOf('\core\event\blog_association_deleted', $event); $this->assertEquals($sitecontext->id, $event->contextid); $this->assertEquals($blog->id, $event->other['blogid']); $this->assertEquals($USER->id, $event->userid); $this->assertEquals($this->userid, $event->relateduserid); $this->assertEquals('blog_association', $event->objecttable); // Add blog associations with a module. $blog = new \blog_entry($this->postid); $blog->add_association($contextmodule->id); $sink = $this->redirectEvents(); $blog->remove_associations(); $events = $sink->get_events(); $event = reset($events); $sink->close(); // Validate event data. $this->assertEquals($blog->id, $event->other['blogid']); $this->assertEquals($USER->id, $event->userid); $this->assertEventContextNotUsed($event); } /** * Tests for event blog_association_created. */ public function test_blog_association_created_event() { global $USER; $this->setAdminUser(); $this->resetAfterTest(); $sitecontext = \context_system::instance(); $coursecontext = \context_course::instance($this->courseid); $contextmodule = \context_module::instance($this->cmid); // Add blog associations with a course. $blog = new \blog_entry($this->postid); $sink = $this->redirectEvents(); $blog->add_association($coursecontext->id); $events = $sink->get_events(); $event = reset($events); $sink->close(); // Validate event data. $this->assertInstanceOf('\core\event\blog_association_created', $event); $this->assertEquals($sitecontext->id, $event->contextid); $url = new \moodle_url('/blog/index.php', array('entryid' => $event->other['blogid'])); $this->assertEquals($url, $event->get_url()); $this->assertEquals($blog->id, $event->other['blogid']); $this->assertEquals($this->courseid, $event->other['associateid']); $this->assertEquals('course', $event->other['associatetype']); $this->assertEquals($blog->subject, $event->other['subject']); $this->assertEquals($USER->id, $event->userid); $this->assertEquals($this->userid, $event->relateduserid); $this->assertEquals('blog_association', $event->objecttable);
< $arr = array(SITEID, 'blog', 'add association', 'index.php?userid=' . $this->userid . '&entryid=' . $blog->id, < $blog->subject, 0, $this->userid); < $this->assertEventLegacyLogData($arr, $event);
// Add blog associations with a module. $blog = new \blog_entry($this->postid); $sink = $this->redirectEvents(); $blog->add_association($contextmodule->id); $events = $sink->get_events(); $event = reset($events); $sink->close(); // Validate event data. $this->assertEquals($blog->id, $event->other['blogid']); $this->assertEquals($this->cmid, $event->other['associateid']); $this->assertEquals('coursemodule', $event->other['associatetype']);
< $arr = array(SITEID, 'blog', 'add association', 'index.php?userid=' . $this->userid . '&entryid=' . $blog->id, < $blog->subject, $this->cmid, $this->userid); < $this->assertEventLegacyLogData($arr, $event);
$this->assertEventContextNotUsed($event); } /** * Tests for event blog_association_created validations. */ public function test_blog_association_created_event_validations() { $this->resetAfterTest(); // Make sure associatetype validations work. try { \core\event\blog_association_created::create(array( 'contextid' => 1, 'objectid' => 3, 'relateduserid' => 2, 'other' => array('associateid' => 2 , 'blogid' => 3, 'subject' => 'blog subject'))); } catch (\coding_exception $e) { $this->assertStringContainsString('The \'associatetype\' value must be set in other and be a valid type.', $e->getMessage()); } try { \core\event\blog_association_created::create(array( 'contextid' => 1, 'objectid' => 3, 'relateduserid' => 2, 'other' => array('associateid' => 2 , 'blogid' => 3, 'associatetype' => 'random', 'subject' => 'blog subject'))); } catch (\coding_exception $e) { $this->assertStringContainsString('The \'associatetype\' value must be set in other and be a valid type.', $e->getMessage()); } // Make sure associateid validations work. try { \core\event\blog_association_created::create(array( 'contextid' => 1, 'objectid' => 3, 'relateduserid' => 2, 'other' => array('blogid' => 3, 'associatetype' => 'course', 'subject' => 'blog subject'))); } catch (\coding_exception $e) { $this->assertStringContainsString('The \'associateid\' value must be set in other.', $e->getMessage()); } // Make sure blogid validations work. try { \core\event\blog_association_created::create(array( 'contextid' => 1, 'objectid' => 3, 'relateduserid' => 2, 'other' => array('associateid' => 3, 'associatetype' => 'course', 'subject' => 'blog subject'))); } catch (\coding_exception $e) { $this->assertStringContainsString('The \'blogid\' value must be set in other.', $e->getMessage()); } // Make sure blogid validations work. try { \core\event\blog_association_created::create(array( 'contextid' => 1, 'objectid' => 3, 'relateduserid' => 2, 'other' => array('blogid' => 3, 'associateid' => 3, 'associatetype' => 'course'))); } catch (\coding_exception $e) { $this->assertStringContainsString('The \'subject\' value must be set in other.', $e->getMessage()); } } /** * Tests for event blog_entries_viewed. */ public function test_blog_entries_viewed_event() { $this->setAdminUser(); $other = array('entryid' => $this->postid, 'tagid' => $this->tagid, 'userid' => $this->userid, 'modid' => $this->cmid, 'groupid' => $this->groupid, 'courseid' => $this->courseid, 'search' => 'search', 'fromstart' => 2); // Trigger event. $sink = $this->redirectEvents(); $eventparams = array('other' => $other); $eventinst = \core\event\blog_entries_viewed::create($eventparams); $eventinst->trigger(); $events = $sink->get_events(); $event = reset($events); $sink->close(); // Validate event data. $url = new \moodle_url('/blog/index.php', $other);
< $url2 = new \moodle_url('index.php', $other);
$this->assertEquals($url, $event->get_url());
< $arr = array(SITEID, 'blog', 'view', $url2->out(), 'view blog entry'); < $this->assertEventLegacyLogData($arr, $event);
$this->assertEventContextNotUsed($event); } /** * Test comment_created event. */ public function test_blog_comment_created_event() { global $USER, $CFG; $this->setAdminUser(); require_once($CFG->dirroot . '/comment/lib.php'); $context = \context_user::instance($USER->id); $cmt = new \stdClass(); $cmt->context = $context; $cmt->courseid = $this->courseid; $cmt->area = 'format_blog'; $cmt->itemid = $this->postid; $cmt->showcount = 1; $cmt->component = 'blog'; $manager = new \comment($cmt); // Triggering and capturing the event. $sink = $this->redirectEvents(); $manager->add("New comment"); $events = $sink->get_events(); $this->assertCount(1, $events); $event = reset($events); // Checking that the event contains the expected values. $this->assertInstanceOf('\core\event\blog_comment_created', $event); $this->assertEquals($context, $event->get_context()); $this->assertEquals($this->postid, $event->other['itemid']); $url = new \moodle_url('/blog/index.php', array('entryid' => $this->postid)); $this->assertEquals($url, $event->get_url()); $this->assertEventContextNotUsed($event); } /** * Test comment_deleted event. */ public function test_blog_comment_deleted_event() { global $USER, $CFG; $this->setAdminUser(); require_once($CFG->dirroot . '/comment/lib.php'); $context = \context_user::instance($USER->id); $cmt = new \stdClass(); $cmt->context = $context; $cmt->courseid = $this->courseid; $cmt->area = 'format_blog'; $cmt->itemid = $this->postid; $cmt->showcount = 1; $cmt->component = 'blog'; $manager = new \comment($cmt); $newcomment = $manager->add("New comment"); // Triggering and capturing the event. $sink = $this->redirectEvents(); $manager->delete($newcomment->id); $events = $sink->get_events(); $this->assertCount(1, $events); $event = reset($events); // Checking that the event contains the expected values. $this->assertInstanceOf('\core\event\blog_comment_deleted', $event); $this->assertEquals($context, $event->get_context()); $this->assertEquals($this->postid, $event->other['itemid']); $url = new \moodle_url('/blog/index.php', array('entryid' => $this->postid)); $this->assertEquals($url, $event->get_url()); $this->assertEventContextNotUsed($event); } /** * Test external blog added event. * * There is no external API for this, so the unit test will simply * create and trigger the event and ensure data is returned as expected. */ public function test_external_blog_added_event() { // Trigger an event: external blog added. $eventparams = array( 'context' => $context = \context_system::instance(), 'objectid' => 1001, 'other' => array('url' => 'http://moodle.org') ); $event = \core\event\blog_external_added::create($eventparams); // 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\blog_external_added', $event); $this->assertEquals(1001, $event->objectid); $this->assertEquals('http://moodle.org', $event->other['url']); $this->assertDebuggingNotCalled(); } /** * Test external blog updated event. * * There is no external API for this, so the unit test will simply * create and trigger the event and ensure data is returned as expected. */ public function test_external_blog_updated_event() { // Trigger an event: external blog updated. $eventparams = array( 'context' => $context = \context_system::instance(), 'objectid' => 1001, 'other' => array('url' => 'http://moodle.org') ); $event = \core\event\blog_external_updated::create($eventparams); // 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\blog_external_updated', $event); $this->assertEquals(1001, $event->objectid); $this->assertEquals('http://moodle.org', $event->other['url']); $this->assertDebuggingNotCalled(); } /** * Test external blog removed event. * * There is no external API for this, so the unit test will simply * create and trigger the event and ensure data is returned as expected. */ public function test_external_blog_removed_event() { // Trigger an event: external blog removed. $eventparams = array( 'context' => $context = \context_system::instance(), 'objectid' => 1001, ); $event = \core\event\blog_external_removed::create($eventparams); // 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\blog_external_removed', $event); $this->assertEquals(1001, $event->objectid); $this->assertDebuggingNotCalled(); } /** * Test external blogs viewed event. * * There is no external API for this, so the unit test will simply * create and trigger the event and ensure data is returned as expected. */ public function test_external_blogs_viewed_event() { // Trigger an event: external blogs viewed. $eventparams = array( 'context' => $context = \context_system::instance(), ); $event = \core\event\blog_external_viewed::create($eventparams); // 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\blog_external_viewed', $event); $this->assertDebuggingNotCalled(); } }