Diff for /loncom/homework/edit.pm between versions 1.20 and 1.36

version 1.20, 2001/07/23 22:40:59 version 1.36, 2002/08/07 16:23:05
Line 1 Line 1
 # The LearningOnline Network with CAPA   # The LearningOnline Network with CAPA 
 # edit mode helpers  # edit mode helpers
   #
   # $Id$
   #
   # Copyright Michigan State University Board of Trustees
   #
   # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
   #
   # LON-CAPA 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 2 of the License, or
   # (at your option) any later version.
   #
   # LON-CAPA 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 LON-CAPA; if not, write to the Free Software
   # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   #
   # /home/httpd/html/adm/gpl.txt
   #
   # http://www.lon-capa.org/
   #
 # 3/20 Guy  # 3/20 Guy
   # 01/10/02 Matthew
   # 03/06/02 Matthew
 package Apache::edit;   package Apache::edit; 
   
 use strict;  use strict;
 use Apache::lonnet;  use Apache::lonnet();
   use HTML::Entities();
   
 # Global Vars  # Global Vars
 # default list of colors to use in editing  # default list of colors to use in editing
Line 21  sub tag_start { Line 49  sub tag_start {
   my $result='';    my $result='';
   if ($target eq "edit") {    if ($target eq "edit") {
     my $tag=$token->[1];      my $tag=$token->[1];
     if (!$description) { $description="<$tag>"; }      if (!$description) {
         $description=&Apache::lonxml::description($token);
         if (!$description) { $description="<$tag>"; }
       }
     $result.= &start_table($token)."<tr><td>$description</td>      $result.= &start_table($token)."<tr><td>$description</td>
 <td>Delete".  <td>Delete".
   &deletelist($target,$token)    &deletelist($target,$token)
   ."</td>    ."</td>
 <td>".  <td>".
   &insertlist($target,$token).      &insertlist($target,$token).&end_row().&start_spanning_row();
     "</td>  #<td>". 
 </tr><tr><td colspan=\"3\">\n";  #  &movebuttons($target,$token).
   #    "</tr><tr><td colspan=\"3\">\n";
   }    }
   return $result;    return $result;
 }  }
