Proyectos de Subversion Moodle

<?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/>.

/**
 * Content bank repository search unit tests.
 *
 * @package    repository_contentbank
 * @copyright  2020 Mihail Geshoski <mihail@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace repository_contentbank\search;

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

global $CFG;

require_once("$CFG->dirroot/repository/lib.php");

/**
 * Tests for the content bank search class.
 *
 * @package    repository_contentbank
 * @copyright  2020 Mihail Geshoski <mihail@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class search_test extends \advanced_testcase {

    /**
     * Test get_search_contents() by searching through some existing content using different search terms.
     *
     * @dataProvider get_search_contents_provider
     * @param array $contentnames The array containing the names of the content that needs to be generated
     * @param string $search The search string
     * @param array $expected The array containing the expected content names that should be returned by the search
     */
    public function test_get_search_contents(array $contentnames, string $search, array $expected): void {
        $this->resetAfterTest();

        $admin = get_admin();
        $systemcontext = \context_system::instance();
        // Add some content to the content bank.
        $generator = $this->getDataGenerator()->get_plugin_generator('core_contentbank');
        foreach ($contentnames as $contentname) {
            $generator->generate_contentbank_data('contenttype_h5p', 1, $admin->id,
                $systemcontext, true, 'file.h5p', $contentname);
        }
        // Log in as admin.
        $this->setUser($admin);
        // Search for content bank content items which have the search pattern within the name.
        $searchcontentnodes = \repository_contentbank\contentbank_search::get_search_contents($search);
        // Get the content name of the each content returned after performing the search.
        $actual = array_map(function($searchcontentnode) {
            return $searchcontentnode['shorttitle'];
        }, $searchcontentnodes);

        $this->assertEqualsCanonicalizing($expected, $actual);
    }

    /**
     * Data provider for test_get_search_contents().
     *
     * @return array
     */
    public function get_search_contents_provider(): array {
        return [
            'Search for existing pattern found within the name of content items' => [
                [
                    'systemcontentfile1',
                    'systemcontentfile2',
                    'somesystemfile'
                ],
                'content',
                [
                    'systemcontentfile1',
                    'systemcontentfile2'
                ]
            ],
            'Search for existing pattern found at the beginning of the name of content items' => [
                [
                    'systemcontentfile1',
                    'systemcontentfile2',
                    'somesystemfile'
                ],
                'some',
                [
                    'somesystemfile',
                ]
            ],
            'Search for existing pattern found at the end of the name of content items' => [
                [
                    'systemcontentfile1',
                    'systemcontentfile2',
                    'somesystemfile'
                ],
                'file2',
                [
                    'systemcontentfile2',
                ]
            ],
            'Search for a pattern which does not exist within the name of any content item' => [
                [
                    'systemcontentfile1',
                    'somesystemfile'
                ],
                'somefile',
                []
            ],
            'Case-insensitive search for a pattern which exists within the name of content items' => [
                [
                    'systemcontentfile1',
                    'systemcontentfile2',
                    'somesystemfile'
                ],
                'CONTENT',
                [
                    'systemcontentfile1',
                    'systemcontentfile2'
                ]
            ]
        ];
    }

    /**
     * Test get_search_contents() by searching for content with users that have capability to access/view
     * all existing content bank content. By default, admins, managers should be able to view every existing content
     * that matches the search criteria.
     */
    public function test_get_search_contents_user_can_access_all_content(): void {
        $this->resetAfterTest(true);

        // Create a course in default category by default.
        $course = $this->getDataGenerator()->create_course();
        $coursecontext = \context_course::instance($course->id);
        // Create a course category without a course.
        $category = $this->getDataGenerator()->create_category();
        $categorycontext = \context_coursecat::instance($category->id);

        $admin = get_admin();
        // Add some content to the content bank in different contexts.
        $generator = $this->getDataGenerator()->get_plugin_generator('core_contentbank');
        // Add a content bank file in the category context.
        $categorycontents = $generator->generate_contentbank_data('contenttype_h5p', 1, $admin->id,
            $categorycontext, true, 'file.h5p', 'categorycontentfile');
        $categorycontent = reset($categorycontents);
        // Add a content bank file in the course context.
        $coursecontents = $generator->generate_contentbank_data('contenttype_h5p', 1, $admin->id,
            $coursecontext, true, 'file.h5p', 'coursecontentfile');
        $coursecontent = reset($coursecontents);

        // Log in as admin.
        $this->setUser($admin);

        // Search for content bank content items which have the pattern 'contentfile' within the name.
        $search = 'contentfile';
        $searchcontentnodes = \repository_contentbank\contentbank_search::get_search_contents($search);
        // All content files which name matches the search criteria should be available to the admin user.
        // The search should return 2 file nodes.
        $this->assertCount(2, $searchcontentnodes);
        $expected = [
            \repository_contentbank\helper::create_contentbank_content_node($categorycontent),
            \repository_contentbank\helper::create_contentbank_content_node($coursecontent),
        ];
        $this->assertEqualsCanonicalizing($expected, $searchcontentnodes);
    }

    /**
     * Test get_search_contents() by searching for content with users that have capability to access/view only
     * certain existing content bank content. By default, editing teachers should be able to view content that matches
     * the search criteria AND is in the courses they are enrolled, course categories of the enrolled courses
     * and system content. Other authenticated users should be able to access only the system content.
     */
    public function test_get_search_contents_user_can_access_certain_content(): void {
        global $CFG;

        $this->resetAfterTest(true);

        $systemcontext = \context_system::instance();
        // Create course1.
        $course1 = $this->getDataGenerator()->create_course();
        $course1context = \context_course::instance($course1->id);
        // Create course2.
        $course2 = $this->getDataGenerator()->create_course();
        $course2context = \context_course::instance($course2->id);

        $admin = get_admin();
        // Create and enrol an editing teacher in course1.
        $editingteacher = $this->getDataGenerator()->create_and_enrol($course1, 'editingteacher');
        // Create and enrol a teacher in course2.
        $teacher = $this->getDataGenerator()->create_and_enrol($course2, 'teacher');

        // Add some content to the content bank in different contexts.
        $generator = $this->getDataGenerator()->get_plugin_generator('core_contentbank');
        // Add a content bank file in the system context.
        $filepath = $CFG->dirroot . '/h5p/tests/fixtures/ipsums.h5p';
        $systemcontents = $generator->generate_contentbank_data('contenttype_h5p', 1, $admin->id,
            $systemcontext, true, $filepath, 'systemcontentfile');
        $systemcontent = reset($systemcontents);
        // Add a content bank file in the course1 context.
        $course1contents = $generator->generate_contentbank_data('contenttype_h5p', 1, $admin->id,
            $course1context, true, $filepath, 'coursecontentfile1');
        $course1content = reset($course1contents);
        // Add a content bank file in the course2 context.
        $generator->generate_contentbank_data('contenttype_h5p', 1, $admin->id,
            $course2context, true, $filepath, 'coursecontentfile2');

        // Log in as an editing teacher.
        $this->setUser($editingteacher);
        // Search for content bank content items which have the pattern 'contentfile' within the name.
        $search = 'contentfile';
        $searchcontentnodes = \repository_contentbank\contentbank_search::get_search_contents($search);
        // The search should return 2 file nodes. The editing teacher does not have access to the content of course2
        // and therefore, the course2 content should be skipped.
        $this->assertCount(2, $searchcontentnodes);
        $expected = [
            \repository_contentbank\helper::create_contentbank_content_node($systemcontent),
            \repository_contentbank\helper::create_contentbank_content_node($course1content),
        ];
        $this->assertEqualsCanonicalizing($expected, $searchcontentnodes);

        // Log in as a teacher.
        $this->setUser($teacher);
        // Search for content bank content items which have the pattern 'contentfile' within the name.
        $search = 'contentfile';
        $searchcontentnodes = \repository_contentbank\contentbank_search::get_search_contents($search);
        // The search should return 1 file node. The teacher should only be able to view system content.
        $this->assertCount(1, $searchcontentnodes);
        $expected = [
            \repository_contentbank\helper::create_contentbank_content_node($systemcontent),
        ];
        $this->assertEqualsCanonicalizing($expected, $searchcontentnodes);
    }
}