diff --git a/backup/bb/README.txt b/backup/bb/README.txt new file mode 100644 index 00000000000..e19a3c9aa38 --- /dev/null +++ b/backup/bb/README.txt @@ -0,0 +1,73 @@ +Ziba Scott 11/19/04 + +This is a beta demonstration of a utility to convert Blackboard +Course export zip files into Moodle course export zip files. It +has been successfully tested with Blackboard 5.5 and +Moodle 1.4.1 and Moodle CVS. There is minimal Blackboard 6 support. +It will convert: + + * Course Name/Title + * Forum Topics + * Course Documents + * Assignments + * External Links + +The current status of this project is +exploration/proof-of-concept. We have successfully converted +basic Blackboard course information as well as course documents +and forum topics using the XSLT methods described above. + +AUTOMATED OPERATION: + + REQUIREMENTS FOR WEB INTERFACE: + *Moodle 1.4.1 or greater + *PHP compiled with --enable-xslt --with-xslt-sablot options + (Check php.net for instructions on enabling xslt for your platform) + + INSTALLATION: + *Unpack this file into the "backup" directory + + + +MANUAL OPERATION: + + REQUIREMENTS: + + *An XSLT 1.0 processor (like Sablotron) + *A zipping utility + + REQUIREMENTS FOR WEB INTERFACE: + + *Linux/Unix + *PHP compiled with --enable-xslt --with-xslt-sablot options. + *Apache with write access to /tmp + *A commandline zipping utility + + COMMAND LINE INSTRUCTIONS: + + 1) Download and uncompress the Blackboard export into a directory. + + 2) Copy bb2moodle.xslt into the Blackboard course directory. + + 3) Run your XSLT processor on imsmanifest.xml with bb2moodle.xslt + as the input and moodle.xml as the output. If you are using + Sablotron on linux, this command will look like this: + sabcmd bb2moodle.xslt imsmanifest.xml > moodle.xml + + 4) Create a moodle zip file with this structure: + moodle.xml + user_files/ + course_files/ + + 5) Copy every subdirectory and its contents from the Blackboard + export directory into the course_files directory. This does + not include the Blackboard XML files, only the course + documents. Your moodle zip file will now look similar to + this: + moodle.xml + user_files/ + course_files/res0009/myfile.doc + course_files/res0010/myotherfile.doc + course_files/res0010/mypicture.jpg + + 6) Upload and restore your moodle zip file diff --git a/backup/bb/bb5.5_to_moodle.xsl b/backup/bb/bb5.5_to_moodle.xsl new file mode 100644 index 00000000000..bf87485d8ba --- /dev/null +++ b/backup/bb/bb5.5_to_moodle.xsl @@ -0,0 +1,737 @@ + + + + + + backup-from-blackboard.zip + 2004083100 + 1.4 + 2004083100 + 1.4 + 1094240862 + INSERT URL HERE +
+ + assignment + true + true + + + chat + true + true + + + choice + true + true + + + forum + true + true + + + glossary + true + true + + + journal + true + true + + + label + true + true + + + lesson + true + true + + + quiz + true + true + + + resource + true + true + + + scorm + true + true + + + survey + true + true + + + wiki + true + true + + + workshop + true + true + + course + false + true + true +
+ + + + + + + + + + + + + + + + + + + false + + + + + + + + + + + + true + + + + + + + + + + + + + + +
+ 2 + + + + + + 4 + topics + 1 + participants,activity_modules,search_forums,admin,course_list:news_items,calendar_upcoming,recent_activity + 5 + Teacher + Teachers + Student + Students + 0 + 1094270400 + 0 + 10 + 2097152 + 0 + 0 + 0 + + + 0 + 1 + 0 + 1094240775 + 1094240775 + + + +
+ + + + + +
+ 0 + 0 + <div style="text-align: center;"><font size="5" style="font-family: arial,helvetica,sans-serif;"></font></div> + + + 1 + + + 1 + + +
+ + + + 1. + +
+ + + <span style="font-weight: bold;"></span> + 1 + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + 1. + 1. + + + + + + + + + + + + + + + + + + + + + + + + + + 1. + + 1. + + + + + + + + + + + label + + + + + + 0 + + resource + + + + + + + + + + + + + label + + + + + + + + + + resource + + + + + + + + + + label + + + + + + + resource + + + + + + + + + + + + + + 1. + 1. + + + + 10 + + + + + + + 1094240775 + 0 + 0 + + 1 + 0 + + + + + + + + 1. + + + + label + + + + + + + + <span style="font-style: italic;"> + + + + + :</span> + + + + + + 1094240775 + + + + + + 1. + + + resource + + + + + file + + + / + + + summary broken + + + + + frame + 1094240775 + + + + + + 1. + + + resource + + + + + + text + + + + + + + + + + + + + + 1094240775 + + + + + + 1. + + + resource + + + + file + + + + + <br/> + + + + + + + frame + 1094240775 + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + 1. + + + + + + + + + + + + + + 1. + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1. + + + forum + general + + + + + + + 2 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + + + + + + + + + + + + 1 + 1094748430 + 1094748430 + 1 + + + 1 + + 0 + + + + + + + 0 + + + + + + + 1. + + 1 + + News forum + + news + 1 + 1094240775 + 0 + 0 + 0 + 1 + 0 + + + + + 1. + + + forum + news + News forum + General news and announcements + 2 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + + + + + + + + + + + + + + + + + + + + + 1. + + + + + + + 1 + -1 + 1 + 1094748430 + 1 + + + + 0 + 1 + 1094748430 + 1094748430 + 1 + + + 1 + + 0 + + + + + + + + + + diff --git a/backup/bb/bb6_to_moodle.xsl b/backup/bb/bb6_to_moodle.xsl new file mode 100644 index 00000000000..1bbabb75da3 --- /dev/null +++ b/backup/bb/bb6_to_moodle.xsl @@ -0,0 +1,690 @@ + + + + + + backup-from-blackboard.zip + 2004083100 + 1.4 + 2004083100 + 1.4 + 1094240862 + INSERT URL HERE +
+ + assignment + true + true + + + chat + true + true + + + choice + true + true + + + forum + true + true + + + glossary + true + true + + + journal + true + true + + + label + true + true + + + lesson + true + true + + + quiz + true + true + + + resource + true + true + + + scorm + true + true + + + survey + true + true + + + wiki + true + true + + + workshop + true + true + + course + false + true + true +
+ + + + + + + + + + + + + + + + + + + + false + + + + + + + + + + + + true + + + + + + + + + + +
+ 2 + + + + + + 4 + topics + 1 + participants,activity_modules,search_forums,admin,course_list:news_items,calendar_upcoming,recent_activity + 5 + Teacher + Teachers + Student + Students + 0 + 1094270400 + 0 + 10 + 2097152 + 0 + 0 + 0 + + + 0 + 1 + 0 + 1094240775 + 1094240775 + + + +
+ + + +
+ 0 + 0 + <div style="text-align: center;"><font size="5" style="font-family: arial,helvetica,sans-serif;"></font></div> + + + 1 + + +
+ + + + 1. + +
+ + + <span style="font-weight: bold;"></span> + 1 + + + + + + + 0 + + + + + + + + + + + 0 + + + + + + +
+ + + + 1. + 1. + + + + + + + + + + + + + + + + + + + + + + + + 1. + 1. + + + + + + + + + + + + + + + + + + 1. + + 1. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1. + 1. + + 10 + + + + + + + label + + 1094240775 + 0 + 0 + + 1 + 0 + + + + + + + 1. + 1. + + 0 + + + + + + + resource + + 1094240775 + 0 + 0 + + 1 + 0 + + + + + + + 1. + 1. + + 0 + + + + resource + + 1094240775 + 0 + 0 + + 1 + 0 + + + + + + + 1. + + + label + + + + + + + + <span style="font-style: italic;"> + + + + + :</span> + + + + + + + + 1094240775 + + + + + + 1. + + + + resource + + + + + + + file + / + + + + + + frame + 1094240775 + + + + + + 1. + + + resource + + + + + + + text + + + + + + + + + + + + + + + + 1094240775 + + + + + + 1. + + + resource + + + + file + + + + + <br/> + + + + + + + frame + 1094240775 + + + + + + 1. + + + + + + + + + + + + + + 1. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1. + + + forum + general + + + + + + + 2 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + + + + + + + + + + + + 1 + 1094748430 + 1094748430 + 1 + + + 1 + + 0 + + + + + + + 0 + + + + + + + + + diff --git a/backup/bb/restore_bb.php b/backup/bb/restore_bb.php new file mode 100644 index 00000000000..238b8a67459 --- /dev/null +++ b/backup/bb/restore_bb.php @@ -0,0 +1,81 @@ + 10-25-04 + +function get_subdirs($directory){ + $opendirectory = opendir( $directory ); + while($filename = readdir($opendirectory)) { + if (is_dir($directory.$filename) and $filename != ".." and $filename != "."){ + $subdirs[] = $filename; + } + } + closedir($opendirectory); + return $subdirs; +} + + +function choose_bb_xsl($manifest){ + $f = fopen($manifest,"r"); + $buffer = fgets($f, 400); + $buffer = fgets($f, 400); + fclose($f); + if (strstr($buffer,"xmlns:bb=\"http://www.blackboard.com/content-packaging/\"")){ + return "bb6_to_moodle.xsl"; + } + return "bb5.5_to_moodle.xsl"; +} + + +function blackboard_convert($dir){ + global $CFG; + + if (!function_exists('xslt_create')) { // XSLT MUST be installed for this to work + return true; + } + + // Check for a Blackboard manifest file + if(is_file($dir."/imsmanifest.xml")){ + + //Select the proper XSL file + $xslt_file = choose_bb_xsl($dir."/imsmanifest.xml"); + + //TODO: Use the get_string function + echo "
  • Converting Blackboard export
    • "; + + // The XSL file must be in the same directory as the Blackboard files when it is processed + copy($CFG->dirroot."/backup/bb/$xslt_file", "$dir/$xslt_file"); + $startdir = getcwd(); + chdir($dir); + + + // Process the Blackboard XML files with the chosen XSL file. + // The imsmanifest contains all the XML files and their relationships. + // The XSL processor will open them as needed. + $xsltproc = xslt_create(); + if (!xslt_process($xsltproc, "imsmanifest.xml", $xslt_file, "$dir/moodle.xml")) { + dump("Failed writing xml file"); + chdir($startdir); + return false; + } + + + // Copy the Blackboard course files into the moodle course_files structure + $subdirs = get_subdirs($dir."/"); + mkdir("$dir/course_files"); + foreach ($subdirs as $subdir){ + rename($subdir, "course_files/$subdir"); + } + + chdir($startdir); + + // Blackboard export successfully converted + return true; + } + // This is not a Blackboard export + return true; + +} + +?> diff --git a/backup/restore.php b/backup/restore.php index 4bf37a62ca0..5ec5769ec5f 100644 --- a/backup/restore.php +++ b/backup/restore.php @@ -9,6 +9,7 @@ require_once ("../course/lib.php"); require_once ("lib.php"); require_once ("restorelib.php"); + require_once ("bb/restore_bb.php"); require_once("$CFG->libdir/blocklib.php"); //Optional diff --git a/backup/restorelib.php b/backup/restorelib.php index 801974ebdc4..bad9eaa06c2 100644 --- a/backup/restorelib.php +++ b/backup/restorelib.php @@ -3525,6 +3525,13 @@ notify("Error unzipping backup file. Invalid zip file."); } } + + //Check for Blackboard backups and convert + if ($status){ + require_once("$CFG->dirroot/backup/bb/restore_bb.php"); + echo "
  • ".get_string("checkingforbbexport"); + $status = blackboard_convert($CFG->dataroot."/temp/backup/".$backup_unique_code); + } //Now check for the moodle.xml file if ($status) {