mirror of
https://github.com/moodle/moodle.git
synced 2025-02-18 23:05:30 +01:00
ede7105fd9
Some early steps in restore are using capability checks to decide how to restore some information. But at that stage, if the course contents have been removed and the user had perms at course level only (usually teacher) the process can fail because some content is not restoreable due to the lack of permissions. Moving the restorer step to the beginning really helps is those situations and it does not hurt at all. Also, fixed one notice detected when testing this.
226 lines
11 KiB
PHP
226 lines
11 KiB
PHP
<?php
|
|
|
|
// This file is part of Moodle - http://moodle.org/
|
|
//
|
|
// Moodle is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// Moodle is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
/**
|
|
* @package moodlecore
|
|
* @subpackage backup-moodle2
|
|
* @copyright 2010 onwards Eloy Lafuente (stronk7) {@link http://stronk7.com}
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
/**
|
|
* Start task that provides all the settings common to all restores and other initial steps
|
|
*
|
|
* TODO: Finish phpdocs
|
|
*/
|
|
class restore_root_task extends restore_task {
|
|
|
|
/**
|
|
* Create all the steps that will be part of this task
|
|
*/
|
|
public function build() {
|
|
|
|
// Conditionally create the temp table (can exist from prechecks) and delete old stuff
|
|
$this->add_step(new restore_create_and_clean_temp_stuff('create_and_clean_temp_stuff'));
|
|
|
|
// Now make sure the user that is running the restore can actually access the course
|
|
// before executing any other step (potentially performing permission checks)
|
|
$this->add_step(new restore_fix_restorer_access_step('fix_restorer_access'));
|
|
|
|
// If we haven't preloaded information, load all the included inforef records to temp_ids table
|
|
$this->add_step(new restore_load_included_inforef_records('load_inforef_records'));
|
|
|
|
// Load all the needed files to temp_ids table
|
|
$this->add_step(new restore_load_included_files('load_file_records', 'files.xml'));
|
|
|
|
// If we haven't preloaded information, load all the needed roles to temp_ids_table
|
|
$this->add_step(new restore_load_and_map_roles('load_and_map_roles'));
|
|
|
|
// If we haven't preloaded information and are restoring user info, load all the needed users to temp_ids table
|
|
$this->add_step(new restore_load_included_users('load_user_records'));
|
|
|
|
// If we haven't preloaded information and are restoring user info, process all those needed users
|
|
// marking for create/map them as needed. Any problem here will cause exception as far as prechecks have
|
|
// performed the same process so, it's not possible to have errors here
|
|
$this->add_step(new restore_process_included_users('process_user_records'));
|
|
|
|
// Unconditionally, create all the needed users calculated in the previous step
|
|
$this->add_step(new restore_create_included_users('create_users'));
|
|
|
|
// Unconditionally, load create all the needed groups and groupings
|
|
$this->add_step(new restore_groups_structure_step('create_groups_and_groupings', 'groups.xml'));
|
|
|
|
// Unconditionally, load create all the needed scales
|
|
$this->add_step(new restore_scales_structure_step('create_scales', 'scales.xml'));
|
|
|
|
// Unconditionally, load create all the needed outcomes
|
|
$this->add_step(new restore_outcomes_structure_step('create_scales', 'outcomes.xml'));
|
|
|
|
// If we haven't preloaded information, load all the needed categories and questions (reduced) to temp_ids_table
|
|
$this->add_step(new restore_load_categories_and_questions('load_categories_and_questions'));
|
|
|
|
// If we haven't preloaded information, process all the loaded categories and questions
|
|
// marking them for creation/mapping as needed. Any problem here will cause exception
|
|
// because this same process has been executed and reported by restore prechecks, so
|
|
// it is not possible to have errors here.
|
|
$this->add_step(new restore_process_categories_and_questions('process_categories_and_questions'));
|
|
|
|
// Unconditionally, create and map all the categories and questions
|
|
$this->add_step(new restore_create_categories_and_questions('create_categories_and_questions', 'questions.xml'));
|
|
|
|
// At the end, mark it as built
|
|
$this->built = true;
|
|
}
|
|
|
|
// Protected API starts here
|
|
|
|
/**
|
|
* Define the common setting that any restore type will have
|
|
*/
|
|
protected function define_settings() {
|
|
|
|
// Load all the root settings found in backup file from controller
|
|
$rootsettings = $this->get_info()->root_settings;
|
|
|
|
// Define users setting (keeping it on hand to define dependencies)
|
|
$defaultvalue = false; // Safer default
|
|
$changeable = false;
|
|
if (isset($rootsettings['users']) && $rootsettings['users']) { // Only enabled when available
|
|
$defaultvalue = true;
|
|
$changeable = true;
|
|
}
|
|
$users = new restore_users_setting('users', base_setting::IS_BOOLEAN, $defaultvalue);
|
|
$users->set_ui(new backup_setting_ui_checkbox($users, get_string('rootsettingusers', 'backup')));
|
|
$users->get_ui()->set_changeable($changeable);
|
|
$this->add_setting($users);
|
|
|
|
// Define role_assignments (dependent of users)
|
|
$defaultvalue = false; // Safer default
|
|
$changeable = false;
|
|
if (isset($rootsettings['role_assignments']) && $rootsettings['role_assignments']) { // Only enabled when available
|
|
$defaultvalue = true;
|
|
$changeable = true;
|
|
}
|
|
$roleassignments = new restore_role_assignments_setting('role_assignments', base_setting::IS_BOOLEAN, $defaultvalue);
|
|
$roleassignments->set_ui(new backup_setting_ui_checkbox($roleassignments,get_string('rootsettingroleassignments', 'backup')));
|
|
$roleassignments->get_ui()->set_changeable($changeable);
|
|
$this->add_setting($roleassignments);
|
|
$users->add_dependency($roleassignments);
|
|
|
|
// Define user_files (dependent of users)
|
|
$defaultvalue = false; // Safer default
|
|
$changeable = false;
|
|
if (isset($rootsettings['user_files']) && $rootsettings['user_files']) { // Only enabled when available
|
|
$defaultvalue = true;
|
|
$changeable = true;
|
|
}
|
|
$userfiles = new restore_user_files_setting('user_files', base_setting::IS_BOOLEAN, $defaultvalue);
|
|
$userfiles->set_ui(new backup_setting_ui_checkbox($userfiles, get_string('rootsettinguserfiles', 'backup')));
|
|
$userfiles->get_ui()->set_changeable($changeable);
|
|
$this->add_setting($userfiles);
|
|
$users->add_dependency($userfiles);
|
|
|
|
// Define activitites
|
|
$defaultvalue = false; // Safer default
|
|
$changeable = false;
|
|
if (isset($rootsettings['activities']) && $rootsettings['activities']) { // Only enabled when available
|
|
$defaultvalue = true;
|
|
$changeable = true;
|
|
}
|
|
$activities = new restore_activities_setting('activities', base_setting::IS_BOOLEAN, $defaultvalue);
|
|
$activities->set_ui(new backup_setting_ui_checkbox($activities, get_string('rootsettingactivities', 'backup')));
|
|
$activities->get_ui()->set_changeable($changeable);
|
|
$this->add_setting($activities);
|
|
|
|
// Define blocks
|
|
$defaultvalue = false; // Safer default
|
|
$changeable = false;
|
|
if (isset($rootsettings['blocks']) && $rootsettings['blocks']) { // Only enabled when available
|
|
$defaultvalue = true;
|
|
$changeable = true;
|
|
}
|
|
$blocks = new restore_generic_setting('blocks', base_setting::IS_BOOLEAN, $defaultvalue);
|
|
$blocks->set_ui(new backup_setting_ui_checkbox($blocks, get_string('rootsettingblocks', 'backup')));
|
|
$blocks->get_ui()->set_changeable($changeable);
|
|
$this->add_setting($blocks);
|
|
|
|
// Define filters
|
|
$defaultvalue = false; // Safer default
|
|
$changeable = false;
|
|
if (isset($rootsettings['filters']) && $rootsettings['filters']) { // Only enabled when available
|
|
$defaultvalue = true;
|
|
$changeable = true;
|
|
}
|
|
$filters = new restore_generic_setting('filters', base_setting::IS_BOOLEAN, $defaultvalue);
|
|
$filters->set_ui(new backup_setting_ui_checkbox($filters, get_string('rootsettingfilters', 'backup')));
|
|
$filters->get_ui()->set_changeable($changeable);
|
|
$this->add_setting($filters);
|
|
|
|
// Define comments (dependent of users)
|
|
$defaultvalue = false; // Safer default
|
|
$changeable = false;
|
|
if (isset($rootsettings['comments']) && $rootsettings['comments']) { // Only enabled when available
|
|
$defaultvalue = true;
|
|
$changeable = true;
|
|
}
|
|
$comments = new restore_comments_setting('comments', base_setting::IS_BOOLEAN, $defaultvalue);
|
|
$comments->set_ui(new backup_setting_ui_checkbox($comments, get_string('rootsettingcomments', 'backup')));
|
|
$comments->get_ui()->set_changeable($changeable);
|
|
$this->add_setting($comments);
|
|
$users->add_dependency($comments);
|
|
|
|
// Define completion (dependent of users)
|
|
$defaultvalue = false; // Safer default
|
|
$changeable = false;
|
|
if (isset($rootsettings['userscompletion']) && $rootsettings['userscompletion']) { // Only enabled when available
|
|
$defaultvalue = true;
|
|
$changeable = true;
|
|
}
|
|
$completion = new restore_userscompletion_setting('userscompletion', base_setting::IS_BOOLEAN, $defaultvalue);
|
|
$completion->set_ui(new backup_setting_ui_checkbox($completion, get_string('rootsettinguserscompletion', 'backup')));
|
|
$completion->get_ui()->set_changeable($changeable);
|
|
$this->add_setting($completion);
|
|
$users->add_dependency($completion);
|
|
|
|
// Define logs (dependent of users)
|
|
$defaultvalue = false; // Safer default
|
|
$changeable = false;
|
|
if (isset($rootsettings['logs']) && $rootsettings['logs']) { // Only enabled when available
|
|
$defaultvalue = true;
|
|
$changeable = true;
|
|
}
|
|
$logs = new restore_logs_setting('logs', base_setting::IS_BOOLEAN, $defaultvalue);
|
|
$logs->set_ui(new backup_setting_ui_checkbox($logs, get_string('rootsettinglogs', 'backup')));
|
|
$logs->get_ui()->set_changeable($changeable);
|
|
$this->add_setting($logs);
|
|
$users->add_dependency($logs);
|
|
|
|
// Define grade_histories (dependent of users)
|
|
$defaultvalue = false; // Safer default
|
|
$changeable = false;
|
|
if (isset($rootsettings['grade_histories']) && $rootsettings['grade_histories']) { // Only enabled when available
|
|
$defaultvalue = true;
|
|
$changeable = true;
|
|
}
|
|
$gradehistories = new restore_grade_histories_setting('grade_histories', base_setting::IS_BOOLEAN, $defaultvalue);
|
|
$gradehistories->set_ui(new backup_setting_ui_checkbox($gradehistories, get_string('rootsettinggradehistories', 'backup')));
|
|
$gradehistories->get_ui()->set_changeable($changeable);
|
|
$this->add_setting($gradehistories);
|
|
$users->add_dependency($gradehistories);
|
|
}
|
|
}
|