Annotation of loncom/homework/edit.pm, revision 1.63

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

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