--- loncom/publisher/lonupload.pm	2002/09/10 02:31:26	1.14
+++ loncom/publisher/lonupload.pm	2004/03/31 05:24:00	1.26
@@ -2,7 +2,7 @@
 # The LearningOnline Network with CAPA
 # Handler to upload files into construction space
 #
-# $Id: lonupload.pm,v 1.14 2002/09/10 02:31:26 foxr Exp $
+# $Id: lonupload.pm,v 1.26 2004/03/31 05:24:00 albertel Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -26,26 +26,6 @@
 #
 # http://www.lon-capa.org/
 #
-# (Handler to retrieve an old version of a file
-#
-# (Publication Handler
-# 
-# (TeX Content Handler
-#
-# YEAR=2000
-# 05/29/00,05/30,10/11 Gerd Kortemeyer)
-#
-# 11/28,11/29,11/30,12/01,12/02,12/04,12/23 Gerd Kortemeyer
-# YEAR=2001
-# 03/23 Guy Albertelli
-# 03/24,03/29 Gerd Kortemeyer)
-#
-# 03/31,04/03 Gerd Kortemeyer)
-#
-# 04/05,04/09,05/25,06/23,06/24,08/22 Gerd Kortemeyer
-# 11/29 Matthew Hall
-# 12/16 Scott Harrison
-#
 ###
 
 package Apache::lonupload;
@@ -60,22 +40,23 @@ use Apache::loncommon();
 use Apache::Log();
 use Apache::lonnet;
 use HTML::Entities();
