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.
<?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    mod_scorm
 * @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
 */

/**
 * Define all the restore steps that will be used by the restore_scorm_activity_task
 */

/**
 * Structure step to restore one scorm activity
 */
class restore_scorm_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('scorm', '/activity/scorm');
        $paths[] = new restore_path_element('scorm_sco', '/activity/scorm/scoes/sco');
        $paths[] = new restore_path_element('scorm_sco_data', '/activity/scorm/scoes/sco/sco_datas/sco_data');
        $paths[] = new restore_path_element('scorm_seq_objective', '/activity/scorm/scoes/sco/seq_objectives/seq_objective');
        $paths[] = new restore_path_element('scorm_seq_rolluprule', '/activity/scorm/scoes/sco/seq_rolluprules/seq_rolluprule');
        $paths[] = new restore_path_element('scorm_seq_rolluprulecond', '/activity/scorm/scoes/sco/seq_rollupruleconds/seq_rolluprulecond');
        $paths[] = new restore_path_element('scorm_seq_rulecond', '/activity/scorm/scoes/sco/seq_ruleconds/seq_rulecond');
        $paths[] = new restore_path_element('scorm_seq_rulecond_data', '/activity/scorm/scoes/sco/seq_rulecond_datas/seq_rulecond_data');

        $paths[] = new restore_path_element('scorm_seq_mapinfo', '/activity/scorm/scoes/sco/seq_objectives/seq_objective/seq_mapinfos/seq_mapinfo');
        if ($userinfo) {
            $paths[] = new restore_path_element('scorm_sco_track', '/activity/scorm/scoes/sco/sco_tracks/sco_track');
        }

        // Return the paths wrapped into standard activity structure
        return $this->prepare_activity_structure($paths);
    }

    protected function process_scorm($data) {
        global $DB;

        $data = (object)$data;
        $oldid = $data->id;

        $data->course = $this->get_courseid();

        // Any changes to the list of dates that needs to be rolled should be same during course restore and course reset.
        // See MDL-9367.
        $data->timeopen = $this->apply_date_offset($data->timeopen);
        $data->timeclose = $this->apply_date_offset($data->timeclose);

< if (!isset($data->displayactivityname)) { < $data->displayactivityname = true; < }
if (!isset($data->completionstatusallscos)) { $data->completionstatusallscos = false; } // insert the scorm record $newitemid = $DB->insert_record('scorm', $data); // immediately after inserting "activity" record, call this $this->apply_activity_instance($newitemid); } protected function process_scorm_sco($data) { global $DB; $data = (object)$data; $oldid = $data->id; $data->scorm = $this->get_new_parentid('scorm'); $newitemid = $DB->insert_record('scorm_scoes', $data); $this->set_mapping('scorm_sco', $oldid, $newitemid); } protected function process_scorm_sco_data($data) { global $DB; $data = (object)$data; $oldid = $data->id; $data->scoid = $this->get_new_parentid('scorm_sco'); $newitemid = $DB->insert_record('scorm_scoes_data', $data); // No need to save this mapping as far as nothing depend on it // (child paths, file areas nor links decoder) } protected function process_scorm_seq_objective($data) { global $DB; $data = (object)$data; $oldid = $data->id; $data->scoid = $this->get_new_parentid('scorm_sco'); $newitemid = $DB->insert_record('scorm_seq_objective', $data); $this->set_mapping('scorm_seq_objective', $oldid, $newitemid); } protected function process_scorm_seq_rolluprule($data) { global $DB; $data = (object)$data; $oldid = $data->id; $data->scoid = $this->get_new_parentid('scorm_sco'); $newitemid = $DB->insert_record('scorm_seq_rolluprule', $data); $this->set_mapping('scorm_seq_rolluprule', $oldid, $newitemid); } protected function process_scorm_seq_rolluprulecond($data) { global $DB; $data = (object)$data; $oldid = $data->id; $data->scoid = $this->get_new_parentid('scorm_sco'); $data->ruleconditions = $this->get_new_parentid('scorm_seq_rolluprule'); $newitemid = $DB->insert_record('scorm_seq_rolluprulecond', $data); // No need to save this mapping as far as nothing depend on it // (child paths, file areas nor links decoder) } protected function process_scorm_seq_rulecond($data) { global $DB; $data = (object)$data; $oldid = $data->id; $data->scoid = $this->get_new_parentid('scorm_sco'); $newitemid = $DB->insert_record('scorm_seq_ruleconds', $data); $this->set_mapping('scorm_seq_ruleconds', $oldid, $newitemid); } protected function process_scorm_seq_rulecond_data($data) { global $DB; $data = (object)$data; $oldid = $data->id; $data->scoid = $this->get_new_parentid('scorm_sco'); $data->ruleconditions = $this->get_new_parentid('scorm_seq_ruleconds'); $newitemid = $DB->insert_record('scorm_seq_rulecond', $data); // No need to save this mapping as far as nothing depend on it // (child paths, file areas nor links decoder) } protected function process_scorm_seq_mapinfo($data) { global $DB; $data = (object)$data; $oldid = $data->id; $data->scoid = $this->get_new_parentid('scorm_sco'); $data->objectiveid = $this->get_new_parentid('scorm_seq_objective'); $newitemid = $DB->insert_record('scorm_scoes_data', $data); // No need to save this mapping as far as nothing depend on it // (child paths, file areas nor links decoder) } protected function process_scorm_sco_track($data) { global $DB; $data = (object)$data; $oldid = $data->id; $data->scormid = $this->get_new_parentid('scorm'); $data->scoid = $this->get_new_parentid('scorm_sco'); $data->userid = $this->get_mappingid('user', $data->userid); $newitemid = $DB->insert_record('scorm_scoes_track', $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() { global $DB; // Add scorm related files, no need to match by itemname (just internally handled context) $this->add_related_files('mod_scorm', 'intro', null); $this->add_related_files('mod_scorm', 'content', null); $this->add_related_files('mod_scorm', 'package', null); // Fix launch param in scorm table to use new sco id. $scormid = $this->get_new_parentid('scorm'); $scorm = $DB->get_record('scorm', array('id' => $scormid)); $scorm->launch = $this->get_mappingid('scorm_sco', $scorm->launch, ''); if (!empty($scorm->launch)) { // Check that this sco has a valid launch value. $scolaunch = $DB->get_field('scorm_scoes', 'launch', array('id' => $scorm->launch)); if (empty($scolaunch)) { // This is not a valid sco - set to empty so we can find a valid launch sco. $scorm->launch = ''; } } if (empty($scorm->launch)) { // This scorm has an invalid launch param - we need to calculate it and get the first launchable sco. $sqlselect = 'scorm = ? AND '.$DB->sql_isnotempty('scorm_scoes', 'launch', false, true); // We use get_records here as we need to pass a limit in the query that works cross db. $scoes = $DB->get_records_select('scorm_scoes', $sqlselect, array($scormid), 'sortorder', 'id', 0, 1); if (!empty($scoes)) { $sco = reset($scoes); // We only care about the first record - the above query only returns one. $scorm->launch = $sco->id; } } if (!empty($scorm->launch)) { $DB->update_record('scorm', $scorm); } } }