version 1.52, 2005/03/01 00:22:57
|
version 1.113, 2022/10/19 18:09:03
|
Line 27
|
Line 27
|
# http://www.lon-capa.org/ |
# http://www.lon-capa.org/ |
# |
# |
|
|
|
|
|
|
package Apache::lonpageflip; |
package Apache::lonpageflip; |
|
|
use strict; |
use strict; |
|
use LONCAPA; |
use Apache::Constants qw(:common :http REDIRECT); |
use Apache::Constants qw(:common :http REDIRECT); |
use Apache::lonnet(); |
use Apache::lonnet; |
|
use Apache::loncommon(); |
|
use Apache::lonnavmaps(); |
|
use Apache::lonuserstate; |
|
use Apache::lonlocal; |
use HTML::TokeParser; |
use HTML::TokeParser; |
use GDBM_File; |
use GDBM_File; |
|
|
Line 46 sub cleanup {
|
Line 53 sub cleanup {
|
&Apache::lonnet::logthis('Failed cleanup pageflip: hash'); |
&Apache::lonnet::logthis('Failed cleanup pageflip: hash'); |
} |
} |
} |
} |
|
return OK; |
} |
} |
|
|
sub addrid { |
sub addrid { |
Line 63 sub addrid {
|
Line 71 sub addrid {
|
|
|
sub fullmove { |
sub fullmove { |
my ($rid,$mapurl,$direction)=@_; |
my ($rid,$mapurl,$direction)=@_; |
if (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.'.db', |
if (tie(%hash,'GDBM_File',$env{'request.course.fn'}.'.db', |
&GDBM_READER(),0640)) { |
&GDBM_READER(),0640)) { |
($rid,$mapurl)=&move($rid,$mapurl,$direction); |
($rid,$mapurl)=&move($rid,$mapurl,$direction); |
untie(%hash); |
untie(%hash); |
Line 73 sub fullmove {
|
Line 81 sub fullmove {
|
|
|
sub hash_src { |
sub hash_src { |
my ($id)=@_; |
my ($id)=@_; |
|
my ($mapid,$resid)=split(/\./,$id); |
|
my $symb=&Apache::lonnet::encode_symb($hash{'map_id_'.$mapid}, |
|
$resid,$hash{'src_'.$id}); |
|
my $anchor; |
|
if ($hash{'ext_'.$id} eq 'true:') { |
|
if ($hash{'src_'.$id} =~ /(\#.+)$/) { |
|
$anchor = $1; |
|
} |
|
} |
if ($hash{'encrypted_'.$id}) { |
if ($hash{'encrypted_'.$id}) { |
return &Apache::lonenc::encrypted($hash{'src_'.$id}); |
return (&Apache::lonenc::encrypted($hash{'src_'.$id}), |
|
&Apache::lonenc::encrypted($symb), |
|
$hash{'encrypted_'.$id},$anchor); |
} |
} |
return $hash{'src_'.$id}; |
return ($hash{'src_'.$id},$symb,$hash{'encrypted_'.$id},$anchor); |
} |
} |
|
|
sub move { |
sub move { |
|
my ($next,$endupmap,$direction,$firstres) = @_; |
|
my $safecount=0; |
|
my $allowed=0; |
|
my $deeplinkonly=0; |
|
my $deeplinkchecked; |
|
my $deeplink_login_pc; |
|
my $prev=$next; |
|
my ($prevmapid)=split(/\./,$next); |
|
do { |
|
($next,$endupmap)=&get_next_possible_move($next,$endupmap,$direction); |
|
|
|
my $url = $hash{'src_'.$next}; |
|
my ($mapid,$resid)=split(/\./,$next); |
|
my $symb = &Apache::lonnet::encode_symb($hash{'map_id_'.$mapid}, |
|
$resid,$url); |
|
if ($url eq '' || $symb eq '') { |
|
$allowed = 0; |
|
} else { |
|
my $nodeeplinkcheck = 0; |
|
if ($hash{'is_map_'.$next}) { |
|
$nodeeplinkcheck = 1; |
|
} |
|
my $priv = &Apache::lonnet::allowed('bre',$url,$symb,'','','','',$nodeeplinkcheck); |
|
$allowed = (($priv eq 'F') || ($priv eq '2') || ($priv eq 'A')); |
|
} |
|
$deeplinkonly = 0; |
|
if ($hash{'deeplinkonly_'.$next}) { |
|
my ($value,$level) = map { &unescape($_); } split(/:/,$hash{'deeplinkonly_'.$next}); |
|
my ($state,$others,$listed,$scope,$protect) = split(/,/,$value); |
|
unless (($state eq 'both') || ($hash{'is_map_'.$next})) { |
|
if ($level eq 'resource') { |
|
$deeplinkonly = 1; |
|
} elsif ($level eq 'map') { |
|
if ($scope eq 'rec') { |
|
unless ($mapid == $prevmapid) { |
|
unless ($deeplinkchecked) { |
|
$deeplink_login_pc = &get_deeplink_login_pc(); |
|
$deeplinkchecked = 1; |
|
} |
|
if ($deeplink_login_pc) { |
|
my $poss_map_pc; |
|
if ($hash{'is_map_'.$next}) { |
|
$poss_map_pc = $hash{'map_pc_'.$url}; |
|
} else { |
|
$poss_map_pc = $hash{'map_pc_'.$hash{'map_id_'.$mapid}}; |
|
} |
|
unless ($deeplink_login_pc == $poss_map_pc) { |
|
unless (grep(/^$deeplink_login_pc$/,split(/,/,$hash{'map_hierarchy_'.$poss_map_pc}))) { |
|
$deeplinkonly = 1; |
|
} |
|
} |
|
} else { |
|
$deeplinkonly = 1; |
|
} |
|
} |
|
} elsif ($mapid != $prevmapid) { |
|
$deeplinkonly = 1; |
|
} |
|
} |
|
} |
|
} elsif (($hash{'deeplinkonly_'.$prev}) && (!$firstres)) { |
|
my ($value,$level) = map { &unescape($_); } split(/:/,$hash{'deeplinkonly_'.$prev}); |
|
my ($state,$others,$listed,$scope,$protect) = split(/,/,$value); |
|
unless (($state eq 'both') || ($hash{'is_map_'.$prev})) { |
|
if ($level eq 'resource') { |
|
$deeplinkonly = 1; |
|
} elsif ($level eq 'map') { |
|
if ($scope eq 'rec') { |
|
unless ($mapid == $prevmapid) { |
|
unless ($deeplinkchecked) { |
|
$deeplink_login_pc = &get_deeplink_login_pc(); |
|
$deeplinkchecked = 1; |
|
} |
|
if ($deeplink_login_pc) { |
|
my $poss_map_pc; |
|
if ($hash{'is_map_'.$prev}) { |
|
$poss_map_pc = $hash{'map_pc_'.$url}; |
|
} else { |
|
$poss_map_pc = $hash{'map_pc_'.$hash{'map_id_'.$mapid}}; |
|
} |
|
unless ($deeplink_login_pc == $poss_map_pc) { |
|
unless (grep(/^$deeplink_login_pc$/,split(/,/,$hash{'map_hierarchy_'.$poss_map_pc}))) { |
|
$deeplinkonly = 1; |
|
} |
|
} |
|
} |
|
} |
|
} else { |
|
if ($mapid != $prevmapid) { |
|
$deeplinkonly = 1; |
|
} |
|
} |
|
} |
|
} |
|
} |
|
$safecount++; |
|
} while ( ($next) |
|
&& ($next!~/\,/) |
|
&& ( |
|
(!$hash{'src_'.$next}) |
|
|| ( |
|
(!$env{'request.role.adv'}) |
|
&& (($hash{'randomout_'.$next}) |
|
|| ($deeplinkonly) |
|
|| ($hash{'deeplinkout_'.$next})) |
|
) |
|
|| (!$allowed) |
|
) |
|
&& ($safecount<10000)); |
|
|
|
return ($next,$endupmap); |
|
} |
|
|
|
sub get_next_possible_move { |
my ($rid,$mapurl,$direction)=@_; |
my ($rid,$mapurl,$direction)=@_; |
my $startoutrid=$rid; |
my $startoutrid=$rid; |
|
|
Line 92 sub move {
|
Line 225 sub move {
|
while ($hash{'type_'.$rid} eq 'finish') { |
while ($hash{'type_'.$rid} eq 'finish') { |
$rid=$hash{'ids_'.$hash{'map_id_'.(split(/\./,$rid))[0]}}; |
$rid=$hash{'ids_'.$hash{'map_id_'.(split(/\./,$rid))[0]}}; |
} |
} |
map { |
foreach my $id (split(/\,/,$hash{'to_'.$rid})) { |
my $thiscond= |
my $condition= $hash{'conditions_'.$hash{'goesto_'.$id}}; |
&Apache::lonnet::directcondval($hash{'condid_'.$hash{'undercond_'.$_}}); |
my $rescond = &Apache::lonnet::docondval($condition); |
if ($thiscond>=$mincond) { |
my $linkcond = &Apache::lonnet::directcondval($hash{'condid_'.$hash{'undercond_'.$id}}); |
|
my $thiscond = ($rescond<$linkcond)?$rescond:$linkcond; |
|
if ($thiscond>=$mincond) { |
if ($posnext) { |
if ($posnext) { |
$posnext.=','.$_.':'.$thiscond; |
$posnext.=','.$id.':'.$thiscond; |
} else { |
} else { |
$posnext=$_.':'.$thiscond; |
$posnext=$id.':'.$thiscond; |
} |
} |
if ($thiscond>$mincond) { $mincond=$thiscond; } |
if ($thiscond>$mincond) { $mincond=$thiscond; } |
} |
} |
} split(/\,/,$hash{'to_'.$rid}); |
} |
map { |
foreach my $id (split(/\,/,$posnext)) { |
my ($linkid,$condval)=split(/\:/,$_); |
my ($linkid,$condval)=split(/\:/,$id); |
if ($condval>=$mincond) { |
if ($condval>=$mincond) { |
$next=&addrid($next,$hash{'goesto_'.$linkid}, |
$next=&addrid($next,$hash{'goesto_'.$linkid}, |
$hash{'condid_'.$hash{'undercond_'.$linkid}}); |
$hash{'condid_'.$hash{'undercond_'.$linkid}}); |
} |
} |
} split(/\,/,$posnext); |
} |
if ($hash{'is_map_'.$next}) { |
if ($hash{'is_map_'.$next}) { |
# This jumps to the beginning of a new map (going down level) |
# This jumps to the beginning of a new map (going down level) |
if ( |
if ( |
Line 126 sub move {
|
Line 261 sub move {
|
((split(/\./,$startoutrid))[0]!=(split(/\./,$next))[0]) { |
((split(/\./,$startoutrid))[0]!=(split(/\./,$next))[0]) { |
# This comes up from a map (coming up one level); |
# This comes up from a map (coming up one level); |
$mapurl=$hash{'map_id_'.(split(/\./,$next))[0]}; |
$mapurl=$hash{'map_id_'.(split(/\./,$next))[0]}; |
} |
} |
} elsif ($direction eq 'back') { |
} elsif ($direction eq 'back') { |
# ------------------------------------------------------------------- Backwards |
# ------------------------------------------------------------------- Backwards |
while ($hash{'type_'.$rid} eq 'start') { |
while ($hash{'type_'.$rid} eq 'start') { |
$rid=$hash{'ids_'.$hash{'map_id_'.(split(/\./,$rid))[0]}}; |
$rid=$hash{'ids_'.$hash{'map_id_'.(split(/\./,$rid))[0]}}; |
} |
} |
map { |
foreach my $id (split(/\,/,$hash{'from_'.$rid})) { |
my $thiscond= |
my $condition= $hash{'conditions_'.$hash{'comesfrom_'.$id}}; |
&Apache::lonnet::directcondval($hash{'condid_'.$hash{'undercond_'.$_}}); |
my $rescond = &Apache::lonnet::docondval($condition); |
if ($thiscond>=$mincond) { |
my $linkcond = &Apache::lonnet::directcondval($hash{'condid_'.$hash{'undercond_'.$id}}); |
if ($posnext) { |
my $thiscond = ($rescond<$linkcond)?$rescond:$linkcond; |
$posnext.=','.$_.':'.$thiscond; |
if ($thiscond>=$mincond) { |
} else { |
if ($posnext) { |
$posnext=$_.':'.$thiscond; |
$posnext.=','.$id.':'.$thiscond; |
} |
} else { |
if ($thiscond>$mincond) { $mincond=$thiscond; } |
$posnext=$id.':'.$thiscond; |
} |
} |
} split(/\,/,$hash{'from_'.$rid}); |
if ($thiscond>$mincond) { $mincond=$thiscond; } |
map { |
} |
my ($linkid,$condval)=split(/\:/,$_); |
} |
if ($condval>=$mincond) { |
foreach my $id (split(/\,/,$posnext)) { |
$next=&addrid($next,$hash{'comesfrom_'.$linkid}, |
my ($linkid,$condval)=split(/\:/,$id); |
$hash{'condid_'.$hash{'undercond_'.$linkid}}); |
if ($condval>=$mincond) { |
} |
$next=&addrid($next,$hash{'comesfrom_'.$linkid}, |
} split(/\,/,$posnext); |
$hash{'condid_'.$hash{'undercond_'.$linkid}}); |
|
} |
|
} |
if ($hash{'is_map_'.$next}) { |
if ($hash{'is_map_'.$next}) { |
# This jumps to the end of a new map (going down one level) |
# This jumps to the end of a new map (going down one level) |
if ( |
if ( |
Line 171 sub move {
|
Line 308 sub move {
|
return ($next,$mapurl); |
return ($next,$mapurl); |
} |
} |
|
|
|
sub first_accessible_resource { |
|
my $furl; |
|
if (tie(%hash,'GDBM_File',$env{'request.course.fn'}.'.db', |
|
&GDBM_READER(),0640)) { |
|
$furl=$hash{'first_url'}; |
|
my (%args,$url,$argstr); |
|
if ($furl =~ m{^/enc/}) { |
|
($url,$argstr) = split(/\?/,&Apache::lonenc::unencrypted($furl)); |
|
} else { |
|
($url,$argstr) = split(/\?/,$furl); |
|
} |
|
foreach my $pair (split(/\&/,$argstr)) { |
|
my ($name,$value) = split(/=/,$pair); |
|
$args{&unescape($name)} = &unescape($value); |
|
} |
|
my $priv = &Apache::lonnet::allowed('bre',$url,$args{'symb'}); |
|
my $allowed = (($priv eq 'F') || ($priv eq '2') || ($priv eq 'A')); |
|
if (!$allowed) { |
|
# Wow, we cannot see this ... move forward to the next one that we can see |
|
my ($newrid,$newmap)=&move($hash{'first_rid'},$hash{'first_mapurl'},'forward',1); |
|
# Build the new URL |
|
if ($newrid eq '') { |
|
$furl = '/adm/navmaps'; |
|
} else { |
|
my ($newmapid,$newresid)=split(/\./,$newrid); |
|
my $symb=&Apache::lonnet::encode_symb($newmap,$newresid,$hash{'src_'.$newrid}); |
|
$furl=&add_get_param($hash{'src_'.$newrid},{ 'symb' => $symb }); |
|
if ($hash{'encrypted_'.$newrid}) { |
|
$furl=&Apache::lonenc::encrypted($furl); |
|
} |
|
} |
|
} |
|
untie(%hash); |
|
return $furl; |
|
} else { |
|
return '/adm/navmaps'; |
|
} |
|
} |
|
|
|
sub first_answerable_ressymb { |
|
my $navmap = Apache::lonnavmaps::navmap->new; |
|
return unless (ref($navmap)); |
|
my $iterator = $navmap->getIterator(undef,undef,undef,1); |
|
return unless (ref($iterator)); |
|
my ($curRes,$result); |
|
while ($curRes = $iterator->next()) { |
|
if (ref($curRes) && $curRes->is_problem()) { |
|
foreach my $part (@{$curRes->parts()}) { |
|
if ($curRes->tries($part) < $curRes->maxtries($part)) { |
|
$result = $curRes->link().'?symb='.$curRes->shown_symb(); |
|
last; |
|
} |
|
} |
|
} |
|
} |
|
if ($result) { |
|
return $result; |
|
} else { |
|
return &first_accessible_resource(); |
|
} |
|
} |
|
|
|
sub check_http_req { |
|
my ($srcref,$hostname) = @_; |
|
return unless (ref($srcref) eq 'SCALAR'); |
|
my $usehttp; |
|
if ($env{'request.course.id'}) { |
|
my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'}; |
|
my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'}; |
|
if (($$srcref =~ m{^\Q/public/$cdom/$cnum/syllabus\E($|\?)}) && |
|
($ENV{'SERVER_PORT'} == 443) && |
|
($env{'course.'.$env{'request.course.id'}.'.externalsyllabus'} =~ m{^http://})) { |
|
unless ((&Apache::lonnet::uses_sts()) || |
|
(&Apache::lonnet::waf_allssl($hostname))) { |
|
$$srcref .= (($$srcref =~/\?/)? '&':'?') . 'usehttp=1'; |
|
$usehttp = 1; |
|
} |
|
} elsif (($$srcref =~ m{^\Q/adm/wrapper/ext/\E(?!https:)}) && |
|
($ENV{'SERVER_PORT'} == 443)) { |
|
unless ((&Apache::lonnet::uses_sts()) || |
|
(&Apache::lonnet::waf_allssl($hostname))) { |
|
my ($url,$anchor) = ($$srcref =~ /^([^\#]+)(?:|(\#[^\#]+))$/); |
|
$$srcref = $url . (($$srcref =~/\?/)? '&':'?') . 'usehttp=1' .$anchor; |
|
$usehttp = 1; |
|
} |
|
} |
|
} |
|
return $usehttp; |
|
} |
|
|
|
sub reinited_js { |
|
my ($url,$cid,$timeout) = @_; |
|
if (!$timeout) { |
|
$timeout = 0; |
|
} |
|
return <<"END"; |
|
<script type="text/javascript"> |
|
// <![CDATA[ |
|
setTimeout(function() { |
|
var newurl = '$url'; |
|
if (document.getElementById('LC_update_$cid')) { |
|
document.getElementById('LC_update_$cid').style.display = 'none'; |
|
} |
|
if ((newurl !== null) && (newurl !== '') && (newurl !== 'undefined')) { |
|
window.location.href = "$url"; |
|
} |
|
}, $timeout); |
|
// ]]> |
|
</script> |
|
END |
|
} |
|
|
|
sub get_deeplink_login_pc { |
|
my $deeplink_login_pc; |
|
if (($env{'request.deeplink.login'}) && ($env{'request.course.id'})) { |
|
my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'}; |
|
my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'}; |
|
my $deeplink_symb = &Apache::loncommon::deeplink_login_symb($cnum,$cdom); |
|
if ($deeplink_symb) { |
|
my $loginmap; |
|
if ($deeplink_symb =~ /\.(page|sequence)$/) { |
|
$loginmap = &Apache::lonnet::clutter((&Apache::lonnet::decode_symb($deeplink_symb))[2]); |
|
} else { |
|
$loginmap = &Apache::lonnet::clutter((&Apache::lonnet::decode_symb($deeplink_symb))[0]); |
|
} |
|
$deeplink_login_pc = $hash{'map_pc_'.$loginmap}; |
|
} |
|
} |
|
return $deeplink_login_pc; |
|
} |
|
|
# ================================================================ Main Handler |
# ================================================================ Main Handler |
|
|
sub handler { |
sub handler { |
Line 187 sub handler {
|
Line 455 sub handler {
|
my %cachehash=(); |
my %cachehash=(); |
my $multichoice=0; |
my $multichoice=0; |
my %multichoicehash=(); |
my %multichoicehash=(); |
my $redirecturl=''; |
my %prog_state=(); |
|
my ($redirecturl,$redirectsymb,$enc,$anchor,$deeplinklevel); |
my $next=''; |
my $next=''; |
|
my $hostname = $r->hostname(); |
my @possibilities=(); |
my @possibilities=(); |
&Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['postdata']); |
&Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['postdata']); |
if (($ENV{'form.postdata'})&&($ENV{'request.course.fn'})) { |
if (($env{'form.postdata'})&&($env{'request.course.fn'})) { |
$ENV{'form.postdata'}=~/(\w+)\:(.*)/; |
my ($direction,$currenturl) = ($env{'form.postdata'}=~/(\w+)\:(.*)/); |
my $direction=$1; |
|
my $currenturl=$2; |
|
if ($currenturl=~m|^/enc/|) { |
if ($currenturl=~m|^/enc/|) { |
$currenturl=&Apache::lonenc::unencrypted($currenturl); |
$currenturl=&Apache::lonenc::unencrypted($currenturl); |
} |
} |
$currenturl=~s/\.\d+\.(\w+)$/\.$1/; |
$currenturl=~s/\.\d+\.(\w+)$/\.$1/; |
|
$currenturl=~s/^https?\:\/\///; |
|
$currenturl=~s/^[^\/]+//; |
|
my ($preupdatepos,$last,$reinitcheck); |
if ($direction eq 'return') { |
if ($direction eq 'return') { |
# -------------------------------------------------------- Return to last known |
if (tie(%hash,'GDBM_File',$env{'request.course.fn'}.'_symb.db', |
my $last; |
|
if (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.'_symb.db', |
|
&GDBM_READER(),0640)) { |
&GDBM_READER(),0640)) { |
$last=$hash{'last_known'}; |
$last=$hash{'last_known'}; |
untie(%hash); |
untie(%hash); |
} |
} |
my $newloc; |
} elsif ($direction eq 'firstanswerable') { |
if (($last) && (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.'.db', |
my $furl = &first_answerable_ressymb(); |
|
my $usehttp = &check_http_req(\$furl,$hostname); |
|
if (($usehttp) && ($hostname ne '')) { |
|
$furl='http://'.$hostname.$furl; |
|
} else { |
|
$furl=&Apache::lonnet::absolute_url().$furl; |
|
} |
|
&Apache::loncommon::content_type($r,'text/html'); |
|
$r->header_out(Location => $furl); |
|
return REDIRECT; |
|
} elsif ($direction eq 'endplacement') { |
|
&Apache::loncommon::content_type($r,'text/html'); |
|
$r->send_http_header; |
|
$r->print(&Apache::lonplacementtest::showresult()); |
|
return OK; |
|
} |
|
if ($env{'request.course.id'}) { |
|
# Check if course needs to be re-initialized |
|
my $loncaparev = $r->dir_config('lonVersion'); |
|
($reinitcheck,my @reinit) = &Apache::loncommon::needs_coursereinit($loncaparev); |
|
if ($reinitcheck eq 'switch') { |
|
&Apache::loncommon::content_type($r,'text/html'); |
|
$r->send_http_header; |
|
$r->print(&Apache::loncommon::check_release_result(@reinit)); |
|
return OK; |
|
} |
|
my ($cnum,$cdom); |
|
if ($reinitcheck) { |
|
$cnum = $env{'course.'.$env{'request.course.id'}.'.num'}; |
|
$cdom = $env{'course.'.$env{'request.course.id'}.'.domain'}; |
|
} |
|
if (($reinitcheck eq 'main') || ($reinitcheck eq 'both')) { |
|
$preupdatepos = &Apache::lonnet::symbread($currenturl); |
|
unless ($direction eq 'return') { |
|
if (tie(%hash,'GDBM_File',$env{'request.course.fn'}.'_symb.db', |
|
&GDBM_READER(),0640)) { |
|
$last=$hash{'last_known'}; |
|
untie(%hash); |
|
} |
|
} |
|
&Apache::loncommon::content_type($r,'text/html'); |
|
$r->send_http_header; |
|
$r->print(&Apache::loncommon::start_page('Content Changed')); |
|
my $preamble = '<div id="LC_update_'.$env{'request.course.id'}.'" class="LC_info">'. |
|
'<br />'. |
|
&mt('Your course session is being updated because of recent changes by course personnel.'). |
|
' '.&mt('Please be patient').'.<br /></div>'. |
|
'<div style="padding:0;clear:both;margin:0;border:0"></div>'; |
|
%prog_state = &Apache::lonhtmlcommon::Create_PrgWin($r,undef,$preamble); |
|
&Apache::lonhtmlcommon::Update_PrgWin($r,\%prog_state,&mt('Updating course')); |
|
my ($furl,$ferr) = &Apache::lonuserstate::readmap("$cdom/$cnum"); |
|
&Apache::lonhtmlcommon::Update_PrgWin($r,\%prog_state,&mt('Finished!')); |
|
if ($ferr) { |
|
&Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state); |
|
my $requrl = $r->uri; |
|
$env{'user.error.msg'}="$requrl:bre:0:0:Course not initialized"; |
|
$env{'user.reinit'} = 1; |
|
return HTTP_NOT_ACCEPTABLE; |
|
} else { |
|
if ($last) { |
|
my ($murl,$id,$fn)=&Apache::lonnet::decode_symb($last); |
|
unless (&Apache::lonnet::symbverify($last,$fn)) { |
|
undef($last); |
|
} |
|
} |
|
} |
|
} |
|
if (($reinitcheck eq 'both') || ($reinitcheck eq 'supp')) { |
|
my $possdel; |
|
if ($reinitcheck eq 'supp') { |
|
$possdel = 1; |
|
} |
|
my ($supplemental,$refs_updated) = &Apache::lonnet::get_supplemental($cnum,$cdom,'',$possdel); |
|
unless ($refs_updated) { |
|
&Apache::loncommon::set_supp_httprefs($cnum,$cdom,$supplemental); |
|
} |
|
} |
|
} |
|
if ($direction eq 'firstres') { |
|
my $furl=&first_accessible_resource(); |
|
my $usehttp = &check_http_req(\$furl,$hostname); |
|
if (($usehttp) && ($hostname ne '')) { |
|
$furl='http://'.$hostname.$furl; |
|
} else { |
|
$furl=&Apache::lonnet::absolute_url().$furl; |
|
} |
|
if ($reinitcheck eq 'update') { |
|
&Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state); |
|
$r->print(&reinited_js($furl,$env{'request.course.id'},100)); |
|
$r->print(&Apache::loncommon::end_page()); |
|
return OK; |
|
} else { |
|
&Apache::loncommon::content_type($r,'text/html'); |
|
$r->header_out(Location => $furl); |
|
return REDIRECT; |
|
} |
|
} |
|
if ($direction eq 'return') { |
|
# -------------------------------------------------------- Return to last known |
|
my ($newloc,$usehttp); |
|
if (($last) && (tie(%hash,'GDBM_File',$env{'request.course.fn'}.'.db', |
&GDBM_READER(),0640))) { |
&GDBM_READER(),0640))) { |
my ($murl,$id,$fn)=&Apache::lonnet::decode_symb($last); |
my ($murl,$id,$fn)=&Apache::lonnet::decode_symb($last); |
$id=$hash{'map_pc_'.&Apache::lonnet::clutter($murl)}.'.'.$id; |
$id=$hash{'map_pc_'.&Apache::lonnet::clutter($murl)}.'.'.$id; |
$newloc=$hash{'src_'.$id}; |
$newloc=$hash{'src_'.$id}; |
if ($newloc) { |
if ($newloc) { |
if ($hash{'encrypted_'.$id}) { $newloc=&Apache::lonenc::encrypted($newloc); } |
$usehttp = &check_http_req(\$newloc,$hostname); |
|
if ($hash{'encrypted_'.$id}) { |
|
$newloc=&Apache::lonenc::encrypted($newloc); |
|
} |
|
if ($newloc =~ m{^(/adm/wrapper/ext/[^\#]+)(?:|(\#[^\#]+))$}) { |
|
my ($url,$anchor) = ($1,$2); |
|
if ($anchor) { |
|
$newloc = $url.(($url=~/\?/)?'&':'?').'symb='.&escape($last).$anchor; |
|
} |
|
} |
} else { |
} else { |
$newloc='/adm/noidea.html'; |
$newloc='/adm/navmaps'; |
} |
} |
untie %hash; |
untie %hash; |
} else { |
} else { |
$newloc='/adm/noidea.html'; |
$newloc='/adm/navmaps'; |
} |
} |
&Apache::loncommon::content_type($r,'text/html'); |
if (($usehttp) && ($hostname ne '')) { |
$r->header_out(Location => |
$newloc='http://'.$hostname.$newloc; |
'http://'.$ENV{'HTTP_HOST'}.$newloc); |
} else { |
|
$newloc=&Apache::lonnet::absolute_url().$newloc |
return REDIRECT; |
} |
|
if ($reinitcheck eq 'update') { |
|
$r->print(&reinited_js($newloc,$env{'request.course.id'},100)); |
|
$r->print(&Apache::loncommon::end_page()); |
|
return OK; |
|
} else { |
|
&Apache::loncommon::content_type($r,'text/html'); |
|
$r->header_out(Location => $newloc); |
|
return REDIRECT; |
|
} |
} |
} |
$currenturl=~s/^http\:\/\///; |
|
$currenturl=~s/^[^\/]+//; |
|
# |
# |
# Is the current URL on the map? If not, start with last known URL |
# Is the current URL on the map? If not, start with last known URL |
# |
# |
|
|
unless (&Apache::lonnet::is_on_map($currenturl)) { |
unless (&Apache::lonnet::is_on_map($currenturl)) { |
my $last; |
if ($preupdatepos) { |
if (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.'_symb.db', |
undef($preupdatepos); |
&GDBM_READER(),0640)) { |
} elsif (tie(%hash,'GDBM_File',$env{'request.course.fn'}.'_symb.db', |
$last=$hash{'last_known'}; |
&GDBM_READER(),0640)) { |
|
$last=$hash{'last_known'}; |
untie(%hash); |
untie(%hash); |
} |
} |
if ($last) { |
if ($last) { |
$currenturl=&Apache::lonnet::clutter((&Apache::lonnet::decode_symb($last))[2]); |
$currenturl=&Apache::lonnet::clutter((&Apache::lonnet::decode_symb($last))[2]); |
} else { |
} else { |
&Apache::loncommon::content_type($r,'text/html'); |
my $newloc = &Apache::lonnet::absolute_url(). |
$r->header_out(Location => |
'/adm/navmaps'; |
'http://'.$ENV{'HTTP_HOST'}.'/adm/noidea.html'); |
if ($reinitcheck eq 'update') { |
return REDIRECT; |
&Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state); |
|
$r->print(&reinited_js($newloc,$env{'request.course.id'},100)); |
|
$r->print(&Apache::loncommon::end_page()); |
|
return OK; |
|
} else { |
|
&Apache::loncommon::content_type($r,'text/html'); |
|
$r->header_out(Location => $newloc); |
|
return REDIRECT; |
|
} |
} |
} |
} |
} |
# ------------------------------------------- Do we have any idea where we are? |
# ------------------------------------------- Do we have any idea where we are? |
my $position; |
my $position; |
if ($position=Apache::lonnet::symbread($currenturl)) { |
if ($preupdatepos) { |
|
$position = $preupdatepos; |
|
} else { |
|
$position=Apache::lonnet::symbread($currenturl); |
|
} |
|
if ($position) { |
# ------------------------------------------------------------------------- Yes |
# ------------------------------------------------------------------------- Yes |
my ($startoutmap,$mapnum,$thisurl)=&Apache::lonnet::decode_symb($position); |
my ($startoutmap,$mapnum,$thisurl)=&Apache::lonnet::decode_symb($position); |
$cachehash{$startoutmap}{$thisurl}=[$thisurl,$mapnum]; |
$cachehash{$startoutmap}{$thisurl}=[$thisurl,$mapnum]; |
Line 260 sub handler {
|
Line 659 sub handler {
|
[&Apache::lonnet::declutter($currenturl),$mapnum]; |
[&Apache::lonnet::declutter($currenturl),$mapnum]; |
|
|
# ============================================================ Tie the big hash |
# ============================================================ Tie the big hash |
if (tie(%hash,'GDBM_File',$ENV{'request.course.fn'}.'.db', |
if (tie(%hash,'GDBM_File',$env{'request.course.fn'}.'.db', |
&GDBM_READER(),0640)) { |
&GDBM_READER(),0640)) { |
my $rid=$hash{'map_pc_'.&Apache::lonnet::clutter($startoutmap)}. |
my $rid=$hash{'map_pc_'.&Apache::lonnet::clutter($startoutmap)}. |
'.'.$mapnum; |
'.'.$mapnum; |
Line 269 sub handler {
|
Line 668 sub handler {
|
my $endupmap; |
my $endupmap; |
($next,$endupmap)=&move($rid,$startoutmap,$direction); |
($next,$endupmap)=&move($rid,$startoutmap,$direction); |
# -------------------------------------- Do we have one and only one empty URL? |
# -------------------------------------- Do we have one and only one empty URL? |
my $safecount=0; |
|
while (($next) && ($next!~/\,/) && |
|
((!$hash{'src_'.$next}) || |
|
((!$ENV{'request.role.adv'}) && $hash{'randomout_'.$next})) |
|
&& ($safecount<10000)) { |
|
($next,$endupmap)=&move($next,$endupmap,$direction); |
|
$safecount++; |
|
} |
|
# We are now at at least one non-empty URL |
# We are now at at least one non-empty URL |
# ----------------------------------------------------- Check out possibilities |
# ----------------------------------------------------- Check out possibilities |
if ($next) { |
if ($next) { |
@possibilities=split(/\,/,$next); |
@possibilities=split(/\,/,$next); |
if ($#possibilities==0) { |
if ($#possibilities==0) { |
# ---------------------------------------------- Only one possibility, redirect |
# ---------------------------------------------- Only one possibility, redirect |
$redirecturl=&hash_src($next); |
($redirecturl,$redirectsymb,$enc,$anchor)=&hash_src($next); |
$cachehash{$endupmap}{$redirecturl}= |
$cachehash{$endupmap}{$redirecturl}= |
[$redirecturl,(split(/\./,$next))[1]]; |
[$redirecturl,(split(/\./,$next))[1]]; |
} else { |
} else { |
# ------------------------ There are multiple possibilities for a next resource |
# ------------------------ There are multiple possibilities for a next resource |
$multichoice=1; |
$multichoice=1; |
map { |
foreach my $id (@possibilities) { |
$multichoicehash{'src_'.$_}=$hash{'src_'.$_}; |
$multichoicehash{'src_'.$id}=$hash{'src_'.$id}; |
$multichoicehash{'title_'.$_}=$hash{'title_'.$_}; |
$multichoicehash{'title_'.$id}=$hash{'title_'.$id}; |
$multichoicehash{'type_'.$_}=$hash{'type_'.$_}; |
$multichoicehash{'type_'.$id}=$hash{'type_'.$id}; |
(my $first, my $second) = $_ =~ /(\d+).(\d+)/; |
(my $first, my $second) = $id =~ /(\d+).(\d+)/; |
my $symbSrc = Apache::lonnet::declutter($hash{'src_'.$_}); |
my $symbSrc = Apache::lonnet::declutter($hash{'src_'.$id}); |
$multichoicehash{'symb_'.$_} = |
$multichoicehash{'symb_'.$id} = |
Apache::lonnet::declutter($hash{'map_id_'.$first}.'___'. |
Apache::lonnet::declutter($hash{'map_id_'.$first}.'___'. |
$second.'___'.$symbSrc); |
$second.'___'.$symbSrc); |
|
|
my ($choicemap,$choiceres)=split(/\./,$_); |
my ($choicemap,$choiceres)=split(/\./,$id); |
my $map=&Apache::lonnet::declutter($hash{'src_'.$choicemap}); |
my $map=&Apache::lonnet::declutter($hash{'src_'.$choicemap}); |
my $url=$multichoicehash{'src_'.$_}; |
my $url=$multichoicehash{'src_'.$id}; |
$cachehash{$map}{$url}=[$url,$choiceres]; |
$cachehash{$map}{$url}=[$url,$choiceres]; |
} @possibilities; |
} |
} |
} |
} else { |
} else { |
# -------------------------------------------------------------- No place to go |
# -------------------------------------------------------------- No place to go |
$multichoice=-1; |
$multichoice=-1; |
|
if ($position && $env{'request.deeplink.login'}) { |
|
my ($map,$resid,$url) = &Apache::lonnet::decode_symb($position); |
|
my $mapid = $hash{'map_pc_'.&Apache::lonnet::clutter($map)}; |
|
my $position_deeplink = $hash{'deeplinkonly_'.$mapid.'.'.$resid}; |
|
if ($position_deeplink) { |
|
(my $value,$deeplinklevel) = map { &unescape($_); } |
|
split(/:/,$position_deeplink); |
|
} |
|
} |
} |
} |
# ----------------- The program must come past this point to untie the big hash |
# ----------------- The program must come past this point to untie the big hash |
untie(%hash); |
untie(%hash); |
# --------------------------------------------------------- Store position info |
# --------------------------------------------------------- Store position info |
$cachehash{$startoutmap}{'last_direction'}=[$direction,'notasymb']; |
$cachehash{$startoutmap}{'last_direction'}=[$direction,'notasymb']; |
foreach my $thismap (keys %cachehash) { |
foreach my $thismap (keys(%cachehash)) { |
my $mapnum=$cachehash{$thismap}->{'mapnum'}; |
my $mapnum=$cachehash{$thismap}->{'mapnum'}; |
delete($cachehash{$thismap}->{'mapnum'}); |
delete($cachehash{$thismap}->{'mapnum'}); |
&Apache::lonnet::symblist($thismap, |
&Apache::lonnet::symblist($thismap, |
Line 328 sub handler {
|
Line 728 sub handler {
|
if ($direction eq 'back') { |
if ($direction eq 'back') { |
&Apache::lonnet::linklog($redirecturl,$currenturl); |
&Apache::lonnet::linklog($redirecturl,$currenturl); |
} |
} |
# ------------------------------------------------- Check for critical messages |
# ------------------------------------- Check for and display critical messages |
if ((time-$ENV{'user.criticalcheck.time'})>300) { |
my ($redirect, $url) = &Apache::loncommon::critical_redirect(300,'flip'); |
my @what=&Apache::lonnet::dump |
unless ($redirect) { |
('critical',$ENV{'user.domain'}, |
my $usehttp = &check_http_req(\$redirecturl,$hostname); |
$ENV{'user.name'}); |
if (($usehttp) && ($hostname ne '')) { |
if ($what[0]) { |
$url='http://'.$hostname.$redirecturl; |
if (($what[0] ne 'con_lost') && |
} else { |
($what[0]!~/^error\:/)) { |
$url=&Apache::lonnet::absolute_url().$redirecturl; |
$redirecturl='/adm/email?critical=display'; |
} |
} |
my $addanchor; |
} |
if (($anchor ne '') && (!$enc || $env{'request.role.adv'})) { |
&Apache::lonnet::appenv('user.criticalcheck.time'=>time); |
$addanchor = 1; |
} |
$url =~ s/\#.+$//; |
|
} |
&Apache::loncommon::content_type($r,'text/html'); |
$url = &add_get_param($url, { 'symb' => $redirectsymb}); |
$r->header_out(Location => |
if ($addanchor) { |
'http://'.$ENV{'HTTP_HOST'}.$redirecturl); |
$url .= $anchor; |
return REDIRECT; |
} |
|
} |
|
if ($reinitcheck eq 'update') { |
|
&Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state); |
|
$r->print(&reinited_js($url,$env{'request.course.id'},100)); |
|
$r->print(&Apache::loncommon::end_page()); |
|
return OK; |
|
} else { |
|
&Apache::loncommon::content_type($r,'text/html'); |
|
$r->header_out(Location => $url); |
|
return REDIRECT; |
|
} |
} else { |
} else { |
# --------------------------------------------------------- There was a problem |
# --------------------------------------------------------- There was a problem |
&Apache::loncommon::content_type($r,'text/html'); |
&Apache::loncommon::content_type($r,'text/html'); |
$r->send_http_header; |
$r->send_http_header; |
|
my %lt=&Apache::lonlocal::texthash('title' => 'End of Sequence', |
|
'deeplink' => 'No link available', |
|
'deeplinkres' => |
|
'Navigation to other content is unavailable when accessing content via deep-linking', |
|
'deeplinkmap' => |
|
'You have reached the end of the sequence of available materials for access via deep-linking', |
|
'explain' => |
|
'You have reached the end of the sequence of materials.', |
|
'back' => 'Go Back', |
|
'nav' => 'Course Contents', |
|
'wherenext' => |
|
'There are several possibilities of where to go next', |
|
'pick' => |
|
'Please click on the the resource you intend to access', |
|
'titleheader' => 'Title', |
|
'type' => 'Type', |
|
'update' => 'Content updated', |
|
'expupdate' => 'As a result of a recent update to the sequence of materials, it is not possible to complete the page flip.', |
|
'gonav' => 'Go to the Contents page to select a resource to display.', |
|
); |
|
if (&Apache::loncommon::course_type() eq 'Community') { |
|
$lt{'nav'} = &mt('Community Contents'); |
|
} |
if ($#possibilities>0) { |
if ($#possibilities>0) { |
my $bodytag= |
my $start_page= |
&Apache::loncommon::bodytag('Multiple Resources'); |
&Apache::loncommon::start_page('Multiple Resources'); |
$r->print(<<ENDSTART); |
$r->print(<<ENDSTART); |
<head><title>Choose Next Location</title></head> |
$start_page |
$bodytag |
<h3>$lt{'wherenext'}</h3> |
<h3>There are several possibilities of where to go next</h3> |
|
<p> |
<p> |
Please click on the the resource you intend to access: |
$lt{'pick'}: |
<p> |
<p> |
<table border=2> |
<table border="2"> |
<tr><th>Title</th><th>Type</th></tr> |
<tr><th>$lt{'titleheader'}</th><th>$lt{'type'}</th></tr> |
ENDSTART |
ENDSTART |
foreach (@possibilities) { |
foreach my $id (@possibilities) { |
|
my $src = $multichoicehash{'src_'.$id}; |
|
my $usehttp = &check_http_req(\$src,$hostname); |
|
if (($usehttp) && ($hostname ne '')) { |
|
$src = 'http://'.$hostname.$src; |
|
} |
$r->print( |
$r->print( |
'<tr><td><a href="'. |
'<tr><td><a href="'. |
$multichoicehash{'src_'.$_}.'?symb=' . |
&add_get_param($src, |
Apache::lonnet::escape($multichoicehash{'symb_'.$_}).'">'. |
{'symb' => |
$multichoicehash{'title_'.$_}. |
$multichoicehash{'symb_'.$id}, |
'</a></td><td>'.$multichoicehash{'type_'.$_}. |
}).'">'. |
|
$multichoicehash{'title_'.$id}. |
|
'</a></td><td>'.$multichoicehash{'type_'.$id}. |
'</td></tr>'); |
'</td></tr>'); |
} |
} |
$r->print('</table></body></html>'); |
$r->print('</table>'); |
return OK; |
|
} else { |
} else { |
my $bodytag=&Apache::loncommon::bodytag('No Resource'); |
if ($reinitcheck) { |
$r->print(<<ENDNONE); |
if (&Apache::loncommon::course_type() eq 'Community') { |
<head><title>No Resource</title></head> |
$r->print( |
$bodytag |
&Apache::loncommon::start_page('Community Contents Updated')); |
<h3>Next resource could not be identified.</h3> |
} else { |
<p>You probably are at the <b>beginning</b> or the <b>end</b> of the |
$r->print( |
course.</p> |
&Apache::loncommon::start_page('Course Contents Updated')); |
<ul> |
} |
<li><a href="/adm/flip?postdata=return:">Go Back</a></li> |
$r->print('<h2>'.$lt{'update'}.'</h2>' |
<li><a href="/adm/navmaps">Navigate Course Content</a></li> |
.'<p>'.$lt{'expupdate'}.'<br />' |
</ul> |
.$lt{'gonav'}.'</p>'); |
</body> |
} else { |
</html> |
if (($env{'course.'.$env{'request.course.id'}.'.type'} eq 'Placement') && |
ENDNONE |
(!$env{'request.role.adv'})) { |
return OK; |
my ($score,$incomplete) = &Apache::lonplacementtest::check_completion(undef,undef,1); |
} |
if ($incomplete) { |
} |
$r->print(&Apache::lonplacementtest::showincomplete($incomplete)); |
|
} else { |
|
$r->print(&Apache::lonplacementtest::showresult(1)); |
|
} |
|
} else { |
|
$r->print( |
|
&Apache::loncommon::start_page('No Resource')); |
|
if ($deeplinklevel eq 'resource') { |
|
$r->print('<h2>'.$lt{'deeplink'}.'</h2>' |
|
.'<p>'.$lt{'deeplinkres'}.'</p>'); |
|
} elsif ($deeplinklevel eq 'map') { |
|
$r->print('<h2>'.$lt{'title'}.'</h2>' |
|
.'<p>'.$lt{'deeplinkmap'}.'</p>'); |
|
} else { |
|
$r->print('<h2>'.$lt{'title'}.'</h2>' |
|
.'<p>'.$lt{'explain'}.'</p>'); |
|
} |
|
} |
|
} |
|
} |
|
unless (($env{'course.'.$env{'request.course.id'}.'.type'} eq 'Placement') && |
|
(!$env{'request.role.adv'})) { |
|
if ($deeplinklevel) { |
|
$r->print( |
|
&Apache::lonhtmlcommon::actionbox( |
|
['<a href="/adm/flip?postdata=return:">'.$lt{'back'}.'</a>'])); |
|
} elsif ((!@possibilities) && ($reinitcheck)) { |
|
$r->print( |
|
&Apache::lonhtmlcommon::actionbox( |
|
['<a href="/adm/navmaps">'.$lt{'nav'}.'</a></li>' |
|
])); |
|
} else { |
|
$r->print( |
|
&Apache::lonhtmlcommon::actionbox( |
|
['<a href="/adm/flip?postdata=return:">'.$lt{'back'}.'</a></li>', |
|
'<a href="/adm/navmaps">'.$lt{'nav'}.'</a></li>' |
|
])); |
|
} |
|
|
|
} |
|
$r->print(&Apache::loncommon::end_page()); |
|
|
|
return OK; |
|
} |
} else { |
} else { |
# ------------------------------------------------- Problem, could not tie hash |
# ------------------------------------------------- Problem, could not tie hash |
$ENV{'user.error.msg'}="/adm/flip:bre:0:1:Course Data Missing"; |
if ($reinitcheck eq 'update') { |
|
&Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state); |
|
$r->print(&Apache::loncommon::end_page()); |
|
} |
|
$env{'user.error.msg'}="/adm/flip:bre:0:1:Course Data Missing"; |
return HTTP_NOT_ACCEPTABLE; |
return HTTP_NOT_ACCEPTABLE; |
} |
} |
} else { |
} else { |
# ---------------------------------------- No, could not determine where we are |
# ---------------------------------------- No, could not determine where we are |
if ( &Apache::lonnet::mod_perl_version() == 2 ) { |
my $newloc = '/adm/ambiguous'; |
&Apache::lonnet::cleanenv(); |
if ($reinitcheck eq 'update') { |
} |
&Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state); |
$r->internal_redirect('/adm/ambiguous'); |
$r->print(&reinited_js($newloc,$env{'request.course.id'},100)); |
|
$r->print(&Apache::loncommon::end_page()); |
|
} else { |
|
$r->internal_redirect($newloc); |
|
} |
|
return OK; |
} |
} |
} else { |
} else { |
# -------------------------- Class was not initialized or page fliped strangely |
# -------------------------- Class was not initialized or page fliped strangely |
$ENV{'user.error.msg'}="/adm/flip:bre:0:0:Choose Course"; |
$env{'user.error.msg'}="/adm/flip:bre:0:0:Choose Course"; |
return HTTP_NOT_ACCEPTABLE; |
return HTTP_NOT_ACCEPTABLE; |
} |
} |
} |
} |
Line 414 ENDNONE
|
Line 905 ENDNONE
|
1; |
1; |
__END__ |
__END__ |
|
|
|
=pod |
|
|
|
=head1 NAME |
|
|
|
Apache::lonpageflip |
|
|
|
=head1 SYNOPSIS |
|
|
|
Deals with forward, backward, and other page flips. |
|
|
|
This is part of the LearningOnline Network with CAPA project |
|
described at http://www.lon-capa.org. |
|
|
|
=head1 OVERVIEW |
|
|
|
(empty) |
|
|
|
=head1 SUBROUTINES |
|
|
|
=over cleanup() |
|
|
|
=item addrid() |
|
|
|
=item fullmove() |
|
|
|
=item hash_src() |
|
|
|
=item move() |
|
|
|
=item get_next_possible_move() |
|
|
|
=item first_accessible_resource() |
|
|
|
=item handler() |
|
|
|
=back |
|
|
|
=cut |
|
|
|
|
|
|