+use Apache::lonlocal;
 
 my $DEBUG=0;
 
 sub Debug {
   
-  # Marshall the parameters.
+    # Marshall the parameters.
   
-  my $r       = shift;
-  my $log     = $r->log;
-  my $message = shift;
+    my $r       = shift;
+    my $log     = $r->log;
+    my $message = shift;
   
-  # Put out the indicated message butonly if DEBUG is false.
+    # Put out the indicated message butonly if DEBUG is false.
   
-  if ($DEBUG) {
-    $log->debug($message);
-  }
+    if ($DEBUG) {
+	$log->debug($message);
+    }
 }
 
 sub upfile_store {
@@ -84,7 +65,7 @@ sub upfile_store {
     my $fname=$ENV{'form.upfile.filename'};
     $fname=~s/\W//g;
     
-    chop($ENV{'form.upfile'});
+    chomp($ENV{'form.upfile'});
   
     my $datatoken=$ENV{'user.name'}.'_'.$ENV{'user.domain'}.
 		  '_upload_'.$fname.'_'.time.'_'.$$;
@@ -98,178 +79,265 @@ sub upfile_store {
 
 
 sub phaseone {
-   my ($r,$fn,$uname,$udom)=@_;
-   $ENV{'form.upfile.filename'}=~s/\\/\//g;
-   $ENV{'form.upfile.filename'}=~s/^.*\/([^\/]+)$/$1/;
-   if ($ENV{'form.upfile.filename'}) {
-    $fn=~s/\/[^\/]+$//;
-    $fn=~s/([^\/])$/$1\//;
-    $fn.=$ENV{'form.upfile.filename'};
-    $fn=~s/^\///;
-    $fn=~s/(\/)+/\//g;
+    my ($r,$fn,$uname,$udom,$mode)=@_;
+    my $action = '/adm/upload';
+    if ($mode eq 'testbank') {
+        $action = '/adm/testbank';
+    } elsif ($mode eq 'imsimport') {
+        $action = '/adm/imsimport';
+    }
+    $ENV{'form.upfile.filename'}=~s/\\/\//g;
+    $ENV{'form.upfile.filename'}=~s/^.*\/([^\/]+)$/$1/;
+    if ($ENV{'form.upfile.filename'}) {
+	$fn=~s/\/[^\/]+$//;
+	$fn=~s/([^\/])$/$1\//;
+	$fn.=$ENV{'form.upfile.filename'};
+	$fn=~s/^\///;
+	$fn=~s/(\/)+/\//g;
 
 #    Fn is the full path to the destination filename.
 #    
 
-    &Debug($r, "Filename for upload: $fn");
-    if (($fn) && ($fn!~/\/$/)) {
-      $r->print(
- '<form action=/adm/upload method=post>'.
- '<input type=hidden name=phase value=two>'.
- '<input type=hidden name=datatoken value="'.&upfile_store.'">'.
- 'Store uploaded file as '.
- '<input type=text size=50 name=filename value="/priv/'.
-  $uname.'/'.$fn.'"><br>'.
- '<input type=submit value="Store"></form>');
-      # Check for bad extension and warn user
-      if ($fn=~/\.(\w+)$/ && 
-	  (&Apache::loncommon::fileembstyle($1) eq 'hdn')) {
-	  $r->print(
- '<font color=red>'.
- 'The extension on this file, "'.$1.
- '", is reserved internally by LON-CAPA. <br \>'.
- 'Please change the extension.'.
- '</font>');
-      } elsif($fn=~/\.(\w+)$/ && 
-	      !defined(&Apache::loncommon::fileembstyle($1))) {
-	  $r->print(
- '<font color=red>'.
- 'The extension on this file, "'.$1.
- '", is not recognized by LON-CAPA. <br \>'.
- 'Please change the extension.'.
- '</font>');
-      }
-  } else {
-      $r->print('<font color=red>Illegal filename.</font>');
-  }
- } else {
-     $r->print('<font color=red>No upload file specified.</font>');
- }
+	&Debug($r, "Filename for upload: $fn");
+	if (($fn) && ($fn!~/\/$/)) {
+	    $r->print('<form action="'.$action.'" method="post">'.
+		      '<input type="hidden" name="phase" value="two" />'.
+		      '<input type="hidden" name="datatoken" value="'.
+		      &upfile_store.'" />'.
+		      '<input type="hidden" name="uploaduname" value="'.$uname.
+		      '" />'.&mt('Store uploaded file as ').
+                      "<tt>/priv/$uname/</tt>".
+                      '<input type="text" size="50" name="filename" value="'.$fn.
+                      '" /><br />');
+            $r->print('<br />'.&mt('Please indicate the type of file you are uploading. The possible types of file are as follows:').'
+<ul>
+ <li><b>'.&mt('Regular file:').'</b>'.&mt(' A file that requires no special handling during upload. The "Regular file" designation applies to html files, image files etc., as well as to zip, tar or gzip files that you wish to decompress after upload. In the case of a zip/tar/gz file etc., once the file has been uploaded, a "Decompress" link will automatically be displayed adjacent to the name of the file in the display of construction space directory contents. You will be able to decompress this file by clicking the link.').'</li>     
+ <li><b>'.&mt('Testbank file:').'</b>'.&mt(' a testbank file containing plain text (ascii) questions and answers, which you plan to convert to LON-CAPA problems. The following question types can be converted: 1 of N multiple choice questions, individual True/False questions, groups of True/False questions, Fill-in-the-blank questions, Ranking questions, and Essay/short answer questions. Specific information about the format of the questions, foils, and correct answers is available ').'<a href="javascript:testbankWin()">'.&mt('here').'</a>,'.&mt(' and is also included in the pages displayed during step-by-step conversion of the testbank. The original testbank file can be removed from your construction space later, once the testbank questions have been converted.').'</li>
+<li><b>'.&mt('IMS package').':</b>'.&mt(' a file containing course content from another Course Management System (e.g., Blackboard or ANGEL) packaged according to the IMS 1.1 specification.  The original IMS package file can be removed from your construction space later, once the package has been decompressed and the files converted to LON-CAPA sequence, page, problem, or bulletin board files, or stored as html, image or movie files etc., as appropriate.').'</li>
+</ul>
+<br />'.&mt('Choose file type:').'
+<select name="filetype">
+ <option value="standard" selected>'.&mt('Regular file').'
+ <option value="testbank">'.&mt('Testbank file').'
+ <option value="imsimport">'.&mt('IMS package').'
+</select>
+<br />
+<br />
+');
+            $r->print('<input type="button" value="'.&mt('Store').'" onClick="javascript:verifyForm()"/></form>');
+	    # Check for bad extension and warn user
+	    if ($fn=~/\.(\w+)$/ && 
+		(&Apache::loncommon::fileembstyle($1) eq 'hdn')) {
+		$r->print('<font color="red">'.&mt('The extension on this file,').
+			  ' "'.$1.'"'.&mt(', is reserved internally by LON-CAPA.').
+			  ' <br />'.&mt('Please change the extension.').'</font>');
+	    } elsif($fn=~/\.(\w+)$/ && 
+		    !defined(&Apache::loncommon::fileembstyle($1))) {
+		$r->print('<font color="red">'.&mt('The extension on this file,').
+			  ' "'.$1.'"'.&mt(', is not recognized by LON-CAPA.').
+			  ' <br />'.&mt('Please change the extension.').
+			  '</font>');
+	    }
+	} else {
+	    $r->print('<font color="red">'.&mt('Illegal filename.').'</font>');
+	}
+    } else {
+	$r->print('<font color="red">'.&mt('No upload file specified.').'</font>');
+    }
 }
 
 sub phasetwo {
-   my ($r,$fn,$uname,$udom)=@_;
-   &Debug($r, "Filename is ".$fn);
-   if ($fn=~/^\/priv\/$uname\//) {
-    &Debug($r, "Filename after priv substitution: ".$fn);
-    my $tfn=$fn;
-    $tfn=~s/^\/(\~|priv)\/(\w+)//;
-    &Debug($r, "Filename for tfn = ".$tfn);
-    my $target='/home/'.$uname.'/public_html'.$tfn;
-    &Debug($r, "target -> ".$target);
+    my ($r,$tfn,$uname,$udom,$mode)=@_;
+    my $action = '/adm/upload';
+    my $returnflag = '';
+    if ($mode eq 'testbank') {
+        $action = '/adm/testbank';
+    } elsif ($mode eq 'imsimport') {
+        $action = '/adm/imsimport';
+    }
+    my $fn='/priv/'.$uname.'/'.$tfn;
+    $fn=~s/\/+/\//g;
+    &Debug($r, "Filename is ".$tfn);
+    if ($tfn) {
+	&Debug($r, "Filename for tfn = ".$tfn);
+	my $target='/home/'.$uname.'/public_html'.$tfn;
+	&Debug($r, "target -> ".$target);
 #     target is the full filesystem path of the destination file.
-    my $base = &File::Basename::basename($fn);
-    my $path = &File::Basename::dirname($fn);
-    $base    = &HTML::Entities::encode($base);
-    my $url  = $path."/".$base; 
-    &Debug($r, "URL is now ".$url);
-    my $datatoken=$ENV{'form.datatoken'};
-    if (($fn) && ($datatoken)) {
-	if ((-e $target) && ($ENV{'form.override'} ne 'Yes')) {
-           $r->print(
- '<form action=/adm/upload method=post>'.
- 'File <tt>'.$fn.'</tt> exists. Overwrite? '.
- '<input type=hidden name=phase value=two>'.
- '<input type=hidden name=filename value="'."$url".'">'.
- '<input type=hidden name=datatoken value="'.$datatoken.'">'.
- '<input type=submit name=override value="Yes"></form>');
-       } else {
-           my $source=$r->dir_config('lonDaemons').
-	                             '/tmp/'.$datatoken.'.tmp';
-           # Check for bad extension and disallow upload
-	   if ($fn=~/\.(\w+)$/ && 
-	       (&Apache::loncommon::fileembstyle($1) eq 'hdn')) {
-	       $r->print(
- 'File <tt>'.$fn.'</tt> could not be copied.<br />'.
- '<font color=red>'.
- 'The extension on this file is reserved internally by LON-CAPA.'.
- '</font>');
-	   } elsif ($fn=~/\.(\w+)$/ && 
-		    !defined(&Apache::loncommon::fileembstyle($1))) {
-	       $r->print(
- 'File <tt>'.$fn.'</tt> could not be copied.<br />'.
- '<font color=red>'.
- 'The extension on this file is not recognized by LON-CAPA.'.
- '</font>');
-	   } elsif (copy($source,$target)) {
-	       chmod(0660, $target); # Set permissions to rw-rw---.
-	      $r->print('File copied.');
-              $r->print('<p><font size=+2><a href="'.$url.
-                        '">View file</a></font>');
-	   } else {
-              $r->print('Failed to copy: '.$!);
-	   }
-       }
+	my $base = &File::Basename::basename($fn);
+	my $path = &File::Basename::dirname($fn);
+	$base    = &HTML::Entities::encode($base,'<>&"');
+	my $url  = $path."/".$base; 
+	&Debug($r, "URL is now ".$url);
+	my $datatoken=$ENV{'form.datatoken'};
+	if (($fn) && ($datatoken)) {
+	    if ((-e $target) && ($ENV{'form.override'} ne 'Yes')) {
+		$r->print('<form action="'.$action.'" method="post">'.
+			  &mt('File').' <tt>'.$fn.'</tt> '.
+			  &mt('exists. Overwrite?').' '.
+			  '<input type="hidden" name="phase" value="two" />'.
+			  '<input type="hidden" name="filename" value="'."$url".'" />'.
+			  '<input type="hidden" name="datatoken" value="'.$datatoken.'" />'.
+			  '<input type="submit" name="override" value="'.&mt('Yes').'" /></form>');
+	    } else {
+		my $source=$r->dir_config('lonDaemons').'/tmp/'.$datatoken.'.tmp';
+		# Check for bad extension and disallow upload
+		if ($fn=~/\.(\w+)$/ && 
+		    (&Apache::loncommon::fileembstyle($1) eq 'hdn')) {
+		    $r->print(&mt('File').' <tt>'.$fn.'</tt> '.
+			      &mt('could not be copied.').'<br />'.
+			      '<font color="red">'.
+			      &mt('The extension on this file is reserved internally by LON-CAPA.').
+			      '</font>');
+		    $r->print('<br /><font size=+2><a href="'.$path.'">'.
+			      &mt('Back to Directory').'</a></font>');
+		} elsif ($fn=~/\.(\w+)$/ && 
+			 !defined(&Apache::loncommon::fileembstyle($1))) {
+		    $r->print(&mt('File').' <tt>'.$fn.'</tt> '.
+			      &mt('could not be copied.').'<br />'.
+			      '<font color="red">'.
+			      &mt('The extension on this file is not recognized by LON-CAPA.').
+			      '</font>');
+		    $r->print('<br /><font size="+2"><a href="'.$path.'">'.
+			      &mt('Back to Directory').'</a></font>');
+		} elsif (-d $target) {
+		    $r->print('File <tt>'.$fn.'</tt> could not be copied.<br />'.
+			      '<font color="red">'.
+			      &mt('The target is an existing directory.').
+			      '</font><br />');
+		    $r->print('<font size="+2"><a href="'.$path.'">'.
+			      &mt('Back to Directory').'</a></font>');
+		} elsif (copy($source,$target)) {
+		    chmod(0660, $target); # Set permissions to rw-rw---.
+                    if ($mode eq 'testbank' || $mode eq 'imsimport') {
+                        $r->print(&mt("Your file - $fn - was uploaded successfully")."<br /><br />");
+                        $returnflag = 'ok';
+                    } else {
+                        $r->print(&mt('File copied.'));
+		        $r->print('<br /><font size="+2"><a href="'.$url.'">'.
+			      &mt('View file').'</a></font>');
+		        $r->print('<br /><font size="+2"><a href="'.$path.'">'.
+			      &mt('Back to Directory').'</a></font><br />');
+                    }
+		} else {
+		    $r->print('Failed to copy: '.$!);
+		    $r->print('<br /><font size="+2"><a href="'.$path.'">'.
+			      &mt('Back to Directory').'</a></font>');
+		}
+	    }
+	} else {
+	    $r->print('<font size="+1" color="red">'.
+		      &mt('Please use browser "Back" button and pick a filename').
+		      '</font><br />');
+	}
     } else {
-       $r->print(
-   '<font size=+1 color=red>Please pick a filename</font><p>');
-       &phaseone($r,$fn,$uname,$udom);
-    }
-  } else {
-    $r->print(
-   '<font size=+1 color=red>Please pick a filename</font><p>');
-    &phaseone($r,$fn,$uname,$udom);
-  }
+	$r->print('<font size=+1 color=red>'.
+		  &mt('Please use browser "Back" button and pick a filename').
+		  '</font><br />>');
+    }
+    return $returnflag;
 }
 
 # ---------------------------------------------------------------- Main Handler
 sub handler {
 
-  my $r=shift;
+    my $r=shift;
 
-  my $uname;
-  my $udom;
+    my $uname;
+    my $udom;
+    my $javascript = '';
+#
+# phase two: re-attach user
+#
+    if ($ENV{'form.uploaduname'}) {
+	$ENV{'form.filename'}='/priv/'.$ENV{'form.uploaduname'}.'/'.
+	    $ENV{'form.filename'};
+    }
 
-  ($uname,$udom)=
-    &Apache::loncacc::constructaccess(
-			 $ENV{'form.filename'},$r->dir_config('lonDefDomain'));
-  unless (($uname) && ($udom)) {
-     $r->log_reason($uname.' at '.$udom.
-         ' trying to publish file '.$ENV{'form.filename'}.
-         ' - not authorized', 
-         $r->filename); 
-     return HTTP_NOT_ACCEPTABLE;
-  }
-
-  my $fn;
-
-  if ($ENV{'form.filename'}) {
-      $fn=$ENV{'form.filename'};
-      $fn=~s/^http\:\/\/[^\/]+\/(\~|priv\/)(\w+)//;
-  } else {
-     $r->log_reason($ENV{'user.name'}.' at '.$ENV{'user.domain'}.
-         ' unspecified filename for upload', $r->filename); 
-     return HTTP_NOT_FOUND;
-  }
+    unless ($ENV{'form.phase'} eq 'two') {
+        $javascript = qq|
+function verifyForm() {
+    var mode = document.forms[0].filetype.options[document.forms[0].filetype.selectedIndex].value
+    if (mode == "testbank") {
+        document.forms[0].action = "/adm/testbank";
+    }
+    if (mode == "imsimport") {
+        document.forms[0].action = "/adm/imsimport";
+    }
+    if (mode == "standard") {
+        document.forms[0].action = "/adm/upload";
+    }
+    document.forms[0].submit();
+}
 
-# ----------------------------------------------------------- Start page output
+function testbankWin() {
+  newWindow = window.open("","testbankinfo","HEIGHT=400,WIDTH=750,scrollbars=yes")
+  newWindow.document.open()
+  newWindow.document.write("<html><head><title>'Importing a Testbank file into LON-CAPA</title><meta http-equiv='pragma' content='no-cache'>\\n")
+  newWindow.document.write("</head><body bgcolor='#CCFFDD' topmargin='0' leftmargin='0' marginheight='0'marginwidth='0' rightmargin='0'>\\n")
+  newWindow.document.write("<img border='0' src='/adm/lonInterFace/author.jpg' alt='[Author Header]'>\\n")
+  newWindow.document.write("<table border='0' cellspacing='0' cellpadding='0' width='95%' bgcolor='#CCFFDD'>\\n")
+  newWindow.document.write("<tr><td width='2'>&nbsp;</td><td width='3'>&nbsp;</td>\\n")
+  newWindow.document.write("<td><font face='arial,helvetica,sans-serif'><h3>Importing Testbank questions into LON-CAPA</h3>")
+  newWindow.document.write("<font face='arial,helvetica,sans-serif'><br />Four requirements must be met to ensure that you will succeed in building LON-CAPA problem files using your plain text file containing testbank questions.")
+  newWindow.document.write("<ol><li>The questions and answers you upload must be in plain text format.  Any header lines should occur before the text containing the questions and answers.</li>")
+  newWindow.document.write("<li>All questions must occur before any of the answers.  Each question should be numbered sequentially using a number followed immediately by a space, a period, or enclosed in parentheses, i.e., 1 , 1., (1), 1), or (1 .</li>")
+   newWindow.document.write("<li>One or more correct answers should be provided for all questions (although blank answers may be provided for <i>essay</i> questions).  Answers should be numbered sequentially, using the same scheme as used for the questions, and must occur after all the questions.")
+    newWindow.document.write("<li><i>Multiple choice</i> and <i>multiple answer correct</i> questions should consist of (i) the question number followed by (ii) a question stem beginning on the same line and (iii) two or more foils, with each foil beginning on a new line and prefixed by a unique letter, or Roman numeral, listed in alphabetic or numeric order, beginning at a (alphabetic) or i (Roman numeral), followed by a period, or enclosed in parentheses, i.e., a., (a), i., or (i) .</li>")
+     newWindow.document.write("<li>If <i>fill-in-the-blank</i> or <i>multiple answer</i> questions have more than one correct answer, each answer should appear in a comma-, tab-, space-, or new line-delimited list. </li></ol>")
+  newWindow.document.write("</td></tr>\\n")
+  newWindow.document.write("</table></body></html>")
+  newWindow.document.close()
+  newWindow.focus()
+}
+|;
+    }
+    ($uname,$udom)=
+	&Apache::loncacc::constructaccess($ENV{'form.filename'},
+					  $r->dir_config('lonDefDomain'));
+    unless (($uname) && ($udom)) {
+	$r->log_reason($uname.' at '.$udom.
+		       ' trying to publish file '.$ENV{'form.filename'}.
+		       ' - not authorized', 
+		       $r->filename); 
+	return HTTP_NOT_ACCEPTABLE;
+    }
+    
+    my $fn;
+    if ($ENV{'form.filename'}) {
+	$fn=$ENV{'form.filename'};
+	$fn=~s/^http\:\/\/[^\/]+\///;
+	$fn=~s/^\///;
+	$fn=~s/(\~|priv\/)(\w+)//;
+	$fn=~s/\/+/\//g;
+    } else {
+	$r->log_reason($ENV{'user.name'}.' at '.$ENV{'user.domain'}.
+		       ' unspecified filename for upload', $r->filename); 
+	return HTTP_NOT_FOUND;
+    }
 
+# ----------------------------------------------------------- Start page output
 
-  $r->content_type('text/html');
-  $r->send_http_header;
 
-  $r->print('<html><head><title>LON-CAPA Construction Space</title></head>');
+    &Apache::loncommon::content_type($r,'text/html');
+    $r->send_http_header;
 
-  $r->print(
-   '<body bgcolor="#FFFFFF"><img align=right src=/adm/lonIcons/lonlogos.gif>');
+    $r->print("<html><head><title>LON-CAPA Construction Space</title><script type=\"text/javascript\">\n//<!--\n$javascript\n// --></script>\n</head>");
 
+    $r->print(&Apache::loncommon::bodytag('Upload file to Construction Space'));
   
-  $r->print('<h1>Upload file to Construction Space</h1>');
-  
-  if (($uname ne $ENV{'user.name'}) || ($udom ne $ENV{'user.domain'})) {
-          $r->print('<h3><font color=red>Co-Author: '.$uname.' at '.$udom.
-               '</font></h3>');
-  }
-
+    if (($uname ne $ENV{'user.name'}) || ($udom ne $ENV{'user.domain'})) {
+	$r->print('<h3><font color=red>'.&mt('Co-Author').': '.$uname.
+		  &mt(' at ').$udom.'</font></h3>');
+    }
 
-  if ($ENV{'form.phase'} eq 'two') {
-      &phasetwo($r,$fn,$uname,$udom);
-  } else {
-      &phaseone($r,$fn,$uname,$udom);
-  }
+    if ($ENV{'form.phase'} eq 'two') {
+	&phasetwo($r,$fn,$uname,$udom);
+    } else {
+	&phaseone($r,$fn,$uname,$udom);
+    }
 
-  $r->print('</body></html>');
-  return OK;  
+    $r->print('</body></html>');
+    return OK;  
 }
 
 1;