Diff for /loncom/homework/edit.pm between versions 1.19 and 1.39

version 1.19, 2001/07/18 20:27:22 version 1.39, 2002/11/07 19:45:16
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
 @Apache::edit::colorlist=('#ffffff','#ff0000','#00ff00','#0000ff','#0ff000','#000ff0','#f0000f');  @Apache::edit::colorlist=('#ffffff','#ff0000','#00ff00','#0000ff','#0ff000','#000ff0','#f0000f');
 # depth of nesting of edit  # depth of nesting of edit
 $Apache::edit::colordepth=0;  $Apache::edit::colordepth=0;
   @Apache::edit::inserttag=();
   
 sub initialize_edit {  sub initialize_edit {
   $Apache::edit::colordepth=0;    $Apache::edit::colordepth=0;
     @Apache::edit::inserttag=();
 }  }
   
 sub tag_start {  sub tag_start {
Line 21  sub tag_start { Line 51  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 88  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 64  sub start_table { Line 98  sub start_table {
     $color = $Apache::edit::colorlist[$Apache::edit::colordepth];      $color = $Apache::edit::colorlist[$Apache::edit::colordepth];
   }    }
   $Apache::edit::colordepth++;    $Apache::edit::colordepth++;
   my $result="<table bgcolor=\"$color\" width=\"100%\" border=\"5\">";    push(@Apache::edit::inserttag,$token->[1]);
     my $result='<p align="right">';
     $result.='<table bgcolor="'.$color.'" width="99%" border="2">';
   return $result;    return $result;
 }  }
   
 sub end_table {  sub end_table {
   $Apache::edit::colordepth--;    $Apache::edit::colordepth--;
   my $result="</table>";    my $result='</table></p>';
     $result.="<table><tr><td>";
   
     my ($tagname,$closingtag);
     if (defined($Apache::edit::inserttag[-2])) {
       $tagname=$Apache::edit::inserttag[-2];
     } else {$tagname='problem';}
     if (defined($Apache::edit::inserttag[-1])) {
       $closingtag=$Apache::edit::inserttag[-1];
     }
     $result.=&innerinsertlist('edit',$tagname,$closingtag).
       "</td></tr></table>";
     pop(@Apache::edit::inserttag);
     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;    return $result;
 }  }
   
Line 107  sub handle_delete { Line 168  sub handle_delete {
 }  }
   
 sub get_insert_list {  sub get_insert_list {
   my ($token) = @_;    my ($tagname) = @_;
   my $result='';    my $result='';
   my @tagnums= ();    my @tagnums= ();
   #&Apache::lonxml::debug("keys ".join("\n",sort(keys(%Apache::lonxml::insertlist))));    #&Apache::lonxml::debug("keys ".join("\n",sort(keys(%Apache::lonxml::insertlist))));
   if ($Apache::lonxml::insertlist{"$token->[1].which"}) {    if ($Apache::lonxml::insertlist{"$tagname.which"}) {
     push (@tagnums, @{ $Apache::lonxml::insertlist{"$token->[1].which"} });      push (@tagnums, @{ $Apache::lonxml::insertlist{"$tagname.which"} });
   }    }
   foreach my $namespace (@Apache::lonxml::namespace) {    foreach my $namespace (@Apache::lonxml::namespace) {
     if ($Apache::lonxml::insertlist{"$namespace".'::'."$token->[1].which"}) {      if ($Apache::lonxml::insertlist{"$namespace".'::'."$tagname.which"}) {
       push (@tagnums, @{ $Apache::lonxml::insertlist{"$namespace".'::'."$token->[1].which"} });        push (@tagnums, @{ $Apache::lonxml::insertlist{"$namespace".'::'."$tagname.which"} });
     }      }
   }    }
   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 130  sub get_insert_list { Line 194  sub get_insert_list {
   
 sub insertlist {  sub insertlist {
   my ($target,$token) = @_;    my ($target,$token) = @_;
     return &innerinsertlist($target,$token->[1]);
   }
   
   sub innerinsertlist {
     my ($target,$tagname,$closingtag) = @_;
   my $result;    my $result;
     my $after='';
     if ($closingtag) {
        $after='_after_'.$closingtag; 
     }
   if ($target eq 'edit') {    if ($target eq 'edit') {
     my $optionlist= &get_insert_list($token);      my $optionlist= &get_insert_list($tagname);
     if ($optionlist) {      if ($optionlist) {
       $result = "Insert:        $result = "Insert:
 <select name=\"insert_$Apache::lonxml::curdepth\">  <select name=\"insert$after\_$Apache::lonxml::curdepth\">
 $optionlist  $optionlist
 </select>"  </select>"
     } else {      } else {
Line 169  sub handle_insert { Line 242  sub handle_insert {
   return $result;    return $result;
 }  }
   
   sub handle_insertafter {
     my $tagname=shift;
     if ($ENV{"form.insert_after_$tagname\_$Apache::lonxml::curdepth"} eq '')
        { return ''; }
     my $result;
     my $tagnum =$ENV{"form.insert_after_$tagname\_$Apache::lonxml::curdepth"};
     my $func=$Apache::lonxml::insertlist{"$tagnum.function"};
     if ($func eq 'default') {
       my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
       my $namespace;
       if ($newtag =~ /::/) { ($namespace,$newtag) = split(/::/,$newtag); }
       $result.="\n<$newtag>\n</$newtag>";
     } else {
       if (defined(&$func)) {
         {
    no strict 'refs';
    $result.=&$func();
         }
       } else {
         my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
         &Apache::lonxml::error("Unable to insert (after) tag $newtag, $func was not defined. ($tagname $tagnum)");
       }
     }
     return $result;
   }
   
 sub insert_responseparam {  sub insert_responseparam {
   return '    return '
     <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 300  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 317  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_radiobuttonhint {
     return '
   <radiobuttonhint>
   </radiobuttonhint>';
   }
   
   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 403  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 {
   my ($token,$parstack,$safeeval,@args)=@_;    my ($token,$parstack,$safeeval,@args)=@_;
   my $rebuild=0;    my $rebuild=0;
   foreach my $arg (@args) {    foreach my $arg (@args) {
     my $value=&Apache::lonxml::get_param($arg,$parstack,$safeeval);      #just want the string that it was set to
       my $value=$token->[2]->{$arg};
     my $newvalue=$ENV{"form.$Apache::lonxml::curdepth.$arg"};      my $newvalue=$ENV{"form.$Apache::lonxml::curdepth.$arg"};
     &Apache::lonxml::debug(" for:$arg: cur is :$value: new is :$newvalue:");      &Apache::lonxml::debug(" for:$arg: cur is :$value: new is :$newvalue:");
     if ($value ne $newvalue) {      if ($value ne $newvalue) {
Line 271  sub rebuild_tag { Line 431  sub rebuild_tag {
   if ($token->[0] eq 'S') {    if ($token->[0] eq 'S') {
     $result = '<'.$token->[1];      $result = '<'.$token->[1];
     while (my ($key,$val)= each(%{$token->[2]})) {      while (my ($key,$val)= each(%{$token->[2]})) {
       $val=~s:^\s|\s$::g;        $val=~s:^\s+|\s+$::g;
       $val=~s:"::g; #"        $val=~s:"::g; #"
       &Apache::lonxml::debug("setting :$key: to  :$val:");        &Apache::lonxml::debug("setting :$key: to  :$val:");
       $result.=' '.$key.'="'.$val.'"';        $result.=' '.$key.'="'.$val.'"';
Line 298  sub text_arg { Line 458  sub text_arg {
 }  }
   
 sub select_arg {  sub select_arg {
   my ($description,$name,$list,$token) = @_;      my ($description,$name,$list,$token) = @_;
   my $result;      my $result;
   my $optionlist="";      my $optionlist="";
   my $selected=$token->[2]{$name};      my $selected=$token->[2]{$name};
   foreach my $option (@$list) {      foreach my $option (@$list) {
     if ( $selected eq $option ) {   my $value;
       $optionlist.="<option selected=\"on\">$option</option>\n";   if ( ref($option) eq 'ARRAY') {
     } else {      $value='value="'.$$option[0].'"';
       $optionlist.="<option>$option</option>\n";      $option=$$option[1];
    } else {
       $value='value="'.$option.'"';
    }
    if ( $selected eq $option ) {
       $optionlist.="<option $value selected=\"on\">$option</option>\n";
    } else {
       $optionlist.="<option $value >$option</option>\n";
    }
     }      }
   }      $result.=$description.'<select name="'.
   $result.=$description.'<select name="'."$Apache::lonxml::curdepth.$name".'">   "$Apache::lonxml::curdepth.$name".'">
        '.$optionlist.'         '.$optionlist.'
       </select></td></tr><tr><td colspan="3">';        </select>';
   return $result;      return $result;
 }  }
   
 sub select_or_text_arg {  sub select_or_text_arg {
   my ($description,$name,$list,$token,$size) = @_;      my ($description,$name,$list,$token,$size) = @_;
   my $result;      my $result;
   my $optionlist="";      my $optionlist="";
   my $found=0;      my $found=0;
   my $selected=$token->[2]{$name};      my $selected=$token->[2]{$name};
   foreach my $option (@$list) {      foreach my $option (@$list) {
     if ( $selected eq $option ) {   my $value;
       $optionlist.="<option selected=\"on\">$option</option>\n";   if ( ref($option) eq 'ARRAY') {
       $found=1;      $value='value="'.$$option[0].'"';
       $option=$$option[1];
    } else {
       $value='value="'.$option.'"';
    }
    if ( $selected eq $option ) {
       $optionlist.="<option $value selected=\"on\">$option</option>\n";
       $found=1;
    } else {
       $optionlist.="<option $value>$option</option>\n";
    }
       }
       $optionlist.="<option value=\"TYPEDINVALUE\">Type in value</option>\n";
       if (($found) || (!$selected)) {
    $result.=$description.'<select name="'."$Apache::lonxml::curdepth.$name".'">
          '.$optionlist.'
         </select>';
     } else {      } else {
       $optionlist.="<option>$option</option>\n";   $result.=&text_arg($description,$name,$token,$size);
     }      }
   }      return $result;
   $optionlist.="<option value=\"TYPEDINVALUE\">Type in value</option>\n";  }
   if ($found) {  
     $result.=$description.'<select name="'."$Apache::lonxml::curdepth.$name".'">  #----------------------------------------------------- browse
        '.$optionlist.'  sub browse {
       </select></td></tr><tr><td colspan="3">';      # insert a link to call up the filesystem browser (lonindexer)
   } else {      $_ = shift;
     $result.=&text_arg($description,$name,$token,$size);      my $form    = 'lonhomework';
   }      my $element = &Apache::lonnet::escape("$Apache::lonxml::curdepth.$_");
   return $result;      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.19  
changed lines
  Added in v.1.39


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