File:  [LON-CAPA] / loncom / homework / edit.pm
Revision 1.49: download - view: text, annotated - select for diffs
Tue May 6 11:54:08 2003 UTC (21 years ago) by www
Branches: MAIN
CVS tags: HEAD
Fix Browse and Search to target id_curdepth instead of curdepth.id (???)
in attribute mode.

Enable clickable coordinate input.

    1: # The LearningOnline Network with CAPA 
    2: # edit mode helpers
    3: #
    4: # $Id: edit.pm,v 1.49 2003/05/06 11:54:08 www Exp $
    5: #
    6: # Copyright Michigan State University Board of Trustees
    7: #
    8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
    9: #
   10: # LON-CAPA is free software; you can redistribute it and/or modify
   11: # it under the terms of the GNU General Public License as published by
   12: # the Free Software Foundation; either version 2 of the License, or
   13: # (at your option) any later version.
   14: #
   15: # LON-CAPA is distributed in the hope that it will be useful,
   16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
   17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   18: # GNU General Public License for more details.
   19: #
   20: # You should have received a copy of the GNU General Public License
   21: # along with LON-CAPA; if not, write to the Free Software
   22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   23: #
   24: # /home/httpd/html/adm/gpl.txt
   25: #
   26: # http://www.lon-capa.org/
   27: #
   28: # 3/20 Guy
   29: # 01/10/02 Matthew
   30: # 03/06/02 Matthew
   31: package Apache::edit; 
   32: 
   33: use strict;
   34: use Apache::lonnet();
   35: use HTML::Entities();
   36: 
   37: # Global Vars
   38: # default list of colors to use in editing
   39: @Apache::edit::colorlist=('#ffffff','#ff0000','#00ff00','#0000ff','#0ff000','#000ff0','#f0000f');
   40: # depth of nesting of edit
   41: $Apache::edit::colordepth=0;
   42: @Apache::edit::inserttag=();
   43: # image-type responses: active background image and curdepth at definition
   44: $Apache::edit::bgimgsrc='';
   45: $Apache::edit::bgimgsrccurdepth='';
   46: 
   47: sub initialize_edit {
   48:   $Apache::edit::colordepth=0;
   49:   @Apache::edit::inserttag=();
   50: }
   51: 
   52: sub tag_start {
   53:   my ($target,$token,$description) = @_;
   54:   my $result='';
   55:   if ($target eq "edit") {
   56:     my $tag=$token->[1];
   57:     if (!$description) {
   58:       $description=&Apache::lonxml::description($token);
   59:       if (!$description) { $description="<$tag>"; }
   60:     }
   61:     $result.= &start_table($token)."<tr><td>$description</td>
   62: <td>Delete".
   63:   &deletelist($target,$token)
   64:   ."</td>
   65: <td>".
   66:     &insertlist($target,$token).&end_row().&start_spanning_row();
   67: #<td>". 
   68: #  &movebuttons($target,$token).
   69: #    "</tr><tr><td colspan=\"3\">\n";
   70:   }
   71:   return $result;
   72: }
   73: 
   74: sub tag_end {
   75:   my ($target,$token,$description) = @_;
   76:   my $result='';
   77:   if ($target eq 'edit') {
   78:     my $tag=$token->[1];
   79:     if (!defined($description)) {
   80:       $result.="</td></tr><tr><td>&lt;/$tag&gt;</td><td colspan=\"2\">&nbsp;</td>";
   81:     } else {
   82:       if ($description ne '') { $result.="</td></tr><tr><td>$description</td><td colspan=\"2\">&nbsp;</td>"; }
   83:     }
   84:     $result.="</tr>".&end_table()."\n";
   85:   }
   86:   return $result;
   87: }
   88: 
   89: sub start_table {
   90:   my ($token)=@_;
   91:   my $tag = $token->[1];
   92:   my $tagnum;
   93:   foreach my $namespace (reverse @Apache::lonxml::namespace) {
   94:     my $testtag=$namespace.'::'.$tag;
   95:     $tagnum=$Apache::lonxml::insertlist{"$testtag.num"};
   96:     if (defined($tagnum)) { last; }
   97:   }
   98:   if (!defined ($tagnum)) { $tagnum=$Apache::lonxml::insertlist{"$tag.num"}; }
   99:   my $color = $Apache::lonxml::insertlist{"$tagnum.color"};
  100:   if (!defined($color)) {
  101:     $color = $Apache::edit::colorlist[$Apache::edit::colordepth];
  102:   }
  103:   $Apache::edit::colordepth++;
  104:   push(@Apache::edit::inserttag,$token->[1]);
  105:   my $result='<div align="right">';
  106:   $result.='<table bgcolor="'.$color.'" width="97%" border="0" cellspacing="5" cellpadding="3">';
  107:   return $result;
  108: }
  109: 
  110: sub end_table {
  111:   $Apache::edit::colordepth--;
  112:   my $result='</table></div>';
  113:   $result.="<table><tr><td>";
  114: 
  115:   my ($tagname,$closingtag);
  116:   if (defined($Apache::edit::inserttag[-2])) {
  117:     $tagname=$Apache::edit::inserttag[-2];
  118:   } else {$tagname='problem';}
  119:   if (defined($Apache::edit::inserttag[-1])) {
  120:     $closingtag=$Apache::edit::inserttag[-1];
  121:   }
  122:   $result.=&innerinsertlist('edit',$tagname,$closingtag).
  123:     "</td></tr></table>";
  124:   pop(@Apache::edit::inserttag);
  125:   return $result;
  126: }
  127: 
  128: sub start_spanning_row { return '<tr><td colspan="3" bgcolor="#DDDDDD">';}
  129: sub start_row          { return '<tr><td bgcolor="#DDDDDD">';            }
  130: sub end_row            { return '</td></tr>';          }
  131: 
  132: sub movebuttons {
  133:   my ($target,$token) = @_;
  134:   my $result='<input type="submit" name="moveup.'.
  135:     $Apache::lonxml::curdepth.'" value="Move Up" />';
  136:   $result.='<input type="submit" name="movedown.'.
  137:     $Apache::lonxml::curdepth.'" value="Move Down" />';
  138:   return $result;
  139: }
  140: 
  141: sub deletelist {
  142:   my ($target,$token) = @_;
  143:   my $result = "<select name=\"delete_$Apache::lonxml::curdepth\">
  144: <option></option>
  145: <option>Yes</option>
  146: </select>";
  147:   return $result;
  148: }
  149: 
  150: sub handle_delete {
  151:   if (!$ENV{"form.delete_$Apache::lonxml::curdepth"}) { return ''; }
  152:   my ($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
  153:   my $result=0;
  154:   if ($space) {
  155:     my $sub1="$space\:\:delete_$token->[1]";
  156:     {
  157:       no strict 'refs';
  158:       if (defined &$sub1) {
  159: 	$result=&$sub1($target,$token,$tagstack,$parstack,$parser,$safeeval,$style);
  160:       }
  161:     }
  162:   }
  163:   if (!$result) {
  164:     my $endtag='/'.$token->[1];
  165:     my $bodytext=&Apache::lonxml::get_all_text($endtag,$parser);
  166:     $$parser['-1']->get_token();
  167:     &Apache::lonxml::debug("Deleting :$bodytext: for $token->[1]");
  168:     &Apache::lonxml::end_tag($tagstack,$parstack,$token);
  169:   }
  170:   return 1;
  171: }
  172: 
  173: sub get_insert_list {
  174:   my ($tagname) = @_;
  175:   my $result='';
  176:   my @tagnums= ();
  177:   #&Apache::lonxml::debug("keys ".join("\n",sort(keys(%Apache::lonxml::insertlist))));
  178:   if ($Apache::lonxml::insertlist{"$tagname.which"}) {
  179:     push (@tagnums, @{ $Apache::lonxml::insertlist{"$tagname.which"} });
  180:   }
  181:   foreach my $namespace (@Apache::lonxml::namespace) {
  182:     if ($Apache::lonxml::insertlist{"$namespace".'::'."$tagname.which"}) {
  183:       push (@tagnums, @{ $Apache::lonxml::insertlist{"$namespace".'::'."$tagname.which"} });
  184:     }
  185:   }
  186:   if (@tagnums) {
  187:     my %options;
  188:     foreach my $tagnum (@tagnums) {
  189:       my $descrip=$Apache::lonxml::insertlist{"$tagnum.description"};
  190:       $options{$descrip} ="<option value=\"$tagnum\">".$descrip."</option>\n";
  191:     }
  192:     foreach my $option (sort(keys(%options))) { $result.=$options{$option}; }
  193:     if ($result) { $result='<option selected="on"></option>'.$result; }
  194:   }
  195:   return $result;
  196: }
  197: 
  198: sub insertlist {
  199:   my ($target,$token) = @_;
  200:   return &innerinsertlist($target,$token->[1]);
  201: }
  202: 
  203: sub innerinsertlist {
  204:   my ($target,$tagname,$closingtag) = @_;
  205:   my $result;
  206:   my $after='';
  207:   if ($closingtag) {
  208:      $after='_after_'.$closingtag; 
  209:   }
  210:   if ($target eq 'edit') {
  211:     my $optionlist= &get_insert_list($tagname);
  212:     if ($optionlist) {
  213:       $result = "Insert:
  214: <select name=\"insert$after\_$Apache::lonxml::curdepth\">
  215: $optionlist
  216: </select>"
  217:     } else {
  218:       $result="&nbsp;";
  219:     }
  220:   }
  221:   return $result;
  222: }
  223: 
  224: sub handle_insert {
  225:   if ($ENV{"form.insert_$Apache::lonxml::curdepth"} eq '') { return ''; }
  226:   my $result;
  227:   my $tagnum = $ENV{"form.insert_$Apache::lonxml::curdepth"};
  228:   my $func=$Apache::lonxml::insertlist{"$tagnum.function"};
  229:   if ($func eq 'default') {
  230:     my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
  231:     my $namespace;
  232:     if ($newtag =~ /::/) { ($namespace,$newtag) = split(/::/,$newtag); }
  233:     $result.="\n<$newtag>\n</$newtag>";
  234:   } else {
  235:     if (defined(&$func)) {
  236:       {
  237: 	no strict 'refs';
  238: 	$result.=&$func();
  239:       }
  240:     } else {
  241:       my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
  242:       &Apache::lonxml::error("Unable to insert tag $newtag, $func was not defined.");
  243:     }
  244:   }
  245:   return $result;
  246: }
  247: 
  248: sub handle_insertafter {
  249:   my $tagname=shift;
  250:   if ($ENV{"form.insert_after_$tagname\_$Apache::lonxml::curdepth"} eq '')
  251:      { return ''; }
  252:   my $result;
  253:   my $tagnum =$ENV{"form.insert_after_$tagname\_$Apache::lonxml::curdepth"};
  254:   my $func=$Apache::lonxml::insertlist{"$tagnum.function"};
  255:   if ($func eq 'default') {
  256:     my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
  257:     my $namespace;
  258:     if ($newtag =~ /::/) { ($namespace,$newtag) = split(/::/,$newtag); }
  259:     $result.="\n<$newtag>\n</$newtag>";
  260:   } else {
  261:     if (defined(&$func)) {
  262:       {
  263: 	no strict 'refs';
  264: 	$result.=&$func();
  265:       }
  266:     } else {
  267:       my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
  268:       &Apache::lonxml::error("Unable to insert (after) tag $newtag, $func was not defined. ($tagname $tagnum)");
  269:     }
  270:   }
  271:   return $result;
  272: }
  273: 
  274: sub insert_responseparam {
  275:   return '
  276:     <responseparam />';
  277: }
  278: 
  279: sub insert_formularesponse {
  280:   return '
  281: <formularesponse answer="" samples="">
  282:     <textline />
  283:     <hintgroup>
  284:     </hintgroup>
  285: </formularesponse>';
  286: }
  287: 
  288: sub insert_numericalresponse {
  289:   return '
  290: <numericalresponse answer="">
  291:     <textline />
  292:     <hintgroup>
  293:     </hintgroup>
  294: </numericalresponse>';
  295: }
  296: 
  297: sub insert_stringresponse {
  298:   return '
  299: <stringresponse answer="" type="">
  300:     <textline />
  301:     <hintgroup>
  302:     </hintgroup>
  303: </stringresponse>';
  304: }
  305: 
  306: sub insert_essayresponse {
  307:   return '
  308: <essayresponse>
  309:     <textfield></textfield>
  310: </essayresponse>';
  311: }
  312: 
  313: sub insert_optionresponse {
  314:   return '
  315: <optionresponse max="10">
  316:     <foilgroup options="">
  317:     </foilgroup>
  318:     <hintgroup>
  319:     </hintgroup>
  320: </optionresponse>';
  321: }
  322: 
  323: sub insert_radiobuttonresponse {
  324:   return '
  325: <radiobuttonresponse max="10">
  326:     <foilgroup>
  327:     </foilgroup>
  328:     <hintgroup>
  329:     </hintgroup>
  330: </radiobuttonresponse>';
  331: }
  332: 
  333: sub insert_rankresponse {
  334:   return '
  335: <rankresponse max="10">
  336:     <foilgroup options="">
  337:     </foilgroup>
  338:     <hintgroup>
  339:     </hintgroup>
  340: </rankresponse>';
  341: }
  342: 
  343: sub insert_matchresponse {
  344:   return '
  345: <matchresponse max="10">
  346:     <foilgroup options="">
  347:       <itemgroup>
  348:       </itemgroup>
  349:     </foilgroup>
  350:     <hintgroup>
  351:     </hintgroup>
  352: </matchresponse>';
  353: }
  354: 
  355: sub insert_displayduedate { return '<displayduedate />'; }
  356: sub insert_displaytitle   { return '<displaytitle />'; }
  357: sub insert_hintpart {
  358:   return '
  359: <hintpart on="default">
  360:     <startouttext/>
  361:     <endouttext />
  362: </hintpart>';
  363: }
  364: 
  365: sub insert_numericalhint {
  366:   return '
  367: <numericalhint>
  368: </numericalhint>';
  369: }
  370: 
  371: sub insert_stringhint {
  372:   return '
  373: <stringhint>
  374: </stringhint>';
  375: }
  376: 
  377: sub insert_formulahint {
  378:   return '
  379: <formulahint>
  380: </formulahint>';
  381: }
  382: 
  383: sub insert_radiobuttonhint {
  384:   return '
  385: <radiobuttonhint>
  386: </radiobuttonhint>';
  387: }
  388: 
  389: sub insert_startouttext {
  390:   return "<startouttext />\n<endouttext />";
  391: }
  392: 
  393: sub insert_script {
  394:   return "\n<script type=\"loncapa/perl\">\n</script>";
  395: }
  396: 
  397: sub textarea_sizes {
  398:   my ($data)=@_;
  399:   my $count=0;
  400:   my $maxlength=-1;
  401:   foreach (split ("\n", $$data)) { $count++;
  402: 	if (length($_) > $maxlength) { $maxlength = length($_); }
  403:       }
  404:   my $rows = $count;
  405:   my $cols = $maxlength;
  406:   return ($rows,$cols);
  407: }
  408: 
  409: sub editline {
  410:     my ($tag,$data,$description,$size)=@_;
  411:     $data=&HTML::Entities::encode($data);
  412:     if ($description) { $description="<br />".$description."<br />"; }
  413:     my $result = <<"END";
  414: $description
  415: <input type="text" name="homework_edit_$Apache::lonxml::curdepth" 
  416:        value="$data" size="$size" />
  417: END
  418:     return $result;
  419: }
  420: 
  421: sub editfield {
  422:   my ($tag,$data,$description,$minwidth,$minheight)=@_;
  423: 
  424:   my ($rows,$cols)=&textarea_sizes(\$data);
  425:   if ($cols > 80) { $cols = 80; }
  426:   if ($cols < $minwidth ) { $cols = $minwidth; }
  427:   if ($rows < $minheight) { $rows = $minheight; }
  428:   if ($description) { $description="<br />".$description."<br />"; }
  429:   return $description."\n".'&nbsp;&nbsp;&nbsp;<textarea rows="'.$rows.
  430:     '" cols="'.$cols.'" name="homework_edit_'.$Apache::lonxml::curdepth.'">'.
  431:       &HTML::Entities::encode($data).'</textarea>'."\n";
  432: }
  433: 
  434: sub modifiedfield {
  435:   my ($token) = @_;
  436:   my $result;
  437: #  foreach my $envkey (sort keys %ENV) {
  438: #    &Apache::lonxml::debug("$envkey ---- $ENV{$envkey}");
  439: #  }
  440: #  &Apache::lonxml::debug("I want homework_edit_$Apache::lonxml::curdepth");
  441: #  &Apache::lonxml::debug($ENV{"form.homework_edit_$Apache::lonxml::curdepth"});
  442:   $result=$ENV{"form.homework_edit_$Apache::lonxml::curdepth"};
  443:   return $result;
  444: }
  445: 
  446: # Returns a 1 if the token has been modified and you should rebuild the tag
  447: # side-effects, will modify the $token if new values are found
  448: sub get_new_args {
  449:   my ($token,$parstack,$safeeval,@args)=@_;
  450:   my $rebuild=0;
  451:   foreach my $arg (@args) {
  452:     #just want the string that it was set to
  453:     my $value=$token->[2]->{$arg};
  454:     my $element=&html_element_name($arg);
  455:     my $newvalue=$ENV{"form.$element"};
  456:     &Apache::lonxml::debug(" for:$arg: cur is :$value: new is :$newvalue:");
  457:     if ($value ne $newvalue) {
  458:       $token->[2]->{$arg}=$newvalue;
  459:       $rebuild=1;
  460:     }
  461:   }
  462:   return $rebuild;
  463: }
  464: 
  465: # looks for /> on start tags
  466: sub rebuild_tag {
  467:   my ($token) = @_;
  468:   my $result;
  469:   if ($token->[0] eq 'S') {
  470:     $result = '<'.$token->[1];
  471:     while (my ($key,$val)= each(%{$token->[2]})) {
  472:       $val=~s:^\s+|\s+$::g;
  473:       $val=~s:"::g; #"
  474:       &Apache::lonxml::debug("setting :$key: to  :$val:");
  475:       $result.=' '.$key.'="'.$val.'"';
  476:     }
  477:     if ($token->[4] =~ m:/>$:) {
  478:       $result.=' />';
  479:     } else {
  480:       $result.='>';
  481:     }
  482:   } elsif ( $token->[0] eq 'E' ) {
  483:     $result = '</'.$token->[1].'>';
  484:   }
  485:   return $result;
  486: }
  487: 
  488: sub html_element_name {
  489:     my ($name) = @_;
  490:     return $name.'_'.$Apache::lonxml::curdepth;
  491: }
  492: 
  493: sub hidden_arg {
  494:     my ($name,$token) = @_;
  495:     my $result;
  496:     my $arg=$token->[2]{$name};
  497:     $result='<input name="'.&html_element_name($name).
  498: 	'" type="hidden" value="'.$arg.'" />';
  499:     return $result;
  500: }
  501: 
  502: sub text_arg {
  503:   my ($description,$name,$token,$size) = @_;
  504:   my $result;
  505:   if (!defined $size) { $size=20; }
  506:   my $arg=$token->[2]{$name};
  507:   $result=$description.'&nbsp;<input name="'.&html_element_name($name).
  508:     '" type="text" value="'.$arg.'" size="'.$size.'" />';
  509:   return $result;
  510: }
  511: 
  512: sub select_arg {
  513:     my ($description,$name,$list,$token) = @_;
  514:     my $result;
  515:     my $optionlist="";
  516:     my $selected=$token->[2]{$name};
  517:     foreach my $option (@$list) {
  518: 	my $value;
  519: 	if ( ref($option) eq 'ARRAY') {
  520: 	    $value='value="'.$$option[0].'"';
  521: 	    $option=$$option[1];
  522: 	} else {
  523: 	    $value='value="'.$option.'"';
  524: 	}
  525: 	if ( $selected eq $option ) {
  526: 	    $optionlist.="<option $value selected=\"on\">$option</option>\n";
  527: 	} else {
  528: 	    $optionlist.="<option $value >$option</option>\n";
  529: 	}
  530:     }
  531:     $result.=$description.'&nbsp;<select name="'.&html_element_name($name).
  532:         '">
  533:        '.$optionlist.'
  534:       </select>';
  535:     return $result;
  536: }
  537: 
  538: sub select_or_text_arg {
  539:     my ($description,$name,$list,$token,$size) = @_;
  540:     my $result;
  541:     my $optionlist="";
  542:     my $found=0;
  543:     my $selected=$token->[2]{$name};
  544:     foreach my $option (@$list) {
  545: 	my $value;
  546: 	if ( ref($option) eq 'ARRAY') {
  547: 	    $value='value="'.$$option[0].'"';
  548: 	    $option=$$option[1];
  549: 	} else {
  550: 	    $value='value="'.$option.'"';
  551: 	}
  552: 	if ( $selected eq $option ) {
  553: 	    $optionlist.="<option $value selected=\"on\">$option</option>\n";
  554: 	    $found=1;
  555: 	} else {
  556: 	    $optionlist.="<option $value>$option</option>\n";
  557: 	}
  558:     }
  559:     $optionlist.="<option value=\"TYPEDINVALUE\">Type in value</option>\n";
  560:     if (($found) || (!$selected)) {
  561: 	$result.=$description.'&nbsp;<select name="'.&html_element_name($name)
  562:             .'">
  563:        '.$optionlist.'
  564:       </select>';
  565:     } else {
  566: 	$result.=&text_arg($description,$name,$token,$size);
  567:     }
  568:     return $result;
  569: }
  570: 
  571: #----------------------------------------------------- image coordinates
  572: # single image coordinates, x, y 
  573: sub entercoords {
  574:     my ($idx,,$idy,$mode,$width,$height) = @_;
  575:     unless ($Apache::edit::bgimgsrc) { return ''; }
  576:     if ($idx) { $idx.='_'; }
  577:     if ($idy) { $idy.='_'; }
  578:     my $bgfile=&Apache::lonnet::escape($Apache::edit::bgimgsrc);
  579:     my $form    = 'lonhomework';
  580:     my $element;
  581:     if (! defined($mode) || $mode eq 'attribute') {
  582:         $element = &Apache::lonnet::escape("$Apache::lonxml::curdepth");
  583:     } elsif ($mode eq 'textnode') {  # for data between <tag> ... </tag>
  584:         $element = &Apache::lonnet::escape('homework_edit_'.
  585:                                            $Apache::lonxml::curdepth);
  586:     }
  587:     my $formheight='';
  588:     if ($height) {
  589: 	$formheight='&formheight='.$height.'_'.$Apache::edit::bgimgsrccurdepth;
  590:     }
  591:     my $formwidth='';
  592:     if ($width) {
  593: 	$formwidth='&formwidth='.$width.'_'.$Apache::edit::bgimgsrccurdepth;
  594:     }
  595:     my $result = <<"ENDBUTTON";
  596: <a href="/cgi-bin/imagechoice.pl?formname=$form&file=$bgfile&formx=$idx$element&formy=$idy$element$formheight$formwidth"
  597: target="imagechoice">Click Coordinates</a>
  598: ENDBUTTON
  599:     return $result;
  600: }
  601: 
  602: # coordinate pair (x1,y1)-(x2,y2)
  603: sub entercoordpair {
  604:     my ($id,$mode,$width,$height) = @_;
  605:     unless ($Apache::edit::bgimgsrc) { return ''; }
  606:     my $bgfile=&Apache::lonnet::escape($Apache::edit::bgimgsrc);
  607:     my $form    = 'lonhomework';
  608:     my $element;
  609:     if (! defined($mode) || $mode eq 'attribute') {
  610:         $element = &Apache::lonnet::escape("$id\_$Apache::lonxml::curdepth");
  611:     } elsif ($mode eq 'textnode') {  # for data between <tag> ... </tag>
  612:         $element = &Apache::lonnet::escape('homework_edit_'.
  613:                                            $Apache::lonxml::curdepth);
  614:     }
  615:     my $formheight='';
  616:     if ($height) {
  617: 	$formheight='&formheight='.$height.'_'.$Apache::edit::bgimgsrccurdepth;
  618:     }
  619:     my $formwidth='';
  620:     if ($width) {
  621: 	$formwidth='&formwidth='.$width.'_'.$Apache::edit::bgimgsrccurdepth;
  622:     }
  623:     my $result = <<"ENDBUTTON";
  624: <a href="/cgi-bin/imagechoice.pl?mode=pair&formname=$form&file=$bgfile$formheight$formwidth"
  625: target="imagechoice">Click Coordinate Pair</a>
  626: ENDBUTTON
  627:     return $result;
  628: }
  629: #----------------------------------------------------- browse
  630: sub browse {
  631:     # insert a link to call up the filesystem browser (lonindexer)
  632:     my ($id, $mode) = @_;
  633:     my $form    = 'lonhomework';
  634:     my $element;
  635:     if (! defined($mode) || $mode eq 'attribute') {
  636:         $element = &Apache::lonnet::escape("$id\_$Apache::lonxml::curdepth");
  637:     } elsif ($mode eq 'textnode') {  # for data between <tag> ... </tag>
  638:         $element = &Apache::lonnet::escape('homework_edit_'.
  639:                                            $Apache::lonxml::curdepth);
  640:     }
  641:     my $result = <<"ENDBUTTON";
  642: <a href=\"javascript:openbrowser('$form','$element')\"\>Browse</a>
  643: ENDBUTTON
  644:     return $result;
  645: }
  646: 
  647: #----------------------------------------------------- browse
  648: sub search {
  649:     # insert a link to call up the filesystem browser (lonindexer)
  650:     my ($id, $mode) = @_;
  651:     my $form    = 'lonhomework';
  652:     my $element;
  653:     if (! defined($mode) || $mode eq 'attribute') {
  654:         $element = &Apache::lonnet::escape("$id\_$Apache::lonxml::curdepth");
  655:     } elsif ($mode eq 'textnode') {  # for data between <tag> ... </tag>
  656:         $element = &Apache::lonnet::escape('homework_edit_'.
  657:                                            $Apache::lonxml::curdepth);
  658:     }
  659:     my $result = <<"ENDBUTTON";
  660: <a href=\"javascript:opensearcher('$form','$element')\"\>Search</a>
  661: ENDBUTTON
  662:     return $result;
  663: }
  664: 
  665: 
  666: 1;
  667: __END__
  668: 
  669: =head1 NAME
  670: 
  671: Apache::edit - edit mode helpers
  672: 
  673: =head1 SYNOPSIS
  674: 
  675: Invoked by many homework and xml related modules.
  676: 
  677:  &Apache::edit::SUBROUTINENAME(ARGUMENTS);
  678: 
  679: =head1 INTRODUCTION
  680: 
  681: This module outputs HTML syntax helpful for the rendering of edit
  682: mode interfaces.
  683: 
  684: This is part of the LearningOnline Network with CAPA project
  685: described at http://www.lon-capa.org.
  686: 
  687: =head1 HANDLER SUBROUTINE
  688: 
  689: There is no handler subroutine.
  690: 
  691: =head1 OTHER SUBROUTINES
  692: 
  693: =over 4
  694: 
  695: =item *
  696: 
  697: initialize_edit() : initialize edit (set colordepth to zero)
  698: 
  699: =item *
  700: 
  701: tag_start($target,$token,$description) : provide deletion and insertion lists
  702: for the manipulation of a start tag; return a scalar string
  703: 
  704: =item *
  705: 
  706: tag_end($target,$token,$description) : ending syntax corresponding to
  707: &tag_start. return a scalar string.
  708: 
  709: =item *
  710: 
  711: start_table($token) : start table; update colordepth; return scalar string.
  712: 
  713: =item *
  714: 
  715: end_table() : reduce color depth; end table; return scalar string
  716: 
  717: =item *
  718: 
  719: start_spanning_row() : start a new table row spanning the 'edit' environment.
  720: 
  721: =item *
  722: 
  723: start_row() : start a new table row and element. 
  724: 
  725: =item *
  726: 
  727: end_row() : end current table element and row.
  728: 
  729: =item *
  730: 
  731: movebuttons($target,$token) : move-up and move-down buttons; return scalar
  732: string
  733: 
  734: =item *
  735: 
  736: deletelist($target,$token) : provide a yes option in an HTML select element;
  737: return scalar string
  738: 
  739: =item *
  740: 
  741: handle_delete($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,
  742: $style) : respond to a user delete request by passing relevant stack
  743: and array information to various rendering functions; return a scalar string
  744: 
  745: =item *
  746: 
  747: get_insert_list($token) : provide an insertion list based on possibilities
  748: from lonxml; return a scalar string
  749: 
  750: =item *
  751: 
  752: insertlist($target,$token) : api that uses get_insert_list;
  753: return a scalar string
  754: 
  755: =item *
  756: 
  757: handleinsert($token) : provide an insertion list based on possibilities
  758: from lonxml; return a scalar string
  759: 
  760: =item *
  761: 
  762: get_insert_list($token) : provide an insertion list based on possibilities
  763: from lonxml; return a scalar string
  764: 
  765: =item *
  766: browse($elementname) : provide a link which will open up the filesystem
  767: browser (lonindexer) and, once a file is selected, place the result in
  768: the form element $elementname.
  769: 
  770: =item *
  771: search($elementname) : provide a link which will open up the filesystem
  772: searcher (lonsearchcat) and, once a file is selected, place the result in
  773: the form element $elementname.
  774: 
  775: =item *
  776: editline(tag,data,description,size): Provide a <input type="text" ../> for
  777: single-line text entry.  This is to be used for text enclosed by tags, not
  778: arguements/parameters associated with a tag.
  779: 
  780: =back
  781: 
  782: incomplete...
  783: 
  784: =cut

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