. /** * Unit tests for the block_community implementation of the privacy API. * * @package block_community * @category test * @copyright 2018 Zig Tan * @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 * @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); } }