Difference between revisions of "Restore 2.0 for developers"

Jump to: navigation, search
(New page: <code php> * * Structure step to restore one choice activity: class restore_choice_activity_structure_step extends restore_activity_structure_step { protected function define_st...)
 
Line 1: Line 1:
 +
{{Template:Development:Backup 2.0}}{{Moodle_2.0}}{{Work in progress}}
 +
 +
== Introduction ==
 +
 +
This page tries to explain, from a development perspective, '''how to implement''' the restore feature for various Moodle 2.x plugins, mainly, modules and blocks.
 +
 +
In order to work with Restore 2.0 you must have read the [https://docs.moodle.org/en/Development:Backup_2.0_for_developers Backup 2.0]. Everything will be crystal clear once you have undergone the full reading of [https://docs.moodle.org/en/Development:Backup_2.0_for_developers Backup 2.0].
 +
 +
In this documentation you will learn about some points that you can not deduce from Backup 2.0 documentation for the Choice module example.
 +
 +
== Coding ==
 +
 +
=== Similarity with Backup 2.0 ===
 +
restore_choice_stepslib.php
 
<code php>
 
<code php>
 
/**
 
/**

Revision as of 02:36, 10 December 2010

Template:Development:Backup 2.0Moodle 2.0

Note: This page is a work-in-progress. Feedback and suggested improvements are welcome. Please join the discussion on moodle.org or use the page comments.


Introduction

This page tries to explain, from a development perspective, how to implement the restore feature for various Moodle 2.x plugins, mainly, modules and blocks.

In order to work with Restore 2.0 you must have read the Backup 2.0. Everything will be crystal clear once you have undergone the full reading of Backup 2.0.

In this documentation you will learn about some points that you can not deduce from Backup 2.0 documentation for the Choice module example.

Coding

Similarity with Backup 2.0

restore_choice_stepslib.php

/**
 * Structure step to restore one choice activity
 */
class restore_choice_activity_structure_step extends restore_activity_structure_step {
 
    protected function define_structure() {
 
        $paths = array();
        $userinfo = $this->get_setting_value('userinfo');
 
        $paths[] = new restore_path_element('choice', '/activity/choice');
        $paths[] = new restore_path_element('choice_option', '/activity/choice/options/option');
        if ($userinfo) {
            $paths[] = new restore_path_element('choice_answer', '/activity/choice/answers/answer');
        }
 
        // Return the paths wrapped into standard activity structure
        return $this->prepare_activity_structure($paths);
    }
 
    protected function process_choice($data) {
        global $DB;
 
        $data = (object)$data;
        $oldid = $data->id;
        $data->course = $this->get_courseid();
 
        $data->timeopen = $this->apply_date_offset($data->timeopen);
        $data->timeclose = $this->apply_date_offset($data->timeclose);
        $data->timemodified = $this->apply_date_offset($data->timemodified);
 
        // insert the choice record
        $newitemid = $DB->insert_record('choice', $data);
        // immediately after inserting "activity" record, call this
        $this->apply_activity_instance($newitemid);
    }
 
    protected function process_choice_option($data) {
        global $DB;
 
        $data = (object)$data;
        $oldid = $data->id;
 
        $data->choiceid = $this->get_new_parentid('choice');
        $data->timemodified = $this->apply_date_offset($data->timemodified);
 
        $newitemid = $DB->insert_record('choice_options', $data);
        $this->set_mapping('choice_option', $oldid, $newitemid);
    }
 
    protected function process_choice_answer($data) {
        global $DB;
 
        $data = (object)$data;
        $oldid = $data->id;
 
        $data->choiceid = $this->get_new_parentid('choice');
        $data->optionid = $this->get_mappingid('choice_option', $oldid);
        $data->userid = $this->get_mappingid('user', $data->userid);
        $data->timemodified = $this->apply_date_offset($data->timemodified);
 
        $newitemid = $DB->insert_record('choice_answers', $data);
        // No need to save this mapping as far as nothing depend on it
        // (child paths, file areas nor links decoder)
    }
 
    protected function after_execute() {
        // Add choice related files, no need to match by itemname (just internally handled context)
        $this->add_related_files('mod_choice', 'intro', null);
    }
}

Some specificities