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.
/backup/moodle2/ -> restore_subplugin.class.php (source)

[Source view]

Differences Between: [Versions 311 and 402] [Versions 311 and 403]

Defines restore_subplugin class

Copyright: 2010 onwards Eloy Lafuente (stronk7) {@link http://stronk7.com}
License: http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
File Size: 217 lines (8 kb)
Included or required:0 times
Referenced: 1 time
Includes or requires: 0 files

Defines 1 class

restore_subplugin:: (16 methods):
  __construct()
  define_subplugin_structure()
  launch_after_execute_methods()
  launch_after_restore_methods()
  get_restoreid()
  set_mapping()
  get_old_parentid()
  get_new_parentid()
  get_mappingid()
  get_mapping()
  add_related_files()
  apply_date_offset()
  log()
  get_setting_value()
  get_namefor()
  get_pathfor()


Class: restore_subplugin  - X-Ref

Class implementing the subplugins support for moodle2 restore

TODO: Finish phpdocs
TODO: Make this subclass of restore_plugin
TODO: Add support for declaring decode_contents (not decode_rules)
__construct($subplugintype, $subpluginname, $step)   X-Ref
No description

define_subplugin_structure($connectionpoint)   X-Ref
No description

launch_after_execute_methods()   X-Ref
after_execute dispatcher for any restore_subplugin 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 subplugin
classes with multiple connection points will support
multiple after_execute methods, one for each connection point

launch_after_restore_methods()   X-Ref
The after_restore dispatcher for any restore_subplugin 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 subplugin
classes with multiple connection points will support
multiple after_restore methods, one for each connection point.

get_restoreid()   X-Ref
No description

set_mapping($itemname, $oldid, $newid, $restorefiles = false, $filesctxid = null, $parentid = null)   X-Ref
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

get_old_parentid($itemname)   X-Ref
Returns the latest (parent) old id mapped by one pathelement


get_new_parentid($itemname)   X-Ref
Returns the latest (parent) new id mapped by one pathelement


get_mappingid($itemname, $oldid, $ifnotfound = false)   X-Ref
Return the new id of a mapping for the given itemname

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

get_mapping($itemname, $oldid)   X-Ref
Return the complete mapping from the given itemname, itemid


add_related_files($component, $filearea, $mappingitemname, $filesctxid = null, $olditemid = null)   X-Ref
Add all the existing file, given their component and filearea and one backup_ids itemname to match with


apply_date_offset($value)   X-Ref
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


log($message, $level, $a = null, $depth = null, $display = false)   X-Ref
Call the log function from the step.


get_setting_value($name)   X-Ref
Returns the value of one (task/plan) setting


get_namefor($name = '')   X-Ref
Simple helper function that returns the name for the restore_path_element
It's not mandatory to use it but recommended ;-)


get_pathfor($path = '')   X-Ref
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 ;-)