You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

402 lines
16 KiB

<?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/>.
/**
* Unit tests for the block_community implementation of the privacy API.
*
* @package block_community
* @category test
* @copyright 2018 Zig Tan <zig@moodle.com>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
defined('MOODLE_INTERNAL') || die();
use \core_privacy\local\metadata\collection;
use \core_privacy\local\request\writer;
use \core_privacy\local\request\approved_contextlist;
use \block_community\privacy\provider;
use \core_privacy\local\request\approved_userlist;
/**
* Unit tests for the block_community implementation of the privacy API.
*
* @copyright 2018 Zig Tan <zig@moodle.com>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class block_community_privacy_testcase extends \core_privacy\tests\provider_testcase {
/**
* Overriding setUp() function to always reset after tests.
*/
public function setUp() {
$this->resetAfterTest(true);
}
/**
* Test for provider::get_metadata().
*/
public function test_get_metadata() {
$collection = new collection('block_community');
$newcollection = provider::get_metadata($collection);
$itemcollection = $newcollection->get_collection();
$this->assertCount(1, $itemcollection);
$table = reset($itemcollection);
$this->assertEquals('block_community', $table->get_name());
$privacyfields = $table->get_privacy_fields();
$this->assertArrayHasKey('userid', $privacyfields);
$this->assertArrayHasKey('coursename', $privacyfields);
$this->assertArrayHasKey('coursedescription', $privacyfields);
$this->assertArrayHasKey('courseurl', $privacyfields);
$this->assertArrayHasKey('imageurl', $privacyfields);
$this->assertEquals('privacy:metadata:block_community', $table->get_summary());
}
/**
* Test for provider::get_contexts_for_userid().
*/
public function test_get_contexts_for_userid() {
global $DB;
// Test setup.
$teacher = $this->getDataGenerator()->create_user();
$this->setUser($teacher);
// Add two community links for the User.
$community = (object)[
'userid' => $teacher->id,
'coursename' => 'Dummy Community Course Name - 1',
'coursedescription' => 'Dummy Community Course Description - 1',
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course-1',
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
$community = (object)[
'userid' => $teacher->id,
'coursename' => 'Dummy Community Course Name - 2',
'coursedescription' => 'Dummy Community Course Description - 2',
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course-2',
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
// Test the User's retrieved contextlist contains only one context.
$contextlist = provider::get_contexts_for_userid($teacher->id);
$contexts = $contextlist->get_contexts();
$this->assertCount(1, $contexts);
// Test the User's contexts equal the User's own context.
$context = reset($contexts);
$this->assertEquals(CONTEXT_USER, $context->contextlevel);
$this->assertEquals($teacher->id, $context->instanceid);
}
/**
* Test for provider::export_user_data().
*/
public function test_export_user_data() {
global $DB;
// Test setup.
$teacher = $this->getDataGenerator()->create_user();
$this->setUser($teacher);
// Add 3 community links for the User.
$nocommunities = 3;
for ($c = 0; $c < $nocommunities; $c++) {
$community = (object)[
'userid' => $teacher->id,
'coursename' => 'Dummy Community Course Name - ' . $c,
'coursedescription' => 'Dummy Community Course Description - ' . $c,
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course-' . $c,
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
}
// Test the created block_community records matches the test number of communities specified.
$communities = $DB->get_records('block_community', ['userid' => $teacher->id]);
$this->assertCount($nocommunities, $communities);
// Test the User's retrieved contextlist contains only one context.
$contextlist = provider::get_contexts_for_userid($teacher->id);
$contexts = $contextlist->get_contexts();
$this->assertCount(1, $contexts);
// Test the User's contexts equal the User's own context.
$context = reset($contexts);
$this->assertEquals(CONTEXT_USER, $context->contextlevel);
$this->assertEquals($teacher->id, $context->instanceid);
$approvedcontextlist = new approved_contextlist($teacher, 'block_community', $contextlist->get_contextids());
// Retrieve Calendar Event and Subscriptions data only for this user.
provider::export_user_data($approvedcontextlist);
// Test the block_community data is exported at the User context level.
$user = $approvedcontextlist->get_user();
$contextuser = context_user::instance($user->id);
$writer = writer::with_context($contextuser);
$this->assertTrue($writer->has_any_data());
}
/**
* Test for provider::delete_data_for_all_users_in_context().
*/
public function test_delete_data_for_all_users_in_context() {
global $DB;
// Test setup.
$teacher = $this->getDataGenerator()->create_user();
$this->setUser($teacher);
// Add a community link for the User.
$community = (object)[
'userid' => $teacher->id,
'coursename' => 'Dummy Community Course Name',
'coursedescription' => 'Dummy Community Course Description',
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course',
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
// Test the User's retrieved contextlist contains only one context.
$contextlist = provider::get_contexts_for_userid($teacher->id);
$contexts = $contextlist->get_contexts();
$this->assertCount(1, $contexts);
// Test the User's contexts equal the User's own context.
$context = reset($contexts);
$this->assertEquals(CONTEXT_USER, $context->contextlevel);
$this->assertEquals($teacher->id, $context->instanceid);
// Test delete all users content by context.
provider::delete_data_for_all_users_in_context($context);
$blockcommunity = $DB->get_records('block_community', ['userid' => $teacher->id]);
$this->assertCount(0, $blockcommunity);
}
/**
* Test for provider::delete_data_for_user().
*/
public function test_delete_data_for_user() {
global $DB;
// Test setup.
$teacher1 = $this->getDataGenerator()->create_user();
$teacher2 = $this->getDataGenerator()->create_user();
$this->setUser($teacher1);
// Add 3 community links for Teacher 1.
$nocommunities = 3;
for ($c = 0; $c < $nocommunities; $c++) {
$community = (object)[
'userid' => $teacher1->id,
'coursename' => 'Dummy Community Course Name - ' . $c,
'coursedescription' => 'Dummy Community Course Description - ' . $c,
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course-' . $c,
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
}
// Add 1 community link for Teacher 2.
$community = (object)[
'userid' => $teacher2->id,
'coursename' => 'Dummy Community Course Name - Blah',
'coursedescription' => 'Dummy Community Course Description - Blah',
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course-Blah',
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
// Test the created block_community records for Teacher 1 equals test number of communities specified.
$communities = $DB->get_records('block_community', ['userid' => $teacher1->id]);
$this->assertCount($nocommunities, $communities);
// Test the created block_community records for Teacher 2 equals 1.
$communities = $DB->get_records('block_community', ['userid' => $teacher2->id]);
$this->assertCount(1, $communities);
// Test the deletion of block_community records for Teacher 1 results in zero records.
$contextlist = provider::get_contexts_for_userid($teacher1->id);
$contexts = $contextlist->get_contexts();
$this->assertCount(1, $contexts);
// Test the User's contexts equal the User's own context.
$context = reset($contexts);
$this->assertEquals(CONTEXT_USER, $context->contextlevel);
$this->assertEquals($teacher1->id, $context->instanceid);
$approvedcontextlist = new approved_contextlist($teacher1, 'block_community', $contextlist->get_contextids());
provider::delete_data_for_user($approvedcontextlist);
$communities = $DB->get_records('block_community', ['userid' => $teacher1->id]);
$this->assertCount(0, $communities);
// Test that Teacher 2's single block_community record still exists.
$contextlist = provider::get_contexts_for_userid($teacher2->id);
$contexts = $contextlist->get_contexts();
$this->assertCount(1, $contexts);
// Test the User's contexts equal the User's own context.
$context = reset($contexts);
$this->assertEquals(CONTEXT_USER, $context->contextlevel);
$this->assertEquals($teacher2->id, $context->instanceid);
$communities = $DB->get_records('block_community', ['userid' => $teacher2->id]);
$this->assertCount(1, $communities);
}
/**
* Test that only users within a course context are fetched.
*/
public function test_get_users_in_context() {
global $DB;
$component = 'block_community';
// Create a user.
$teacher = $this->getDataGenerator()->create_user();
$teacherctx = \context_user::instance($teacher->id);
$userlist = new \core_privacy\local\request\userlist($teacherctx, $component);
provider::get_users_in_context($userlist);
$this->assertCount(0, $userlist);
$this->setUser($teacher);
// Add two community links for the user.
$community = (object)[
'userid' => $teacher->id,
'coursename' => 'Dummy Community Course Name - 1',
'coursedescription' => 'Dummy Community Course Description - 1',
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course-1',
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
$community = (object)[
'userid' => $teacher->id,
'coursename' => 'Dummy Community Course Name - 2',
'coursedescription' => 'Dummy Community Course Description - 2',
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course-2',
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
// The list of users within the user context should contain user.
provider::get_users_in_context($userlist);
$this->assertCount(1, $userlist);
$expected = [$teacher->id];
$actual = $userlist->get_userids();
$this->assertEquals($expected, $actual);
// The list of users within the system context should be empty.
$systemctx = \context_system::instance();
$userlist2 = new \core_privacy\local\request\userlist($systemctx, $component);
provider::get_users_in_context($userlist2);
$this->assertCount(0, $userlist2);
}
/**
* Test that data for users in approved userlist is deleted.
*/
public function test_delete_data_for_users() {
global $DB;
$component = 'block_community';
// Create user1.
$user1 = $this->getDataGenerator()->create_user();
$userctx1 = \context_user::instance($user1->id);
// Create user2.
$user2 = $this->getDataGenerator()->create_user();
$userctx2 = \context_user::instance($user2->id);
$this->setUser($user1);
// Add a community link for user1.
$community = (object)[
'userid' => $user1->id,
'coursename' => 'Dummy Community Course Name - 1',
'coursedescription' => 'Dummy Community Course Description - 1',
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course-1',
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
// Add a community link for user1.
$community = (object)[
'userid' => $user1->id,
'coursename' => 'Dummy Community Course Name - 2',
'coursedescription' => 'Dummy Community Course Description - 2',
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course-2',
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
$this->setUser($user2);
// Add a community link for user2.
$community = (object)[
'userid' => $user2->id,
'coursename' => 'Dummy Community Course Name - 3',
'coursedescription' => 'Dummy Community Course Description - 3',
'courseurl' => 'https://moodle.org/community_courses/Dummy_Community_Course-3',
'imageurl' => ''
];
$DB->insert_record('block_community', $community);
$userlist1 = new \core_privacy\local\request\userlist($userctx1, $component);
provider::get_users_in_context($userlist1);
$this->assertCount(1, $userlist1);
$userlist2 = new \core_privacy\local\request\userlist($userctx2, $component);
provider::get_users_in_context($userlist2);
$this->assertCount(1, $userlist2);
// Convert $userlist1 into an approved_contextlist.
$approvedlist1 = new approved_userlist($userctx1, $component, $userlist1->get_userids());
// Delete using delete_data_for_user.
provider::delete_data_for_users($approvedlist1);
// Re-fetch users in userctx1.
$userlist1 = new \core_privacy\local\request\userlist($userctx1, $component);
provider::get_users_in_context($userlist1);
// The user data in userctx1 should be deleted.
$this->assertCount(0, $userlist1);
// Re-fetch users in userctx2.
$userlist2 = new \core_privacy\local\request\userlist($userctx2, $component);
provider::get_users_in_context($userlist2);
// The user data in userctx2 should be still present.
$this->assertCount(1, $userlist2);
// Convert $userlist2 into an approved_contextlist in the system context.
$systemcontext = \context_system::instance();
$approvedlist2 = new approved_userlist($systemcontext, $component, $userlist2->get_userids());
// Delete using delete_data_for_user.
provider::delete_data_for_users($approvedlist2);
// Re-fetch users in userctx2.
$userlist2 = new \core_privacy\local\request\userlist($userctx2, $component);
provider::get_users_in_context($userlist2);
// The user data in systemcontext should not be deleted.
$this->assertCount(1, $userlist2);
}
}