Represents a course context in the tree navigated by file_browser. More...

Inheritance diagram for file_info_context_course:

Public Member Functions
	__construct ($browser, $context, $course)
	Constructor. More...

	copy_to_pathname ($pathname)
	Copy content of this file to local storage, overriding current file if needed. More...

	copy_to_storage ($filerecord)
	Copy content of this file to local storage, overriding current file if needed. More...

	count_non_empty_children ($extensions=' *', $limit=1)
	Returns the number of children which are either files matching the specified extensions or folders containing at least one such file. More...

	create_directory ($newdirname, $userid=NULL)
	Create new directory, may throw exception - make sure params are valid. More...

	create_file_from_pathname ($newfilename, $pathname, $userid=NULL)
	Create new file from pathname - make sure params are valid. More...

	create_file_from_storedfile ($newfilename, $fid, $userid=NULL)
	Create new file from stored file - make sure params are valid. More...

	create_file_from_string ($newfilename, $content, $userid=NULL)
	Create new file from string - make sure params are valid. More...

	delete ()
	Delete file, make sure file is deletable first. More...

	get_author ()
	Returns the author name of the file. More...

	get_children ()
	Returns list of children. More...

	get_file_info ($component, $filearea, $itemid, $filepath, $filename)
	Return information about this specific context level. More...

	get_filesize ()
	Returns file size in bytes, null for directories. More...

	get_license ()
	Returns the license type of the file. More...

	get_mimetype ()
	Returns mimetype. More...

	get_non_empty_children ($extensions=' *')
	Returns list of children which are either files matching the specified extensions or folders that contain at least one such file. More...

	get_params ()
	Returns list of standard virtual file/directory identification. More...

	get_params_rawencoded ()
	Returns array of url encoded params. More...

	get_parent ()
	Returns parent file_info instance. More...

	get_readable_fullname ()
	Returns the localised human-readable name of the file together with virtual path. More...

	get_sortorder ()
	Returns the sort order of the file. More...

	get_source ()
	Returns the source of the file. More...

	get_status ()
	Returns file status flag. More...

	get_timecreated ()
	Returns time created unix timestamp if known. More...

	get_timemodified ()
	Returns time modified unix timestamp if known. More...

	get_url ($forcedownload=false, $https=false)
	Returns file download url. More...

	get_visible_name ()
	Returns localised visible name. More...

	is_directory ()
	Whether or not this is a directory. More...

	is_empty_area ()
	Is this info area and is it "empty"? Are there any files in subfolders? More...

	is_external_file ()
	Whether or not this is a external resource. More...

	is_readable ()
	Whether or not I can read content of this file or enter directory. More...

	is_writable ()
	Whether or not new files or directories can be added. More...

Protected Member Functions
	build_search_files_sql ($extensions, $prefix=null)
	Builds SQL sub query (WHERE clause) for selecting files with the specified extensions. More...

	get_area_backup_automated ($itemid, $filepath, $filename)
	Gets a stored file for the automated backup filearea directory. More...

	get_area_backup_course ($itemid, $filepath, $filename)
	Gets a stored file for the backup course filearea directory. More...

	get_area_backup_section ($itemid, $filepath, $filename)
	Gets a stored file for the backup section filearea directory. More...

	get_area_course_legacy ($itemid, $filepath, $filename)
	Gets a stored file for the course legacy filearea directory. More...

	get_area_course_overviewfiles ($itemid, $filepath, $filename)
	Gets a stored file for the course images filearea directory. More...

	get_area_course_section ($itemid, $filepath, $filename)
	Gets a stored file for the course section filearea directory. More...

	get_area_course_summary ($itemid, $filepath, $filename)
	Gets a stored file for the course summary filearea directory. More...

	get_child_module ($cm)
	Returns the child module if it is accessible by the current user. More...

	get_course_areas ($extensions=' *', $returnemptyfolders=false)
	Returns list of areas inside this course. More...

	get_module_areas_with_files ($extensions=' *')
	Returns list of areas inside the course modules that have files with the given extension. More...

Protected Attributes
file_browser	$browser
	File browser instance.

file_info_context_module[]	$childrenmodules = []
	cached child modules. More...

stdClass	$context
	File context.

stdClass	$course
	course object

Detailed Description

Represents a course context in the tree navigated by file_browser.

