--- loncom/publisher/lonretrieve.pm 2008/12/12 03:57:12 1.34.2.1 +++ loncom/publisher/lonretrieve.pm 2009/05/11 16:51:32 1.39 @@ -1,7 +1,7 @@ # The LearningOnline Network with CAPA # Handler to retrieve an old version of a file # -# $Id: lonretrieve.pm,v 1.34.2.1 2008/12/12 03:57:12 raeburn Exp $ +# $Id: lonretrieve.pm,v 1.39 2009/05/11 16:51:32 bisitz Exp $ # # Copyright Michigan State University Board of Trustees # @@ -28,6 +28,71 @@ # ### +=head1 NAME + +Apache::lonretrieve - retrieves an old version of a file + +=head1 SYNOPSIS + +Invoked by /etc/httpd/conf/srm.conf: + + + PerlAccessHandler Apache::lonacc + SetHandler perl-script + PerlHandler Apache::lonretrieve + ErrorDocument 403 /adm/login + ErrorDocument 404 /adm/notfound.html + ErrorDocument 406 /adm/unauthorized.html + ErrorDocument 500 /adm/errorhandler + + +=head1 INTRODUCTION + +This module retrieves an old published version of a file. + +This is part of the LearningOnline Network with CAPA project +described at http://www.lon-capa.org. + +=head1 HANDLER SUBROUTINE + +This routine is called by Apache and mod_perl. + +=over 4 + +=item * + +Get query string for limited number of parameters + +=item * + +Start page output + +=item * + +print phase relevant output + +=item * + +(phase one is to select version; phase two retrieves version) + +=back + +=head1 OTHER SUBROUTINES + +=over 4 + +=item * + +phaseone() : Interface for selecting previous version. + +=item * + +phasetwo() : Interface for presenting specified version. + +=back + +=cut + package Apache::lonretrieve; use strict; @@ -55,7 +120,7 @@ sub phaseone { my ($main,$suffix,$is_meta) = &get_file_info($fn); if (-e $resfn) { - $r->print('
'. + $r->print(''. ''. ''. &Apache::loncommon::start_data_table(). @@ -91,7 +156,7 @@ sub phaseone { localtime($rmtime).''); if (!$is_meta) { - $r->print(''. + $r->print(''. &mt('Metadata Version').' '.$version.''); } if ($is_meta @@ -113,7 +178,7 @@ sub phaseone { ''.&mt('Currently published version').''.localtime($rmtime). ''); if (!$is_meta) { - $r->print(''. + $r->print(''. &mt('Metadata current version').''); } if ($is_meta @@ -130,15 +195,16 @@ sub phaseone { &mt('Retrieval of an old version will overwrite the file currently in construction space.').'

'); if (!$is_meta) { $r->print('

'.''. - &mt('This will only retrieve the resource. If you want to retrieve the metadata you will need to do that separately.'). + &mt('This will only retrieve the resource. If you want to retrieve the metadata, you will need to do that separately.'). '

'); } $r->print('
'); } else { $r->print('

'.&mt('No previous versions published.').'

'); } - $r->print('

'.&mt('Back to [_1]',''.$fn.'') - .'

'); + $r->print('

' + .&mt('Back to [_1]',''.$fn.'') + .'

'); } # ---------------------------------- Interface for presenting specified version @@ -166,9 +232,9 @@ sub phasetwo { if ($is_meta) { $logname =~ s/\.meta$//; } $logname = $ctarget.'.log'; unless ($logfile=Apache::File->new('>>'.$logname)) { - $r->print('' - .&mt('No write permission to user directory, FAIL') - .''); + $r->print('' + .&mt('No write permission to user directory, FAIL') + .''); } print $logfile "\n\n================= Retrieve ".localtime()." ================\n". @@ -176,20 +242,20 @@ sub phasetwo { $r->print('

'.&mt('Copying file').': '); if (copy($csource,$ctarget)) { $r->print('' - .&mt('ok') - .''); + .&mt('ok') + .''); print $logfile "Copied sucessfully.\n\n"; } else { my $error=$!; $r->print('' - .&mt('Copy failed: [_1]',$error) - .''); + .&mt('Copy failed: [_1]',$error) + .''); print $logfile "Copy failed: $error\n\n"; } $r->print('

' - .'

' - .&mt('Back to [_1]',$fn) - .'

'); + .'

' + .&mt('Back to [_1]',$fn) + .'

'); } else { $r->print('

'.&mt('Please pick a version to retrieve:').'

'); &phaseone($r,$fn,$uname,$udom); @@ -223,7 +289,7 @@ sub handler { if ($env{'form.filename'}) { $fn=$env{'form.filename'}; - $fn=~s/^http\:\/\/[^\/]+//; + $fn=~s/^https?\:\/\/[^\/]+//; } else { $r->log_reason($env{'user.name'}.' at '.$env{'user.domain'}. ' unspecified filename for retrieval', $r->filename); @@ -259,9 +325,9 @@ sub handler { $r->print('

' - .&mt('Retrieve previous versions of [_1]' - ,''.$fn.'') - .'

'); + .&mt('Retrieve previous versions of [_1]' + ,''.$fn.'') + .''); if (($uname ne $env{'user.name'}) || ($udom ne $env{'user.domain'})) { $r->print('

'.&mt('Co-Author').': '.$uname. @@ -283,67 +349,4 @@ sub handler { 1; __END__ -=head1 NAME - -Apache::lonretrieve - retrieves an old version of a file - -=head1 SYNOPSIS - -Invoked by /etc/httpd/conf/srm.conf: - - - PerlAccessHandler Apache::lonacc - SetHandler perl-script - PerlHandler Apache::lonretrieve - ErrorDocument 403 /adm/login - ErrorDocument 404 /adm/notfound.html - ErrorDocument 406 /adm/unauthorized.html - ErrorDocument 500 /adm/errorhandler - - -=head1 INTRODUCTION - -This module retrieves an old published version of a file. - -This is part of the LearningOnline Network with CAPA project -described at http://www.lon-capa.org. - -=head1 HANDLER SUBROUTINE - -This routine is called by Apache and mod_perl. - -=over 4 - -=item * - -Get query string for limited number of parameters - -=item * - -Start page output - -=item * - -print phase relevant output - -=item * - -(phase one is to select version; phase two retrieves version) - -=back - -=head1 OTHER SUBROUTINES - -=over 4 - -=item * - -phaseone() : Interface for selecting previous version. - -=item * - -phasetwo() : Interface for presenting specified version. - -=back -=cut