mirror of
https://github.com/moodle/moodle.git
synced 2025-02-21 01:48:45 +01:00
190 lines
8.8 KiB
PHP
190 lines
8.8 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/>.
|
|
|
|
/**
|
|
* This file contains the backup structure for the lesson module
|
|
*
|
|
* This is the "graphical" structure of the lesson module:
|
|
*
|
|
* lesson ------------>---------------|-------------->-----------|------------->------------|
|
|
* (CL,pk->id) | | |
|
|
* | | | |
|
|
* | lesson_grades lesson_high_scores lesson_timer
|
|
* | (UL, pk->id,fk->lessonid) (UL, pk->id,fk->lessonid) (UL, pk->id,fk->lessonid)
|
|
* | |
|
|
* | |
|
|
* | |
|
|
* | |
|
|
* lesson_pages----------->---------lesson_branch
|
|
* (CL,pk->id,fk->lessonid) (UL, pk->id,fk->pageid)
|
|
* |
|
|
* |
|
|
* |
|
|
* lesson_answers
|
|
* (CL,pk->id,fk->pageid)
|
|
* |
|
|
* |
|
|
* |
|
|
* lesson_attempts
|
|
* (UL,pk->id,fk->answerid)
|
|
*
|
|
* Meaning: pk->primary key field of the table
|
|
* fk->foreign key to link with parent
|
|
* nt->nested field (recursive data)
|
|
* CL->course level info
|
|
* UL->user level info
|
|
* files->table may have files)
|
|
*
|
|
* @package moodlecore
|
|
* @copyright 2010 Sam Hemelryk
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
|
|
/**
|
|
* Structure step class that informs a backup task how to backup the lesson module.
|
|
*
|
|
* @copyright 2010 Sam Hemelryk
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
class backup_lesson_activity_structure_step extends backup_activity_structure_step {
|
|
|
|
protected function define_structure() {
|
|
|
|
// The lesson table
|
|
// This table contains all of the goodness for the lesson module, quite
|
|
// alot goes into it but nothing relational other than course when will
|
|
// need to be corrected upon restore
|
|
$lesson = new backup_nested_element('lesson', array('id'), array(
|
|
'course','name','practice','modattempts','usepassword','password',
|
|
'dependency','conditions','grade','custom','ongoing','usemaxgrade',
|
|
'maxanswers','maxattempts','review','nextpagedefault','feedback',
|
|
'minquestions','maxpages','timed','maxtime','retake','activitylink',
|
|
'mediafile','mediaheight','mediawidth','mediaclose','slideshow',
|
|
'width','height','bgcolor','displayleft','displayleftif','progressbar',
|
|
'highscores','maxhighscores','available','deadline','timemodified'
|
|
));
|
|
|
|
// The lesson_pages table
|
|
// Grouped within a `pages` element, important to note that page is relational
|
|
// to the lesson, and also to the previous/next page in the series.
|
|
// Upon restore prevpageid and nextpageid will need to be corrected.
|
|
$pages = new backup_nested_element('pages');
|
|
$page = new backup_nested_element('page', array('id'), array(
|
|
'prevpageid','nextpageid','qtype','qoption','layout',
|
|
'display','timecreated','timemodified','title','contents'
|
|
));
|
|
|
|
// The lesson_answers table
|
|
// Grouped within an answers `element`, the lesson_answers table relates
|
|
// to the page and lesson with `pageid` and `lessonid` that will both need
|
|
// to be corrected during restore.
|
|
$answers = new backup_nested_element('answers');
|
|
$answer = new backup_nested_element('answer', array('id'), array(
|
|
'jumpto','grade','score','flags','timecreated','timemodified','answer_text',
|
|
'response'
|
|
));
|
|
// Tell the answer element about the answer_text elements mapping to the answer
|
|
// database field.
|
|
$answer->set_source_alias('answer', 'answer_text');
|
|
|
|
// The lesson_attempts table
|
|
// Grouped by an `attempts` element this is relational to the page, lesson,
|
|
// and user.
|
|
$attempts = new backup_nested_element('attempts');
|
|
$attempt = new backup_nested_element('attempt', array('id'), array(
|
|
'userid','retry','correct','useranswer','timeseen'
|
|
));
|
|
|
|
// The lesson_branch table
|
|
// Grouped by a `branch` element this is relational to the page, lesson,
|
|
// and user.
|
|
$branches = new backup_nested_element('branches');
|
|
$branch = new backup_nested_element('branch', array('id'), array(
|
|
'userid','retry','flag','timeseen'
|
|
));
|
|
|
|
// The lesson_grades table
|
|
// Grouped by a grades element this is relational to the lesson and user.
|
|
$grades = new backup_nested_element('grades');
|
|
$grade = new backup_nested_element('grade', array('id'), array(
|
|
'userid','grade','late','completed'
|
|
));
|
|
|
|
// The lesson_high_scores table
|
|
// Grouped by a highscores element this is relational to the lesson, user,
|
|
// and possibly a grade.
|
|
$highscores = new backup_nested_element('highscores');
|
|
$highscore = new backup_nested_element('highscore', array('id'), array(
|
|
'gradeid','userid','nickname'
|
|
));
|
|
|
|
// The lesson_timer table
|
|
// Grouped by a `timers` element this is relational to the lesson and user.
|
|
$timers = new backup_nested_element('timers');
|
|
$timer = new backup_nested_element('timer', array('id'), array(
|
|
'userid','starttime','lessontime'
|
|
));
|
|
|
|
// Now that we have all of the elements created we've got to put them
|
|
// together correctly.
|
|
$lesson->add_child($pages);
|
|
$pages->add_child($page);
|
|
$page->add_child($answers);
|
|
$answers->add_child($answer);
|
|
$answer->add_child($attempts);
|
|
$attempts->add_child($attempt);
|
|
$page->add_child($branches);
|
|
$branches->add_child($branch);
|
|
$lesson->add_child($grades);
|
|
$grades->add_child($grade);
|
|
$lesson->add_child($highscores);
|
|
$highscores->add_child($highscore);
|
|
$lesson->add_child($timers);
|
|
$timers->add_child($timer);
|
|
|
|
// Set the source table for the elements that aren't reliant on the user
|
|
// at this point (lesson, lesson_pages, lesson_answers)
|
|
$lesson->set_source_table('lesson', array('id' => backup::VAR_ACTIVITYID));
|
|
$page->set_source_table('lesson_pages', array('lessonid' => backup::VAR_PARENTID));
|
|
$answer->set_source_table('lesson_answers', array('pageid' => backup::VAR_PARENTID));
|
|
|
|
// Check if we are also backing up user information
|
|
if ($this->get_setting_value('userinfo')) {
|
|
// Set the source table for elements that are reliant on the user
|
|
// lesson_attempts, lesson_branch, lesson_grades, lesson_high_scores, lesson_timer
|
|
$attempt->set_source_table('lesson_attempts', array('answerid' => backup::VAR_PARENTID));
|
|
$branch->set_source_table('lesson_branch', array('pageid' => backup::VAR_PARENTID));
|
|
$grade->set_source_table('lesson_grades', array('lessonid'=>backup::VAR_PARENTID));
|
|
$highscore->set_source_table('lesson_high_scores', array('lessonid' => backup::VAR_PARENTID));
|
|
$timer->set_source_table('lesson_timer', array('lessonid' => backup::VAR_PARENTID));
|
|
}
|
|
|
|
// Annotate the user id's where required.
|
|
$attempt->annotate_ids('user', 'userid');
|
|
$branch->annotate_ids('user', 'userid');
|
|
$grade->annotate_ids('user', 'userid');
|
|
$highscore->annotate_ids('user', 'userid');
|
|
$timer->annotate_ids('user', 'userid');
|
|
|
|
// Annotate the file areas in user by the lesson module.
|
|
$lesson->annotate_files(array('lesson_media_file'), 'id');
|
|
$page->annotate_files(array('lesson_page_contents'), 'id');
|
|
|
|
// Prepare and return the structure we have just created for the lesson module.
|
|
return $this->prepare_activity_structure($lesson);
|
|
}
|
|
} |