See Release Notes
Long Term Support Release
<?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/>. /** * This script is used to configure and execute the import proccess. * * @package core * @subpackage backup * @copyright Moodle * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ define('NO_OUTPUT_BUFFERING', true); // Require both the backup and restore libs require_once('../config.php'); require_once($CFG->dirroot . '/backup/util/includes/backup_includes.php'); require_once($CFG->dirroot . '/backup/moodle2/backup_plan_builder.class.php'); require_once($CFG->dirroot . '/backup/util/includes/restore_includes.php'); require_once($CFG->dirroot . '/backup/util/ui/import_extensions.php'); // The courseid we are importing to $courseid = required_param('id', PARAM_INT); // The id of the course we are importing FROM (will only be set if past first stage $importcourseid = optional_param('importid', false, PARAM_INT); // We just want to check if a search has been run. True if anything is there. $searchcourses = optional_param('searchcourses', false, PARAM_BOOL); // The target method for the restore (adding or deleting) $restoretarget = optional_param('target', backup::TARGET_CURRENT_ADDING, PARAM_INT); // Load the course and context $course = $DB->get_record('course', array('id'=>$courseid), '*', MUST_EXIST); $context = context_course::instance($courseid); // Must pass login require_login($course); // Must hold restoretargetimport in the current course require_capability('moodle/restore:restoretargetimport', $context); // Set up the page $PAGE->set_title($course->shortname . ': ' . get_string('import')); $PAGE->set_heading($course->fullname); $PAGE->set_url(new moodle_url('/backup/import.php', array('id'=>$courseid))); $PAGE->set_context($context); $PAGE->set_pagelayout('incourse'); // Prepare the backup renderer $renderer = $PAGE->get_renderer('core','backup'); // Check if we already have a import course id if ($importcourseid === false || $searchcourses) { // Obviously not... show the selector so one can be chosen $url = new moodle_url('/backup/import.php', array('id'=>$courseid)); $search = new import_course_search(array('url'=>$url)); // show the course selector echo $OUTPUT->header(); $backup = new import_ui(false, array()); echo $renderer->progress_bar($backup->get_progress_bar()); $html = $renderer->import_course_selector($url, $search); echo $html; echo $OUTPUT->footer(); die(); } // Load the course +context to import from $importcourse = $DB->get_record('course', array('id'=>$importcourseid), '*', MUST_EXIST); $importcontext = context_course::instance($importcourseid); // Make sure the user can backup from that course require_capability('moodle/backup:backuptargetimport', $importcontext); // Attempt to load the existing backup controller (backupid will be false if there isn't one) $backupid = optional_param('backup', false, PARAM_ALPHANUM); if (!($bc = backup_ui::load_controller($backupid))) { $bc = new backup_controller(backup::TYPE_1COURSE, $importcourse->id, backup::FORMAT_MOODLE, backup::INTERACTIVE_YES, backup::MODE_IMPORT, $USER->id); $bc->get_plan()->get_setting('users')->set_status(backup_setting::LOCKED_BY_CONFIG); $settings = $bc->get_plan()->get_settings(); // For the initial stage we want to hide all locked settings and if there are // no visible settings move to the next stage $visiblesettings = false; foreach ($settings as $setting) { if ($setting->get_status() !== backup_setting::NOT_LOCKED) { $setting->set_visibility(backup_setting::HIDDEN); } else { $visiblesettings = true; } } import_ui::skip_current_stage(!$visiblesettings); } // Prepare the import UI $backup = new import_ui($bc, array('importid'=>$importcourse->id, 'target'=>$restoretarget)); // Process the current stage $backup->process(); // If this is the confirmation stage remove the filename setting if ($backup->get_stage() == backup_ui::STAGE_CONFIRMATION) { $backup->get_setting('filename')->set_visibility(backup_setting::HIDDEN); } // If it's the final stage process the import if ($backup->get_stage() == backup_ui::STAGE_FINAL) { echo $OUTPUT->header(); // Display an extra progress bar so that we can show the current stage. echo html_writer::start_div('', array('id' => 'executionprogress')); echo $renderer->progress_bar($backup->get_progress_bar()); // Start the progress display - we split into 2 chunks for backup and restore. $progress = new \core\progress\display(); $progress->start_progress('', 2); $backup->get_controller()->set_progress($progress); // Prepare logger for backup. $logger = new core_backup_html_logger($CFG->debugdeveloper ? backup::LOG_DEBUG : backup::LOG_INFO); $backup->get_controller()->add_logger($logger); // First execute the backup $backup->execute(); // Before destroying the backup object, we still need to generate the progress bar. $progressbar = $renderer->progress_bar($backup->get_progress_bar()); $backup->destroy(); unset($backup); // Note that we've done that progress. $progress->progress(1); // Check whether the backup directory still exists. If missing, something // went really wrong in backup, throw error. Note that backup::MODE_IMPORT // backups don't store resulting files ever $tempdestination = make_backup_temp_directory($backupid, false); if (!file_exists($tempdestination) || !is_dir($tempdestination)) {< print_error('unknownbackupexporterror'); // shouldn't happen ever> throw new \moodle_exception('unknownbackupexporterror'); // Shouldn't happen ever.} // Prepare the restore controller. We don't need a UI here as we will just use what // ever the restore has (the user has just chosen). $rc = new restore_controller($backupid, $course->id, backup::INTERACTIVE_YES, backup::MODE_IMPORT, $USER->id, $restoretarget); // Start a progress section for the restore, which will consist of 2 steps // (the precheck and then the actual restore). $progress->start_progress('Restore process', 2); $rc->set_progress($progress); // Set logger for restore. $rc->add_logger($logger); // Convert the backup if required.... it should NEVER happed if ($rc->get_status() == backup::STATUS_REQUIRE_CONV) { $rc->convert(); } // Mark the UI finished. $rc->finish_ui(); // Execute prechecks $warnings = false; if (!$rc->execute_precheck()) { $precheckresults = $rc->get_precheck_results(); if (is_array($precheckresults)) { if (!empty($precheckresults['errors'])) { // If errors are found, terminate the import. fulldelete($tempdestination); echo $renderer->precheck_notices($precheckresults); echo $OUTPUT->continue_button(new moodle_url('/course/view.php', array('id'=>$course->id))); echo $OUTPUT->footer(); die(); } if (!empty($precheckresults['warnings'])) { // If warnings are found, go ahead but display warnings later. $warnings = $precheckresults['warnings']; } } } if ($restoretarget == backup::TARGET_CURRENT_DELETING || $restoretarget == backup::TARGET_EXISTING_DELETING) { restore_dbops::delete_course_content($course->id); } // Execute the restore. $rc->execute_plan(); // Delete the temp directory now fulldelete($tempdestination); // End restore section of progress tracking (restore/precheck). $progress->end_progress(); // All progress complete. Hide progress area. $progress->end_progress(); echo html_writer::end_div(); echo html_writer::script('document.getElementById("executionprogress").style.display = "none";'); // Display a notification and a continue button if ($warnings) { echo $OUTPUT->box_start(); echo $OUTPUT->notification(get_string('warning'), 'notifyproblem'); echo html_writer::start_tag('ul', array('class'=>'list')); foreach ($warnings as $warning) { echo html_writer::tag('li', $warning); } echo html_writer::end_tag('ul'); echo $OUTPUT->box_end(); } echo $progressbar; echo $OUTPUT->notification(get_string('importsuccess', 'backup'), 'notifysuccess'); echo $OUTPUT->continue_button(new moodle_url('/course/view.php', array('id'=>$course->id))); // Get and display log data if there was any. $loghtml = $logger->get_html(); if ($loghtml != '') { echo $renderer->log_display($loghtml); } echo $OUTPUT->footer(); die(); } else { // Otherwise save the controller and progress $backup->save_controller(); } // Display the current stage echo $OUTPUT->header(); if ($backup->enforce_changed_dependencies()) { debugging('Your settings have been altered due to unmet dependencies', DEBUG_DEVELOPER); } echo $renderer->progress_bar($backup->get_progress_bar()); echo $backup->display($renderer); $backup->destroy(); unset($backup); echo $OUTPUT->footer();