Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.10.x will end 8 November 2021 (12 months).
  • Bug fixes for security issues in 3.10.x will end 9 May 2022 (18 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.
<?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/>.

/**
 * The exported_posts builder tests.
 *
 * @package    mod_forum
 * @copyright  2019 Ryan Wyllie <ryan@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

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

require_once(__DIR__ . '/generator_trait.php');

/**
 * The exported_posts builder tests.
 *
 * @package    mod_forum
 * @copyright  2019 Ryan Wyllie <ryan@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class mod_forum_builders_exported_posts_testcase extends advanced_testcase {
    // Make use of the test generator trait.
    use mod_forum_tests_generator_trait;

    /** @var \mod_forum\local\builders\exported_posts */
    private $builder;

    /**
     * Set up function for tests.
     */
< public function setUp() {
> public function setUp(): void {
// We must clear the subscription caches. This has to be done both before each test, and after in case of other // tests using these functions. \mod_forum\subscriptions::reset_forum_cache(); $builderfactory = \mod_forum\local\container::get_builder_factory(); $this->builder = $builderfactory->get_exported_posts_builder(); } /** * Tear down function for tests. */
< public function tearDown() {
> public function tearDown(): void {
// We must clear the subscription caches. This has to be done both before each test, and after in case of other // tests using these functions. \mod_forum\subscriptions::reset_forum_cache(); } /** * Convert the stdClass values into their proper entity classes. * * @param stdClass[] $forums List of forums * @param stdClass[] $discussions List of discussions * @param stdClass[] $posts List of posts * @return array */ private function convert_to_entities(array $forums, array $discussions, array $posts) { global $DB; $entityfactory = \mod_forum\local\container::get_entity_factory(); return [ // Forums. array_map(function($forum) use ($entityfactory, $DB) { $course = $DB->get_record('course', ['id' => $forum->course]); $coursemodule = get_coursemodule_from_instance('forum', $forum->id); $context = context_module::instance($coursemodule->id); return $entityfactory->get_forum_from_stdclass($forum, $context, $coursemodule, $course); }, $forums), // Discussions. array_map(function($discussion) use ($entityfactory) { return $entityfactory->get_discussion_from_stdclass($discussion); }, $discussions), // Posts. array_map(function($post) use ($entityfactory) { return $entityfactory->get_post_from_stdclass($post); }, $posts) ]; } /** * Test the build function throws exception if not given all of the forums for * the list of posts. */ public function test_build_throws_exception_on_missing_forums() { $this->resetAfterTest(); $datagenerator = $this->getDataGenerator(); $user = $datagenerator->create_user(); $course = $datagenerator->create_course(); $forum1 = $datagenerator->create_module('forum', ['course' => $course->id]); $forum2 = $datagenerator->create_module('forum', ['course' => $course->id]); [$discussion1, $post1] = $this->helper_post_to_forum($forum1, $user); [$discussion2, $post2] = $this->helper_post_to_forum($forum2, $user); [$forums, $discussions, $posts] = $this->convert_to_entities( [$forum1, $forum2], [$discussion1, $discussion2], [$post1, $post2] ); $this->expectException('moodle_exception'); $this->builder->build($user, [$forums[0]], $discussions, $posts); } /** * Test the build function throws exception if not given all of the discussions for * the list of posts. */ public function test_build_throws_exception_on_missing_discussions() { $this->resetAfterTest(); $datagenerator = $this->getDataGenerator(); $user = $datagenerator->create_user(); $course = $datagenerator->create_course(); $forum1 = $datagenerator->create_module('forum', ['course' => $course->id]); $forum2 = $datagenerator->create_module('forum', ['course' => $course->id]); [$discussion1, $post1] = $this->helper_post_to_forum($forum1, $user); [$discussion2, $post2] = $this->helper_post_to_forum($forum2, $user); [$forums, $discussions, $posts] = $this->convert_to_entities( [$forum1, $forum2], [$discussion1, $discussion2], [$post1, $post2] ); $this->expectException('moodle_exception'); $this->builder->build($user, $forums, [$discussions[0]], $posts); } /** * Test the build function returns the exported posts in the order that the posts are * given. */ public function test_build_returns_posts_in_order() { $this->resetAfterTest(); $datagenerator = $this->getDataGenerator(); $user1 = $datagenerator->create_user(); $user2 = $datagenerator->create_user(); $course = $datagenerator->create_course(); $forum1 = $datagenerator->create_module('forum', ['course' => $course->id]); $forum2 = $datagenerator->create_module('forum', ['course' => $course->id]); [$discussion1, $post1] = $this->helper_post_to_forum($forum1, $user1); [$discussion2, $post2] = $this->helper_post_to_forum($forum1, $user2); $post3 = $this->helper_reply_to_post($post1, $user1); $post4 = $this->helper_reply_to_post($post1, $user2); [$discussion3, $post5] = $this->helper_post_to_forum($forum2, $user1); [$discussion4, $post6] = $this->helper_post_to_forum($forum2, $user2); $post7 = $this->helper_reply_to_post($post2, $user1); $post8 = $this->helper_reply_to_post($post2, $user2); [$forums, $discussions, $posts] = $this->convert_to_entities( [$forum1, $forum2], [$discussion1, $discussion2, $discussion3, $discussion4], [$post1, $post2, $post3, $post4, $post5, $post6, $post7, $post8] ); // Randomly order the posts. shuffle($posts); $exportedposts = $this->builder->build($user1, $forums, $discussions, $posts); $expectedpostids = array_map(function($post) { return $post->get_id(); }, $posts); $actualpostids = array_map(function($exportedpost) { return (int) $exportedpost->id; }, $exportedposts); $this->assertEquals($expectedpostids, $actualpostids); } /** * Test the build function loads authors. */ public function test_build_loads_authors() { $this->resetAfterTest(); $datagenerator = $this->getDataGenerator(); $user1 = $datagenerator->create_user(); $user2 = $datagenerator->create_user(); $user3 = $datagenerator->create_user(); $course = $datagenerator->create_course(); $forum1 = $datagenerator->create_module('forum', ['course' => $course->id]); $forum2 = $datagenerator->create_module('forum', ['course' => $course->id]); [$discussion1, $post1] = $this->helper_post_to_forum($forum1, $user1); [$discussion2, $post2] = $this->helper_post_to_forum($forum1, $user2); $post3 = $this->helper_reply_to_post($post1, $user1); $post4 = $this->helper_reply_to_post($post1, $user2); [$discussion3, $post5] = $this->helper_post_to_forum($forum2, $user1); [$discussion4, $post6] = $this->helper_post_to_forum($forum2, $user2); // These 2 replies from user 3 won't be inlcuded in the export. $post7 = $this->helper_reply_to_post($post2, $user3); $post8 = $this->helper_reply_to_post($post2, $user3); [$forums, $discussions, $posts] = $this->convert_to_entities( [$forum1, $forum2], [$discussion1, $discussion2, $discussion3, $discussion4], [$post1, $post2, $post3, $post4, $post5, $post6] ); $datagenerator->enrol_user($user1->id, $course->id); $exportedposts = $this->builder->build($user1, $forums, $discussions, $posts); // We didn't include any posts from user 3 so we shouldn't see the authors // that match that user. $expectedids = [$user1->id, $user2->id]; $actualids = array_unique(array_map(function($exportedpost) { return (int) $exportedpost->author->id; }, $exportedposts)); sort($expectedids); sort($actualids); $this->assertEquals($expectedids, $actualids); } /** * Test the build function loads attachments. */ public function test_build_loads_attachments() { $this->resetAfterTest(); $datagenerator = $this->getDataGenerator(); $user1 = $datagenerator->create_user(); $user2 = $datagenerator->create_user(); $user3 = $datagenerator->create_user(); $course = $datagenerator->create_course(); $forum1 = $datagenerator->create_module('forum', ['course' => $course->id]); $forum2 = $datagenerator->create_module('forum', ['course' => $course->id]); [$discussion1, $post1] = $this->helper_post_to_forum($forum1, $user1); [$discussion2, $post2] = $this->helper_post_to_forum($forum1, $user2); $post3 = $this->helper_reply_to_post($post1, $user1); $post4 = $this->helper_reply_to_post($post1, $user2); [$discussion3, $post5] = $this->helper_post_to_forum($forum2, $user1); [$discussion4, $post6] = $this->helper_post_to_forum($forum2, $user2); $post7 = $this->helper_reply_to_post($post5, $user3); $post8 = $this->helper_reply_to_post($post5, $user3); $filestorage = get_file_storage(); [$forums, $discussions, $posts] = $this->convert_to_entities( [$forum1, $forum2], [$discussion1, $discussion2, $discussion3, $discussion4], [$post1, $post2, $post3, $post4, $post5, $post6, $post7, $post8] ); // Add an attachment to a post in forum 1. $attachment1 = $filestorage->create_file_from_string( [ 'contextid' => $forums[0]->get_context()->id, 'component' => 'mod_forum', 'filearea' => 'attachment', 'itemid' => $post1->id, 'filepath' => '/', 'filename' => 'example1.jpg', ], 'image contents' ); // Add an attachment to a post in forum 2. $attachment2 = $filestorage->create_file_from_string( [ 'contextid' => $forums[1]->get_context()->id, 'component' => 'mod_forum', 'filearea' => 'attachment', 'itemid' => $post7->id, 'filepath' => '/', 'filename' => 'example2.jpg', ], 'image contents' ); // Enrol the user so that they can see the posts. $datagenerator->enrol_user($user1->id, $course->id); $exportedposts = $this->builder->build($user1, $forums, $discussions, $posts); $expected = ['example1.jpg', 'example2.jpg']; $actual = array_reduce($exportedposts, function($carry, $exportedpost) { if (!empty($exportedpost->attachments)) { foreach ($exportedpost->attachments as $attachment) { $carry[] = $attachment->filename; } } return $carry; }, []); sort($expected); sort($actual); $this->assertEquals($expected, $actual); } /** * Test the build function loads author groups. */ public function test_build_loads_author_groups() { $this->resetAfterTest(); $datagenerator = $this->getDataGenerator(); $user1 = $datagenerator->create_user(); $user2 = $datagenerator->create_user(); $user3 = $datagenerator->create_user(); $course1 = $datagenerator->create_course(); $course2 = $datagenerator->create_course(); $forum1 = $datagenerator->create_module('forum', ['course' => $course1->id]); $forum2 = $datagenerator->create_module('forum', ['course' => $course1->id]); [$discussion1, $post1] = $this->helper_post_to_forum($forum1, $user1); [$discussion2, $post2] = $this->helper_post_to_forum($forum1, $user2); $post3 = $this->helper_reply_to_post($post1, $user1); $post4 = $this->helper_reply_to_post($post1, $user2); [$discussion3, $post5] = $this->helper_post_to_forum($forum2, $user1); [$discussion4, $post6] = $this->helper_post_to_forum($forum2, $user2); $post7 = $this->helper_reply_to_post($post5, $user3); $post8 = $this->helper_reply_to_post($post5, $user3); [$forums, $discussions, $posts] = $this->convert_to_entities( [$forum1, $forum2], [$discussion1, $discussion2, $discussion3, $discussion4], [$post1, $post2, $post3, $post4, $post5, $post6, $post7, $post8] ); // Enrol the user so that they can see the posts. $datagenerator->enrol_user($user1->id, $course1->id); $datagenerator->enrol_user($user1->id, $course2->id); $datagenerator->enrol_user($user2->id, $course1->id); $datagenerator->enrol_user($user2->id, $course2->id); $datagenerator->enrol_user($user3->id, $course1->id); $datagenerator->enrol_user($user3->id, $course2->id); $group1 = $datagenerator->create_group(['courseid' => $course1->id]); $group2 = $datagenerator->create_group(['courseid' => $course1->id]); // This group shouldn't be included in the results since it's in a different course. $group3 = $datagenerator->create_group(['courseid' => $course2->id]); $datagenerator->create_group_member(['userid' => $user1->id, 'groupid' => $group1->id]); $datagenerator->create_group_member(['userid' => $user2->id, 'groupid' => $group1->id]); $datagenerator->create_group_member(['userid' => $user1->id, 'groupid' => $group2->id]); $datagenerator->create_group_member(['userid' => $user1->id, 'groupid' => $group3->id]); $exportedposts = $this->builder->build($user1, $forums, $discussions, $posts); $expected = [ $user1->id => [$group1->id, $group2->id], $user2->id => [$group1->id], $user3->id => [] ]; $actual = array_reduce($exportedposts, function($carry, $exportedpost) { $author = $exportedpost->author; $authorid = $author->id; if (!isset($carry[$authorid])) { $carry[$authorid] = array_map(function($group) { return $group['id']; }, $author->groups); } return $carry; }, []); $this->assertEquals($expected, $actual); } /** * Test the build function loads tags. */ public function test_build_loads_tags() { $this->resetAfterTest(); $datagenerator = $this->getDataGenerator(); $user1 = $datagenerator->create_user(); $user2 = $datagenerator->create_user(); $user3 = $datagenerator->create_user(); $course1 = $datagenerator->create_course(); $course2 = $datagenerator->create_course(); $forum1 = $datagenerator->create_module('forum', ['course' => $course1->id]); $forum2 = $datagenerator->create_module('forum', ['course' => $course1->id]); [$discussion1, $post1] = $this->helper_post_to_forum($forum1, $user1); [$discussion2, $post2] = $this->helper_post_to_forum($forum1, $user2); $post3 = $this->helper_reply_to_post($post1, $user1); $post4 = $this->helper_reply_to_post($post1, $user2); [$discussion3, $post5] = $this->helper_post_to_forum($forum2, $user1); [$discussion4, $post6] = $this->helper_post_to_forum($forum2, $user2); $post7 = $this->helper_reply_to_post($post5, $user3); $post8 = $this->helper_reply_to_post($post5, $user3); [$forums, $discussions, $posts] = $this->convert_to_entities( [$forum1, $forum2], [$discussion1, $discussion2, $discussion3, $discussion4], [$post1, $post2, $post3, $post4, $post5, $post6, $post7, $post8] ); // Enrol the user so that they can see the posts. $datagenerator->enrol_user($user1->id, $course1->id); $datagenerator->enrol_user($user1->id, $course2->id); $datagenerator->enrol_user($user2->id, $course1->id); $datagenerator->enrol_user($user2->id, $course2->id); $datagenerator->enrol_user($user3->id, $course1->id); $datagenerator->enrol_user($user3->id, $course2->id); \core_tag_tag::set_item_tags('mod_forum', 'forum_posts', $post1->id, $forums[0]->get_context(), ['foo', 'bar']); \core_tag_tag::set_item_tags('mod_forum', 'forum_posts', $post4->id, $forums[0]->get_context(), ['foo', 'baz']); \core_tag_tag::set_item_tags('mod_forum', 'forum_posts', $post7->id, $forums[1]->get_context(), ['bip']); $exportedposts = $this->builder->build($user1, $forums, $discussions, $posts); $expected = [ $post1->id => ['foo', 'bar'], $post4->id => ['foo', 'baz'], $post7->id => ['bip'] ]; $actual = array_reduce($exportedposts, function($carry, $exportedpost) { if (!empty($exportedpost->tags)) { $carry[$exportedpost->id] = array_map(function($tag) { return $tag['displayname']; }, $exportedpost->tags); } return $carry; }, []); $this->assertEquals($expected, $actual); } /** * Test the build function loads read_receipts. */ public function test_build_loads_read_receipts() { $this->resetAfterTest(); $datagenerator = $this->getDataGenerator(); $user1 = $datagenerator->create_user(['trackforums' => 1]); $user2 = $datagenerator->create_user(['trackforums' => 0]); $course1 = $datagenerator->create_course(); $course2 = $datagenerator->create_course(); $forum1 = $datagenerator->create_module('forum', ['course' => $course1->id, 'trackingtype' => FORUM_TRACKING_OPTIONAL]); $forum2 = $datagenerator->create_module('forum', ['course' => $course1->id, 'trackingtype' => FORUM_TRACKING_OFF]); [$discussion1, $post1] = $this->helper_post_to_forum($forum1, $user1); [$discussion2, $post2] = $this->helper_post_to_forum($forum1, $user2); $post3 = $this->helper_reply_to_post($post1, $user1); $post4 = $this->helper_reply_to_post($post1, $user2); [$discussion3, $post5] = $this->helper_post_to_forum($forum2, $user1); [$discussion4, $post6] = $this->helper_post_to_forum($forum2, $user2); $post7 = $this->helper_reply_to_post($post5, $user1); $post8 = $this->helper_reply_to_post($post5, $user1); [$forums, $discussions, $posts] = $this->convert_to_entities( [$forum1, $forum2], [$discussion1, $discussion2, $discussion3, $discussion4], [$post1, $post2, $post3, $post4, $post5, $post6, $post7, $post8] ); // Enrol the user so that they can see the posts. $datagenerator->enrol_user($user1->id, $course1->id); $datagenerator->enrol_user($user1->id, $course2->id); $datagenerator->enrol_user($user2->id, $course1->id); $datagenerator->enrol_user($user2->id, $course2->id); forum_tp_add_read_record($user1->id, $post1->id); forum_tp_add_read_record($user1->id, $post4->id); forum_tp_add_read_record($user1->id, $post7->id); forum_tp_add_read_record($user2->id, $post1->id); forum_tp_add_read_record($user2->id, $post4->id); forum_tp_add_read_record($user2->id, $post7->id); // User 1 has tracking enabled. $exportedposts = $this->builder->build($user1, $forums, $discussions, $posts); $expected = [ // Tracking set for forum 1 for user 1. $post1->id => false, $post2->id => true, $post3->id => true, $post4->id => false, // Tracking is off for forum 2 so everything should be null. $post5->id => null, $post6->id => null, $post7->id => null, $post8->id => null ]; $actual = array_reduce($exportedposts, function($carry, $exportedpost) { $carry[$exportedpost->id] = $exportedpost->unread; return $carry; }, []); $this->assertEquals($expected, $actual); // User 2 has tracking disabled. $exportedposts = $this->builder->build($user2, $forums, $discussions, $posts); // Tracking is off for user 2 so everything should be null. $expected = [ $post1->id => null, $post2->id => null, $post3->id => null, $post4->id => null, $post5->id => null, $post6->id => null, $post7->id => null, $post8->id => null ]; $actual = array_reduce($exportedposts, function($carry, $exportedpost) { $carry[$exportedpost->id] = $exportedpost->unread; return $carry; }, []); $this->assertEquals($expected, $actual); } }