Contains API class for the H5P area. More...

Static Public Member Functions
static	create_content_from_pluginfile_url (string $url, stdClass $config, factory $factory, stdClass &$messages, bool $preventredirect=true, bool $skipcapcheck=false)
	Create, if it doesn't exist, the H5P DB instance id for a H5P pluginfile URL. More...

static	delete_content (\stdClass $content, factory $factory)
	Delete an H5P package. More...

static	delete_content_from_pluginfile_url (string $url, factory $factory)
	Delete an H5P package deployed from the defined $url. More...

static	delete_library (factory $factory, stdClass $library)
	Delete a library and also all the libraries depending on it and the H5P contents using it. More...

static	get_content_from_pathnamehash (string $pathnamehash)
	Returns the H5P content object corresponding to an H5P content file. More...

static	get_content_from_pluginfile_url (string $url, bool $preventredirect=true, bool $skipcapcheck=false)
	Get the H5P DB instance id for a H5P pluginfile URL. More...

static	get_contenttype_libraries (?string $fields='')
	Get all the H5P content type libraries versions. More...

static	get_dependent_libraries (int $libraryid)
	Get all the libraries using a defined library. More...

static	get_export_info_from_context_id (int $contextid, factory $factory, string $component, string $filearea)
	Return the H5P export information file when the file has been deployed. More...

static	get_library (int $libraryid)
	Get a library from an identifier. More...

static	get_library_details (array $params, bool $configurable, string $fields='')
	Returns a library as an object with properties that correspond to the fetched row's field names. More...

static	is_library_enabled (\stdClass $librarydata)
	Check whether a library is enabled or not. More...

static	is_valid_package (\stored_file $file, bool $onlyupdatelibs, bool $skipcontent=false, ?factory $factory=null, bool $deletefiletree=true)
	Check whether an H5P package is valid or not. More...

static	set_library_enabled (int $libraryid, bool $isenabled)
	Enable or disable a library. More...

Static Protected Member Functions
static	can_access_pluginfile_hash (string $url, bool $preventredirect=true)
	If user can access pathnamehash from an H5P internal URL. More...

static	get_pluginfile_hash (string $url)
	Get the pathnamehash from an H5P internal URL. More...

Detailed Description

Contains API class for the H5P area.

Copyright: 2020 Sara Arjona sara@.nosp@m.mood.nosp@m.le.co.nosp@m.m

License: http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

◆ can_access_pluginfile_hash()

static core_h5p\api::can_access_pluginfile_hash	(	string	$url,
		bool	$preventredirect = `true`
	)

staticprotected

If user can access pathnamehash from an H5P internal URL.

Parameters

string	$url	H5P pluginfile URL poiting to an H5P file.
bool	$preventredirect	Set to true in scripts that can not redirect (CLI, RSS feeds, etc.), throws exceptions

Return values

bool	if user can access pluginfile hash.

Exceptions

moodle_exception
coding_exception
require_login_exception

◆ create_content_from_pluginfile_url()

static core_h5p\api::create_content_from_pluginfile_url	(	string	$url,
		stdClass	$config,
		factory	$factory,
		stdClass &	$messages,
		bool	$preventredirect = `true`,
		bool	$skipcapcheck = `false`
	)

static

Create, if it doesn't exist, the H5P DB instance id for a H5P pluginfile URL.

If it exists:

If the content is not the same, remove the existing content and re-deploy the H5P content again.
If the content is the same, returns the H5P identifier.

Parameters

string	$url	H5P pluginfile URL.
stdClass	$config	Configuration for H5P buttons.
factory	$factory	The core_h5p::factory object
stdClass	$messages	The error, exception and info messages, raised while preparing and running an H5P content.
bool	$preventredirect	Set to true in scripts that can not redirect (CLI, RSS feeds, etc.), throws exceptions
bool	$skipcapcheck	Whether capabilities should be checked or not to get the pluginfile URL because sometimes they might be controlled before calling this method.

Return values

array

of [file, h5pid]:

file local file for this $url.
h5pid is the H5P identifier or false if there isn't any H5P with this URL.

◆ delete_content()

static core_h5p\api::delete_content	(	\stdClass	$content,
		factory	$factory
	)

static

Delete an H5P package.

Parameters