Line 54  sub start_table { Line 86  sub start_table {
   my $tag = $token->[1];    my $tag = $token->[1];
   my $tagnum;    my $tagnum;
   foreach my $namespace (reverse @Apache::lonxml::namespace) {    foreach my $namespace (reverse @Apache::lonxml::namespace) {
     my $testtag=$Apache::lonxml::namespace['-1'].'::'.$tag;      my $testtag=$namespace.'::'.$tag;
     $tagnum=$Apache::lonxml::insertlist{"$testtag.num"};      $tagnum=$Apache::lonxml::insertlist{"$testtag.num"};
     if (defined($tagnum)) { last; }      if (defined($tagnum)) { last; }
   }    }
Line 74  sub end_table { Line 106  sub end_table {
   return $result;    return $result;
 }  }
   
   sub start_spanning_row { return '<tr><td colspan="3">';}
   sub start_row          { return '<tr><td>';            }
   sub end_row            { return '</td></tr>';          }
   
   sub movebuttons {
     my ($target,$token) = @_;
     my $result='<input type="submit" name="moveup.'.
       $Apache::lonxml::curdepth.'" value="Move Up" />';
     $result.='<input type="submit" name="movedown.'.
       $Apache::lonxml::curdepth.'" value="Move Down" />';
     return $result;
   }
   
 sub deletelist {  sub deletelist {
   my ($target,$token) = @_;    my ($target,$token) = @_;
   my $result = "<select name=\"delete_$Apache::lonxml::curdepth\">    my $result = "<select name=\"delete_$Apache::lonxml::curdepth\">
Line 120  sub get_insert_list { Line 165  sub get_insert_list {
     }      }
   }    }
   if (@tagnums) {    if (@tagnums) {
       my %options;
     foreach my $tagnum (@tagnums) {      foreach my $tagnum (@tagnums) {
       $result.='<option value="'.$tagnum.'">'.$Apache::lonxml::insertlist{"$tagnum.description"}."</option>\n";        my $descrip=$Apache::lonxml::insertlist{"$tagnum.description"};
         $options{$descrip} ="<option value=\"$tagnum\">".$descrip."</option>\n";
     }      }
       foreach my $option (sort(keys(%options))) { $result.=$options{$option}; }
     if ($result) { $result='<option selected="on"></option>'.$result; }      if ($result) { $result='<option selected="on"></option>'.$result; }
   }    }
   return $result;    return $result;
Line 174  sub insert_responseparam { Line 222  sub insert_responseparam {
     <responseparam />';      <responseparam />';
 }  }
   
   sub insert_formularesponse {
     return '
   <formularesponse answer="" samples="">
       <textline />
       <hintgroup>
       </hintgroup>
   </formularesponse>';
   }
   
 sub insert_numericalresponse {  sub insert_numericalresponse {
   return '    return '
 <numericalresponse answer="">  <numericalresponse answer="">
Line 192  sub insert_stringresponse { Line 249  sub insert_stringresponse {
 </stringresponse>';  </stringresponse>';
 }  }
   
   sub insert_essayresponse {
     return '
   <essayresponse>
       <textfield></textfield>
   </essayresponse>';
   }
   
 sub insert_optionresponse {  sub insert_optionresponse {
   return '    return '
 <optionresponse max="10">  <optionresponse max="10">
Line 202  sub insert_optionresponse { Line 266  sub insert_optionresponse {
 </optionresponse>';  </optionresponse>';
 }  }
   
 sub editfield {  sub insert_radiobuttonresponse {
   my ($tag,$data,$description,$minwidth,$minheight)=@_;    return '
     <radiobuttonresponse max="10">
       <foilgroup>
       </foilgroup>
       <hintgroup>
       </hintgroup>
   </radiobuttonresponse>';
   }
   
   sub insert_displayduedate { return '<displayduedate />'; }
   sub insert_displaytitle   { return '<displaytitle />'; }
   sub insert_hintpart {
     return '
   <hintpart on="default">
       <startouttext/>
       <endouttext />
   </hintpart>';
   }
   
   sub insert_numericalhint {
     return '
   <numericalhint>
   </numericalhint>';
   }
   
   sub insert_startouttext {
     return "<startouttext />\n<endouttext />";
   }
   
   sub insert_script {
     return "\n<script type=\"loncapa/perl\">\n</script>";
   }
   
   sub textarea_sizes {
     my ($data)=@_;
   my $count=0;    my $count=0;
   my $maxlength=-1;    my $maxlength=-1;
   map { $count++;    foreach (split ("\n", $$data)) { $count++;
  if (length($_) > $maxlength) { $maxlength = length ($_); }   if (length($_) > $maxlength) { $maxlength = length($_); }
       } split ("\n", $data);        }
   if ($maxlength > 80) { $maxlength = 80; }    my $rows = $count;
   if ($maxlength < $minwidth) { $maxlength = $minwidth; }    my $cols = $maxlength;
   if ( $count < $minheight) { $count = $minheight; }    return ($rows,$cols);
   if ($description) {  }
     $description="<br />".$description."<br />";  
   }  sub editline {
   return "$description\n&nbsp;&nbsp;&nbsp;<textarea rows=\"$count\" cols=\"$maxlength\" name=homework_edit_".$Apache::lonxml::curdepth.">$data</textarea>\n";      my ($tag,$data,$description,$size)=@_;
 #  return "<br />\n&lt;$tag&gt;<br />\n&nbsp;&nbsp;&nbsp;<textarea rows=\"$count\" cols=\"$maxlength\" name=homework_edit_".$Apache::lonxml::curdepth.">$data</textarea><br />\n&lt;/$tag&gt;<br />\n";      $data=&HTML::Entities::encode($data);
       if ($description) { $description="<br />".$description."<br />"; }
       my $result = <<"END";
   $description
   <input type="text" name="homework_edit_$Apache::lonxml::curdepth" 
          value="$data" size="$size" />
   END
       return $result;
   }
   
   sub editfield {
     my ($tag,$data,$description,$minwidth,$minheight)=@_;
   
     my ($rows,$cols)=&textarea_sizes(\$data);
     if ($cols > 80) { $cols = 80; }
     if ($cols < $minwidth ) { $cols = $minwidth; }
     if ($rows < $minheight) { $rows = $minheight; }
     if ($description) { $description="<br />".$description."<br />"; }
     return $description."\n".'&nbsp;&nbsp;&nbsp;<textarea rows="'.$rows.
       '" cols="'.$cols.'" name="homework_edit_'.$Apache::lonxml::curdepth.'">'.
         &HTML::Entities::encode($data).'</textarea>'."\n";
 }  }
   
 sub modifiedfield {  sub modifiedfield {
Line 229  sub modifiedfield { Line 346  sub modifiedfield {
 #  &Apache::lonxml::debug("I want homework_edit_$Apache::lonxml::curdepth");  #  &Apache::lonxml::debug("I want homework_edit_$Apache::lonxml::curdepth");
 #  &Apache::lonxml::debug($ENV{"form.homework_edit_$Apache::lonxml::curdepth"});  #  &Apache::lonxml::debug($ENV{"form.homework_edit_$Apache::lonxml::curdepth"});
   $result=$ENV{"form.homework_edit_$Apache::lonxml::curdepth"};    $result=$ENV{"form.homework_edit_$Apache::lonxml::curdepth"};
   if (defined $token) {  
     if (defined $token->[4]) {  
       $result=$token->[4].$result;  
     } else {  
       $result=$result.$token->[2];  
     }  
   }  
   return $result;    return $result;
 }  }
   
 sub insert_startouttext {  
   return "<startouttext />\n<endouttext />";  
 }  
   
 sub insert_script {  
   return "\n<script type=\"loncapa/perl\">\n</script>";  
 }  
   
 # Returns a 1 if the token has been modified and you should rebuild the tag  # Returns a 1 if the token has been modified and you should rebuild the tag
 # side-effects, will modify the $token if new values are found  # side-effects, will modify the $token if new values are found
 sub get_new_args {  sub get_new_args {
Line 312  sub select_arg { Line 414  sub select_arg {
   }    }
   $result.=$description.'<select name="'."$Apache::lonxml::curdepth.$name".'">    $result.=$description.'<select name="'."$Apache::lonxml::curdepth.$name".'">
        '.$optionlist.'         '.$optionlist.'
       </select></td></tr><tr><td colspan="3">';        </select>';
   return $result;    return $result;
 }  }
   
Line 331  sub select_or_text_arg { Line 433  sub select_or_text_arg {
     }      }
   }    }
   $optionlist.="<option value=\"TYPEDINVALUE\">Type in value</option>\n";    $optionlist.="<option value=\"TYPEDINVALUE\">Type in value</option>\n";
   if ($found) {    if (($found) || (!$selected)) {
     $result.=$description.'<select name="'."$Apache::lonxml::curdepth.$name".'">      $result.=$description.'<select name="'."$Apache::lonxml::curdepth.$name".'">
        '.$optionlist.'         '.$optionlist.'
       </select></td></tr><tr><td colspan="3">';        </select>';
   } else {    } else {
     $result.=&text_arg($description,$name,$token,$size);      $result.=&text_arg($description,$name,$token,$size);
   }    }
   return $result;    return $result;
 }  }
   
   #----------------------------------------------------- browse
   sub browse {
       # insert a link to call up the filesystem browser (lonindexer)
       $_ = shift;
       my $form    = 'lonhomework';
       my $element = &Apache::lonnet::escape("$Apache::lonxml::curdepth.$_");
       my $result = <<"ENDBUTTON";
   <a href=\"javascript:openbrowser('$form','$element')\"\>Browse</a>
   ENDBUTTON
       return $result;
   }
   
   #----------------------------------------------------- browse
   sub search {
       # insert a link to call up the filesystem browser (lonindexer)
       $_ = shift;
       my $form    = 'lonhomework';
       my $element = &Apache::lonnet::escape("$Apache::lonxml::curdepth.$_");
       my $result = <<"ENDBUTTON";
   <a href=\"javascript:opensearcher('$form','$element')\"\>Search</a>
   ENDBUTTON
       return $result;
   }
   
   
 1;  1;
 __END__  __END__
   
   =head1 NAME
   
   Apache::edit - edit mode helpers
   
   =head1 SYNOPSIS
   
   Invoked by many homework and xml related modules.
   
    &Apache::edit::SUBROUTINENAME(ARGUMENTS);
   
   =head1 INTRODUCTION
   
   This module outputs HTML syntax helpful for the rendering of edit
   mode interfaces.
   
   This is part of the LearningOnline Network with CAPA project
   described at http://www.lon-capa.org.
   
   =head1 HANDLER SUBROUTINE
   
   There is no handler subroutine.
   
   =head1 OTHER SUBROUTINES
   
   =over 4
   
   =item *
   
   initialize_edit() : initialize edit (set colordepth to zero)
   
   =item *
   
   tag_start($target,$token,$description) : provide deletion and insertion lists
   for the manipulation of a start tag; return a scalar string
   
   =item *
   
   tag_end($target,$token,$description) : ending syntax corresponding to
   &tag_start. return a scalar string.
   
   =item *
   
   start_table($token) : start table; update colordepth; return scalar string.
   
   =item *
   
   end_table() : reduce color depth; end table; return scalar string
   
   =item *
   
   start_spanning_row() : start a new table row spanning the 'edit' environment.
   
   =item *
   
   start_row() : start a new table row and element. 
   
   =item *
   
   end_row() : end current table element and row.
   
   =item *
   
   movebuttons($target,$token) : move-up and move-down buttons; return scalar
   string
   
   =item *
   
   deletelist($target,$token) : provide a yes option in an HTML select element;
   return scalar string
   
   =item *
   
   handle_delete($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,
   $style) : respond to a user delete request by passing relevant stack
   and array information to various rendering functions; return a scalar string
   
   =item *
   
   get_insert_list($token) : provide an insertion list based on possibilities
   from lonxml; return a scalar string
   
   =item *
   
   insertlist($target,$token) : api that uses get_insert_list;
   return a scalar string
   
   =item *
   
   handleinsert($token) : provide an insertion list based on possibilities
   from lonxml; return a scalar string
   
   =item *
   
   get_insert_list($token) : provide an insertion list based on possibilities
   from lonxml; return a scalar string
   
   =item *
   browse($elementname) : provide a link which will open up the filesystem
   browser (lonindexer) and, once a file is selected, place the result in
   the form element $elementname.
   
   =item *
   search($elementname) : provide a link which will open up the filesystem
   searcher (lonsearchcat) and, once a file is selected, place the result in
   the form element $elementname.
   
   =item *
   editline(tag,data,description,size): Provide a <input type="text" ../> for
   single-line text entry.  This is to be used for text enclosed by tags, not
   arguements/parameters associated with a tag.
   
   =back
   
   incomplete...
   
   =cut

Removed from v.1.20  
changed lines
  Added in v.1.36


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>