Copyright: 2008 Petr Skoda (http://skodak.org)

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

Constructor & Destructor Documentation

◆ __construct()

file_info_context_course::__construct	(	$browser,
		$context,
		$course
	)

Constructor.

Parameters

file_browser	$browser	file browser instance
stdClass	$context	context object
stdClass	$course	course object

Member Function Documentation

◆ build_search_files_sql()

file_info::build_search_files_sql	(	$extensions,
		$prefix = `null`
	)

protectedinherited

Builds SQL sub query (WHERE clause) for selecting files with the specified extensions.

If $extensions == '*' (any file), the result is array('', array()) otherwise the result is something like array('AND filename ...', array(...))

Parameters

string \| array	$extensions	- either '*' or array of lowercase extensions, i.e. array('.gif','.jpg')
string	$prefix	prefix for DB table files in the query (empty by default)

Return values

array of two elements: $sql - sql where clause and $params - array of parameters

◆ copy_to_pathname()

file_info::copy_to_pathname ( $pathname )

inherited

Copy content of this file to local storage, overriding current file if needed.

Todo:: MDL-31068 implement move() rename() unzip() zip()

Parameters

string $pathname real local full file name

Return values

boolean success

Reimplemented in file_info_stored.

◆ copy_to_storage()

file_info::copy_to_storage ( $filerecord )

inherited

Copy content of this file to local storage, overriding current file if needed.

Parameters

array | stdClass $filerecord contains contextid, component, filearea, itemid, filepath, filename and optionally other attributes of the new file

Return values

bool success

Reimplemented in file_info_stored.

◆ count_non_empty_children()

file_info_context_course::count_non_empty_children	(	$extensions = `'*'`,
		$limit = `1`
	)

Returns the number of children which are either files matching the specified extensions or folders containing at least one such file.

Parameters

string \| array	$extensions,for	example '*' or array('.gif','.jpg')
int	$limit	stop counting after at least $limit non-empty children are found

Return values

int

Reimplemented from file_info.

◆ create_directory()

file_info::create_directory	(	$newdirname,
		$userid = `NULL`
	)

inherited

Create new directory, may throw exception - make sure params are valid.

Parameters

string	$newdirname	name of new directory
int	$userid	id of author, default $USER->id

Return values

file_info new directory

Reimplemented in file_info_stored.

◆ create_file_from_pathname()

file_info::create_file_from_pathname	(	$newfilename,
		$pathname,
		$userid = `NULL`
	)

inherited

Create new file from pathname - make sure params are valid.

Parameters

string	$newfilename	name of new file
string	$pathname	location of file
int	$userid	id of author, default $USER->id

Return values

file_info new file

Reimplemented in file_info_stored.

◆ create_file_from_storedfile()

file_info::create_file_from_storedfile	(	$newfilename,
		$fid,
		$userid = `NULL`
	)

inherited

Create new file from stored file - make sure params are valid.

Parameters

string	$newfilename	name of new file
int \| stored_file	$fid	id or stored_file of file
int	$userid	id of author, default $USER->id

Return values

file_info new file

Reimplemented in file_info_stored.

◆ create_file_from_string()

file_info::create_file_from_string	(	$newfilename,
		$content,
		$userid = `NULL`
	)

inherited

Create new file from string - make sure params are valid.

Parameters

string	$newfilename	name of new file
string	$content	of file
int	$userid	id of author, default $USER->id

Return values

file_info new file

Reimplemented in file_info_stored.

◆ delete()

file_info::delete ( )

inherited

Delete file, make sure file is deletable first.

Return values

bool success

Reimplemented in file_info_stored.

◆ get_area_backup_automated()

file_info_context_course::get_area_backup_automated	(	$itemid,
		$filepath,
		$filename
	)

protected

Gets a stored file for the automated backup filearea directory.

Parameters

int	$itemid	item ID
string	$filepath	file path
string	$filename	file name

Return values

file_info|null

◆ get_area_backup_course()

file_info_context_course::get_area_backup_course	(	$itemid,
		$filepath,
		$filename
	)

protected

Gets a stored file for the backup course filearea directory.

Parameters

int	$itemid	item ID
string	$filepath	file path
string	$filename	file name

Return values

file_info|null file_info instance or null if not found or access not allowed

◆ get_area_backup_section()

file_info_context_course::get_area_backup_section	(	$itemid,
		$filepath,
		$filename
	)

protected

Gets a stored file for the backup section filearea directory.

Parameters

int	$itemid	item ID
string	$filepath	file path
string	$filename	file name

Return values

file_info|null file_info instance or null if not found or access not allowed

◆ get_area_course_legacy()

file_info_context_course::get_area_course_legacy	(	$itemid,
		$filepath,
		$filename
	)

protected

Gets a stored file for the course legacy filearea directory.

Parameters

int	$itemid	item ID
string	$filepath	file path
string	$filename	file name

Return values

file_info|null file_info instance or null if not found or access not allowed

◆ get_area_course_overviewfiles()

file_info_context_course::get_area_course_overviewfiles	(	$itemid,
		$filepath,
		$filename
	)

protected

Gets a stored file for the course images filearea directory.

Parameters

int	$itemid	item ID
string	$filepath	file path
string	$filename	file name

Return values

file_info|null file_info instance or null if not found or access not allowed

◆ get_area_course_section()

file_info_context_course::get_area_course_section	(	$itemid,
		$filepath,
		$filename
	)

protected

Gets a stored file for the course section filearea directory.

Parameters

int	$itemid	item ID
string	$filepath	file path
string	$filename	file name

Return values

file_info|null file_info instance or null if not found or access not allowed

◆ get_area_course_summary()

file_info_context_course::get_area_course_summary	(	$itemid,
		$filepath,
		$filename
	)

protected

Gets a stored file for the course summary filearea directory.

Parameters

int	$itemid	item ID
string	$filepath	file path
string	$filename	file name

Return values

file_info|null file_info instance or null if not found or access not allowed

◆ get_author()

file_info::get_author ( )

inherited

Returns the author name of the file.

Return values

string author name or null

Reimplemented in file_info_stored.

◆ get_child_module()

file_info_context_course::get_child_module ( $cm )

protected

Returns the child module if it is accessible by the current user.

Parameters

cm_info | int $cm

Return values

file_info_context_module|null

◆ get_children()

file_info_context_course::get_children ( )

Returns list of children.

Return values

array of file_info instances

Reimplemented from file_info.

◆ get_course_areas()

file_info_context_course::get_course_areas	(	$extensions = `'*'`,
		$returnemptyfolders = `false`
	)

protected

Returns list of areas inside this course.

Parameters

string	$extensions	Only return areas that have files with these extensions
bool	$returnemptyfolders	return all areas always, if true it will ignore the previous argument

Return values

array

◆ get_file_info()

file_info_context_course::get_file_info	(	$component,
		$filearea,
		$itemid,
		$filepath,
		$filename
	)

Return information about this specific context level.

Parameters

string	$component	component
string	$filearea	file area
int	$itemid	item ID
string	$filepath	file path
string	$filename	file name

Return values

file_info|null file_info instance or null if not found or access not allowed

◆ get_filesize()

file_info::get_filesize ( )

inherited

Returns file size in bytes, null for directories.

Return values

int	bytes or null if not known

Reimplemented in file_info_stored.

◆ get_license()

file_info::get_license ( )

inherited

Returns the license type of the file.

Return values

string license short name or null

Reimplemented in file_info_stored.

◆ get_mimetype()

file_info::get_mimetype ( )

inherited

Returns mimetype.

Return values

string mimetype or null if not known

Reimplemented in file_info_stored.

◆ get_module_areas_with_files()

file_info_context_course::get_module_areas_with_files ( $extensions = '*' )

protected

Returns list of areas inside the course modules that have files with the given extension.

Parameters

string $extensions

Return values

array

◆ get_non_empty_children()

file_info_context_course::get_non_empty_children ( $extensions = '*' )

Returns list of children which are either files matching the specified extensions or folders that contain at least one such file.

Parameters

string | array $extensions,either '*' or array of lowercase extensions, i.e. array('.gif','.jpg')

Return values

array of file_info instances

Reimplemented from file_info.

◆ get_params()

file_info::get_params ( )

inherited

Returns list of standard virtual file/directory identification.

The difference from stored_file parameters is that null values are allowed in all fields

Return values

array with keys contextid, component, filearea, itemid, filepath and filename

Reimplemented in workshop_file_info_overallfeedback_container, workshop_file_info_submissions_container, mod_lesson_file_info, imscp_file_info, glossary_file_info_container, forum_file_info_container, data_file_info_container, book_file_info, file_info_stored, file_info_area_backup_section, and file_info_area_course_section.

◆ get_params_rawencoded()

file_info::get_params_rawencoded ( )

inherited

Returns array of url encoded params.

Return values

array with numeric keys

◆ get_parent()

file_info_context_course::get_parent ( )

Returns parent file_info instance.

Return values

file_info or null for root

Reimplemented from file_info.

◆ get_readable_fullname()

file_info::get_readable_fullname ( )

inherited

Returns the localised human-readable name of the file together with virtual path.

See also: file_info_stored::get_readable_fullname()

Return values

string

Reimplemented in file_info_stored.

◆ get_sortorder()

file_info::get_sortorder ( )

inherited

Returns the sort order of the file.

Return values

int

Reimplemented in file_info_stored.

◆ get_source()

file_info::get_source ( )

inherited

Returns the source of the file.

Return values

string a source url or null

Reimplemented in file_info_stored.

◆ get_status()

file_info::get_status ( )

inherited

Returns file status flag.

Return values

int	0 means file OK, anything else is a problem and file can not be used

Reimplemented in file_info_stored.

◆ get_timecreated()

file_info::get_timecreated ( )

inherited

Returns time created unix timestamp if known.

Return values

int	timestamp or null

Reimplemented in file_info_stored.

◆ get_timemodified()

file_info::get_timemodified ( )

inherited

Returns time modified unix timestamp if known.

Return values

int	timestamp or null

Reimplemented in file_info_stored.

◆ get_url()

file_info::get_url	(	$forcedownload = `false`,
		$https = `false`
	)

inherited

Returns file download url.

Parameters

bool	$forcedownload	whether or not force download
bool	$https	whether or not force https

Return values

string url

Reimplemented in file_info_stored, and file_info_area_course_legacy.

◆ get_visible_name()

file_info_context_course::get_visible_name ( )

Returns localised visible name.

Return values

string

Reimplemented from file_info.

◆ is_directory()

file_info_context_course::is_directory ( )

Whether or not this is a directory.

Return values

bool

Reimplemented from file_info.

◆ is_empty_area()

file_info::is_empty_area ( )

inherited

Is this info area and is it "empty"? Are there any files in subfolders?

This is used mostly in repositories to reduce the number of empty folders. This method may be very slow, use with care.

Return values

bool

Reimplemented in file_info_stored, file_info_context_module, file_info_area_backup_section, and file_info_area_course_section.

◆ is_external_file()

file_info::is_external_file ( )

inherited

Whether or not this is a external resource.

Return values

bool

Reimplemented in file_info_stored.

◆ is_readable()

file_info::is_readable ( )

inherited

Whether or not I can read content of this file or enter directory.

Return values

bool

Reimplemented in file_info_stored.

◆ is_writable()

file_info_context_course::is_writable ( )

Whether or not new files or directories can be added.

Return values

bool

Reimplemented from file_info.

Member Data Documentation

◆ $childrenmodules

file_info_context_module [] file_info_context_course::$childrenmodules = []

protected

cached child modules.

See get_child_module()

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

lib/filebrowser/file_info_context_course.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ build_search_files_sql()

◆ copy_to_pathname()

◆ copy_to_storage()

◆ count_non_empty_children()

◆ create_directory()

◆ create_file_from_pathname()

◆ create_file_from_storedfile()

◆ create_file_from_string()

◆ delete()

◆ get_area_backup_automated()

◆ get_area_backup_course()

◆ get_area_backup_section()

◆ get_area_course_legacy()

◆ get_area_course_overviewfiles()

◆ get_area_course_section()

◆ get_area_course_summary()

◆ get_author()

◆ get_child_module()

◆ get_children()

◆ get_course_areas()

◆ get_file_info()

◆ get_filesize()

◆ get_license()

◆ get_mimetype()

◆ get_module_areas_with_files()

◆ get_non_empty_children()

◆ get_params()

◆ get_params_rawencoded()

◆ get_parent()

◆ get_readable_fullname()

◆ get_sortorder()

◆ get_source()

◆ get_status()

◆ get_timecreated()

◆ get_timemodified()

◆ get_url()

◆ get_visible_name()

◆ is_directory()

◆ is_empty_area()

◆ is_external_file()

◆ is_readable()

◆ is_writable()

Member Data Documentation

◆ $childrenmodules