1: # The LearningOnline Network with CAPA
2: # edit mode helpers
3: #
4: # $Id: edit.pm,v 1.45 2003/02/07 22:03:21 albertel 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:
44: sub initialize_edit {
45: $Apache::edit::colordepth=0;
46: @Apache::edit::inserttag=();
47: }
48:
49: sub tag_start {
50: my ($target,$token,$description) = @_;
51: my $result='';
52: if ($target eq "edit") {
53: my $tag=$token->[1];
54: if (!$description) {
55: $description=&Apache::lonxml::description($token);
56: if (!$description) { $description="<$tag>"; }
57: }
58: $result.= &start_table($token)."<tr><td>$description</td>
59: <td>Delete".
60: &deletelist($target,$token)
61: ."</td>
62: <td>".
63: &insertlist($target,$token).&end_row().&start_spanning_row();
64: #<td>".
65: # &movebuttons($target,$token).
66: # "</tr><tr><td colspan=\"3\">\n";
67: }
68: return $result;
69: }
70:
71: sub tag_end {
72: my ($target,$token,$description) = @_;
73: my $result='';
74: if ($target eq 'edit') {
75: my $tag=$token->[1];
76: if (!defined($description)) {
77: $result.="</td></tr><tr><td></$tag></td><td colspan=\"2\"> </td>";
78: } else {
79: if ($description ne '') { $result.="</td></tr><tr><td>$description</td><td colspan=\"2\"> </td>"; }
80: }
81: $result.="</tr>".&end_table()."\n";
82: }
83: return $result;
84: }
85:
86: sub start_table {
87: my ($token)=@_;
88: my $tag = $token->[1];
89: my $tagnum;
90: foreach my $namespace (reverse @Apache::lonxml::namespace) {
91: my $testtag=$namespace.'::'.$tag;
92: $tagnum=$Apache::lonxml::insertlist{"$testtag.num"};
93: if (defined($tagnum)) { last; }
94: }
95: if (!defined ($tagnum)) { $tagnum=$Apache::lonxml::insertlist{"$tag.num"}; }
96: my $color = $Apache::lonxml::insertlist{"$tagnum.color"};
97: if (!defined($color)) {
98: $color = $Apache::edit::colorlist[$Apache::edit::colordepth];
99: }
100: $Apache::edit::colordepth++;
101: push(@Apache::edit::inserttag,$token->[1]);
102: my $result='<div align="right">';
103: $result.='<table bgcolor="'.$color.'" width="97%" border="0" cellspacing="5" cellpadding="3">';
104: return $result;
105: }
106:
107: sub end_table {
108: $Apache::edit::colordepth--;
109: my $result='</table></div>';
110: $result.="<table><tr><td>";
111:
112: my ($tagname,$closingtag);
113: if (defined($Apache::edit::inserttag[-2])) {
114: $tagname=$Apache::edit::inserttag[-2];
115: } else {$tagname='problem';}
116: if (defined($Apache::edit::inserttag[-1])) {
117: $closingtag=$Apache::edit::inserttag[-1];
118: }
119: $result.=&innerinsertlist('edit',$tagname,$closingtag).
120: "</td></tr></table>";
121: pop(@Apache::edit::inserttag);
122: return $result;
123: }
124:
125: sub start_spanning_row { return '<tr><td colspan="3" bgcolor="#DDDDDD">';}
126: sub start_row { return '<tr><td bgcolor="#DDDDDD">'; }
127: sub end_row { return '</td></tr>'; }
128:
129: sub movebuttons {
130: my ($target,$token) = @_;
131: my $result='<input type="submit" name="moveup.'.
132: $Apache::lonxml::curdepth.'" value="Move Up" />';
133: $result.='<input type="submit" name="movedown.'.
134: $Apache::lonxml::curdepth.'" value="Move Down" />';
135: return $result;
136: }
137:
138: sub deletelist {
139: my ($target,$token) = @_;
140: my $result = "<select name=\"delete_$Apache::lonxml::curdepth\">
141: <option></option>
142: <option>Yes</option>
143: </select>";
144: return $result;
145: }
146:
147: sub handle_delete {
148: if (!$ENV{"form.delete_$Apache::lonxml::curdepth"}) { return ''; }
149: my ($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
150: my $result=0;
151: if ($space) {
152: my $sub1="$space\:\:delete_$token->[1]";
153: {
154: no strict 'refs';
155: if (defined &$sub1) {
156: $result=&$sub1($target,$token,$tagstack,$parstack,$parser,$safeeval,$style);
157: }
158: }
159: }
160: if (!$result) {
161: my $endtag='/'.$token->[1];
162: my $bodytext=&Apache::lonxml::get_all_text($endtag,$parser);
163: $$parser['-1']->get_token();
164: &Apache::lonxml::debug("Deleting :$bodytext: for $token->[1]");
165: &Apache::lonxml::end_tag($tagstack,$parstack,$token);
166: }
167: return 1;
168: }
169:
170: sub get_insert_list {
171: my ($tagname) = @_;
172: my $result='';
173: my @tagnums= ();
174: #&Apache::lonxml::debug("keys ".join("\n",sort(keys(%Apache::lonxml::insertlist))));
175: if ($Apache::lonxml::insertlist{"$tagname.which"}) {
176: push (@tagnums, @{ $Apache::lonxml::insertlist{"$tagname.which"} });
177: }
178: foreach my $namespace (@Apache::lonxml::namespace) {
179: if ($Apache::lonxml::insertlist{"$namespace".'::'."$tagname.which"}) {
180: push (@tagnums, @{ $Apache::lonxml::insertlist{"$namespace".'::'."$tagname.which"} });
181: }
182: }
183: if (@tagnums) {
184: my %options;
185: foreach my $tagnum (@tagnums) {
186: my $descrip=$Apache::lonxml::insertlist{"$tagnum.description"};
187: $options{$descrip} ="<option value=\"$tagnum\">".$descrip."</option>\n";
188: }
189: foreach my $option (sort(keys(%options))) { $result.=$options{$option}; }
190: if ($result) { $result='<option selected="on"></option>'.$result; }
191: }
192: return $result;
193: }
194:
195: sub insertlist {
196: my ($target,$token) = @_;
197: return &innerinsertlist($target,$token->[1]);
198: }
199:
200: sub innerinsertlist {
201: my ($target,$tagname,$closingtag) = @_;
202: my $result;
203: my $after='';
204: if ($closingtag) {
205: $after='_after_'.$closingtag;
206: }
207: if ($target eq 'edit') {
208: my $optionlist= &get_insert_list($tagname);
209: if ($optionlist) {
210: $result = "Insert:
211: <select name=\"insert$after\_$Apache::lonxml::curdepth\">
212: $optionlist
213: </select>"
214: } else {
215: $result=" ";
216: }
217: }
218: return $result;
219: }
220:
221: sub handle_insert {
222: if ($ENV{"form.insert_$Apache::lonxml::curdepth"} eq '') { return ''; }
223: my $result;
224: my $tagnum = $ENV{"form.insert_$Apache::lonxml::curdepth"};
225: my $func=$Apache::lonxml::insertlist{"$tagnum.function"};
226: if ($func eq 'default') {
227: my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
228: my $namespace;
229: if ($newtag =~ /::/) { ($namespace,$newtag) = split(/::/,$newtag); }
230: $result.="\n<$newtag>\n</$newtag>";
231: } else {
232: if (defined(&$func)) {
233: {
234: no strict 'refs';
235: $result.=&$func();
236: }
237: } else {
238: my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
239: &Apache::lonxml::error("Unable to insert tag $newtag, $func was not defined.");
240: }
241: }
242: return $result;
243: }
244:
245: sub handle_insertafter {
246: my $tagname=shift;
247: if ($ENV{"form.insert_after_$tagname\_$Apache::lonxml::curdepth"} eq '')
248: { return ''; }
249: my $result;
250: my $tagnum =$ENV{"form.insert_after_$tagname\_$Apache::lonxml::curdepth"};
251: my $func=$Apache::lonxml::insertlist{"$tagnum.function"};
252: if ($func eq 'default') {
253: my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
254: my $namespace;
255: if ($newtag =~ /::/) { ($namespace,$newtag) = split(/::/,$newtag); }
256: $result.="\n<$newtag>\n</$newtag>";
257: } else {
258: if (defined(&$func)) {
259: {
260: no strict 'refs';
261: $result.=&$func();
262: }
263: } else {
264: my $newtag=$Apache::lonxml::insertlist{"$tagnum.tag"};
265: &Apache::lonxml::error("Unable to insert (after) tag $newtag, $func was not defined. ($tagname $tagnum)");
266: }
267: }
268: return $result;
269: }
270:
271: sub insert_responseparam {
272: return '
273: <responseparam />';
274: }
275:
276: sub insert_formularesponse {
277: return '
278: <formularesponse answer="" samples="">
279: <textline />
280: <hintgroup>
281: </hintgroup>
282: </formularesponse>';
283: }
284:
285: sub insert_numericalresponse {
286: return '
287: <numericalresponse answer="">
288: <textline />
289: <hintgroup>
290: </hintgroup>
291: </numericalresponse>';
292: }
293:
294: sub insert_stringresponse {
295: return '
296: <stringresponse answer="" type="">
297: <textline />
298: <hintgroup>
299: </hintgroup>
300: </stringresponse>';
301: }
302:
303: sub insert_essayresponse {
304: return '
305: <essayresponse>
306: <textfield></textfield>
307: </essayresponse>';
308: }
309:
310: sub insert_optionresponse {
311: return '
312: <optionresponse max="10">
313: <foilgroup options="">
314: </foilgroup>
315: <hintgroup>
316: </hintgroup>
317: </optionresponse>';
318: }
319:
320: sub insert_radiobuttonresponse {
321: return '
322: <radiobuttonresponse max="10">
323: <foilgroup>
324: </foilgroup>
325: <hintgroup>
326: </hintgroup>
327: </radiobuttonresponse>';
328: }
329:
330: sub insert_rankresponse {
331: return '
332: <rankresponse max="10">
333: <foilgroup options="">
334: </foilgroup>
335: <hintgroup>
336: </hintgroup>
337: </rankresponse>';
338: }
339:
340: sub insert_matchresponse {
341: return '
342: <matchresponse max="10">
343: <foilgroup options="">
344: <itemgroup>
345: </itemgroup>
346: </foilgroup>
347: <hintgroup>
348: </hintgroup>
349: </matchresponse>';
350: }
351:
352: sub insert_displayduedate { return '<displayduedate />'; }
353: sub insert_displaytitle { return '<displaytitle />'; }
354: sub insert_hintpart {
355: return '
356: <hintpart on="default">
357: <startouttext/>
358: <endouttext />
359: </hintpart>';
360: }
361:
362: sub insert_numericalhint {
363: return '
364: <numericalhint>
365: </numericalhint>';
366: }
367:
368: sub insert_radiobuttonhint {
369: return '
370: <radiobuttonhint>
371: </radiobuttonhint>';
372: }
373:
374: sub insert_startouttext {
375: return "<startouttext />\n<endouttext />";
376: }
377:
378: sub insert_script {
379: return "\n<script type=\"loncapa/perl\">\n</script>";
380: }
381:
382: sub textarea_sizes {
383: my ($data)=@_;
384: my $count=0;
385: my $maxlength=-1;
386: foreach (split ("\n", $$data)) { $count++;
387: if (length($_) > $maxlength) { $maxlength = length($_); }
388: }
389: my $rows = $count;
390: my $cols = $maxlength;
391: return ($rows,$cols);
392: }
393:
394: sub editline {
395: my ($tag,$data,$description,$size)=@_;
396: $data=&HTML::Entities::encode($data);
397: if ($description) { $description="<br />".$description."<br />"; }
398: my $result = <<"END";
399: $description
400: <input type="text" name="homework_edit_$Apache::lonxml::curdepth"
401: value="$data" size="$size" />
402: END
403: return $result;
404: }
405:
406: sub editfield {
407: my ($tag,$data,$description,$minwidth,$minheight)=@_;
408:
409: my ($rows,$cols)=&textarea_sizes(\$data);
410: if ($cols > 80) { $cols = 80; }
411: if ($cols < $minwidth ) { $cols = $minwidth; }
412: if ($rows < $minheight) { $rows = $minheight; }
413: if ($description) { $description="<br />".$description."<br />"; }
414: return $description."\n".' <textarea rows="'.$rows.
415: '" cols="'.$cols.'" name="homework_edit_'.$Apache::lonxml::curdepth.'">'.
416: &HTML::Entities::encode($data).'</textarea>'."\n";
417: }
418:
419: sub modifiedfield {
420: my ($token) = @_;
421: my $result;
422: # foreach my $envkey (sort keys %ENV) {
423: # &Apache::lonxml::debug("$envkey ---- $ENV{$envkey}");
424: # }
425: # &Apache::lonxml::debug("I want homework_edit_$Apache::lonxml::curdepth");
426: # &Apache::lonxml::debug($ENV{"form.homework_edit_$Apache::lonxml::curdepth"});
427: $result=$ENV{"form.homework_edit_$Apache::lonxml::curdepth"};
428: return $result;
429: }
430:
431: # Returns a 1 if the token has been modified and you should rebuild the tag
432: # side-effects, will modify the $token if new values are found
433: sub get_new_args {
434: my ($token,$parstack,$safeeval,@args)=@_;
435: my $rebuild=0;
436: foreach my $arg (@args) {
437: #just want the string that it was set to
438: my $value=$token->[2]->{$arg};
439: my $newvalue=$ENV{"form.$Apache::lonxml::curdepth.$arg"};
440: &Apache::lonxml::debug(" for:$arg: cur is :$value: new is :$newvalue:");
441: if ($value ne $newvalue) {
442: $token->[2]->{$arg}=$newvalue;
443: $rebuild=1;
444: }
445: }
446: return $rebuild;
447: }
448:
449: # looks for /> on start tags
450: sub rebuild_tag {
451: my ($token) = @_;
452: my $result;
453: if ($token->[0] eq 'S') {
454: $result = '<'.$token->[1];
455: while (my ($key,$val)= each(%{$token->[2]})) {
456: $val=~s:^\s+|\s+$::g;
457: $val=~s:"::g; #"
458: &Apache::lonxml::debug("setting :$key: to :$val:");
459: $result.=' '.$key.'="'.$val.'"';
460: }
461: if ($token->[4] =~ m:/>$:) {
462: $result.=' />';
463: } else {
464: $result.='>';
465: }
466: } elsif ( $token->[0] eq 'E' ) {
467: $result = '</'.$token->[1].'>';
468: }
469: return $result;
470: }
471:
472: sub text_arg {
473: my ($description,$name,$token,$size) = @_;
474: my $result;
475: if (!defined $size) { $size=20; }
476: my $arg=$token->[2]{$name};
477: $result=$description.' <input name="'."$Apache::lonxml::curdepth.$name".
478: '" type="text" value="'.$arg.'" size="'.$size.'" />';
479: return $result;
480: }
481:
482: sub select_arg {
483: my ($description,$name,$list,$token) = @_;
484: my $result;
485: my $optionlist="";
486: my $selected=$token->[2]{$name};
487: foreach my $option (@$list) {
488: my $value;
489: if ( ref($option) eq 'ARRAY') {
490: $value='value="'.$$option[0].'"';
491: $option=$$option[1];
492: } else {
493: $value='value="'.$option.'"';
494: }
495: if ( $selected eq $option ) {
496: $optionlist.="<option $value selected=\"on\">$option</option>\n";
497: } else {
498: $optionlist.="<option $value >$option</option>\n";
499: }
500: }
501: $result.=$description.' <select name="'.
502: "$Apache::lonxml::curdepth.$name".'">
503: '.$optionlist.'
504: </select>';
505: return $result;
506: }
507:
508: sub select_or_text_arg {
509: my ($description,$name,$list,$token,$size) = @_;
510: my $result;
511: my $optionlist="";
512: my $found=0;
513: my $selected=$token->[2]{$name};
514: foreach my $option (@$list) {
515: my $value;
516: if ( ref($option) eq 'ARRAY') {
517: $value='value="'.$$option[0].'"';
518: $option=$$option[1];
519: } else {
520: $value='value="'.$option.'"';
521: }
522: if ( $selected eq $option ) {
523: $optionlist.="<option $value selected=\"on\">$option</option>\n";
524: $found=1;
525: } else {
526: $optionlist.="<option $value>$option</option>\n";
527: }
528: }
529: $optionlist.="<option value=\"TYPEDINVALUE\">Type in value</option>\n";
530: if (($found) || (!$selected)) {
531: $result.=$description.' <select name="'."$Apache::lonxml::curdepth.$name".'">
532: '.$optionlist.'
533: </select>';
534: } else {
535: $result.=&text_arg($description,$name,$token,$size);
536: }
537: return $result;
538: }
539:
540: #----------------------------------------------------- browse
541: sub browse {
542: # insert a link to call up the filesystem browser (lonindexer)
543: my ($id, $mode) = @_;
544: my $form = 'lonhomework';
545: my $element;
546: if (! defined($mode) || $mode eq 'attribute') {
547: $element = &Apache::lonnet::escape("$Apache::lonxml::curdepth.$id");
548: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
549: $element = &Apache::lonnet::escape('homework_edit_'.
550: $Apache::lonxml::curdepth);
551: }
552: my $result = <<"ENDBUTTON";
553: <a href=\"javascript:openbrowser('$form','$element')\"\>Browse</a>
554: ENDBUTTON
555: return $result;
556: }
557:
558: #----------------------------------------------------- browse
559: sub search {
560: # insert a link to call up the filesystem browser (lonindexer)
561: $_ = shift;
562: my $form = 'lonhomework';
563: my $element = &Apache::lonnet::escape("$Apache::lonxml::curdepth.$_");
564: my $result = <<"ENDBUTTON";
565: <a href=\"javascript:opensearcher('$form','$element')\"\>Search</a>
566: ENDBUTTON
567: return $result;
568: }
569:
570:
571: 1;
572: __END__
573:
574: =head1 NAME
575:
576: Apache::edit - edit mode helpers
577:
578: =head1 SYNOPSIS
579:
580: Invoked by many homework and xml related modules.
581:
582: &Apache::edit::SUBROUTINENAME(ARGUMENTS);
583:
584: =head1 INTRODUCTION
585:
586: This module outputs HTML syntax helpful for the rendering of edit
587: mode interfaces.
588:
589: This is part of the LearningOnline Network with CAPA project
590: described at http://www.lon-capa.org.
591:
592: =head1 HANDLER SUBROUTINE
593:
594: There is no handler subroutine.
595:
596: =head1 OTHER SUBROUTINES
597:
598: =over 4
599:
600: =item *
601:
602: initialize_edit() : initialize edit (set colordepth to zero)
603:
604: =item *
605:
606: tag_start($target,$token,$description) : provide deletion and insertion lists
607: for the manipulation of a start tag; return a scalar string
608:
609: =item *
610:
611: tag_end($target,$token,$description) : ending syntax corresponding to
612: &tag_start. return a scalar string.
613:
614: =item *
615:
616: start_table($token) : start table; update colordepth; return scalar string.
617:
618: =item *
619:
620: end_table() : reduce color depth; end table; return scalar string
621:
622: =item *
623:
624: start_spanning_row() : start a new table row spanning the 'edit' environment.
625:
626: =item *
627:
628: start_row() : start a new table row and element.
629:
630: =item *
631:
632: end_row() : end current table element and row.
633:
634: =item *
635:
636: movebuttons($target,$token) : move-up and move-down buttons; return scalar
637: string
638:
639: =item *
640:
641: deletelist($target,$token) : provide a yes option in an HTML select element;
642: return scalar string
643:
644: =item *
645:
646: handle_delete($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,
647: $style) : respond to a user delete request by passing relevant stack
648: and array information to various rendering functions; return a scalar string
649:
650: =item *
651:
652: get_insert_list($token) : provide an insertion list based on possibilities
653: from lonxml; return a scalar string
654:
655: =item *
656:
657: insertlist($target,$token) : api that uses get_insert_list;
658: return a scalar string
659:
660: =item *
661:
662: handleinsert($token) : provide an insertion list based on possibilities
663: from lonxml; return a scalar string
664:
665: =item *
666:
667: get_insert_list($token) : provide an insertion list based on possibilities
668: from lonxml; return a scalar string
669:
670: =item *
671: browse($elementname) : provide a link which will open up the filesystem
672: browser (lonindexer) and, once a file is selected, place the result in
673: the form element $elementname.
674:
675: =item *
676: search($elementname) : provide a link which will open up the filesystem
677: searcher (lonsearchcat) and, once a file is selected, place the result in
678: the form element $elementname.
679:
680: =item *
681: editline(tag,data,description,size): Provide a <input type="text" ../> for
682: single-line text entry. This is to be used for text enclosed by tags, not
683: arguements/parameters associated with a tag.
684:
685: =back
686:
687: incomplete...
688:
689: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to edit.pm CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / loncom / homework