Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.11.x will end 14 Nov 2022 (12 months plus 6 months extension).
  • Bug fixes for security issues in 3.11.x will end 13 Nov 2023 (18 months plus 12 months extension).
  • PHP version: minimum PHP 7.3.0 Note: minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is 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/>.

/**
 * Generator for the core_h5p subsystem.
 *
 * @package    core_h5p
 * @category   test
 * @copyright  2019 Victor Deniz <victor@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

use core_h5p\local\library\autoloader;
use core_h5p\core;
use core_h5p\player;
use core_h5p\factory;

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

/**
 * Generator for the core_h5p subsystem.
 *
 * @package    core_h5p
 * @category   test
 * @copyright  2019 Victor Deniz <victor@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class core_h5p_generator extends \component_generator_base {

    /** Url pointing to webservice plugin file. */
    public const WSPLUGINFILE = 0;
    /** Url pointing to token plugin file. */
    public const TOKENPLUGINFILE = 1;
    /** Url pointing to plugin file. */
    public const PLUGINFILE = 2;

    /**
     * Convenience function to create a file.
     *
     * @param  string $file path to a file.
     * @param  string $content file content.
     */
    public function create_file(string $file, string $content=''): void {
        $handle = fopen($file, 'w+');
        // File content is not relevant.
        if (empty($content)) {
            $content = hash("md5", $file);
        }
        fwrite($handle, $content);
        fclose($handle);
    }

    /**
     * Creates the file record. Currently used for the cache tests.
     *
     * @param string $type    Either 'scripts' or 'styles'.
     * @param string $path    Path to the file in the file system.
     * @param string $version Not really needed at the moment.
     */
    protected function add_libfile_to_array(string $type, string $path, string $version, &$files): void {
        $files[$type][] = (object)[
            'path' => $path,
            'version' => "?ver=$version"
        ];
    }

    /**
     * Create the necessary files and return an array structure for a library.
     *
     * @param  string $uploaddirectory Base directory for the library.
     * @param  int    $libraryid       Library id.
     * @param  string $machinename     Name for this library.
     * @param  int    $majorversion    Major version (any number will do).
     * @param  int    $minorversion    Minor version (any number will do).
     * @param  array  $langs           Languages to be included into the library.
     * @return array A list of library data and files that the core API will understand.
     */
    public function create_library(string $uploaddirectory, int $libraryid, string $machinename, int $majorversion,
            int $minorversion, ?array $langs = []): array {
        // Array $files used in the cache tests.
        $files = ['scripts' => [], 'styles' => [], 'language' => []];

        check_dir_exists($uploaddirectory . '/' . 'scripts');
        check_dir_exists($uploaddirectory . '/' . 'styles');
        if (!empty($langs)) {
            check_dir_exists($uploaddirectory . '/' . 'language');
        }

        $jsonfile = $uploaddirectory . '/' . 'library.json';
        $jsfile = $uploaddirectory . '/' . 'scripts/testlib.min.js';
        $cssfile = $uploaddirectory . '/' . 'styles/testlib.min.css';
        $this->create_file($jsonfile);
        $this->create_file($jsfile);
        $this->create_file($cssfile);
        foreach ($langs as $lang => $value) {
            $jsonfile = $uploaddirectory . '/' . 'language/' . $lang . '.json';
            $this->create_file($jsonfile, $value);
        }

        $lib = [
            'title' => 'Test lib',
            'description' => 'Test library description',
            'majorVersion' => $majorversion,
            'minorVersion' => $minorversion,
            'patchVersion' => 2,
            'machineName' => $machinename,
            'preloadedJs' => [
                [
                    'path' => 'scripts' . '/' . 'testlib.min.js'
                ]
            ],
            'preloadedCss' => [
                [
                    'path' => 'styles' . '/' . 'testlib.min.css'
                ]
            ],
            'uploadDirectory' => $uploaddirectory,
            'libraryId' => $libraryid
        ];

        $version = "{$majorversion}.{$minorversion}.2";
        $libname = "{$machinename}-{$majorversion}.{$minorversion}";
        $path = '/' . 'libraries' . '/' . $libraryid . '/' . $libname . '/' . 'scripts' . '/' . 'testlib.min.js';
        $this->add_libfile_to_array('scripts', $path, $version, $files);
        $path = '/' . 'libraries' . '/' . $libraryid .'/' . $libname . '/' . 'styles' . '/' . 'testlib.min.css';
        $this->add_libfile_to_array('styles', $path, $version, $files);
        foreach ($langs as $lang => $notused) {
            $path = '/' . 'libraries' . '/' . $libraryid . '/' . $libname . '/' . 'language' . '/' . $lang . '.json';
            $this->add_libfile_to_array('language', $path, $version, $files);
        }

        return [$lib, $files];
    }

    /**
     * Save the library files on the filesystem.
     *
     * @param stdClss $lib The library data
     */
    private function save_library(stdClass $lib) {
        // Get a temp path.
        $filestorage = new \core_h5p\file_storage();
        $temppath = $filestorage->getTmpPath();

        // Create and save the library files on the filesystem.
        $basedirectorymain = $temppath . '/' . $lib->machinename . '-' .
            $lib->majorversion . '.' . $lib->minorversion;

        list($library, $libraryfiles) = $this->create_library($basedirectorymain, $lib->id, $lib->machinename,
            $lib->majorversion, $lib->minorversion);

        $filestorage->saveLibrary($library);
    }

    /**
     * Populate H5P database tables with relevant data to simulate the process of adding H5P content.
     *
     * @param bool $createlibraryfiles Whether to create and store library files on the filesystem
     * @return stdClass An object representing the added H5P records
     */
    public function generate_h5p_data(bool $createlibraryfiles = false): stdClass {
        // Create libraries.
        $mainlib = $libraries[] = $this->create_library_record('MainLibrary', 'Main Lib', 1, 0, 1, '', null,
            'http://tutorial.org', 'http://example.org');
        $lib1 = $libraries[] = $this->create_library_record('Library1', 'Lib1', 2, 0, 1, '', null, null,  'http://example.org');
        $lib2 = $libraries[] = $this->create_library_record('Library2', 'Lib2', 2, 1, 1, '', null, 'http://tutorial.org');
< $lib3 = $libraries[] = $this->create_library_record('Library3', 'Lib3', 3, 2);
> $lib3 = $libraries[] = $this->create_library_record('Library3', 'Lib3', 3, 2, 1, '', null, null, null, true, 0);
$lib4 = $libraries[] = $this->create_library_record('Library4', 'Lib4', 1, 1); $lib5 = $libraries[] = $this->create_library_record('Library5', 'Lib5', 1, 3); if ($createlibraryfiles) { foreach ($libraries as $lib) { // Create and save the library files on the filesystem. $this->save_library($lib); } } // Create h5p content. $h5p = $this->create_h5p_record($mainlib->id); // Create h5p content library dependencies. $this->create_contents_libraries_record($h5p, $mainlib->id); $this->create_contents_libraries_record($h5p, $lib1->id); $this->create_contents_libraries_record($h5p, $lib2->id); $this->create_contents_libraries_record($h5p, $lib3->id); $this->create_contents_libraries_record($h5p, $lib4->id); // Create library dependencies for $mainlib. $this->create_library_dependency_record($mainlib->id, $lib1->id); $this->create_library_dependency_record($mainlib->id, $lib2->id); $this->create_library_dependency_record($mainlib->id, $lib3->id); // Create library dependencies for $lib1. $this->create_library_dependency_record($lib1->id, $lib2->id); $this->create_library_dependency_record($lib1->id, $lib3->id); $this->create_library_dependency_record($lib1->id, $lib4->id); // Create library dependencies for $lib3. $this->create_library_dependency_record($lib3->id, $lib5->id); return (object) [ 'h5pcontent' => (object) array( 'h5pid' => $h5p, 'contentdependencies' => array($mainlib, $lib1, $lib2, $lib3, $lib4) ), 'mainlib' => (object) array( 'data' => $mainlib, 'dependencies' => array($lib1, $lib2, $lib3) ), 'lib1' => (object) array( 'data' => $lib1, 'dependencies' => array($lib2, $lib3, $lib4) ), 'lib2' => (object) array( 'data' => $lib2, 'dependencies' => array() ), 'lib3' => (object) array( 'data' => $lib3, 'dependencies' => array($lib5) ), 'lib4' => (object) array( 'data' => $lib4, 'dependencies' => array() ), 'lib5' => (object) array( 'data' => $lib5, 'dependencies' => array() ), ]; } /** * Create a record in the h5p_libraries database table. * * @param string $machinename The library machine name * @param string $title The library's name * @param int $majorversion The library's major version * @param int $minorversion The library's minor version * @param int $patchversion The library's patch version * @param string $semantics Json describing the content structure for the library * @param string $addto The plugin configuration data * @param string $tutorial The tutorial URL * @param string $examlpe The example URL
> * @param bool $enabled Whether the library is enabled or not * @return stdClass An object representing the added library record > * @param int $runnable Whether the library is runnable (1) or not (0)
*/ public function create_library_record(string $machinename, string $title, int $majorversion = 1, int $minorversion = 0, int $patchversion = 1, string $semantics = '', string $addto = null,
< string $tutorial = null, string $example = null): stdClass {
> string $tutorial = null, string $example = null, bool $enabled = true, int $runnable = 1): stdClass {
global $DB;
< $content = array(
> $content = [
'machinename' => $machinename, 'title' => $title, 'majorversion' => $majorversion, 'minorversion' => $minorversion, 'patchversion' => $patchversion,
< 'runnable' => 1,
> 'runnable' => $runnable,
'fullscreen' => 1, 'preloadedjs' => 'js/example.js', 'preloadedcss' => 'css/example.css', 'droplibrarycss' => '', 'semantics' => $semantics, 'addto' => $addto, 'tutorial' => $tutorial,
< 'example' => $example < );
> 'example' => $example, > 'enabled' => $enabled, > ];
$libraryid = $DB->insert_record('h5p_libraries', $content); return $DB->get_record('h5p_libraries', ['id' => $libraryid]); } /** * Create a record in the h5p database table. * * @param int $mainlibid The ID of the content's main library * @param string $jsoncontent The content in json format * @param string $filtered The filtered content parameters * @return int The ID of the added record */ public function create_h5p_record(int $mainlibid, string $jsoncontent = null, string $filtered = null): int { global $DB; if (!$jsoncontent) { $jsoncontent = json_encode( array( 'text' => '<p>Dummy text<\/p>\n', 'questions' => '<p>Test question<\/p>\n' ) ); } if (!$filtered) { $filtered = json_encode( array( 'text' => 'Dummy text', 'questions' => 'Test question' ) ); } return $DB->insert_record( 'h5p', array( 'jsoncontent' => $jsoncontent, 'displayoptions' => 8, 'mainlibraryid' => $mainlibid, 'timecreated' => time(), 'timemodified' => time(), 'filtered' => $filtered, 'pathnamehash' => sha1('pathname'), 'contenthash' => sha1('content') ) ); } /** * Create a record in the h5p_contents_libraries database table. * * @param string $h5pid The ID of the H5P content * @param int $libid The ID of the library * @param string $dependencytype The dependency type * @return int The ID of the added record */ public function create_contents_libraries_record(string $h5pid, int $libid, string $dependencytype = 'preloaded'): int { global $DB; return $DB->insert_record( 'h5p_contents_libraries', array( 'h5pid' => $h5pid, 'libraryid' => $libid, 'dependencytype' => $dependencytype, 'dropcss' => 0, 'weight' => 1 ) ); } /** * Create a record in the h5p_library_dependencies database table. * * @param int $libid The ID of the library * @param int $requiredlibid The ID of the required library * @param string $dependencytype The dependency type * @return int The ID of the added record */ public function create_library_dependency_record(int $libid, int $requiredlibid, string $dependencytype = 'preloaded'): int { global $DB; return $DB->insert_record( 'h5p_library_dependencies', array( 'libraryid' => $libid, 'requiredlibraryid' => $requiredlibid, 'dependencytype' => $dependencytype ) ); } /** * Create H5P content type records in the h5p_libraries database table. * * @param array $typestonotinstall H5P content types that should not be installed * @param core $core h5p_test_core instance required to use the exttests URL * @return array Data of the content types not installed. */ public function create_content_types(array $typestonotinstall, core $core): array { global $DB; autoloader::register(); // Get info of latest content types versions. $contenttypes = $core->get_latest_content_types()->contentTypes; $installedtypes = 0; // Fake installation of all other H5P content types. foreach ($contenttypes as $contenttype) { // Don't install pending content types. if (in_array($contenttype->id, $typestonotinstall)) { continue; } $library = [ 'machinename' => $contenttype->id, 'majorversion' => $contenttype->version->major, 'minorversion' => $contenttype->version->minor, 'patchversion' => $contenttype->version->patch, 'runnable' => 1, 'coremajor' => $contenttype->coreApiVersionNeeded->major, 'coreminor' => $contenttype->coreApiVersionNeeded->minor ]; $DB->insert_record('h5p_libraries', (object) $library); $installedtypes++; } return [$installedtypes, count($typestonotinstall)]; } /** * Add a record on files table for a file that belongs to * * @param string $file File name and path inside the filearea. * @param string $filearea The filearea in which the file is ("editor" or "content"). * @param int $contentid Id of the H5P content to which the file belongs. null if the file is in the editor. * * @return stored_file; * @throws coding_exception */ public function create_content_file(string $file, string $filearea, int $contentid = 0): stored_file { global $USER; $filepath = '/'.dirname($file).'/'; $filename = basename($file); if (($filearea === 'content') && ($contentid == 0)) { throw new coding_exception('Files belonging to an H5P content must specify the H5P content id'); } if ($filearea === 'draft') { $usercontext = \context_user::instance($USER->id); $context = $usercontext->id; $component = 'user'; $itemid = 0; } else { $systemcontext = context_system::instance(); $context = $systemcontext->id; $component = \core_h5p\file_storage::COMPONENT; $itemid = $contentid; } $content = 'fake content'; $filerecord = array( 'contextid' => $context, 'component' => $component, 'filearea' => $filearea, 'itemid' => $itemid, 'filepath' => $filepath, 'filename' => $filename, ); $fs = new file_storage(); return $fs->create_file_from_string($filerecord, $content); } /** * Create a fake export H5P deployed file. * * @param string $filename Name of the H5P file to deploy. * @param int $contextid Context id of the H5P activity. * @param string $component component. * @param string $filearea file area. * @param int $typeurl Type of url to create the export url plugin file. * @return array return deployed file information. */ public function create_export_file(string $filename, int $contextid, string $component, string $filearea, int $typeurl = self::WSPLUGINFILE): array { global $CFG; // We need the autoloader for H5P player. autoloader::register(); $path = $CFG->dirroot.'/h5p/tests/fixtures/'.$filename; $filerecord = [ 'contextid' => $contextid, 'component' => $component, 'filearea' => $filearea, 'itemid' => 0, 'filepath' => '/', 'filename' => $filename, ]; // Load the h5p file into DB. $fs = get_file_storage(); if (!$fs->get_file($contextid, $component, $filearea, $filerecord['itemid'], $filerecord['filepath'], $filename)) { $fs->create_file_from_pathname($filerecord, $path); } // Make the URL to pass to the player. if ($typeurl == self::WSPLUGINFILE) { $url = \moodle_url::make_webservice_pluginfile_url( $filerecord['contextid'], $filerecord['component'], $filerecord['filearea'], $filerecord['itemid'], $filerecord['filepath'], $filerecord['filename'] ); } else { $includetoken = false; if ($typeurl == self::TOKENPLUGINFILE) { $includetoken = true; } $url = \moodle_url::make_pluginfile_url( $filerecord['contextid'], $filerecord['component'], $filerecord['filearea'], $filerecord['itemid'], $filerecord['filepath'], $filerecord['filename'], false, $includetoken ); } $config = new stdClass(); $h5pplayer = new player($url->out(false), $config); // We need to add assets to page to create the export file. $h5pplayer->add_assets_to_page(); // Call the method. We need the id of the new H5P content. $rc = new \ReflectionClass(player::class); $rcp = $rc->getProperty('h5pid'); $rcp->setAccessible(true); $h5pid = $rcp->getValue($h5pplayer); // Get the info export file. $factory = new factory(); $core = $factory->get_core(); $content = $core->loadContent($h5pid); $slug = $content['slug'] ? $content['slug'] . '-' : ''; $exportfilename = "{$slug}{$h5pid}.h5p"; $fileh5p = $core->fs->get_export_file($exportfilename); $deployedfile = []; $deployedfile['filename'] = $fileh5p->get_filename(); $deployedfile['filepath'] = $fileh5p->get_filepath(); $deployedfile['mimetype'] = $fileh5p->get_mimetype(); $deployedfile['filesize'] = $fileh5p->get_filesize(); $deployedfile['timemodified'] = $fileh5p->get_timemodified(); // Create the url depending the request was made through typeurl. if ($typeurl == self::WSPLUGINFILE) { $url = \moodle_url::make_webservice_pluginfile_url( $fileh5p->get_contextid(), $fileh5p->get_component(), $fileh5p->get_filearea(), '', '', $fileh5p->get_filename() ); } else { $includetoken = false; if ($typeurl == self::TOKENPLUGINFILE) { $includetoken = true; } $url = \moodle_url::make_pluginfile_url( $fileh5p->get_contextid(), $fileh5p->get_component(), $fileh5p->get_filearea(), '', '', $fileh5p->get_filename(), false, $includetoken ); } $deployedfile['fileurl'] = $url->out(false); return $deployedfile; } }