Content bank class. More...

Public Member Functions
	create_content_from_file (\context $context, int $userid, stored_file $file)
	Create content from a file information.

	delete_contents (context $context)
	Delete content bank content by context.

	get_content_from_id (int $id)
	Return a content class form a content id.

	get_contenttypes_with_capability_feature (string $feature, context $context=null, bool $enabled=true)
	Get the list of content types that have the requested feature.

	get_contexts_with_capabilities_by_user ($capability='moodle/contentbank:access', $userid=null)
	Return all the context where a user has all the given capabilities.

	get_enabled_content_types ()
	Obtains the list of core_contentbank_content objects currently active.

	get_extension (string $filename)
	Returns the file extension for a file.

	get_extension_supporter (string $extension, context $context=null)
	Get the first content bank plugin supports a file extension.

	get_supported_extensions_as_string (context $context=null)
	Obtains a string with all supported extensions by active plugins.

	is_context_allowed (context $context)
	Whether the context is allowed.

	load_all_supported_extensions ()
	Obtains an array of supported extensions by active plugins.

	load_context_supported_extensions (context $context=null)
	Obtains an array of supported extensions in the given context.

	move_contents (context $from, context $to)
	Move content bank content from a context to another.

	search_contents (?string $search=null, ?int $contextid=0, ?array $contenttypenames=null)
	Find the contents with $search% in the contextid defined.

Detailed Description

Content bank class.

Copyright: 2020 Amaia Anabitarte amaia.nosp@m.@moo.nosp@m.dle.c.nosp@m.om

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

Member Function Documentation

◆ create_content_from_file()

core_contentbank\contentbank::create_content_from_file	(	\context	$context,
		int	$userid,
		stored_file	$file )

Create content from a file information.

Exceptions

file_exception	If file operations fail
dml_exception	if the content creation fails

Parameters

context	$context	Context where to upload the file and content.
int	$userid	Id of the user uploading the file.
stored_file	$file	The file to get information from

Return values

content

◆ delete_contents()

core_contentbank\contentbank::delete_contents ( context $context )

Delete content bank content by context.

Parameters

context $context The context to delete content from.

Return values

bool

◆ get_content_from_id()

core_contentbank\contentbank::get_content_from_id ( int $id )

Return a content class form a content id.

Exceptions

coding_exception if the ID is not valid or some class does no exists

Parameters

int $id the content id

Return values

content the content class instance

◆ get_contenttypes_with_capability_feature()

core_contentbank\contentbank::get_contenttypes_with_capability_feature	(	string	$feature,
		context	$context = null,
		bool	$enabled = true )

Get the list of content types that have the requested feature.

Parameters

string	$feature	Feature code e.g CAN_UPLOAD.
null \| context	$context	Optional context to check the permission to use the feature.
bool	$enabled	Whether check only the enabled content types or all of them.

Return values

string[] List of content types where the user has permission to access the feature.

◆ get_contexts_with_capabilities_by_user()

core_contentbank\contentbank::get_contexts_with_capabilities_by_user	(		$capability = 'moodle/contentbank:access',
			$userid = null )

Return all the context where a user has all the given capabilities.

Parameters

string	$capability	The capability the user needs to have.
int \| null	$userid	Optional userid. $USER by default.

Return values

array Array of the courses and course categories where the user has the given capability.

◆ get_enabled_content_types()

core_contentbank\contentbank::get_enabled_content_types ( )

Obtains the list of core_contentbank_content objects currently active.

The list does not include players which are disabled.

Return values

string[] Array of contentbank contenttypes.

◆ get_extension()

core_contentbank\contentbank::get_extension ( string $filename )

Returns the file extension for a file.

Parameters

string $filename The name of the file

Return values

string The extension of the file

◆ get_extension_supporter()

core_contentbank\contentbank::get_extension_supporter	(	string	$extension,
		context	$context = null )

Get the first content bank plugin supports a file extension.

Parameters

string	$extension	Content file extension
context	$context	$context Optional context to check (default null)

Return values

string contenttype name supports the file extension or null if the extension is not supported by any allowed plugin.

◆ get_supported_extensions_as_string()

core_contentbank\contentbank::get_supported_extensions_as_string ( context $context = null )

Obtains a string with all supported extensions by active plugins.

Mainly to use as filepicker options parameter.

Parameters

context $context Optional context to check (default null)

Return values

string A string with all the extensions supported.

◆ is_context_allowed()

core_contentbank\contentbank::is_context_allowed ( context $context )

Whether the context is allowed.

Parameters

context $context Context to check.

Return values

bool

◆ load_all_supported_extensions()

core_contentbank\contentbank::load_all_supported_extensions ( )

Obtains an array of supported extensions by active plugins.

Return values

array The array with all the extensions supported and the supporting plugin names.

◆ load_context_supported_extensions()

core_contentbank\contentbank::load_context_supported_extensions ( context $context = null )

Obtains an array of supported extensions in the given context.

Parameters

context $context Optional context to check (default null)

Return values

array The array with all the extensions supported and the supporting plugin names.

◆ move_contents()

core_contentbank\contentbank::move_contents	(	context	$from,
		context	$to )

Move content bank content from a context to another.

Parameters

context	$from	The context to get content from.
context	$to	The context to move content to.

Return values

bool

◆ search_contents()

core_contentbank\contentbank::search_contents	(	?string	$search = null,
		?int	$contextid = 0,
		?array	$contenttypenames = null )

Find the contents with $search% in the contextid defined.

If contextid and search are empty, all contents are returned. In all the cases, only the contents for the enabled contentbank-type plugins are returned. No content-type permissions are validated here. It is the caller responsability to check that the user can access to them. The only validation done here is, for each content, a call to the method $content->is_view_allowed().

Parameters

string \| null	$search	Optional string to search (for now it will search only into the name).
int	$contextid	Optional contextid to search.
array	$contenttypenames	Optional array with the list of content-type names to search.

Return values

array The contents for the enabled contentbank-type plugins having $search as name and placed in $contextid.

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

contentbank/classes/contentbank.php

Public Member Functions

Detailed Description

Member Function Documentation

◆ create_content_from_file()

◆ delete_contents()

◆ get_content_from_id()

◆ get_contenttypes_with_capability_feature()

◆ get_contexts_with_capabilities_by_user()

◆ get_enabled_content_types()

◆ get_extension()

◆ get_extension_supporter()

◆ get_supported_extensions_as_string()

◆ is_context_allowed()

◆ load_all_supported_extensions()

◆ load_context_supported_extensions()

◆ move_contents()

◆ search_contents()