2 //This file contains all the function needed in the backup utility
3 //except the mod-related funtions that are into every backuplib.php inside
6 //Insert necessary category ids to backup_ids table
7 function insert_category_ids ($course,$backup_unique_code) {
10 $status = execute_sql("INSERT INTO {$CFG->prefix}backup_ids
11 (backup_code, table_name, old_id)
12 SELECT DISTINCT '$backup_unique_code','quiz_categories',t.category
13 FROM {$CFG->prefix}quiz_questions t,
14 {$CFG->prefix}quiz_question_grades g,
16 WHERE q.course = '$course' AND
18 g.question = t.id",false);
22 //Delete category ids from backup_ids table
23 function delete_category_ids ($backup_unique_code) {
26 $status = execute_sql("DELETE FROM {$CFG->prefix}backup_ids
27 WHERE backup_code = '$backup_unique_code'",false);
31 //Calculate the number of users to backup and put their ids in backup_ids
32 //Return an array of info (name,value)
33 function user_check_backup($course,$backup_unique_code,$backup_users) {
34 //$backup_users=0-->all
35 // 1-->course (needed + enrolled)
43 //If we've selected none, simply return 0
44 if ($backup_users == 0 or $backup_users == 1) {
46 //Calculate needed users (calling every xxxx_get_participants function + scales users)
47 $needed_users = backup_get_needed_users($course);
49 //Calculate enrolled users (students + teachers)
50 $enrolled_users = backup_get_enrolled_users($course);
52 //Calculate all users (every record in users table)
53 $all_users = backup_get_all_users();
55 //Calculate course users (needed + enrolled)
57 $course_users = $needed_users;
60 if ($enrolled_users) {
61 foreach ($enrolled_users as $enrolled_user) {
62 $course_users[$enrolled_user->id]->id = $enrolled_user->id;
66 //Now, depending of parameters, create $backupable_users
67 if ($backup_users == 0) {
68 $backupable_users = $all_users;
70 $backupable_users = $course_users;
73 //If we have backupable users
74 if ($backupable_users) {
75 //Iterate over users putting their roles
76 foreach ($backupable_users as $backupable_user) {
77 $backupable_user->info = "";
78 //Is Admin in tables (not is_admin()) !!
79 if (record_exists("user_admins","userid",$backupable_user->id)) {
80 $backupable_user->info .= "admin";
82 //Is Course Creator in tables (not is_coursecreator()) !!
83 if (record_exists("user_coursecreators","userid",$backupable_user->id)) {
84 $backupable_user->info .= "coursecreator";
86 //Is Teacher in tables (not is_teacher()) !!
87 if (record_exists("user_teachers","course",$course,"userid",$backupable_user->id)) {
88 $backupable_user->info .= "teacher";
90 //Is Student in tables (not is_student()) !!
91 if (record_exists("user_students","course",$course,"userid",$backupable_user->id)) {
92 $backupable_user->info .= "student";
94 //Is needed user (exists in needed_users)
95 if (isset($needed_users[$backupable_user->id])) {
96 $backupable_user->info .= "needed";
98 //Now create the backup_id record
99 $backupids_rec->backup_code = $backup_unique_code;
100 $backupids_rec->table_name = "user";
101 $backupids_rec->old_id = $backupable_user->id;
102 $backupids_rec->info = $backupable_user->info;
104 //Insert the record id. backup_users decide it.
106 $status = insert_record("backup_ids",$backupids_rec,false,"backup_code");
116 $info[0][0] = get_string("users");
117 $info[0][1] = $count_users;
122 //Returns every needed user (participant) in a course
123 //It uses the xxxx_get_participants() function
124 //plus users needed to backup scales.
125 //WARNING: It returns only NEEDED users, not every
126 // every student and teacher in the course, so it
127 //must be merged with backup_get_enrrolled_users !!
129 function backup_get_needed_users ($courseid) {
135 $course_modules = get_records_sql ("SELECT cm.id, m.name, cm.instance
136 FROM {$CFG->prefix}modules m,
137 {$CFG->prefix}course_modules cm
138 WHERE m.id = cm.module and
139 cm.course = '$courseid'");
141 if ($course_modules) {
142 //Iterate over each module
143 foreach ($course_modules as $course_module) {
144 $modlib = "$CFG->dirroot/mod/$course_module->name/lib.php";
145 $modgetparticipants = $course_module->name."_get_participants";
146 if (file_exists($modlib)) {
147 include_once($modlib);
148 if (function_exists($modgetparticipants)) {
149 $module_participants = $modgetparticipants($course_module->instance);
151 if ($module_participants) {
152 foreach ($module_participants as $module_participant) {
153 $result[$module_participant->id]->id = $module_participant->id;
161 //Now, add scales users (from site and course scales)
163 $scaleusers = get_records_sql("SELECT DISTINCT userid,userid
164 FROM {$CFG->prefix}scale
165 WHERE courseid = '0' or courseid = '$courseid'");
166 //Add scale users to results
168 foreach ($scaleusers as $scaleuser) {
170 if ($scaleuser->userid != 0) {
171 $result[$scaleuser->userid]->id = $scaleuser->userid;
180 //Returns every enrolled user (student and teacher) in a course
182 function backup_get_enrolled_users ($courseid) {
189 $teachers = get_records_sql("SELECT DISTINCT userid,userid
190 FROM {$CFG->prefix}user_teachers
191 WHERE course = '$courseid'");
193 $students = get_records_sql("SELECT DISTINCT userid,userid
194 FROM {$CFG->prefix}user_students
195 WHERE course = '$courseid'");
198 foreach ($teachers as $teacher) {
199 $result[$teacher->userid]->id = $teacher->userid;
204 foreach ($students as $student) {
205 $result[$student->userid]->id = $student->userid;
212 //Returns all users (every record in users table)
214 function backup_get_all_users() {
221 $users = get_records_sql("SELECT DISTINCT id,id
222 FROM {$CFG->prefix}user");
225 foreach ($users as $user) {
226 $result[$user->id]->id = $user->id;
233 //Calculate the number of log entries to backup
234 //Return an array of info (name,value)
235 function log_check_backup($course) {
239 //Now execute the count
240 $ids = count_records("log","course",$course);
243 $info[0][0] = get_string("logs");
253 //Calculate the number of user files to backup
254 //Under $CFG->dataroot/users
255 //and put them (their path) in backup_ids
256 //Return an array of info (name,value)
257 function user_files_check_backup($course,$backup_unique_code) {
261 $rootdir = $CFG->dataroot."/users";
262 //Check if directory exists
263 if (is_dir($rootdir)) {
264 $coursedirs = get_directory_list($rootdir);
265 foreach ($coursedirs as $dir) {
266 //Extracts user id from file path
267 $tok = strtok($dir,"/");
273 //Look it is a backupable user
274 $data = get_record ("backup_ids","backup_code","$backup_unique_code",
278 //Insert them into backup_files
279 $status = execute_sql("INSERT INTO {$CFG->prefix}backup_files
280 (backup_code, file_type, path, old_id)
282 ('$backup_unique_code','user','$dir','$userid')",false);
289 //Now execute the select
290 $ids = get_records_sql("SELECT DISTINCT b.path, b.old_id
291 FROM {$CFG->prefix}backup_files b
292 WHERE backup_code = '$backup_unique_code' AND
293 file_type = 'user'");
295 $info[0][0] = get_string("files");
297 $info[0][1] = count($ids);
305 //Calculate the number of course files to backup
306 //under $CFG->dataroot/$course, except $CFG->moddata, and backupdata
307 //and put them (their path) in backup_ids
308 //Return an array of info (name,value)
309 function course_files_check_backup($course,$backup_unique_code) {
313 $rootdir = $CFG->dataroot."/$course";
314 //Check if directory exists
315 if (is_dir($rootdir)) {
316 $coursedirs = get_directory_list($rootdir,$CFG->moddata);
317 $backupdata_dir = "backupdata";
318 foreach ($coursedirs as $dir) {
319 //Check it isn't backupdata_dir
320 if (strpos($dir,$backupdata_dir)!==0) {
321 //Insert them into backup_files
322 $status = execute_sql("INSERT INTO {$CFG->prefix}backup_files
323 (backup_code, file_type, path)
325 ('$backup_unique_code','course','$dir')",false);
332 //Now execute the select
333 $ids = get_records_sql("SELECT DISTINCT b.path, b.old_id
334 FROM {$CFG->prefix}backup_files b
335 WHERE backup_code = '$backup_unique_code' AND
336 file_type = 'course'");
338 $info[0][0] = get_string("files");
340 $info[0][1] = count($ids);
348 //Function to check and create the needed moddata dir to
349 //save all the mod backup files. We always name it moddata
350 //to be able to restore it, but in restore we check for
352 function check_and_create_moddata_dir($backup_unique_code) {
356 $status = check_dir_exists($CFG->dataroot."/temp/backup/".$backup_unique_code."/moddata",true);
361 //Function to check and create the "user_files" dir to
362 //save all the user files we need from "users" dir
363 function check_and_create_user_files_dir($backup_unique_code) {
367 $status = check_dir_exists($CFG->dataroot."/temp/backup/".$backup_unique_code."/user_files",true);
372 //Function to check and create the "course_files" dir to
373 //save all the course files we need from "CFG->datadir/course" dir
374 function check_and_create_course_files_dir($backup_unique_code) {
378 $status = check_dir_exists($CFG->dataroot."/temp/backup/".$backup_unique_code."/course_files",true);
383 //Function to create, open and write header of the xml file
384 function backup_open_xml($backup_unique_code) {
392 $file = $CFG->dataroot."/temp/backup/".$backup_unique_code."/moodle.xml";
393 $backup_file = fopen($file,"w");
395 $status = fwrite ($backup_file,"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n");
397 $status = fwrite ($backup_file,start_tag("MOODLE_BACKUP",0,true));
407 function backup_close_xml($backup_file) {
408 $status = fwrite ($backup_file,end_tag("MOODLE_BACKUP",0,true));
409 return fclose($backup_file);
412 //Return the xml start tag
413 function start_tag($tag,$level=0,$endline=false) {
419 return str_repeat(" ",$level*2)."<".strtoupper($tag).">".$endchar;
422 //Return the xml end tag
423 function end_tag($tag,$level=0,$endline=true) {
429 return str_repeat(" ",$level*2)."</".strtoupper($tag).">".$endchar;
432 //Return the start tag, the contents and the end tag
433 function full_tag($tag,$level=0,$endline=true,$content,$to_utf=true) {
434 //Here we encode absolute links
435 $content = backup_encode_absolute_links($content);
436 $st = start_tag($tag,$level,$endline);
439 $co = preg_replace("/\r\n|\r/", "\n", utf8_encode(htmlspecialchars($content)));
441 $co = preg_replace("/\r\n|\r/", "\n", htmlspecialchars($content));
443 $et = end_tag($tag,0,true);
447 //Prints General info about the course
448 //name, moodle_version (internal and release), backup_version, date, info in file...
449 function backup_general_info ($bf,$preferences) {
453 fwrite ($bf,start_tag("INFO",1,true));
455 //The name of the backup
456 fwrite ($bf,full_tag("NAME",2,false,$preferences->backup_name));
458 fwrite ($bf,full_tag("MOODLE_VERSION",2,false,$preferences->moodle_version));
459 fwrite ($bf,full_tag("MOODLE_RELEASE",2,false,$preferences->moodle_release));
461 fwrite ($bf,full_tag("BACKUP_VERSION",2,false,$preferences->backup_version));
462 fwrite ($bf,full_tag("BACKUP_RELEASE",2,false,$preferences->backup_release));
464 fwrite ($bf,full_tag("DATE",2,false,$preferences->backup_unique_code));
465 //The original site wwwroot
466 fwrite ($bf,full_tag("ORIGINAL_WWWROOT",2,false,$CFG->wwwroot));
468 fwrite ($bf,start_tag("DETAILS",2,true));
469 //Now, go to mod element of preferences to print its status
470 foreach ($preferences->mods as $element) {
474 if ($element->backup) {
476 if ($element->userinfo) {
480 //Prints the mod start
481 fwrite ($bf,start_tag("MOD",3,true));
482 fwrite ($bf,full_tag("NAME",4,false,$element->name));
483 fwrite ($bf,full_tag("INCLUDED",4,false,$included));
484 fwrite ($bf,full_tag("USERINFO",4,false,$userinfo));
487 fwrite ($bf,end_tag("MOD",3,true));
490 if ($preferences->backup_users == 1) {
491 fwrite ($bf,full_tag("USERS",3,false,"course"));
492 } else if ($preferences->backup_users == 0) {
493 fwrite ($bf,full_tag("USERS",3,false,"all"));
495 fwrite ($bf,full_tag("USERS",3,false,"none"));
498 if ($preferences->backup_logs == 1) {
499 fwrite ($bf,full_tag("LOGS",3,false,"true"));
501 fwrite ($bf,full_tag("LOGS",3,false,"false"));
504 if ($preferences->backup_user_files == 1) {
505 fwrite ($bf,full_tag("USERFILES",3,false,"true"));
507 fwrite ($bf,full_tag("USERFILES",3,false,"false"));
510 if ($preferences->backup_course_files == 1) {
511 fwrite ($bf,full_tag("COURSEFILES",3,false,"true"));
513 fwrite ($bf,full_tag("COURSEFILES",3,false,"false"));
516 fwrite ($bf,end_tag("DETAILS",2,true));
519 $status = fwrite ($bf,end_tag("INFO",1,true));
524 //Prints course's general info (table course)
525 function backup_course_start ($bf,$preferences) {
532 fwrite ($bf,start_tag("COURSE",1,true));
534 fwrite ($bf,start_tag("HEADER",2,true));
536 //Get info from course
538 if ($courses = get_records("course","id",$preferences->backup_course)) {
539 $course = $courses[$preferences->backup_course];
543 fwrite ($bf,full_tag("ID",3,false,$course->id));
544 //Obtain the category
546 if ($categories = get_records("course_categories","id","$course->category")) {
547 $category = $categories[$course->category];
550 //Prints category info
551 fwrite ($bf,start_tag("CATEGORY",3,true));
552 fwrite ($bf,full_tag("ID",4,false,$course->category));
553 fwrite ($bf,full_tag("NAME",4,false,$category->name));
554 fwrite ($bf,end_tag("CATEGORY",3,true));
556 //Continues with the course
557 fwrite ($bf,full_tag("PASSWORD",3,false,$course->password));
558 fwrite ($bf,full_tag("FULLNAME",3,false,$course->fullname));
559 fwrite ($bf,full_tag("SHORTNAME",3,false,$course->shortname));
560 fwrite ($bf,full_tag("IDNUMBER",3,false,$course->idnumber));
561 fwrite ($bf,full_tag("SUMMARY",3,false,$course->summary));
562 fwrite ($bf,full_tag("FORMAT",3,false,$course->format));
563 fwrite ($bf,full_tag("SHOWGRADES",3,false,$course->showgrades));
564 fwrite ($bf,full_tag("BLOCKINFO",3,false,blocks_get_block_names($course->blockinfo)));
565 fwrite ($bf,full_tag("NEWSITEMS",3,false,$course->newsitems));
566 fwrite ($bf,full_tag("TEACHER",3,false,$course->teacher));
567 fwrite ($bf,full_tag("TEACHERS",3,false,$course->teachers));
568 fwrite ($bf,full_tag("STUDENT",3,false,$course->student));
569 fwrite ($bf,full_tag("STUDENTS",3,false,$course->students));
570 fwrite ($bf,full_tag("GUEST",3,false,$course->guest));
571 fwrite ($bf,full_tag("STARTDATE",3,false,$course->startdate));
572 fwrite ($bf,full_tag("NUMSECTIONS",3,false,$course->numsections));
573 //fwrite ($bf,full_tag("SHOWRECENT",3,false,$course->showrecent)); INFO: This is out in 1.3
574 fwrite ($bf,full_tag("MAXBYTES",3,false,$course->maxbytes));
575 fwrite ($bf,full_tag("SHOWREPORTS",3,false,$course->showreports));
576 fwrite ($bf,full_tag("GROUPMODE",3,false,$course->groupmode));
577 fwrite ($bf,full_tag("GROUPMODEFORCE",3,false,$course->groupmodeforce));
578 fwrite ($bf,full_tag("LANG",3,false,$course->lang));
579 fwrite ($bf,full_tag("MARKER",3,false,$course->marker));
580 fwrite ($bf,full_tag("VISIBLE",3,false,$course->visible));
581 fwrite ($bf,full_tag("HIDDENSECTIONS",3,false,$course->hiddensections));
582 fwrite ($bf,full_tag("TIMECREATED",3,false,$course->timecreated));
583 $status = fwrite ($bf,full_tag("TIMEMODIFIED",3,false,$course->timemodified));
585 fwrite ($bf,end_tag("HEADER",2,true));
593 //Prints course's end tag
594 function backup_course_end ($bf,$preferences) {
597 $status = fwrite ($bf,end_tag("COURSE",1,true));
603 //Prints course's sections info (table course_sections)
604 function backup_course_sections ($bf,$preferences) {
611 //Get info from sections
613 if ($sections = get_records("course_sections","course",$preferences->backup_course,"section")) {
615 fwrite ($bf,start_tag("SECTIONS",2,true));
616 //Iterate over every section (ordered by section)
617 foreach ($sections as $section) {
619 fwrite ($bf,start_tag("SECTION",3,true));
620 fwrite ($bf,full_tag("ID",4,false,$section->id));
621 fwrite ($bf,full_tag("NUMBER",4,false,$section->section));
622 fwrite ($bf,full_tag("SUMMARY",4,false,$section->summary));
623 fwrite ($bf,full_tag("VISIBLE",4,false,$section->visible));
624 //Now print the mods in section
625 backup_course_modules ($bf,$preferences,$section);
627 fwrite ($bf,end_tag("SECTION",3,true));
630 $status = fwrite ($bf,end_tag("SECTIONS",2,true));
637 //Prints course's modules info (table course_modules)
638 //Only for selected mods in preferences
639 function backup_course_modules ($bf,$preferences,$section) {
645 $first_record = true;
647 //Now print the mods in section
648 //Extracts mod id from sequence
649 $tok = strtok($section->sequence,",");
652 $moduletype = get_module_type ($preferences->backup_course,$tok);
653 //Check if we've selected to backup that type
654 if ($moduletype and $preferences->mods[$moduletype]->backup) {
661 //Gets course_module data from db
662 $course_module = get_records ("course_modules","id",$tok);
663 //If it's the first, pring MODS tag
665 fwrite ($bf,start_tag("MODS",4,true));
666 $first_record = false;
668 //Print mod info from course_modules
669 fwrite ($bf,start_tag("MOD",5,true));
670 //Save neccesary info to backup_ids
671 fwrite ($bf,full_tag("ID",6,false,$tok));
672 fwrite ($bf,full_tag("TYPE",6,false,$moduletype));
673 fwrite ($bf,full_tag("INSTANCE",6,false,$course_module[$tok]->instance));
674 fwrite ($bf,full_tag("ADDED",6,false,$course_module[$tok]->added));
675 fwrite ($bf,full_tag("DELETED",6,false,$course_module[$tok]->deleted));
676 fwrite ($bf,full_tag("SCORE",6,false,$course_module[$tok]->score));
677 fwrite ($bf,full_tag("INDENT",6,false,$course_module[$tok]->indent));
678 fwrite ($bf,full_tag("VISIBLE",6,false,$course_module[$tok]->visible));
679 fwrite ($bf,full_tag("GROUPMODE",6,false,$course_module[$tok]->groupmode));
680 fwrite ($bf,end_tag("MOD",5,true));
686 //Si ha habido modulos, final de MODS
687 if (!$first_record) {
688 $status =fwrite ($bf,end_tag("MODS",4,true));
695 //Only users previously calculated in backup_ids will output
697 function backup_user_info ($bf,$preferences) {
703 $users = get_records_sql("SELECT u.old_id, u.table_name,u.info
704 FROM {$CFG->prefix}backup_ids u
705 WHERE u.backup_code = '$preferences->backup_unique_code' AND
706 u.table_name = 'user'");
708 //If we have users to backup
711 fwrite ($bf,start_tag("USERS",2,true));
714 foreach ($users as $user) {
715 //Get user data from table
716 $user_data = get_record("user","id",$user->old_id);
718 fwrite ($bf,start_tag("USER",3,true));
719 //Output all user data
720 fwrite ($bf,full_tag("ID",4,false,$user_data->id));
721 fwrite ($bf,full_tag("CONFIRMED",4,false,$user_data->confirmed));
722 fwrite ($bf,full_tag("DELETED",4,false,$user_data->deleted));
723 fwrite ($bf,full_tag("USERNAME",4,false,$user_data->username));
724 fwrite ($bf,full_tag("PASSWORD",4,false,$user_data->password));
725 fwrite ($bf,full_tag("IDNUMBER",4,false,$user_data->idnumber));
726 fwrite ($bf,full_tag("FIRSTNAME",4,false,$user_data->firstname));
727 fwrite ($bf,full_tag("LASTNAME",4,false,$user_data->lastname));
728 fwrite ($bf,full_tag("EMAIL",4,false,$user_data->email));
729 fwrite ($bf,full_tag("EMAILSTOP",4,false,$user_data->emailstop));
730 fwrite ($bf,full_tag("ICQ",4,false,$user_data->icq));
731 fwrite ($bf,full_tag("PHONE1",4,false,$user_data->phone1));
732 fwrite ($bf,full_tag("PHONE2",4,false,$user_data->phone2));
733 fwrite ($bf,full_tag("INSTITUTION",4,false,$user_data->institution));
734 fwrite ($bf,full_tag("DEPARTMENT",4,false,$user_data->department));
735 fwrite ($bf,full_tag("ADDRESS",4,false,$user_data->address));
736 fwrite ($bf,full_tag("CITY",4,false,$user_data->city));
737 fwrite ($bf,full_tag("COUNTRY",4,false,$user_data->country));
738 fwrite ($bf,full_tag("LANG",4,false,$user_data->lang));
739 fwrite ($bf,full_tag("TIMEZONE",4,false,$user_data->timezone));
740 fwrite ($bf,full_tag("FIRSTACCESS",4,false,$user_data->firstaccess));
741 fwrite ($bf,full_tag("LASTACCESS",4,false,$user_data->lastaccess));
742 fwrite ($bf,full_tag("LASTLOGIN",4,false,$user_data->lastlogin));
743 fwrite ($bf,full_tag("CURRENTLOGIN",4,false,$user_data->currentlogin));
744 fwrite ($bf,full_tag("LASTIP",4,false,$user_data->lastIP));
745 fwrite ($bf,full_tag("SECRET",4,false,$user_data->secret));
746 fwrite ($bf,full_tag("PICTURE",4,false,$user_data->picture));
747 fwrite ($bf,full_tag("URL",4,false,$user_data->url));
748 fwrite ($bf,full_tag("DESCRIPTION",4,false,$user_data->description));
749 fwrite ($bf,full_tag("MAILFORMAT",4,false,$user_data->mailformat));
750 fwrite ($bf,full_tag("MAILDISPLAY",4,false,$user_data->maildisplay));
751 fwrite ($bf,full_tag("HTMLEDITOR",4,false,$user_data->htmleditor));
752 fwrite ($bf,full_tag("AUTOSUBSCRIBE",4,false,$user_data->autosubscribe));
753 fwrite ($bf,full_tag("TIMEMODIFIED",4,false,$user_data->timemodified));
755 //Output every user role (with its associated info)
756 $user->isadmin = strpos($user->info,"admin");
757 $user->iscoursecreator = strpos($user->info,"coursecreator");
758 $user->isteacher = strpos($user->info,"teacher");
759 $user->isstudent = strpos($user->info,"student");
760 $user->isneeded = strpos($user->info,"needed");
761 if ($user->isadmin!==false or
762 $user->iscoursecreator!==false or
763 $user->isteacher!==false or
764 $user->isstudent!==false or
765 $user->isneeded!==false) {
767 fwrite ($bf,start_tag("ROLES",4,true));
770 if ($user->isadmin!==false) {
772 fwrite ($bf,start_tag("ROLE",5,true));
774 fwrite ($bf,full_tag("TYPE",6,false,"admin"));
776 fwrite ($bf,end_tag("ROLE",5,true));
779 if ($user->iscoursecreator!==false) {
781 fwrite ($bf,start_tag("ROLE",5,true));
783 fwrite ($bf,full_tag("TYPE",6,false,"coursecreator"));
785 fwrite ($bf,end_tag("ROLE",5,true));
788 if ($user->isteacher!==false) {
790 fwrite ($bf,start_tag("ROLE",5,true));
792 fwrite ($bf,full_tag("TYPE",6,false,"teacher"));
793 //Get specific info for teachers
794 $tea = get_record("user_teachers","userid",$user->old_id,"course",$preferences->backup_course);
795 fwrite ($bf,full_tag("AUTHORITY",6,false,$tea->authority));
796 fwrite ($bf,full_tag("TEA_ROLE",6,false,$tea->role));
797 fwrite ($bf,full_tag("EDITALL",6,false,$tea->editall));
798 fwrite ($bf,full_tag("TIMESTART",6,false,$tea->timestart));
799 fwrite ($bf,full_tag("TIMEEND",6,false,$tea->timeend));
800 fwrite ($bf,full_tag("TIMEMODIFIED",6,false,$tea->timemodified));
801 fwrite ($bf,full_tag("TIMEACCESS",6,false,$tea->timeaccess));
803 fwrite ($bf,end_tag("ROLE",5,true));
806 if ($user->isstudent!==false) {
808 fwrite ($bf,start_tag("ROLE",5,true));
810 fwrite ($bf,full_tag("TYPE",6,false,"student"));
811 //Get specific info for students
812 $stu = get_record("user_students","userid",$user->old_id,"course",$preferences->backup_course);
813 fwrite ($bf,full_tag("TIMESTART",6,false,$stu->timestart));
814 fwrite ($bf,full_tag("TIMEEND",6,false,$stu->timeend));
815 fwrite ($bf,full_tag("TIME",6,false,$stu->time));
816 fwrite ($bf,full_tag("TIMEACCESS",6,false,$stu->timeaccess));
818 fwrite ($bf,end_tag("ROLE",5,true));
821 if ($user->isneeded!==false) {
823 fwrite ($bf,start_tag("ROLE",5,true));
825 fwrite ($bf,full_tag("TYPE",6,false,"needed"));
827 fwrite ($bf,end_tag("ROLE",5,true));
831 fwrite ($bf,end_tag("ROLES",4,true));
833 //Check if we have user_preferences to backup
834 if ($preferences_data = get_records("user_preferences","userid",$user->old_id)) {
835 //Start USER_PREFERENCES tag
836 fwrite ($bf,start_tag("USER_PREFERENCES",4,true));
837 //Write each user_preference
838 foreach ($preferences_data as $user_preference) {
839 fwrite ($bf,start_tag("USER_PREFERENCE",5,true));
840 fwrite ($bf,full_tag("NAME",6,false,$user_preference->name));
841 fwrite ($bf,full_tag("VALUE",6,false,$user_preference->value));
842 fwrite ($bf,end_tag("USER_PREFERENCE",5,true));
844 //End USER_PREFERENCES tag
845 fwrite ($bf,end_tag("USER_PREFERENCES",4,true));
850 fwrite ($bf,end_tag("USER",3,true));
853 if ($counter % 10 == 0) {
855 if ($counter % 200 == 0) {
862 fwrite ($bf,end_tag("USERS",2,true));
864 // There aren't any users.
871 //Backup log info (time ordered)
872 function backup_log_info($bf,$preferences) {
876 //Number of records to get in every chunk
877 $recordset_size = 1000;
881 //Counter, points to current record
885 $count_logs = count_records("log","course",$preferences->backup_course);
888 if ($count_logs > 0 ) {
889 fwrite ($bf,start_tag("LOGS",2,true));
891 while ($counter < $count_logs) {
892 //Get a chunk of records
893 $logs = get_records ("log","course",$preferences->backup_course,"time","*",$counter,$recordset_size);
898 foreach ($logs as $log) {
899 //See if it is a valid module to backup
900 if ($log->module == "course" or
901 $log->module == "user" or
902 $preferences->mods[$log->module]->backup == 1) {
904 fwrite ($bf,start_tag("LOG",3,true));
907 fwrite ($bf,full_tag("ID",4,false,$log->id));
908 fwrite ($bf,full_tag("TIME",4,false,$log->time));
909 fwrite ($bf,full_tag("USERID",4,false,$log->userid));
910 fwrite ($bf,full_tag("IP",4,false,$log->ip));
911 fwrite ($bf,full_tag("MODULE",4,false,$log->module));
912 fwrite ($bf,full_tag("CMID",4,false,$log->cmid));
913 fwrite ($bf,full_tag("ACTION",4,false,$log->action));
914 fwrite ($bf,full_tag("URL",4,false,$log->url));
915 fwrite ($bf,full_tag("INFO",4,false,$log->info));
918 fwrite ($bf,end_tag("LOG",3,true));
922 if ($counter % 10 == 0) {
924 if ($counter % 200 == 0) {
933 if ($count_logs > 0 ) {
934 $status = fwrite ($bf,end_tag("LOGS",2,true));
940 //Backup scales info (common and course scales)
941 function backup_scales_info($bf,$preferences) {
947 //Counter, points to current record
950 //Get scales (common and course scales)
951 $scales = get_records_sql("SELECT id, courseid, userid, name, scale, description, timemodified
952 FROM {$CFG->prefix}scale
953 WHERE courseid = '0' or courseid = $preferences->backup_course");
955 //Copy only used scales to $backupscales. They will be in backup (unused no). See Bug 1223.
956 $backupscales = array();
958 foreach ($scales as $scale) {
959 if (course_scale_used($preferences->backup_course, $scale->id)) {
960 $backupscales[] = $scale;
965 //Pring scales header
967 //Pring scales header
968 fwrite ($bf,start_tag("SCALES",2,true));
970 foreach ($backupscales as $scale) {
972 fwrite ($bf,start_tag("SCALE",3,true));
974 fwrite ($bf,full_tag("ID",4,false,$scale->id));
975 fwrite ($bf,full_tag("COURSEID",4,false,$scale->courseid));
976 fwrite ($bf,full_tag("USERID",4,false,$scale->userid));
977 fwrite ($bf,full_tag("NAME",4,false,$scale->name));
978 fwrite ($bf,full_tag("SCALETEXT",4,false,$scale->scale));
979 fwrite ($bf,full_tag("DESCRIPTION",4,false,$scale->description));
980 fwrite ($bf,full_tag("TIMEMODIFIED",4,false,$scale->timemodified));
982 fwrite ($bf,end_tag("SCALE",3,true));
985 $status = fwrite ($bf,end_tag("SCALES",2,true));
990 //Backup events info (course events)
991 function backup_events_info($bf,$preferences) {
997 //Counter, points to current record
1000 //Get events (course events)
1001 $events = get_records_select("event","courseid='$preferences->backup_course' AND instance='0'","id");
1003 //Pring events header
1005 //Pring events header
1006 fwrite ($bf,start_tag("EVENTS",2,true));
1008 foreach ($events as $event) {
1010 fwrite ($bf,start_tag("EVENT",3,true));
1012 fwrite ($bf,full_tag("ID",4,false,$event->id));
1013 fwrite ($bf,full_tag("NAME",4,false,$event->name));
1014 fwrite ($bf,full_tag("DESCRIPTION",4,false,$event->description));
1015 fwrite ($bf,full_tag("FORMAT",4,false,$event->format));
1016 fwrite ($bf,full_tag("GROUPID",4,false,$event->groupid));
1017 fwrite ($bf,full_tag("USERID",4,false,$event->userid));
1018 fwrite ($bf,full_tag("EVENTTYPE",4,false,$event->eventtype));
1019 fwrite ($bf,full_tag("TIMESTART",4,false,$event->timestart));
1020 fwrite ($bf,full_tag("TIMEDURATION",4,false,$event->timeduration));
1021 fwrite ($bf,full_tag("VISIBLE",4,false,$event->visible));
1022 fwrite ($bf,full_tag("TIMEMODIFIED",4,false,$event->timemodified));
1024 fwrite ($bf,end_tag("EVENT",3,true));
1027 $status = fwrite ($bf,end_tag("EVENTS",2,true));
1032 //Backup groups info
1033 function backup_groups_info($bf,$preferences) {
1041 $groups = get_records("groups","courseid",$preferences->backup_course);
1043 //Pring groups header
1045 //Pring groups header
1046 fwrite ($bf,start_tag("GROUPS",2,true));
1048 foreach ($groups as $group) {
1050 fwrite ($bf,start_tag("GROUP",3,true));
1051 //Output group contents
1052 fwrite ($bf,full_tag("ID",4,false,$group->id));
1053 fwrite ($bf,full_tag("COURSEID",4,false,$group->courseid));
1054 fwrite ($bf,full_tag("NAME",4,false,$group->name));
1055 fwrite ($bf,full_tag("DESCRIPTION",4,false,$group->description));
1056 fwrite ($bf,full_tag("LANG",4,false,$group->lang));
1057 fwrite ($bf,full_tag("PICTURE",4,false,$group->picture));
1058 fwrite ($bf,full_tag("HIDEPICTURE",4,false,$group->hidepicture));
1059 fwrite ($bf,full_tag("TIMECREATED",4,false,$group->timecreated));
1060 fwrite ($bf,full_tag("TIMEMODIFIED",4,false,$group->timemodified));
1062 //Now, backup groups_members
1063 $status2 = backup_groups_members_info($bf,$preferences,$group->id);
1066 fwrite ($bf,end_tag("GROUP",3,true));
1069 $status = fwrite ($bf,end_tag("GROUPS",2,true));
1071 return ($status && $status2);
1074 //Backup groups_members info
1075 function backup_groups_members_info($bf,$preferences,$groupid) {
1081 //Get groups_members
1082 $groups_members = get_records("groups_members","groupid",$groupid);
1084 //Pring groups_members header
1085 if ($groups_members) {
1086 //Pring groups_members header
1087 fwrite ($bf,start_tag("MEMBERS",4,true));
1089 foreach ($groups_members as $group_member) {
1090 //Begin group_member tag
1091 fwrite ($bf,start_tag("MEMBER",5,true));
1092 //Output group_member contents
1093 fwrite ($bf,full_tag("USERID",6,false,$group_member->userid));
1094 fwrite ($bf,full_tag("TIMEADDED",6,false,$group_member->timeadded));
1095 //End group_member tag
1096 fwrite ($bf,end_tag("MEMBER",5,true));
1098 //End groups_members tag
1099 $status = fwrite ($bf,end_tag("MEMBERS",4,true));
1104 //Start the modules tag
1105 function backup_modules_start ($bf,$preferences) {
1107 return fwrite ($bf,start_tag("MODULES",2,true));
1110 //End the modules tag
1111 function backup_modules_end ($bf,$preferences) {
1113 return fwrite ($bf,end_tag("MODULES",2,true));
1116 //This function makes all the necesary calls to every mod
1117 //to export itself and its files !!!
1118 function backup_module($bf,$preferences,$module) {
1124 //First, re-check if necessary functions exists
1125 $modbackup = $module."_backup_mods";
1126 if (function_exists($modbackup)) {
1128 $status = $modbackup($bf,$preferences);
1130 //Something was wrong. Function should exist.
1138 //This function encode things to make backup multi-site fully functional
1139 //It does this conversions:
1140 // - $CFG->wwwroot/file.php/courseid ----------------------> $@FILEPHP@$
1141 // - Links to forums everywhere (DB) are encoded.
1143 function backup_encode_absolute_links($content) {
1145 global $CFG,$preferences;
1147 //Check if preferences is ok. If it isn't set, we are
1148 //in a scheduled_backup to we are able to get a copy
1149 //from CFG->backup_preferences
1150 if (!isset($preferences)) {
1151 $mypreferences = $CFG->backup_preferences;
1153 //We are in manual backups so global preferences must exist!!
1154 $mypreferences = $preferences;
1157 //First, we check for every call to file.php inside the course
1158 $search = array($CFG->wwwroot."/file.php/".$mypreferences->backup_course);
1160 $replace = array("$@FILEPHP@$");
1162 $result = str_replace($search,$replace,$content);
1164 foreach ($mypreferences->mods as $name => $info) {
1165 //Check if the xxxx_encode_content_links exists
1166 $function_name = $name."_encode_content_links";
1167 if (function_exists($function_name)) {
1168 $result = $function_name($result,$mypreferences);
1172 if ($result != $content && $CFG->debug>7) { //Debug
1173 echo "<br><hr>".$content."<br>changed to<br>".$result."<hr><br>"; //Debug
1179 //This function copies all the needed files under the "users" directory to the "user_files"
1180 //directory under temp/backup
1181 function backup_copy_user_files ($preferences) {
1187 //First we check to "user_files" exists and create it as necessary
1188 //in temp/backup/$backup_code dir
1189 $status = check_and_create_user_files_dir($preferences->backup_unique_code);
1191 //Now iterate over directories under "users" to check if that user must be
1194 $rootdir = $CFG->dataroot."/users";
1195 //Check if directory exists
1196 if (is_dir($rootdir)) {
1197 $list = list_directories ($rootdir);
1200 foreach ($list as $dir) {
1201 //Look for dir like username in backup_ids
1202 $data = get_record ("backup_ids","backup_code",$preferences->backup_unique_code,
1203 "table_name","user",
1205 //If exists, copy it
1207 $status = backup_copy_file($rootdir."/".$dir,
1208 $CFG->dataroot."/temp/backup/".$preferences->backup_unique_code."/user_files/".$dir);
1216 //This function copies all the course files under the course directory (except the moddata
1217 //directory to the "course_files" directory under temp/backup
1218 function backup_copy_course_files ($preferences) {
1224 //First we check to "course_files" exists and create it as necessary
1225 //in temp/backup/$backup_code dir
1226 $status = check_and_create_course_files_dir($preferences->backup_unique_code);
1228 //Now iterate over files and directories except $CFG->moddata and backupdata to be
1231 $rootdir = $CFG->dataroot."/".$preferences->backup_course;
1233 $name_moddata = $CFG->moddata;
1234 $name_backupdata = "backupdata";
1235 //Check if directory exists
1236 if (is_dir($rootdir)) {
1237 $list = list_directories_and_files ($rootdir);
1240 foreach ($list as $dir) {
1241 if ($dir !== $name_moddata and $dir !== $name_backupdata) {
1242 $status = backup_copy_file($rootdir."/".$dir,
1243 $CFG->dataroot."/temp/backup/".$preferences->backup_unique_code."/course_files/".$dir);
1251 //This function creates the zip file containing all the backup info
1252 //moodle.xml, moddata, user_files, course_files.
1253 //The zipped file is created in the backup directory and named with
1254 //the "oficial" name of the backup
1255 //It uses "pclzip" if available or system "zip" (unix only)
1256 function backup_zip ($preferences) {
1262 //Base dir where everything happens
1263 $basedir = $CFG->dataroot."/temp/backup/".$preferences->backup_unique_code;
1264 //Backup zip file name
1265 $name = $preferences->backup_name;
1266 //List base_dir files and directories
1267 $filelist = list_directories_and_files ($basedir);
1269 if (empty($CFG->zip)) { // Use built-in php-based zip function
1270 //echo "<br>Using pclzip"; //Debug
1272 foreach ($filelist as $file) {
1273 //If directory, append "/"
1274 //Commented. Not needed wit version 2.0 of pclzip !!
1275 //if (is_dir($basedir."/".$file)) {
1276 // $file = $file."/";
1278 //Include into array
1279 //echo "<br>Adding file/dir ".$file; //Debug
1280 $files[] = $basedir."/".$file;
1282 include_once("$CFG->dirroot/lib/pclzip/pclzip.lib.php");
1283 //include_once("$CFG->dirroot/lib/pclzip/pclerror.lib.php"); //Debug
1284 //include_once("$CFG->dirroot/lib/pclzip/pcltrace.lib.php"); //Debug
1285 //PclTraceOn(2); //Debug
1286 $archive = new PclZip("$basedir/$name");
1287 if (($list = $archive->create($files,PCLZIP_OPT_REMOVE_PATH,$basedir)) == 0) {
1288 error($archive->errorInfo(true));
1291 //PclTraceDisplay(); //Debug
1292 //PclTraceOff(); //Debug
1293 } else { // Use external zip program
1294 //echo "<br>Using external zip"; //Debug
1296 foreach ($filelist as $file) {
1297 $files .= basename($file);
1300 $command = "cd $basedir ; $CFG->zip -r $name $files";
1301 //echo "<br>Executing command: ".$command; //Debug
1302 $status = Exec($command);
1305 //echo "<br>Status: ".$status; //Debug
1310 //This function copies the final zip to the course dir
1311 function copy_zip_to_course_dir ($preferences) {
1317 //Define zip location (from)
1318 $from_zip_file = $CFG->dataroot."/temp/backup/".$preferences->backup_unique_code."/".$preferences->backup_name;
1320 //Initialise $to_zip_file
1323 //If $preferences->backup_destination isn't empty, then copy to custom directory
1324 if (!empty($preferences->backup_destination)) {
1325 $to_zip_file = $preferences->backup_destination."/".$preferences->backup_name;
1327 //Define zip destination (course dir)
1328 $to_zip_file = $CFG->dataroot."/".$preferences->backup_course;
1330 //echo "<p>From: ".$from_zip_file."<br>"; //Debug
1332 //echo "<p>Checking: ".$to_zip_file."<br>"; //Debug
1334 //Checks course dir exists
1335 $status = check_dir_exists($to_zip_file,true);
1337 //Define zip destination (backup dir)
1338 $to_zip_file = $to_zip_file."/backupdata";
1340 //echo "<p>Checking: ".$to_zip_file."<br>"; //Debug
1342 //Checks backup dir exists
1343 $status = check_dir_exists($to_zip_file,true);
1345 //Define zip destination (zip file)
1346 $to_zip_file = $to_zip_file."/".$preferences->backup_name;
1349 //echo "<p>To: ".$to_zip_file."<br>"; //Debug
1353 $status = backup_copy_file ($from_zip_file,$to_zip_file);