Annotation of loncom/homework/essayresponse.pm, revision 1.92
1.1 albertel 1: # The LearningOnline Network with CAPA
2: # essay (ungraded) style responses
1.5 albertel 3: #
1.92 ! jms 4: # $Id: essayresponse.pm,v 1.91 2008/11/16 02:46:25 raeburn Exp $
1.5 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.33 albertel 28:
1.1 albertel 29: package Apache::essayresponse;
30: use strict;
1.33 albertel 31: use Apache::lonxml();
1.62 albertel 32: use Apache::lonnet;
1.33 albertel 33: use Apache::lonlocal;
1.88 raeburn 34: use LONCAPA qw(:DEFAULT :match);
1.72 www 35:
1.1 albertel 36:
1.6 harris41 37: BEGIN {
1.10 ng 38: &Apache::lonxml::register('Apache::essayresponse',('essayresponse'));
1.1 albertel 39: }
40:
41: sub start_essayresponse {
1.10 ng 42: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
43: my $result;
1.14 albertel 44: my $id = &Apache::response::start_response($parstack,$safeeval);
45: if ($target eq 'meta') {
46: $result=&Apache::response::meta_package_write('essayresponse');
1.69 albertel 47: } elsif ($target eq 'web' &&
48: $Apache::inputtags::status[-1] eq 'CAN_ANSWER') {
1.10 ng 49: my $part= $Apache::inputtags::part;
50: my $ncol= &Apache::lonnet::EXT("resource.$part".'_'."$id.maxcollaborators");
1.34 albertel 51: my $coll= &HTML::Entities::encode($Apache::lonhomework::history{"resource.$part.$id.collaborators"},'<>&"');
1.17 www 52: my $uploadedfiletypes= &Apache::lonnet::EXT("resource.$part".'_'."$id.uploadedfiletypes");
1.21 www 53: $uploadedfiletypes=~s/[^\w\,]//g;
1.75 albertel 54: if ( $Apache::lonhomework::type eq 'survey' ) {
55: $result.= '<input type="hidden" name="HWDRAFT'.$part.'_'.$id.'" value="yes" /> ';
56: }
57: $result.='<br /><table border="1">';
58: if ( $Apache::lonhomework::type ne 'survey' ) {
59: $result.= '<tr><td>'.
60: '<label>'.
61: '<input type="radio" name="HWDRAFT'.$part.'_'.$id.'" value="yes" checked="checked" /> '.
62: &mt('Submit entries below as answer to receive credit').
63: '</label> <br />'.
64: '<label>'.
65: '<input type="radio" name="HWDRAFT'.$part.'_'.$id.'" value="no" /> '.
66: &mt('Save entries below as a draft answer (not submitting them for credit yet)').
67: '</label>'.
68: '</td></tr>';
69: }
70:
1.10 ng 71: if ($ncol > 0) {
1.64 matthew 72: $result .='<tr><td>'.'<label>'.
1.88 raeburn 73: &mt('Collaborators:').' <input type="text" size="70" max="80" name="HWCOL'.
74: $part.'_'.$id.'" value="'.$coll.'" /><br />'.
75: &mt('(Enter a maximum of [quant,_1,collaborator] using username or username:domain, e.g. smithje or smithje:[_2].)',$ncol,$env{'user.domain'});
76: if ($ncol > 1) {
77: $result .= '<br />'.&mt('If entering more than one, use spaces to separate the collaborators.');
78: }
79: $result .= '</label><br />';
1.10 ng 80: $result .= &check_collaborators($ncol,$coll) if ($coll =~ /\w+/);
1.13 ng 81: $result .='</td></tr>';
1.10 ng 82: }
1.60 albertel 83: $result.=&Apache::inputtags::file_selector($part,$id,
84: $uploadedfiletypes,'both');
1.22 www 85: $result.='</table>';
1.74 albertel 86: } elsif ($target eq 'web' &&
87: $Apache::inputtags::status[-1] ne 'CAN_ANSWER') {
88: my $part= $Apache::inputtags::part;
89: my @msgs;
90: if ($Apache::lonhomework::history{"resource.$part.$id.collaborators"} =~ /\S/) {
91: my $coll= &HTML::Entities::encode($Apache::lonhomework::history{"resource.$part.$id.collaborators"},'<>&"');
92: $result .= '<td>'.&mt('Collaborated with [_1]',$coll).'</td>';
93: }
94:
95: my $file_submission =
96: &Apache::inputtags::show_past_file_submission($part,$id);
97: if ($file_submission) {
98: $result .= '<td>'.$file_submission.'</td>';
99: }
100:
101: my $port_submission =
102: &Apache::inputtags::show_past_portfile_submission($part,$id);
103: if ($port_submission) {
104: $result .= '<td>'.$port_submission.'</td>';
105: }
106:
107: if ($result ne '') {
108: $result =
109: '<table class="LC_pastsubmission"><tr>'.$result.
110: '</tr></table>';
111: }
1.10 ng 112: }
113: return $result;
1.1 albertel 114: }
115:
116: sub end_essayresponse {
1.10 ng 117: my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
1.13 ng 118: my $part = $Apache::inputtags::part;
1.14 albertel 119: my $id = $Apache::inputtags::response[-1];
1.70 albertel 120: my $increment = &Apache::response::repetition();
1.15 albertel 121: my $result;
1.10 ng 122: if ( $target eq 'grade' ) {
1.62 albertel 123: my $collaborators = $env{'form.HWCOL'.$part.'_'.$id};
1.14 albertel 124: if ($collaborators =~ /[^\s]/) {
1.34 albertel 125: my $previous_list= &HTML::Entities::encode($Apache::lonhomework::history{"resource.$part.$id.collaborators"},'<>&"');
1.14 albertel 126: $Apache::lonhomework::results{"resource.$part.$id.collaborators"}=$collaborators
127: if ($collaborators ne $previous_list);
128: }
1.58 albertel 129: if ( &Apache::response::submitted('scantron') ) {
1.31 albertel 130: $increment=&Apache::response::scored_response($part,$id);
1.58 albertel 131: } elsif ( &Apache::response::submitted() ) {
1.62 albertel 132: my $response = $env{'form.HWVAL_'.$id};
1.91 raeburn 133: my $filename = $env{'form.HWFILE'.$part.'_'.$id.'.filename'} ||
134: $env{'form.HWFILETOOBIG'.$part.'_'.$id};
1.62 albertel 135: my $portfiles = $env{'form.HWPORT'.$part.'_'.$id};
1.42 banghart 136: if (( $response =~ /[^\s]/) || ($filename =~ /[^\s]/) || ($portfiles =~ /[^\s]/)) {
1.61 albertel 137: my $award='DRAFT';
1.62 albertel 138: if ($env{'form.HWDRAFT'.$part.'_'.$id} eq 'yes') {
1.14 albertel 139: $award='SUBMITTED';
140: }
1.22 www 141: my $uploadedflag=0;
1.91 raeburn 142: my $totalsize=0;
143: &file_submission($part,$id,'filename',\$award,\$uploadedflag,\$totalsize);
144: &file_submission($part,$id,'portfiles',\$award,\$uploadedflag,\$totalsize);
1.10 ng 145: $Apache::lonhomework::results{"resource.$part.$id.submission"}=$response;
1.14 albertel 146: $Apache::lonhomework::results{"resource.$part.$id.awarddetail"}=$award;
1.10 ng 147: my %previous=&Apache::response::check_for_previous($response,$part,$id);
1.22 www 148: unless ($uploadedflag) { &Apache::response::handle_previous(\%previous,$award); }
1.32 www 149: #
150: # Store with resource author for similarity testing
151: #
152: if ($award eq 'SUBMITTED') {
153: my ($symb,$crsid,$domain,$name)=
1.77 albertel 154: &Apache::lonnet::whichuser();
1.32 www 155: if ($crsid) {
1.83 albertel 156: my $akey=join('.',&escape($name),&escape($domain),
157: &escape($crsid));
1.32 www 158: my $essayurl=
159: &Apache::lonnet::declutter($ENV{'REQUEST_URI'});
160: my ($adom,$aname,$apath)=
1.80 albertel 161: ($essayurl=~/^($LONCAPA::domain_re)\/($LONCAPA::username_re)\/(.*)$/);
1.72 www 162: $apath=&escape($apath);
1.32 www 163: $apath=~s/\W/\_/gs;
164: &Apache::lonnet::put('nohist_essay_'.$apath,
165: { $akey => $response },$adom,$aname);
166: }
1.42 banghart 167: }
1.10 ng 168: }
1.42 banghart 169: }
1.15 albertel 170: } elsif ($target eq 'edit') {
171: $result.=&Apache::edit::end_table();
1.71 albertel 172:
173: } elsif ($target eq 'tex'
174: && $Apache::lonhomework::type eq 'exam') {
175: $result .= &Apache::inputtags::exam_score_line($target);
176:
1.70 albertel 177: } elsif ($target eq 'answer') {
1.78 albertel 178: $result.=&Apache::response::answer_header($$tagstack[-1]);
1.81 foxr 179: my $answer = &mt('Essay will be hand graded.');
1.78 albertel 180: $result.=&Apache::response::answer_part($$tagstack[-1],$answer,
181: {'no_verbatim' => 1});
182: $result.=&Apache::response::answer_footer($$tagstack[-1]);
1.10 ng 183: }
1.82 albertel 184: if ($target eq 'web') {
185: &Apache::response::setup_prior_tries_hash(\&format_prior_response,
186: ['portfiles',
187: 'uploadedurl']);
188: }
1.71 albertel 189:
1.27 albertel 190: if ($target eq 'grade' || $target eq 'web' || $target eq 'answer' ||
191: $target eq 'tex' || $target eq 'analyze') {
1.86 foxr 192: &Apache::lonxml::increment_counter($increment, "$part.$id");
1.85 foxr 193:
194: if ($target eq 'analyze') {
1.87 raeburn 195: $Apache::lonhomework::analyze{"$part.$id.type"} = 'essayresponse';
1.85 foxr 196: &Apache::lonhomework::set_bubble_lines();
197: }
1.27 albertel 198: }
1.10 ng 199: &Apache::response::end_response;
1.42 banghart 200:
1.15 albertel 201: return $result;
1.10 ng 202: }
203:
1.82 albertel 204: sub format_prior_response {
205: my ($mode,$answer,$other_data) = @_;
206: my $output;
207:
208: my (undef,undef,$udom,$uname) = &Apache::lonnet::whichuser();
209: my $port_url = '/uploaded/'.$udom.'/'.$uname.'/portfolio/';
210:
211: my $file_list;
212:
213: foreach my $file (split(/\s*,\s*/,
214: $other_data->[0].','.$other_data->[1])) {
215: next if ($file!~/\S/);
216: if ($file !~ m{^/uploaded/}) { $file=$port_url.$file; }
217: $file=~s|/+|/|g;
218: &Apache::lonnet::allowuploaded('/adm/essayresponse',$file);
219: $file_list.='<li><span class="LC_nobreak"><a href="'.$file.'?rawmode=1" target="lonGRDs"><img src="'.
220: &Apache::loncommon::icon($file).'" alt="file icon" border="0" /> '.$file.
221: '</a></span></li>'."\n";
222: }
223: if ($file_list) {
224: $output.= &mt('Submitted Files').'<ul>'.$file_list.'</ul>';
225: }
226: if ($answer =~ /\S/) {
227: $output.='<p>'.&mt('Submitted text').
228: '<blockquote>'.$answer.'</blockquote></p>';
229: }
230:
231: return '<div class="LC_prior_essay">'.$output.'</div>';
232: }
233:
1.61 albertel 234: sub file_submission {
1.91 raeburn 235: my ($part,$id,$which,$award,$uploadedflag,$totalsize)=@_;
1.61 albertel 236: my $files;
1.67 albertel 237: my $jspart=$part;
238: $jspart=~s/\./_/g;
1.91 raeburn 239: if ($which eq 'portfiles') {
240: $files= $env{'form.HWPORT'.$jspart.'_'.$id};
241: } elsif ($which eq 'filename') {
242: if ($env{'form.HWFILETOOBIG'.$jspart.'_'.$id} ne '') {
243: $$award = 'EXCESS_FILESIZE';
244: return;
245: } else {
246: $files = $env{'form.HWFILE'.$jspart.'_'.$id.'.filename'};
247: }
1.61 albertel 248: }
249: if ($files =~ /[^\s]/) {
250: $files =~s/,$//;
1.91 raeburn 251: my (@submitted_files,@acceptable_files,@accepted_files);
252: if ($which eq 'portfiles') {
253: @submitted_files = split(/\s*,\s*/,$files);
254: } else {
255: @submitted_files = ($files);
256: }
257: my $uploadedfiletypes=
258: &Apache::lonnet::EXT("resource.$part".'_'."$id.uploadedfiletypes");
259: if ($uploadedfiletypes) {
260: $uploadedfiletypes=~s/[^\w\,]//g;
261: $uploadedfiletypes=','.$uploadedfiletypes.',';
262: foreach my $file (@submitted_files) {
263: my ($extension)=($file=~/\.(\w+)$/);
264: if ($uploadedfiletypes=~/\,\s*\Q$extension\E\s*\,/i) {
265: push(@acceptable_files,$file);
266: } else {
267: $$award='INVALID_FILETYPE';
268: if ($which eq 'filename') {
269: &delete_form_items($jspart,$id);
270: }
271: }
272: }
273: }
274: my $maxfilesize=&Apache::lonnet::EXT("resource.$part".'_'."$id.maxfilesize");
275: if (!$maxfilesize) {
276: $maxfilesize = 100.0; #FIXME This should become a domain configuration
277: }
278: my %dirlist;
279: foreach my $file (@acceptable_files) {
280: if ($which eq 'filename') {
281: if (ref($totalsize)) {
282: $$totalsize += $env{'form.HWFILESIZE'.$jspart.'_'.$id};
283: }
284: } else {
285: my ($symb,$crsid,$udom,$uname) = &Apache::lonnet::whichuser();
286: my ($path,$filename) = ($file =~ m{^(.+)/([^/]+)$});
287: my $fullpath = '/userfiles/portfolio'.$path;
288: if (!exists($dirlist{$fullpath})) {
289: my @list = &Apache::lonnet::dirlist($fullpath,$udom,$uname,1);
290: foreach my $dir_line (@list) {
291: my ($fname,$dom,undef,$testdir,undef,undef,undef,undef,
292: $size,undef,$mtime,undef,undef,undef,$obs,undef) =
293: split(/\&/,$dir_line,16);
294: if ($filename eq $fname) {
295: my $mbsize = $size/(1024.0*1024.0);
296: if (ref($totalsize)) {
297: $$totalsize += $mbsize;
298: }
299: last;
300: }
301: }
302: $dirlist{$fullpath} = \@list;
303: }
304: }
305: if (ref($totalsize)) {
306: if ($$totalsize > $maxfilesize) {
307: $$award='EXCESS_FILESIZE';
308: if ($which eq 'filename') {
309: &delete_form_items($jspart,$id);
310: }
311: }
312: } else {
313: push(@accepted_files,$file);
314: }
315: }
1.61 albertel 316: my $uploadedfiletypes= &Apache::lonnet::EXT("resource.$part".'_'."$id.uploadedfiletypes");
1.91 raeburn 317: $Apache::lonhomework::results{"resource.$part.$id.$which"}=join(',',@accepted_files);
318: if (($$award eq 'INVALID_FILETYPE') || ($award eq 'EXCESS_FILESIZE')) {
319: return;
320: }
321: if (ref($uploadedflag)) {
1.61 albertel 322: $$uploadedflag=1;
323: }
1.91 raeburn 324: if ($which eq 'portfiles') {
1.77 albertel 325: my ($symb,$crsid,$domain,$name)=&Apache::lonnet::whichuser();
1.66 albertel 326: &Apache::lonnet::unmark_as_readonly($domain,$name,[$symb,$crsid]);
327: &Apache::lonnet::mark_as_readonly($domain,$name,\@submitted_files,[$symb,$crsid]);
1.61 albertel 328: &Apache::lonnet::clear_selected_files($name);
329: }
1.91 raeburn 330: if ($which eq 'filename') {
1.61 albertel 331: $Apache::lonhomework::results{"resource.$part.$id.uploadedfile"}=
332: $files;
333: $Apache::lonhomework::results{"resource.$part.$id.uploadedurl"}=
1.67 albertel 334: &Apache::lonnet::userfileupload('HWFILE'.$jspart.'_'.$id,undef,
1.61 albertel 335: 'essayresponse');
1.91 raeburn 336: &Apache::lonnet::delenv($env{'form.HWFILE'.$jspart.'_'.$id});
1.61 albertel 337: }
338: } elsif ($which eq 'portfiles' &&
339: $Apache::lonhomework::history{"resource.$part.$id.$which"}) {
1.77 albertel 340: my ($symb,$crsid,$domain,$name)=&Apache::lonnet::whichuser();
1.66 albertel 341: &Apache::lonnet::unmark_as_readonly($domain,$name,[$symb,$crsid]);
1.61 albertel 342: $Apache::lonhomework::results{"resource.$part.$id.$which"}="";
343: }
344: }
345:
1.91 raeburn 346: sub delete_form_items {
347: my ($jspart,$id) = @_;
348: &Apache::lonnet::delenv($env{'form.HWFILE'.$jspart.'_'.$id.'.filename'});
349: &Apache::lonnet::delenv($env{'form.HWFILE'.$jspart.'_'.$id.'.mimetype'});
350: &Apache::lonnet::delenv($env{'form.HWFILE'.$jspart.'_'.$id});
351: }
352:
353:
1.10 ng 354: sub check_collaborators {
1.11 ng 355: my ($ncol,$coll) = @_;
1.10 ng 356: my %classlist=&Apache::lonnet::dump('classlist',
1.62 albertel 357: $env{'course.'.$env{'request.course.id'}.'.domain'},
358: $env{'course.'.$env{'request.course.id'}.'.num'});
1.10 ng 359: my (@badcollaborators,$result);
1.88 raeburn 360:
361: my (@collaborators) = split(/,?\s+/,$coll);
362: foreach my $entry (@collaborators) {
363: my $collaborator;
364: if ($entry =~ /:/) {
365: $collaborator = $entry;
1.10 ng 366: } else {
1.88 raeburn 367: $collaborator = $entry.':'.$env{'user.domain'};
1.10 ng 368: }
1.88 raeburn 369: if ($collaborator !~ /^$match_username:$match_domain$/) {
370: if (!grep(/^\Q$entry\E$/,@badcollaborators)) {
371: push(@badcollaborators,$entry);
372: }
373: } elsif (!grep(/^\Q$collaborator\E$/i,keys(%classlist))) {
374: if (!grep(/^\Q$entry\E$/,@badcollaborators)) {
375: push(@badcollaborators,$entry);
376: }
377: }
1.10 ng 378: }
379:
1.88 raeburn 380: my $numbad = scalar(@badcollaborators);
381: if ($numbad) {
382: $result = '<table border="0"><tr bgcolor="#ffbbbb"><td>';
383: if ($numbad == 1) {
384: $result .= &mt('The following user is invalid:');
385: } else {
386: $result .= &mt('The following [_1] users are invalid:',$numbad);
387: }
388: $result .= ' '.join(', ',@badcollaborators).'. '.&mt('Please correct.').
389: '</td></tr></table>';
1.10 ng 390: }
391: my $toomany = scalar(@collaborators) - $ncol;
392: if ($toomany > 0) {
393: $result .= '<table border="0"><tr bgcolor="#ffbbbb"><td>'.
1.88 raeburn 394: &mt('You have too many collaborators.').' '.
395: &mt('Please remove [quant,_1,collaborator].',$toomany).
396: '</td></tr></table>';
1.10 ng 397: }
398: return $result;
1.1 albertel 399: }
1.2 albertel 400:
401: 1;
402: __END__
1.92 ! jms 403:
! 404:
! 405: =pod
! 406:
! 407: =head1 NAME
! 408:
! 409: Apache::easyresponse
! 410:
! 411: =head1 SYNOPSIS
! 412:
! 413: Handler to evaluate essay (ungraded) style responses.
! 414:
! 415: This is part of the LearningOnline Network with CAPA project
! 416: described at http://www.lon-capa.org.
! 417:
! 418: =head1 SUBROUTINES
! 419:
! 420: =over
! 421:
! 422: =item start_essayresponse()
! 423:
! 424: =item end_essayresponse()
! 425:
! 426: =item format_prior_response()
! 427:
! 428: =item file_submission()
! 429:
! 430: =item delete_form_items()
! 431:
! 432: =item check_collaborators()
! 433:
! 434: =back
! 435:
! 436: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>