restore_format_topics_plugin Class Reference

Specialised restore for Topics course format. More...

Inheritance diagram for restore_format_topics_plugin:

Public Member Functions
	after_restore_course ()
	Executed after course restore is complete.
	define_course_plugin_structure ()
	Creates a dummy path element in order to be able to execute code after restore.
	define_plugin_structure ($connectionpoint)
	launch_after_execute_methods ()
	after_execute dispatcher for any restore_plugin class
	launch_after_restore_methods ()
	after_restore dispatcher for any restore_plugin class
	process_dummy_course ()
	Dummy process method.

Static Public Member Functions
static	define_plugin_decode_contents ()
	Define the contents in the plugin that must be processed by the link decoder.
static	get_restore_decode_contents ($plugintype)
	Returns one array with all the decode contents to be processed by the links decoder.

Protected Member Functions
	add_related_files ($component, $filearea, $mappingitemname, $filesctxid=null, $olditemid=null)
	Add all the existing file, given their component and filearea and one backup_ids itemname to match with.
	apply_date_offset ($value)
	Apply course startdate offset based in original course startdate and course_offset_startdate setting Note we are using one static cache here, but by restoreid, so it's ok for concurrence/multiple executions in the same request.
	get_mapping ($itemname, $oldid)
	Return the complete mapping from the given itemname, itemid.
	get_mappingid ($itemname, $oldid, $ifnotfound=false)
	Return the new id of a mapping for the given itemname.
	get_namefor ($name='')
	Simple helper function that returns the name for the restore_path_element It's not mandatory to use it but recommended ;-)
	get_new_parentid ($itemname)
	Returns the latest (parent) new id mapped by one pathelement.
	get_old_parentid ($itemname)
	Returns the latest (parent) old id mapped by one pathelement.
	get_pathfor ($path='')
	Simple helper function that returns the base (prefix) of the path for the restore_path_element Useful if we used get_recommended_name() in backup.
	get_restoreid ()
	get_setting_value ($name)
	Returns the value of one (task/plan) setting.
	get_task ()
	Get the task we are part of.
	need_restore_numsections ()
	Checks if backup file was made on Moodle before 3.3 and we should respect the 'numsections' and potential "orphaned" sections in the end of the course.
	set_mapping ($itemname, $oldid, $newid, $restorefiles=false, $filesctxid=null, $parentid=null)
	To send ids pairs to backup_ids_table and to store them into paths.

Protected Attributes
restore_path_element	$connectionpoint
int	$originalnumsections = 0
string	$pluginname
string	$plugintype
restore_structure_step	$step
restore_course_task restore_activity_task	$task

Detailed Description

Specialised restore for Topics course format.

Processes 'numsections' from the old backup files and hides sections that used to be "orphaned".

Copyright

2017 Marina Glancy

License

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

Member Function Documentation

after_restore_course()

restore_format_topics_plugin::after_restore_course

(

)

Executed after course restore is complete.

This method is only executed if course configuration was overridden.

Return values

void

define_course_plugin_structure()

restore_format_topics_plugin::define_course_plugin_structure

(

)

Creates a dummy path element in order to be able to execute code after restore.

Return values

restore_path_element[]

define_plugin_decode_contents()

static restore_plugin::define_plugin_decode_contents ( )

staticinherited

Define the contents in the plugin that must be processed by the link decoder.

Reimplemented in restore_qtype_plugin.

get_mappingid()

restore_plugin::get_mappingid ( $itemname, $oldid, $ifnotfound = false )

protectedinherited

Return the new id of a mapping for the given itemname.

Parameters

string	$itemname	the type of item
int	$oldid	the item ID from the backup
mixed	$ifnotfound	what to return if $oldid wasnt found. Defaults to false

get_pathfor()

restore_plugin::get_pathfor ( $path = '' )

protectedinherited

Simple helper function that returns the base (prefix) of the path for the restore_path_element Useful if we used get_recommended_name() in backup.

It's not mandatory to use it but recommended ;-)

get_restore_decode_contents()

static restore_plugin::get_restore_decode_contents ( $plugintype )

staticinherited

Returns one array with all the decode contents to be processed by the links decoder.

This method, given one plugin type, returns one array of restore_decode_content objects that will be added to the restore decoder in order to perform modifications under the plugin contents.

The objects are retrieved by calling to the define_decode_contents method (when available), first in the main restore_xxxx_plugin class and later on each of the available subclasses

get_task()

restore_plugin::get_task ( )

protectedinherited

Get the task we are part of.

Return values

restore_activity_task|restore_course_task

the task.

launch_after_execute_methods()

restore_plugin::launch_after_execute_methods ( )

inherited

after_execute dispatcher for any restore_plugin class

This method will dispatch execution to the corresponding after_execute_xxx() method when available, with xxx being the connection point of the instance, so plugin classes with multiple connection points will support multiple after_execute methods, one for each connection point

launch_after_restore_methods()

restore_plugin::launch_after_restore_methods ( )

inherited

after_restore dispatcher for any restore_plugin class

This method will dispatch execution to the corresponding after_restore_xxx() method when available, with xxx being the connection point of the instance, so plugin classes with multiple connection points will support multiple after_restore methods, one for each connection point

need_restore_numsections()

restore_format_topics_plugin::need_restore_numsections ( )

protected

Checks if backup file was made on Moodle before 3.3 and we should respect the 'numsections' and potential "orphaned" sections in the end of the course.

Return values

bool

process_dummy_course()

restore_format_topics_plugin::process_dummy_course

(

)

Dummy process method.

Return values

void

set_mapping()

restore_plugin::set_mapping ( $itemname, $oldid, $newid, $restorefiles = false, $filesctxid = null, $parentid = null )

protectedinherited

To send ids pairs to backup_ids_table and to store them into paths.

This method will send the given itemname and old/new ids to the backup_ids_temp table, and, at the same time, will save the new id into the corresponding restore_path_element for easier access by children. Also will inject the known old context id for the task in case it's going to be used for restoring files later

---

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

• course/format/topics/backup/moodle2/restore_format_topics_plugin.class.php