Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.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 backup steps that will be used by the backup_scorm_activity_task
 */

/**
 * Define the complete scorm structure for backup, with file and id annotations
 */
class backup_scorm_activity_structure_step extends backup_activity_structure_step {

    protected function define_structure() {

        // To know if we are including userinfo
        $userinfo = $this->get_setting_value('userinfo');

        // Define each element separated
        $scorm = new backup_nested_element('scorm', array('id'), array(
            'name', 'scormtype', 'reference', 'intro',
            'introformat', 'version', 'maxgrade', 'grademethod',
            'whatgrade', 'maxattempt', 'forcecompleted', 'forcenewattempt',
            'lastattemptlock', 'masteryoverride', 'displayattemptstatus', 'displaycoursestructure', 'updatefreq',
            'sha1hash', 'md5hash', 'revision', 'launch',
            'skipview', 'hidebrowse', 'hidetoc', 'nav', 'navpositionleft', 'navpositiontop',
            'auto', 'popup', 'options', 'width',
            'height', 'timeopen', 'timeclose', 'timemodified',
            'completionstatusrequired', 'completionscorerequired',
< 'completionstatusallscos', 'displayactivityname',
> 'completionstatusallscos',
'autocommit')); $scoes = new backup_nested_element('scoes'); $sco = new backup_nested_element('sco', array('id'), array( 'manifest', 'organization', 'parent', 'identifier', 'launch', 'scormtype', 'title', 'sortorder')); $scodatas = new backup_nested_element('sco_datas'); $scodata = new backup_nested_element('sco_data', array('id'), array( 'name', 'value')); $seqruleconds = new backup_nested_element('seq_ruleconds'); $seqrulecond = new backup_nested_element('seq_rulecond', array('id'), array( 'conditioncombination', 'ruletype', 'action')); $seqrulecondsdatas = new backup_nested_element('seq_rulecond_datas'); $seqrulecondsdata = new backup_nested_element('seq_rulecond_data', array('id'), array( 'refrencedobjective', 'measurethreshold', 'operator', 'cond')); $seqrolluprules = new backup_nested_element('seq_rolluprules'); $seqrolluprule = new backup_nested_element('seq_rolluprule', array('id'), array( 'childactivityset', 'minimumcount', 'minimumpercent', 'conditioncombination', 'action')); $seqrollupruleconds = new backup_nested_element('seq_rollupruleconds'); $seqrolluprulecond = new backup_nested_element('seq_rolluprulecond', array('id'), array( 'cond', 'operator')); $seqobjectives = new backup_nested_element('seq_objectives'); $seqobjective = new backup_nested_element('seq_objective', array('id'), array( 'primaryobj', 'objectiveid', 'satisfiedbymeasure', 'minnormalizedmeasure')); $seqmapinfos = new backup_nested_element('seq_mapinfos'); $seqmapinfo = new backup_nested_element('seq_mapinfo', array('id'), array( 'targetobjectiveid', 'readsatisfiedstatus', 'readnormalizedmeasure', 'writesatisfiedstatus', 'writenormalizedmeasure')); $scotracks = new backup_nested_element('sco_tracks'); $scotrack = new backup_nested_element('sco_track', array('id'), array( 'userid', 'attempt', 'element', 'value', 'timemodified')); // Build the tree $scorm->add_child($scoes); $scoes->add_child($sco); $sco->add_child($scodatas); $scodatas->add_child($scodata); $sco->add_child($seqruleconds); $seqruleconds->add_child($seqrulecond); $seqrulecond->add_child($seqrulecondsdatas); $seqrulecondsdatas->add_child($seqrulecondsdata); $sco->add_child($seqrolluprules); $seqrolluprules->add_child($seqrolluprule); $seqrolluprule->add_child($seqrollupruleconds); $seqrollupruleconds->add_child($seqrolluprulecond); $sco->add_child($seqobjectives); $seqobjectives->add_child($seqobjective); $seqobjective->add_child($seqmapinfos); $seqmapinfos->add_child($seqmapinfo); $sco->add_child($scotracks); $scotracks->add_child($scotrack); // Define sources $scorm->set_source_table('scorm', array('id' => backup::VAR_ACTIVITYID)); // Order is important for several SCORM calls (especially scorm_scoes) in the following calls to set_source_table $sco->set_source_table('scorm_scoes', array('scorm' => backup::VAR_PARENTID), 'sortorder, id'); $scodata->set_source_table('scorm_scoes_data', array('scoid' => backup::VAR_PARENTID), 'id ASC'); $seqrulecond->set_source_table('scorm_seq_ruleconds', array('scoid' => backup::VAR_PARENTID), 'id ASC'); $seqrulecondsdata->set_source_table('scorm_seq_rulecond', array('ruleconditionsid' => backup::VAR_PARENTID), 'id ASC'); $seqrolluprule->set_source_table('scorm_seq_rolluprule', array('scoid' => backup::VAR_PARENTID), 'id ASC'); $seqrolluprulecond->set_source_table('scorm_seq_rolluprulecond', array('rollupruleid' => backup::VAR_PARENTID), 'id ASC'); $seqobjective->set_source_table('scorm_seq_objective', array('scoid' => backup::VAR_PARENTID), 'id ASC'); $seqmapinfo->set_source_table('scorm_seq_mapinfo', array('objectiveid' => backup::VAR_PARENTID), 'id ASC'); // All the rest of elements only happen if we are including user info if ($userinfo) { $scotrack->set_source_table('scorm_scoes_track', array('scoid' => backup::VAR_PARENTID), 'id ASC'); } // Define id annotations $scotrack->annotate_ids('user', 'userid'); // Define file annotations $scorm->annotate_files('mod_scorm', 'intro', null); // This file area hasn't itemid $scorm->annotate_files('mod_scorm', 'content', null); // This file area hasn't itemid $scorm->annotate_files('mod_scorm', 'package', null); // This file area hasn't itemid // Return the root element (scorm), wrapped into standard activity structure return $this->prepare_activity_structure($scorm); } }