# The LearningOnline Network with CAPA
# essay (ungraded) style responses
#
# $Id: essayresponse.pm,v 1.107 2010/06/17 00:13:20 raeburn Exp $
#
# Copyright Michigan State University Board of Trustees
#
# This file is part of the LearningOnline Network with CAPA (LON-CAPA).
#
# LON-CAPA is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# LON-CAPA is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with LON-CAPA; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
#
# /home/httpd/html/adm/gpl.txt
#
# http://www.lon-capa.org/
#
package Apache::essayresponse;
use strict;
use Apache::lonxml();
use Apache::lonnet;
use Apache::lonlocal;
use LONCAPA qw(:DEFAULT :match);
BEGIN {
&Apache::lonxml::register('Apache::essayresponse',('essayresponse'));
}
sub start_essayresponse {
my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
my $result;
my $id = &Apache::response::start_response($parstack,$safeeval);
if ($target eq 'meta') {
$result=&Apache::response::meta_package_write('essayresponse');
} elsif ($target eq 'web' &&
$Apache::inputtags::status[-1] eq 'CAN_ANSWER') {
my $part= $Apache::inputtags::part;
my $ncol= &Apache::lonnet::EXT("resource.$part".'_'."$id.maxcollaborators");
my $coll= &HTML::Entities::encode($Apache::lonhomework::history{"resource.$part.$id.collaborators"},'<>&"');
my $uploadedfiletypes= &Apache::lonnet::EXT("resource.$part".'_'."$id.uploadedfiletypes");
$uploadedfiletypes=~s/[^\w\,]//g;
my $maxfilesize=&Apache::lonnet::EXT("resource.$part".'_'."$id.maxfilesize");
if (!defined($maxfilesize)) {
$maxfilesize = 10.0; #FIXME This should become a domain configuration
}
if (($Apache::lonhomework::type eq 'survey') ||
($Apache::lonhomework::type eq 'surveycred') ||
($Apache::lonhomework::type eq 'anonsurvey') ||
($Apache::lonhomework::type eq 'anonsurveycred')) {
$result.= ' ';
}
$result.='
';
if (($Apache::lonhomework::type ne 'survey') &&
($Apache::lonhomework::type ne 'surveycred') &&
($Apache::lonhomework::type ne 'anonsurvey') &&
($Apache::lonhomework::type ne 'anonsurveycred')) {
$result.= '
'."\n";
}
if ($file_list) {
$output.= &mt('Submitted Files').'
'.$file_list.'
';
}
if ($answer =~ /\S/) {
$output.='
'.&mt('Submitted text').
'
'.$answer.'
';
}
return '
'.$output.'
';
}
sub file_submission {
my ($part,$id,$which,$award,$uploadedflag,$totalsize)=@_;
my $files;
my $jspart=$part;
$jspart=~s/\./_/g;
if ($which eq 'portfiles') {
$files= $env{'form.HWPORT'.$jspart.'_'.$id};
} elsif ($which eq 'filename') {
if ($env{'form.HWFILETOOBIG'.$jspart.'_'.$id} ne '') {
$$award = 'EXCESS_FILESIZE';
return;
} else {
$files = $env{'form.HWFILE'.$jspart.'_'.$id.'.filename'};
}
}
my ($symb,$crsid,$udom,$uname)=&Apache::lonnet::whichuser();
if ($files =~ /[^\s]/) {
$files =~s/,$//;
my (@submitted_files,@acceptable_files,@accepted_files);
if ($which eq 'portfiles') {
@submitted_files = split(/\s*,\s*/,$files);
} else {
@submitted_files = ($files);
}
my $uploadedfiletypes=
&Apache::lonnet::EXT("resource.$part".'_'."$id.uploadedfiletypes");
if ($uploadedfiletypes ne '') {
$uploadedfiletypes=~s/[^\w\,]//g;
$uploadedfiletypes=','.$uploadedfiletypes.',';
foreach my $file (@submitted_files) {
my ($extension)=($file=~/\.(\w+)$/);
if ($uploadedfiletypes=~/\,\s*\Q$extension\E\s*\,/i) {
push(@acceptable_files,$file);
} else {
$$award='INVALID_FILETYPE';
if ($which eq 'filename') {
&delete_form_items($jspart,$id);
}
}
}
} else {
@acceptable_files = @submitted_files;
}
my $maxfilesize=&Apache::lonnet::EXT("resource.$part".'_'."$id.maxfilesize");
if (!$maxfilesize) {
$maxfilesize = 10.0; #FIXME This should become a domain configuration
}
my %dirlist;
foreach my $file (@acceptable_files) {
if ($which eq 'filename') {
if (ref($totalsize)) {
$$totalsize += $env{'form.HWFILESIZE'.$jspart.'_'.$id};
}
} else {
my ($path,$filename) = ($file =~ m{^(.*/)([^/]+)$});
my $fullpath = '/userfiles/portfolio'.$path;
if (!exists($dirlist{$fullpath})) {
my @list = &Apache::lonnet::dirlist($fullpath,$udom,$uname,1);
$dirlist{$fullpath} = \@list;
}
if (ref($dirlist{$fullpath}) eq 'ARRAY') {
foreach my $dir_line (@{$dirlist{$fullpath}}) {
my ($fname,$dom,undef,$testdir,undef,undef,undef,undef,
$size,undef,$mtime,undef,undef,undef,$obs,undef) =
split(/\&/,$dir_line,16);
if ($filename eq $fname) {
my $mbsize = $size/(1024.0*1024.0);
if (ref($totalsize)) {
$$totalsize += $mbsize;
}
last;
}
}
}
}
if (ref($totalsize)) {
if ($$totalsize > $maxfilesize) {
$$award='EXCESS_FILESIZE';
if ($which eq 'filename') {
&delete_form_items($jspart,$id);
}
last;
} else {
push(@accepted_files,$file);
}
} else {
push(@accepted_files,$file);
}
}
if ($which eq 'portfiles') {
my @to_mark;
if ($Apache::lonhomework::results{"resource.$part.$id.portfiles"}) {
@to_mark = ($Apache::lonhomework::results{"resource.$part.$id.portfiles"});
}
if (@accepted_files) {
if ($Apache::lonhomework::results{"resource.$part.$id.portfiles"}) {
$Apache::lonhomework::results{"resource.$part.$id.$which"} .= ',';
}
$Apache::lonhomework::results{"resource.$part.$id.$which"}.=join(',',@accepted_files);
push(@to_mark,@accepted_files);
}
&Apache::lonnet::unmark_as_readonly($udom,$uname,[$symb,$crsid]);
&Apache::lonnet::mark_as_readonly($udom,$uname,\@to_mark,[$symb,$crsid]);
&Apache::lonnet::clear_selected_files($uname);
}
if (($$award eq 'INVALID_FILETYPE') || ($$award eq 'EXCESS_FILESIZE')) {
if ($which eq 'filename') {
delete($env{'form.HWFILE'.$jspart.'_'.$id});
}
return;
}
if (ref($uploadedflag)) {
$$uploadedflag=1;
}
if ($which eq 'filename') {
my $cleanpart = $part;
$cleanpart =~ s/\W/_/g;
my $cleanid = $id;
$cleanid =~ s/\W/_/g;
my ($map,$resid,$resurl)=&Apache::lonnet::decode_symb($symb);
my %crsdesc = &Apache::lonnet::coursedescription($crsid);
my $turnindir;
my %userhash = &Apache::lonnet::userenvironment($udom,$uname,'turnindir');
$turnindir = $userhash{'turnindir'};
if ($turnindir eq '') {
$turnindir = &mt('turned in');
$turnindir =~ s/\W+/_/g;
my %newhash = (
'turnindir' => $turnindir,
);
&Apache::lonnet::put('environment',\%newhash,$udom,$uname);
}
my $prefix = 'portfolio';
my $path = '/'.$turnindir.'/';
my $crsname = $crsdesc{'description'};
my $restitle=&Apache::lonnet::gettitle($symb);
foreach my $item ($crsname,$restitle) {
$item =~ s/\W+/_/g;
}
if ($crsname eq '') {
$crsname = $crsid;
}
if ($restitle eq '') {
$restitle = ($resurl =~ m{/[^/]+$});
if ($restitle eq '') {
$restitle = time;
}
}
my @pathitems;
my $navmap = Apache::lonnavmaps::navmap->new();
if (defined($navmap)) {
my $mapres = $navmap->getResourceByUrl($map);
if (ref($mapres)) {
my $pcslist = $mapres->map_hierarchy();
if ($pcslist ne '') {
foreach my $pc (split(/,/,$pcslist)) {
my $res = $navmap->getByMapPc($pc);
if (ref($res)) {
my $title = $res->compTitle();
$title =~ s/\W+/_/g;
if ($title ne '') {
push(@pathitems,$title);
}
}
}
}
my $maptitle = $mapres->compTitle();
$maptitle =~ s/\W+/_/g;
if ($maptitle ne '') {
push(@pathitems,$maptitle);
}
} else {
$$award = 'INTERNAL_ERROR';
}
} else {
$$award = 'INTERNAL_ERROR';
}
push(@pathitems,$restitle);
unshift(@pathitems,$crsname);
$path .= join('/',@pathitems);
my $formelement = 'HWFILE'.$jspart.'_'.$id;
my $fname = $env{'form.'.$formelement.'.filename'};
&Apache::lonnet::clean_filename($fname);
my $url = '/uploaded/'.$udom.'/'.$uname.'/'.$prefix.$path.'/'.$fname;
my @stat = &Apache::lonnet::stat_file($url);
if (@stat && $stat[0] ne 'no_such_dir') {
$$award = 'FILENAME_INUSE';
} else {
my ($mode,%allfiles,%codebase);
my $result = &Apache::lonnet::userfileupload($formelement,'',
$prefix.$path,$mode,\%allfiles,\%codebase);
if ($result =~ m{^/uploaded/}) {
$Apache::lonhomework::results{"resource.$part.$id.portfiles"} .= $path.'/'.$fname;
&Apache::lonnet::unmark_as_readonly($udom,$uname,[$symb,$crsid]);
&Apache::lonnet::mark_as_readonly($udom,$uname,[$path.'/'.$fname],[$symb,$crsid]);
} else {
$$award = 'INTERNAL_ERROR';
}
}
delete($env{'form.HWFILE'.$jspart.'_'.$id});
}
}
}
sub delete_form_items {
my ($jspart,$id) = @_;
delete($env{'form.HWFILE'.$jspart.'_'.$id.'.filename'});
delete($env{'form.HWFILE'.$jspart.'_'.$id.'.mimetype'});
delete($env{'form.HWFILE'.$jspart.'_'.$id});
}
sub check_collaborators {
my ($ncol,$coll) = @_;
my %classlist=&Apache::lonnet::dump('classlist',
$env{'course.'.$env{'request.course.id'}.'.domain'},
$env{'course.'.$env{'request.course.id'}.'.num'});
my (@badcollaborators,$result);
my (@collaborators) = split(/[,;\s]+/,$coll);
foreach my $entry (@collaborators) {
my $collaborator;
if ($entry =~ /:/) {
$collaborator = $entry;
} else {
$collaborator = $entry.':'.$env{'user.domain'};
}
if ($collaborator !~ /^$match_username:$match_domain$/) {
if (!grep(/^\Q$entry\E$/,@badcollaborators)) {
push(@badcollaborators,$entry);
}
} elsif (!grep(/^\Q$collaborator\E$/i,keys(%classlist))) {
if (!grep(/^\Q$entry\E$/,@badcollaborators)) {
push(@badcollaborators,$entry);
}
}
}
my $numbad = scalar(@badcollaborators);
if ($numbad) {
$result = '
';
if ($numbad == 1) {
$result .= &mt('The following user is invalid:');
} else {
$result .= &mt('The following [_1] users are invalid:',$numbad);
}
$result .= ' '.join(', ',@badcollaborators).'. '.&mt('Please correct.').
'
';
}
my $toomany = scalar(@collaborators) - $ncol;
if ($toomany > 0) {
$result .= '
'.
&mt('You have too many collaborators.').' '.
&mt('Please remove [quant,_1,collaborator].',$toomany).
'
';
}
return $result;
}
1;
__END__
=pod
=head1 NAME
Apache::essayresponse
=head1 SYNOPSIS
Handler to evaluate essay (ungraded) style responses.
This is part of the LearningOnline Network with CAPA project
described at http://www.lon-capa.org.
=head1 SUBROUTINES
=over
=item start_essayresponse()
=item end_essayresponse()
=item format_prior_response()
=item file_submission()
=item delete_form_items()
=item check_collaborators()
=back
=cut