1: # The LearningOnline Network with CAPA
2: # edit mode helpers
3: #
4: # $Id: edit.pm,v 1.42 2002/11/14 16:47:41 matthew 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[$#$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_displayduedate { return '<displayduedate />'; }
331: sub insert_displaytitle { return '<displaytitle />'; }
332: sub insert_hintpart {
333: return '
334: <hintpart on="default">
335: <startouttext/>
336: <endouttext />
337: </hintpart>';
338: }
339:
340: sub insert_numericalhint {
341: return '
342: <numericalhint>
343: </numericalhint>';
344: }
345:
346: sub insert_radiobuttonhint {
347: return '
348: <radiobuttonhint>
349: </radiobuttonhint>';
350: }
351:
352: sub insert_startouttext {
353: return "<startouttext />\n<endouttext />";
354: }
355:
356: sub insert_script {
357: return "\n<script type=\"loncapa/perl\">\n</script>";
358: }
359:
360: sub textarea_sizes {
361: my ($data)=@_;
362: my $count=0;
363: my $maxlength=-1;
364: foreach (split ("\n", $$data)) { $count++;
365: if (length($_) > $maxlength) { $maxlength = length($_); }
366: }
367: my $rows = $count;
368: my $cols = $maxlength;
369: return ($rows,$cols);
370: }
371:
372: sub editline {
373: my ($tag,$data,$description,$size)=@_;
374: $data=&HTML::Entities::encode($data);
375: if ($description) { $description="<br />".$description."<br />"; }
376: my $result = <<"END";
377: $description
378: <input type="text" name="homework_edit_$Apache::lonxml::curdepth"
379: value="$data" size="$size" />
380: END
381: return $result;
382: }
383:
384: sub editfield {
385: my ($tag,$data,$description,$minwidth,$minheight)=@_;
386:
387: my ($rows,$cols)=&textarea_sizes(\$data);
388: if ($cols > 80) { $cols = 80; }
389: if ($cols < $minwidth ) { $cols = $minwidth; }
390: if ($rows < $minheight) { $rows = $minheight; }
391: if ($description) { $description="<br />".$description."<br />"; }
392: return $description."\n".' <textarea rows="'.$rows.
393: '" cols="'.$cols.'" name="homework_edit_'.$Apache::lonxml::curdepth.'">'.
394: &HTML::Entities::encode($data).'</textarea>'."\n";
395: }
396:
397: sub modifiedfield {
398: my ($token) = @_;
399: my $result;
400: # foreach my $envkey (sort keys %ENV) {
401: # &Apache::lonxml::debug("$envkey ---- $ENV{$envkey}");
402: # }
403: # &Apache::lonxml::debug("I want homework_edit_$Apache::lonxml::curdepth");
404: # &Apache::lonxml::debug($ENV{"form.homework_edit_$Apache::lonxml::curdepth"});
405: $result=$ENV{"form.homework_edit_$Apache::lonxml::curdepth"};
406: return $result;
407: }
408:
409: # Returns a 1 if the token has been modified and you should rebuild the tag
410: # side-effects, will modify the $token if new values are found
411: sub get_new_args {
412: my ($token,$parstack,$safeeval,@args)=@_;
413: my $rebuild=0;
414: foreach my $arg (@args) {
415: #just want the string that it was set to
416: my $value=$token->[2]->{$arg};
417: my $newvalue=$ENV{"form.$Apache::lonxml::curdepth.$arg"};
418: &Apache::lonxml::debug(" for:$arg: cur is :$value: new is :$newvalue:");
419: if ($value ne $newvalue) {
420: $token->[2]->{$arg}=$newvalue;
421: $rebuild=1;
422: }
423: }
424: return $rebuild;
425: }
426:
427: # looks for /> on start tags
428: sub rebuild_tag {
429: my ($token) = @_;
430: my $result;
431: if ($token->[0] eq 'S') {
432: $result = '<'.$token->[1];
433: while (my ($key,$val)= each(%{$token->[2]})) {
434: $val=~s:^\s+|\s+$::g;
435: $val=~s:"::g; #"
436: &Apache::lonxml::debug("setting :$key: to :$val:");
437: $result.=' '.$key.'="'.$val.'"';
438: }
439: if ($token->[4] =~ m:/>$:) {
440: $result.=' />';
441: } else {
442: $result.='>';
443: }
444: } elsif ( $token->[0] eq 'E' ) {
445: $result = '</'.$token->[1].'>';
446: }
447: return $result;
448: }
449:
450: sub text_arg {
451: my ($description,$name,$token,$size) = @_;
452: my $result;
453: if (!defined $size) { $size=20; }
454: my $arg=$token->[2]{$name};
455: $result=$description.'<input name="'."$Apache::lonxml::curdepth.$name".
456: '" type="text" value="'.$arg.'" size="'.$size.'" />';
457: return $result;
458: }
459:
460: sub select_arg {
461: my ($description,$name,$list,$token) = @_;
462: my $result;
463: my $optionlist="";
464: my $selected=$token->[2]{$name};
465: foreach my $option (@$list) {
466: my $value;
467: if ( ref($option) eq 'ARRAY') {
468: $value='value="'.$$option[0].'"';
469: $option=$$option[1];
470: } else {
471: $value='value="'.$option.'"';
472: }
473: if ( $selected eq $option ) {
474: $optionlist.="<option $value selected=\"on\">$option</option>\n";
475: } else {
476: $optionlist.="<option $value >$option</option>\n";
477: }
478: }
479: $result.=$description.'<select name="'.
480: "$Apache::lonxml::curdepth.$name".'">
481: '.$optionlist.'
482: </select>';
483: return $result;
484: }
485:
486: sub select_or_text_arg {
487: my ($description,$name,$list,$token,$size) = @_;
488: my $result;
489: my $optionlist="";
490: my $found=0;
491: my $selected=$token->[2]{$name};
492: foreach my $option (@$list) {
493: my $value;
494: if ( ref($option) eq 'ARRAY') {
495: $value='value="'.$$option[0].'"';
496: $option=$$option[1];
497: } else {
498: $value='value="'.$option.'"';
499: }
500: if ( $selected eq $option ) {
501: $optionlist.="<option $value selected=\"on\">$option</option>\n";
502: $found=1;
503: } else {
504: $optionlist.="<option $value>$option</option>\n";
505: }
506: }
507: $optionlist.="<option value=\"TYPEDINVALUE\">Type in value</option>\n";
508: if (($found) || (!$selected)) {
509: $result.=$description.'<select name="'."$Apache::lonxml::curdepth.$name".'">
510: '.$optionlist.'
511: </select>';
512: } else {
513: $result.=&text_arg($description,$name,$token,$size);
514: }
515: return $result;
516: }
517:
518: #----------------------------------------------------- browse
519: sub browse {
520: # insert a link to call up the filesystem browser (lonindexer)
521: my ($id, $mode) = @_;
522: my $form = 'lonhomework';
523: my $element;
524: if (! defined($mode) || $mode eq 'attribute') {
525: $element = &Apache::lonnet::escape("$Apache::lonxml::curdepth.$id");
526: } elsif ($mode eq 'textnode') { # for data between <tag> ... </tag>
527: $element = &Apache::lonnet::escape('homework_edit_'.
528: $Apache::lonxml::curdepth);
529: }
530: my $result = <<"ENDBUTTON";
531: <a href=\"javascript:openbrowser('$form','$element')\"\>Browse</a>
532: ENDBUTTON
533: return $result;
534: }
535:
536: #----------------------------------------------------- browse
537: sub search {
538: # insert a link to call up the filesystem browser (lonindexer)
539: $_ = shift;
540: my $form = 'lonhomework';
541: my $element = &Apache::lonnet::escape("$Apache::lonxml::curdepth.$_");
542: my $result = <<"ENDBUTTON";
543: <a href=\"javascript:opensearcher('$form','$element')\"\>Search</a>
544: ENDBUTTON
545: return $result;
546: }
547:
548:
549: 1;
550: __END__
551:
552: =head1 NAME
553:
554: Apache::edit - edit mode helpers
555:
556: =head1 SYNOPSIS
557:
558: Invoked by many homework and xml related modules.
559:
560: &Apache::edit::SUBROUTINENAME(ARGUMENTS);
561:
562: =head1 INTRODUCTION
563:
564: This module outputs HTML syntax helpful for the rendering of edit
565: mode interfaces.
566:
567: This is part of the LearningOnline Network with CAPA project
568: described at http://www.lon-capa.org.
569:
570: =head1 HANDLER SUBROUTINE
571:
572: There is no handler subroutine.
573:
574: =head1 OTHER SUBROUTINES
575:
576: =over 4
577:
578: =item *
579:
580: initialize_edit() : initialize edit (set colordepth to zero)
581:
582: =item *
583:
584: tag_start($target,$token,$description) : provide deletion and insertion lists
585: for the manipulation of a start tag; return a scalar string
586:
587: =item *
588:
589: tag_end($target,$token,$description) : ending syntax corresponding to
590: &tag_start. return a scalar string.
591:
592: =item *
593:
594: start_table($token) : start table; update colordepth; return scalar string.
595:
596: =item *
597:
598: end_table() : reduce color depth; end table; return scalar string
599:
600: =item *
601:
602: start_spanning_row() : start a new table row spanning the 'edit' environment.
603:
604: =item *
605:
606: start_row() : start a new table row and element.
607:
608: =item *
609:
610: end_row() : end current table element and row.
611:
612: =item *
613:
614: movebuttons($target,$token) : move-up and move-down buttons; return scalar
615: string
616:
617: =item *
618:
619: deletelist($target,$token) : provide a yes option in an HTML select element;
620: return scalar string
621:
622: =item *
623:
624: handle_delete($space,$target,$token,$tagstack,$parstack,$parser,$safeeval,
625: $style) : respond to a user delete request by passing relevant stack
626: and array information to various rendering functions; return a scalar string
627:
628: =item *
629:
630: get_insert_list($token) : provide an insertion list based on possibilities
631: from lonxml; return a scalar string
632:
633: =item *
634:
635: insertlist($target,$token) : api that uses get_insert_list;
636: return a scalar string
637:
638: =item *
639:
640: handleinsert($token) : provide an insertion list based on possibilities
641: from lonxml; return a scalar string
642:
643: =item *
644:
645: get_insert_list($token) : provide an insertion list based on possibilities
646: from lonxml; return a scalar string
647:
648: =item *
649: browse($elementname) : provide a link which will open up the filesystem
650: browser (lonindexer) and, once a file is selected, place the result in
651: the form element $elementname.
652:
653: =item *
654: search($elementname) : provide a link which will open up the filesystem
655: searcher (lonsearchcat) and, once a file is selected, place the result in
656: the form element $elementname.
657:
658: =item *
659: editline(tag,data,description,size): Provide a <input type="text" ../> for
660: single-line text entry. This is to be used for text enclosed by tags, not
661: arguements/parameters associated with a tag.
662:
663: =back
664:
665: incomplete...
666:
667: =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