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

< /** < * Testing the H5P helper. < * < * @package core_h5p < * @category test < * @copyright 2019 Sara Arjona <sara@moodle.com> < * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later < */ <
declare(strict_types = 1); namespace core_h5p;
< use advanced_testcase;
> use core_h5p\local\library\autoloader;
/** * Test class covering the H5P helper. * * @package core_h5p
> * @category test
* @copyright 2019 Sara Arjona <sara@moodle.com> * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
> * @covers \core_h5p\helper
*/ class helper_test extends \advanced_testcase { /**
> * Register the H5P autoloader * Test the behaviour of get_display_options(). > */ * > protected function setUp(): void { * @dataProvider display_options_provider > autoloader::register(); * @param bool $frame Whether the frame should be displayed or not > } * @param bool $export Whether the export action button should be displayed or not > * @param bool $embed Whether the embed action button should be displayed or not > /**
* @param bool $copyright Whether the copyright action button should be displayed or not * @param int $expected The expectation with the displayoptions value */ public function test_display_options(bool $frame, bool $export, bool $embed, bool $copyright, int $expected): void { $this->setRunTestInSeparateProcess(true); $this->resetAfterTest(); $factory = new \core_h5p\factory(); $core = $factory->get_core(); $config = (object)[ 'frame' => $frame, 'export' => $export, 'embed' => $embed, 'copyright' => $copyright, ]; // Test getting display options. $displayoptions = helper::get_display_options($core, $config); $this->assertEquals($expected, $displayoptions); // Test decoding display options. $decoded = helper::decode_display_options($core, $expected); $this->assertEquals($decoded->export, $config->export); $this->assertEquals($decoded->embed, $config->embed); $this->assertEquals($decoded->copyright, $config->copyright); } /** * Data provider for test_get_display_options(). * * @return array */ public function display_options_provider(): array { return [ 'All display options disabled' => [ false, false, false, false, 15, ], 'All display options enabled' => [ true, true, true, true, 0, ], 'Frame disabled and the rest enabled' => [ false, true, true, true, 0, ], 'Only export enabled' => [ false, true, false, false, 12, ], 'Only embed enabled' => [ false, false, true, false, 10, ], 'Only copyright enabled' => [ false, false, false, true, 6, ], ]; } /** * Test the behaviour of save_h5p() when there are some missing libraries in the system. * @runInSeparateProcess */ public function test_save_h5p_missing_libraries(): void { $this->resetAfterTest(); $factory = new \core_h5p\factory(); // Create a user. $user = $this->getDataGenerator()->create_user(); $this->setUser($user); // This is a valid .H5P file.
< $path = __DIR__ . '/fixtures/greeting-card-887.h5p';
> $path = __DIR__ . '/fixtures/greeting-card.h5p';
$file = helper::create_fake_stored_file_from_path($path, (int)$user->id); $factory->get_framework()->set_file($file); $config = (object)[ 'frame' => 1, 'export' => 1, 'embed' => 0, 'copyright' => 0, ]; // There are some missing libraries in the system, so an error should be returned. $h5pid = helper::save_h5p($factory, $file, $config); $this->assertFalse($h5pid); $errors = $factory->get_framework()->getMessages('error'); $this->assertCount(1, $errors); $error = reset($errors);
< $this->assertEquals('missing-required-library', $error->code); < $this->assertEquals('Missing required library H5P.GreetingCard 1.0', $error->message);
> $this->assertEquals('missing-main-library', $error->code); > $this->assertEquals('Missing main library H5P.GreetingCard 1.0', $error->message);
} /** * Test the behaviour of save_h5p() when the libraries exist in the system. * @runInSeparateProcess */ public function test_save_h5p_existing_libraries(): void { global $DB; $this->resetAfterTest(); $factory = new \core_h5p\factory(); // Create a user. $user = $this->getDataGenerator()->create_user(); $this->setUser($user); // This is a valid .H5P file.
< $path = __DIR__ . '/fixtures/greeting-card-887.h5p';
> $path = __DIR__ . '/fixtures/greeting-card.h5p';
$file = helper::create_fake_stored_file_from_path($path, (int)$user->id); $factory->get_framework()->set_file($file); $config = (object)[ 'frame' => 1, 'export' => 1, 'embed' => 0, 'copyright' => 0, ]; // The required libraries exist in the system before saving the .h5p file. $generator = $this->getDataGenerator()->get_plugin_generator('core_h5p'); $lib = $generator->create_library_record('H5P.GreetingCard', 'GreetingCard', 1, 0); $h5pid = helper::save_h5p($factory, $file, $config); $this->assertNotEmpty($h5pid); // No errors are raised. $errors = $factory->get_framework()->getMessages('error'); $this->assertCount(0, $errors); // And the content in the .h5p file has been saved as expected. $h5p = $DB->get_record('h5p', ['id' => $h5pid]); $this->assertEquals($lib->id, $h5p->mainlibraryid); $this->assertEquals(helper::get_display_options($factory->get_core(), $config), $h5p->displayoptions); $this->assertStringContainsString('Hello world!', $h5p->jsoncontent); } /**
> * Test the behaviour of save_h5p() when the H5P file contains metadata. * Test the behaviour of save_h5p() when the .h5p file is invalid. > * * @runInSeparateProcess > * @runInSeparateProcess */ > * @covers ::save_h5p public function test_save_h5p_invalid_file(): void { > */ $this->resetAfterTest(); > public function test_save_h5p_metadata(): void { $factory = new \core_h5p\factory(); > global $DB; > // Create a user. > $this->resetAfterTest(); $user = $this->getDataGenerator()->create_user(); > $factory = new \core_h5p\factory(); $this->setUser($user); > > // Create a user. // Prepare an invalid .H5P file. > $user = $this->getDataGenerator()->create_user(); $path = __DIR__ . '/fixtures/h5ptest.zip'; > $this->setUser($user); $file = helper::create_fake_stored_file_from_path($path, (int)$user->id); > $factory->get_framework()->set_file($file); > // This is a valid .H5P file. $config = (object)[ > $path = __DIR__ . '/fixtures/guess-the-answer.h5p'; 'frame' => 1, > $file = helper::create_fake_stored_file_from_path($path, (int)$user->id); 'export' => 1, > $factory->get_framework()->set_file($file); 'embed' => 0, > 'copyright' => 0, > $config = (object)[ ]; > 'frame' => 1, > 'export' => 1, // When saving an invalid .h5p file, an error should be raised. > 'embed' => 0, $h5pid = helper::save_h5p($factory, $file, $config); > 'copyright' => 1, $this->assertFalse($h5pid); > ]; $errors = $factory->get_framework()->getMessages('error'); > // The required libraries exist in the system before saving the .h5p file. $this->assertCount(2, $errors); > $generator = $this->getDataGenerator()->get_plugin_generator('core_h5p'); > $lib = $generator->create_library_record('H5P.GuessTheAnswer', 'Guess the Answer', 1, 5); $expectederrorcodes = ['invalid-content-folder', 'invalid-h5p-json-file']; > $generator->create_library_record('H5P.Image', 'Image', 1, 1); foreach ($errors as $error) { > $generator->create_library_record('FontAwesome', 'Font Awesome', 4, 5); $this->assertContains($error->code, $expectederrorcodes); > $h5pid = helper::save_h5p($factory, $file, $config); } > $this->assertNotEmpty($h5pid); } > > // No errors are raised. /** > $errors = $factory->get_framework()->getMessages('error'); * Test the behaviour of can_deploy_package(). > $this->assertCount(0, $errors); */ > public function test_can_deploy_package(): void { > // And the content in the .h5p file has been saved as expected. $this->resetAfterTest(); > $h5p = $DB->get_record('h5p', ['id' => $h5pid]); $factory = new \core_h5p\factory(); > $this->assertEquals($lib->id, $h5p->mainlibraryid); > $this->assertEquals(helper::get_display_options($factory->get_core(), $config), $h5p->displayoptions); // Create a user. > $this->assertStringContainsString('Which fruit is this?', $h5p->jsoncontent); $user = $this->getDataGenerator()->create_user(); > // Metadata has been also saved. $admin = get_admin(); > $this->assertStringContainsString('This is licence extras information added for testing purposes.', $h5p->jsoncontent); > $this->assertStringContainsString('H5P Author', $h5p->jsoncontent); // Prepare a valid .H5P file. > $this->assertStringContainsString('Add metadata information', $h5p->jsoncontent); $path = __DIR__ . '/fixtures/greeting-card-887.h5p'; > } > // Files created by users can't be deployed. > /**
< $path = __DIR__ . '/fixtures/greeting-card-887.h5p';
> $path = __DIR__ . '/fixtures/greeting-card.h5p';
$factory->get_framework()->set_file($file); $candeploy = helper::can_deploy_package($file); $this->assertFalse($candeploy); // Files created by admins can be deployed, even when the current user is not the admin. $this->setUser($user); $file = helper::create_fake_stored_file_from_path($path, (int)$admin->id); $factory->get_framework()->set_file($file); $candeploy = helper::can_deploy_package($file); $this->assertTrue($candeploy); } /** * Test the behaviour of can_update_library(). */ public function test_can_update_library(): void { $this->resetAfterTest(); $factory = new \core_h5p\factory(); // Create a user. $user = $this->getDataGenerator()->create_user(); $admin = get_admin(); // Prepare a valid .H5P file.
< $path = __DIR__ . '/fixtures/greeting-card-887.h5p';
> $path = __DIR__ . '/fixtures/greeting-card.h5p';
// Libraries can't be updated when the file has been created by users. $file = helper::create_fake_stored_file_from_path($path, (int)$user->id); $factory->get_framework()->set_file($file); $candeploy = helper::can_update_library($file); $this->assertFalse($candeploy); // Libraries can be updated when the file has been created by admin, even when the current user is not the admin. $this->setUser($user); $file = helper::create_fake_stored_file_from_path($path, (int)$admin->id); $factory->get_framework()->set_file($file); $candeploy = helper::can_update_library($file); $this->assertTrue($candeploy); } /** * Test the behaviour of get_messages(). */ public function test_get_messages(): void { $this->resetAfterTest(); $factory = new \core_h5p\factory(); $messages = new \stdClass(); helper::get_messages($messages, $factory); $this->assertTrue(empty($messages->error)); $this->assertTrue(empty($messages->info)); // Add an some messages manually and check they are still there.
> $messages->error = [];
$messages->error['error1'] = 'Testing ERROR message';
> $messages->info = [];
$messages->info['info1'] = 'Testing INFO message'; $messages->info['info2'] = 'Testing INFO message'; helper::get_messages($messages, $factory); $this->assertCount(1, $messages->error); $this->assertCount(2, $messages->info); // When saving an invalid .h5p file, 6 errors should be raised. $path = __DIR__ . '/fixtures/h5ptest.zip'; $file = helper::create_fake_stored_file_from_path($path); $factory->get_framework()->set_file($file); $config = (object)[ 'frame' => 1, 'export' => 1, 'embed' => 0, 'copyright' => 0, ]; $h5pid = helper::save_h5p($factory, $file, $config); $this->assertFalse($h5pid); helper::get_messages($messages, $factory); $this->assertCount(7, $messages->error); $this->assertCount(2, $messages->info); } /** * Test the behaviour of get_export_info(). */ public function test_get_export_info(): void { $this->resetAfterTest(); $filename = 'guess-the-answer.h5p'; $syscontext = \context_system::instance(); $generator = $this->getDataGenerator()->get_plugin_generator('core_h5p'); $deployedfile = $generator->create_export_file($filename, $syscontext->id, file_storage::COMPONENT, file_storage::EXPORT_FILEAREA); // Test scenario 1: Get export information from correct filename. $helperfile = helper::get_export_info($deployedfile['filename']); $this->assertEquals($deployedfile['filename'], $helperfile['filename']); $this->assertEquals($deployedfile['filepath'], $helperfile['filepath']); $this->assertEquals($deployedfile['filesize'], $helperfile['filesize']); $this->assertEquals($deployedfile['timemodified'], $helperfile['timemodified']); $this->assertEquals($deployedfile['fileurl'], $helperfile['fileurl']); // Test scenario 2: Get export information from correct filename and url. $url = \moodle_url::make_pluginfile_url( $syscontext->id, file_storage::COMPONENT, 'unittest', 0, '/', $deployedfile['filename'], false, true ); $helperfile = helper::get_export_info($deployedfile['filename'], $url); $this->assertEquals($url, $helperfile['fileurl']); // Test scenario 3: Get export information from correct filename and factory. $factory = new \core_h5p\factory(); $helperfile = helper::get_export_info($deployedfile['filename'], null, $factory); $this->assertEquals($deployedfile['filename'], $helperfile['filename']); $this->assertEquals($deployedfile['filepath'], $helperfile['filepath']); $this->assertEquals($deployedfile['filesize'], $helperfile['filesize']); $this->assertEquals($deployedfile['timemodified'], $helperfile['timemodified']); $this->assertEquals($deployedfile['fileurl'], $helperfile['fileurl']); // Test scenario 4: Get export information from wrong filename. $helperfile = helper::get_export_info('nofileexist.h5p', $url); $this->assertNull($helperfile); } /** * Test the parse_js_array function with a range of content. * * @dataProvider parse_js_array_provider * @param string $content * @param array $expected */ public function test_parse_js_array(string $content, array $expected): void { $this->assertEquals($expected, helper::parse_js_array($content)); } /** * Data provider for test_parse_js_array(). * * @return array */ public function parse_js_array_provider(): array { $lines = [ "{", " missingTranslation: '[Missing translation :key]',", " loading: 'Loading, please wait...',", " selectLibrary: 'Select the library you wish to use for your content.',", "}", ]; $expected = [ 'missingTranslation' => '[Missing translation :key]', 'loading' => 'Loading, please wait...', 'selectLibrary' => 'Select the library you wish to use for your content.', ]; return [ 'Strings with \n' => [ implode("\n", $lines), $expected, ], 'Strings with \r\n' => [ implode("\r\n", $lines), $expected, ], 'Strings with \r' => [ implode("\r", $lines), $expected, ], ]; } }