stdClass	$content	The H5P package to delete with, at least content['id].
factory	$factory	The core_h5p::factory object

◆ delete_content_from_pluginfile_url()

static core_h5p\api::delete_content_from_pluginfile_url	(	string	$url,
		factory	$factory
	)

static

Delete an H5P package deployed from the defined $url.

Parameters

string	$url	pluginfile URL of the H5P package to delete.
factory	$factory	The core_h5p::factory object

◆ delete_library()

static core_h5p\api::delete_library	(	factory	$factory,
		stdClass	$library
	)

static

Delete a library and also all the libraries depending on it and the H5P contents using it.

For the H5P content, only the database entries in {h5p} are removed (the .h5p files are not removed in order to let users to deploy them again).

Parameters

factory	$factory	The H5P factory.
stdClass	$library	The library to delete.

◆ get_content_from_pathnamehash()

static core_h5p\api::get_content_from_pathnamehash ( string $pathnamehash )

static

Returns the H5P content object corresponding to an H5P content file.

Parameters

string $pathnamehash The pathnamehash of the file associated to an H5P content.

Return values

null|stdClass H5P content object or null if not found.

◆ get_content_from_pluginfile_url()

static core_h5p\api::get_content_from_pluginfile_url	(	string	$url,
		bool	$preventredirect = `true`,
		bool	$skipcapcheck = `false`
	)

static

Get the H5P DB instance id for a H5P pluginfile URL.

If it doesn't exist, it's not created.

Parameters

string	$url	H5P pluginfile URL.
bool	$preventredirect	Set to true in scripts that can not redirect (CLI, RSS feeds, etc.), throws exceptions
bool	$skipcapcheck	Whether capabilities should be checked or not to get the pluginfile URL because sometimes they might be controlled before calling this method.

Return values

array

of [file, stdClass|false]:

file local file for this $url.
stdClass is an H5P object or false if there isn't any H5P with this URL.

◆ get_contenttype_libraries()

static core_h5p\api::get_contenttype_libraries ( ?string $fields = '' )

static

Get all the H5P content type libraries versions.

Parameters

string | null $fields Library fields to return.

Return values

array An array with an object for each content type library installed.

◆ get_dependent_libraries()

static core_h5p\api::get_dependent_libraries ( int $libraryid )

static

Get all the libraries using a defined library.

Parameters

int $libraryid The library to get its dependencies.

Return values

array List of libraryid with all the libraries required by a defined library.

◆ get_export_info_from_context_id()

static core_h5p\api::get_export_info_from_context_id	(	int	$contextid,
		factory	$factory,
		string	$component,
		string	$filearea
	)

static

Return the H5P export information file when the file has been deployed.

Otherwise, return null if H5P file: i) has not been deployed. ii) has changed the content.

The information returned will be:

filename, filepath, mimetype, filesize, timemodified and fileurl.

Parameters

int	$contextid	ContextId of the H5P activity.
factory	$factory	The core_h5p::factory object.
string	$component	component
string	$filearea	file area

Return values

array|null Return file info otherwise null.

◆ get_library()

static core_h5p\api::get_library ( int $libraryid )

static

Get a library from an identifier.

Parameters

int $libraryid The library identifier.

Return values

stdClass The library object having the library identifier defined.

Exceptions

dml_exception A DML specific exception is thrown if the libraryid doesn't exist.

◆ get_library_details()

static core_h5p\api::get_library_details	(	array	$params,
		bool	$configurable,
		string	$fields = `''`
	)

static

Returns a library as an object with properties that correspond to the fetched row's field names.

Parameters

array	$params	An associative array with the values of the machinename, majorversion and minorversion fields.
bool	$configurable	A library that has semantics so it can be configured in the editor.
string	$fields	Library attributes to retrieve.

Return values

stdClass|null An object with one attribute for each field name in $fields param.

◆ get_pluginfile_hash()

static core_h5p\api::get_pluginfile_hash ( string $url )

staticprotected

Get the pathnamehash from an H5P internal URL.

Parameters

string $url H5P pluginfile URL poiting to an H5P file.

Return values

string|false pathnamehash for the file in the internal URL.

Exceptions

moodle_exception

◆ is_library_enabled()

static core_h5p\api::is_library_enabled ( \stdClass $librarydata )

static

Check whether a library is enabled or not.

When machinename is passed, it will return false if any of the versions for this machinename is disabled. If the library doesn't exist, it will return true.

Parameters

stdClass $librarydata Supported fields for library: 'id' and 'machichename'.

Return values

bool

Exceptions

moodle_exception

◆ is_valid_package()

static core_h5p\api::is_valid_package	(	\stored_file	$file,
		bool	$onlyupdatelibs,
		bool	$skipcontent = `false`,
		?factory	$factory = `null`,
		bool	$deletefiletree = `true`
	)

static

Check whether an H5P package is valid or not.

Parameters

stored_file	$file	The file with the H5P content.
bool	$onlyupdatelibs	Whether new libraries can be installed or only the existing ones can be updated
bool	$skipcontent	Should the content be skipped (so only the libraries will be saved)?
factory \| null	$factory	The core_h5p::factory object
bool	$deletefiletree	Should the temporary files be deleted before returning?

Return values

bool	True if the H5P file is valid (expected format, valid libraries...); false otherwise.

◆ set_library_enabled()

static core_h5p\api::set_library_enabled	(	int	$libraryid,
		bool	$isenabled
	)

static

Enable or disable a library.

Parameters

int	$libraryid	The id of the library to enable/disable.
bool	$isenabled	True if the library should be enabled; false otherwise.

The documentation for this class was generated from the following file:

h5p/classes/api.php

Static Public Member Functions

Static Protected Member Functions

Detailed Description

Member Function Documentation

◆ can_access_pluginfile_hash()

◆ create_content_from_pluginfile_url()

◆ delete_content()

◆ delete_content_from_pluginfile_url()

◆ delete_library()

◆ get_content_from_pathnamehash()

◆ get_content_from_pluginfile_url()

◆ get_contenttype_libraries()

◆ get_dependent_libraries()

◆ get_export_info_from_context_id()

◆ get_library()

◆ get_library_details()

◆ get_pluginfile_hash()

◆ is_library_enabled()

◆ is_valid_package()

◆ set_library_enabled()