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 forum module mail generation tests for groups. < * < * @package mod_forum < * @copyright 2013 Andrew Nicols < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < */
> namespace mod_forum; > > use mod_forum_tests_cron_trait; > use mod_forum_tests_generator_trait;
defined('MOODLE_INTERNAL') || die(); global $CFG; require_once($CFG->dirroot . '/mod/forum/lib.php'); require_once(__DIR__ . '/cron_trait.php'); require_once(__DIR__ . '/generator_trait.php'); /** * The forum module mail generation tests for groups. * * @copyright 2013 Andrew Nicols * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */
< class mod_forum_mail_group_testcase extends advanced_testcase {
> class mail_group_test extends \advanced_testcase {
// Make use of the cron tester trait. use mod_forum_tests_cron_trait; // Make use of the test generator trait. use mod_forum_tests_generator_trait; /** * @var \phpunit_message_sink */ protected $messagesink; /** * @var \phpunit_mailer_sink */ protected $mailsink; public function setUp(): void { global $CFG; // 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(); \mod_forum\subscriptions::reset_discussion_cache(); // Messaging is not compatible with transactions... $this->preventResetByRollback(); // Catch all messages. $this->messagesink = $this->redirectMessages(); $this->mailsink = $this->redirectEmails(); // Forcibly reduce the maxeditingtime to a second in the past to // ensure that messages are sent out. $CFG->maxeditingtime = -1; } 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(); $this->messagesink->clear(); $this->messagesink->close(); unset($this->messagesink); $this->mailsink->clear(); $this->mailsink->close(); unset($this->mailsink); } /** * Ensure that posts written in a forum marked for separate groups includes notifications for the members of that * group, and any user with accessallgroups. */ public function test_separate_group() { global $CFG, $DB; $this->resetAfterTest(true); // Create a course, with a forum. $course = $this->getDataGenerator()->create_course(); $forum = $this->getDataGenerator()->create_module('forum', [ 'course' => $course->id, 'forcesubscribe' => FORUM_INITIALSUBSCRIBE, 'groupmode' => SEPARATEGROUPS, ]); // Create three students: // - author, enrolled in group A; and // - recipient, enrolled in group B; and // - other, enrolled in the course, but no groups. list($author, $recipient, $otheruser) = $this->helper_create_users($course, 3); // Create one teacher, not in any group and no accessallgroups capability. list($teacher) = $this->helper_create_users($course, 1, 'teacher'); // Create one editing teacher, not in any group but with accessallgroups capability. list($editingteacher) = $this->helper_create_users($course, 1, 'editingteacher'); $groupa = $this->getDataGenerator()->create_group(['courseid' => $course->id]); $groupb = $this->getDataGenerator()->create_group(['courseid' => $course->id]); $this->getDataGenerator()->create_group_member([ 'groupid' => $groupa->id, 'userid' => $author->id, ]); $this->getDataGenerator()->create_group_member([ 'groupid' => $groupb->id, 'userid' => $recipient->id, ]); // Post a discussion to the forum. list($discussion, $post) = $this->helper_post_to_forum($forum, $author, [ 'groupid' => $groupa->id, ]); // Only the author should receive. $expect = [ 'author' => (object) [ 'userid' => $author->id, 'messages' => 1, ], 'recipient' => (object) [ 'userid' => $recipient->id, 'messages' => 0, ], 'otheruser' => (object) [ 'userid' => $otheruser->id, 'messages' => 0, ], 'teacher' => (object) [ 'userid' => $teacher->id, 'messages' => 0, ], 'editingteacher' => (object) [ 'userid' => $editingteacher->id, 'messages' => 1, ], ]; $this->queue_tasks_and_assert($expect); // No notifications should be queued. $this->send_notifications_and_assert($author, [$post]); $this->send_notifications_and_assert($recipient, []); $this->send_notifications_and_assert($otheruser, []); $this->send_notifications_and_assert($teacher, []); $this->send_notifications_and_assert($editingteacher, [$post]); } /** * Ensure that posts written in a forum marked for visible groups includes notifications for the members of that * group, and any user with accessallgroups. */ public function test_visible_group() { global $CFG, $DB; $this->resetAfterTest(true); // Create a course, with a forum. $course = $this->getDataGenerator()->create_course(); $forum = $this->getDataGenerator()->create_module('forum', [ 'course' => $course->id, 'forcesubscribe' => FORUM_INITIALSUBSCRIBE, 'groupmode' => VISIBLEGROUPS, ]); // Create three students: // - author, enrolled in group A; and // - recipient, enrolled in group B; and // - other, enrolled in the course, but no groups. list($author, $recipient, $otheruser) = $this->helper_create_users($course, 3); // Create one teacher, not in any group and no accessallgroups capability. list($teacher) = $this->helper_create_users($course, 1, 'teacher'); // Create one editing teacher, not in any group but with accessallgroups capability. list($editingteacher) = $this->helper_create_users($course, 1, 'editingteacher'); $groupa = $this->getDataGenerator()->create_group(['courseid' => $course->id]); $groupb = $this->getDataGenerator()->create_group(['courseid' => $course->id]); $this->getDataGenerator()->create_group_member([ 'groupid' => $groupa->id, 'userid' => $author->id, ]); $this->getDataGenerator()->create_group_member([ 'groupid' => $groupb->id, 'userid' => $recipient->id, ]); // Post a discussion to the forum. list($discussion, $post) = $this->helper_post_to_forum($forum, $author, [ 'groupid' => $groupa->id, ]); // Only the author should receive. $expect = [ 'author' => (object) [ 'userid' => $author->id, 'messages' => 1, ], 'recipient' => (object) [ 'userid' => $recipient->id, 'messages' => 0, ], 'otheruser' => (object) [ 'userid' => $otheruser->id, 'messages' => 0, ], 'teacher' => (object) [ 'userid' => $teacher->id, 'messages' => 0, ], 'editingteacher' => (object) [ 'userid' => $editingteacher->id, 'messages' => 1, ], ]; $this->queue_tasks_and_assert($expect); // No notifications should be queued. $this->send_notifications_and_assert($author, [$post]); $this->send_notifications_and_assert($recipient, []); $this->send_notifications_and_assert($otheruser, []); $this->send_notifications_and_assert($teacher, []); $this->send_notifications_and_assert($editingteacher, [$post]); } }