--- rat/lonwrapper.pm 2023/10/06 17:35:54 1.49.2.11.2.5 +++ rat/lonwrapper.pm 2017/12/18 23:23:14 1.66 @@ -1,7 +1,7 @@ # The LearningOnline Network with CAPA # Wrapper for external and binary files as standalone resources # -# $Id: lonwrapper.pm,v 1.49.2.11.2.5 2023/10/06 17:35:54 raeburn Exp $ +# $Id: lonwrapper.pm,v 1.66 2017/12/18 23:23:14 raeburn Exp $ # # Copyright Michigan State University Board of Trustees # @@ -38,16 +38,13 @@ use Apache::loncommon(); use Apache::lonhtmlcommon(); use Apache::lonextresedit(); use Apache::lonexttool(); -use Apache::lonhomework(); -use Apache::lonnavmaps(); use LONCAPA qw(:DEFAULT :match); use HTML::Entities(); -use Digest::MD5(); # ================================================================ Main Handler sub wrapper { - my ($r,$url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,$linktext,$explanation, - $title,$width,$height,$reuse,$is_supp) = @_; + my ($url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,$linktext,$explanation, + $title,$width,$height) = @_; my $forcereg; unless ($env{'form.folderpath'}) { @@ -58,10 +55,7 @@ sub wrapper { 'show' => 'Show content in pop-up window', ); - (undef,undef,undef,undef,undef,undef,my $clientmobile) = - &Apache::loncommon::decode_user_agent($r); - - my ($anchor,$uselink); + my $anchor; if ($is_ext) { if ($env{'form.symb'}) { (undef,undef,my $res) = &Apache::lonnet::decode_symb($env{'form.symb'}); @@ -71,15 +65,6 @@ sub wrapper { } elsif ($env{'form.anchor'} ne '') { $anchor = '#'.$env{'form.anchor'}; } - if (($is_ext eq 'tab') || ($is_ext eq 'window')) { - $uselink = 1; - } - unless (($is_pdf && $clientmobile) || $uselink) { - my $hostname = $r->hostname(); - my $lonhost = $r->dir_config('lonHostID'); - my $ip = &Apache::lonnet::get_host_ip($lonhost); - $uselink = &Apache::loncommon::is_nonframeable($url,$absolute,$hostname,$ip); - } } my $noiframe = &Apache::loncommon::modal_link($url.$anchor,$lt{'show'},500,400); @@ -95,171 +80,66 @@ sub wrapper { } if ($env{'form.only_body'}) { $args->{'only_body'} = $env{'form.only_body'}; - } elsif (($is_supp) && ($env{'form.folderpath'} ne '')) { - $args->{'bread_crumbs_nomenu'} = 1; } - my ($countdown,$donemsg,$headjs); - if (($exttool) && (&Apache::lonnet::EXT('resource.0.gradable') =~ /^yes$/i)) { - $Apache::lonhomework::browse = &Apache::lonnet::allowed('bre',$url); - if ($env{'form.markaccess'}) { - my $symb=&Apache::lonnet::symbread($url); - my @interval=&Apache::lonnet::EXT('resource.0.interval',$symb); - my ($timelimit) = split(/_/,$interval[0]); - my $setres = &Apache::lonnet::set_first_access($interval[1],$timelimit); - if ($setres eq 'ok') { - delete($env{'form.markaccess'}); - } - } elsif ($env{'form.LC_interval_done'} eq 'true') { - my $symb=&Apache::lonnet::symbread($url); - if ($symb) { - (my $donebuttonresult,$donemsg) = &Apache::lonhomework::zero_timer($symb); - undef($env{'form.LC_interval_done'}); - undef($env{'form.LC_interval_done_proctorpass'}); - } - } - my ($status,$result,$resource_due) = - &Apache::lonexttool::gradabletool_access_check(); - undef($Apache::lonhomework::browse); - if ($status eq 'CAN_ANSWER') { - if ($resource_due) { - my $time_left = $resource_due - time(); - if ($resource_due && ($time_left > 0)) { - $countdown =' + my $startpage = &Apache::loncommon::start_page('Menu',undef,$args); + my $endpage = &Apache::loncommon::end_page(); + + if (($exttool) && (&Apache::lonnet::EXT('resource.0.gradable'))) { + my $resource_due = &Apache::lonhomework::due_date(0, $env{'request.symb'}); + if ($resource_due) { + my $time_left = $resource_due - time(); + if ($resource_due && ($time_left > 0)) { + $startpage .=' '."\n". - &Apache::lonhtmlcommon::set_due_date($resource_due); - } - } - } else { - if ($status eq 'SHOW_ANSWER') { - $result = &Apache::lonexttool::display_score(). - &Apache::lonfeedback::list_discussion('tool','OPEN'); + &Apache::lonhtmlcommon::set_due_date($resource_due); } - return &Apache::loncommon::start_page('Menu',undef,$args). - $result. - &Apache::loncommon::end_page(); } } -# -# Where iframe is in use, if window.onload() executes before the custom resize function -# has been defined (jQuery), two global javascript vars (LCnotready and LCresizedef) -# are used to ensure document.ready() triggers a call to resize, so the iframe contents -# do not obscure the Functions menu. -# - - unless ($clientmobile || ($exttool eq 'window') || ($exttool eq 'tab') || $uselink) { - $headjs = ' -'."\n"; - } - - my $startpage = &Apache::loncommon::start_page('Menu',$headjs,$args).$countdown.$donemsg; - my $endpage = &Apache::loncommon::end_page(); - - if (($uselink) && ($title eq '')) { - if ($env{'form.symb'}) { - $title=&Apache::lonnet::gettitle($env{'form.symb'}); - } elsif (!$is_supp) { - my $symb=&Apache::lonnet::symbread($r->uri); - if ($symb) { - $title=&Apache::lonnet::gettitle($symb); - } - } - } - if ($clientmobile || ($exttool eq 'window') || ($exttool eq 'tab') || - ($is_ext eq 'tab') || ($is_ext eq 'window')) { + if (($env{'browser.mobile'}) || ($exttool eq 'window') || ($exttool eq 'tab')) { my $output = $startpage; if ($is_pdf) { - $linktext = &mt('Link to PDF (for mobile devices)'); - $output .= &create_link($url,$anchor,$title,$linktext); - } elsif (($exttool eq 'window') || ($exttool eq 'tab') || - ($is_ext eq 'tab') || ($is_ext eq 'window')) { - my $preamble; - if ($linktext eq '') { - if ($exttool) { - $linktext = &mt('Launch External Tool'); - } else { - $linktext = &mt('Link to External Resource'); + if ($title eq '') { + $title = $env{'form.title'}; + if ($title eq '') { + unless ($env{'request.enc'}) { + ($title) = ($url =~ m{/([^/]+)$}); + $title =~ s/(\?[^\?]+)$//; + } } } - if ($exttool) { - $url = &HTML::Entities::encode($url,'"<>&'); - } else { - $url = &HTML::Entities::encode($url.$anchor,'&<>"'); + unless ($title eq '') { + $output .= $title.'
'; } - if (($exttool eq 'tab') || ($is_ext eq 'tab')) { - my $target; - if ($exttool) { - $target = 'LCExternalToolTab'; - } else { - if ($reuse) { - $target = 'LCExternalResTab'; - } else { - $target = '_blank'; - } - if ($title ne '') { - $preamble = ''.$title.'
'; - } - } - $output .= '
'.$preamble. - ''. + $output .= ''.&mt('Link to PDF (for mobile devices)').''; + } elsif (($exttool eq 'window') || ($exttool eq 'tab')) { + if ($linktext eq '') { + $linktext = &mt('Launch External Tool'); + } + $url = &HTML::Entities::encode($url,'"<>&'); + if ($exttool eq 'tab') { + $output .= '
'. + ''. $linktext.''. '
'; } else { - my ($target,$extlinkimg); - if ($exttool) { - $target = 'LCExternalToolPopUp'; - } else { - $target = 'LCExternalResPopUp'; - if ($title ne '') { - $preamble = ''.$title.'
'; - } - $extlinkimg = ''; - unless ($reuse) { - my $resid; - if ($env{'request.course.id'}) { - unless (($is_supp) || ($env{'form.folderpath'} =~ /^supplemental/)) { - my $symb=&Apache::lonnet::symbread($r->uri); - if ($symb) { - my $navmap = Apache::lonnavmaps::navmap->new(); - if (ref($navmap)) { - my $res = $navmap->getBySymb($symb); - if (ref($res)) { - $resid = $res->id; - $resid =~ s/\./_/g; - } - } - } - } - } - if ($resid eq '') { - $resid = substr(Digest::MD5::md5_hex(Digest::MD5::md5_hex(time(). {}. rand(). $$)), 0, 8); - } - &js_escape(\$resid); - $target .= $resid; - } - } $output .= <<"ENDLINK"; -
$preamble - -$linktext$extlinkimg +
+ +$linktext
ENDLINK } - if ($exttool) { - if ($explanation ne '') { - $output .= '
'.$explanation.'
'; - } - if (&Apache::lonnet::EXT('resource.0.gradable')) { - $output .= &Apache::lonfeedback::list_discussion('tool','OPEN'); - } + if ($explanation ne '') { + $output .= '
'.$explanation.'
'; } - } else { - if ($uselink) { - $linktext = &mt('Link to resource'); - $output .= &create_link($url,$anchor,$title,$linktext); - } else { - my $dest = &HTML::Entities::encode($url.$anchor,'&<>"'); - $output .= '
'."\n". - '\n". - "
\n"; + if (&Apache::lonnet::EXT('resource.0.gradable')) { + $output .= &Apache::lonfeedback::list_discussion('tool','OPEN'); } + } else { + my $dest = &HTML::Entities::encode($url.$anchor,'&<>"'); + $output .= '
'."\n". + '\n". + "
\n"; } $output .= $endpage; return $output; - } elsif ($uselink) { - $linktext = &mt('Link to resource'); - return $startpage.&create_link($url,$anchor,$title,$linktext).$endpage; } else { my $offset = 5; &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['inhibitmenu']); - if (($env{'form.inhibitmenu'} eq 'yes') || ($env{'form.only_body'})) { + if ($env{'form.inhibitmenu'} eq 'yes') { $offset = 0; } my $script = &Apache::lonhtmlcommon::scripttag(<"'); @@ -357,26 +215,6 @@ ENDFRAME } } -sub create_link { - my ($url,$anchor,$title,$linktext) = @_; - my $shownlink; - if ($title eq '') { - $title = $env{'form.title'}; - if ($title eq '') { - unless ($env{'request.enc'}) { - ($title) = ($url =~ m{/([^/]+)$}); - $title =~ s/(\?[^\?]+)$//; - } - } - } - unless ($title eq '') { - $shownlink = ''.$title.'
'; - } - my $dest = &HTML::Entities::encode($url.$anchor,'&<>"'); - $shownlink .= ''.$linktext.''; - return $shownlink; -} - sub handler { my $r=shift; &Apache::loncommon::content_type($r,'text/html'); @@ -386,38 +224,18 @@ sub handler { my $url = $r->uri; my ($is_ext,$brcrum,$absolute,$is_pdf,$exttool,$cdom,$cnum,$hostname, - $linktext,$explanation,$width,$height,$reuse,$is_supp); + $linktext,$explanation,$width,$height); for ($url){ s|^/adm/wrapper||; - $is_ext = $_ =~ s|^/ext/|http://|; - s|http://https://|https://| if ($is_ext); - s|:|:|g; + $is_ext = $_ =~ s|^/ext/|http://|; + s|http://https://|https://|; + s|:|:|g; } + if ($url =~ /\.pdf$/i) { $is_pdf = 1; - } elsif (($is_ext) && ($env{'request.course.id'})) { - if ($env{'course.'.$env{'request.course.id'}.'.extresource'}) { - (my $selected,$reuse,$width,$height) = split(/:/,$env{'course.'.$env{'request.course.id'}.'.extresource'}); - if ($selected eq 'tab') { - $is_ext = 'tab'; - $width = ''; - $height = ''; - } elsif ($selected eq 'window') { - $is_ext = 'window'; - unless ($width =~ /^\d+$/) { - $width = ''; - } - unless ($height =~ /^\d+$/) { - $height = ''; - } - } else { - $width = ''; - $height = ''; - $reuse = ''; - } - } } elsif ($url =~ m{^/adm/($match_domain)/($match_courseid)/(\d+)/ext\.tool$}) { $cdom = $1; $cnum = $2; @@ -427,16 +245,9 @@ sub handler { my %toolhash = &Apache::lonnet::get('exttool_'.$marker,['target','linktext','explanation','id','width','height'], $cdom,$cnum); if ($toolhash{'id'}) { - my ($idx,%ltitools); - if ($toolhash{'id'} =~ /^c(\d+)$/) { - $idx = $1; - %ltitools = &Apache::lonnet::get_course_lti($cnum,$cdom,'consumer'); - } else { - $idx = $toolhash{'id'}; - %ltitools = &Apache::lonnet::get_domain_lti($cdom,'consumer'); - } - if (ref($ltitools{$idx}) eq 'HASH') { - $exttoolremote = $ltitools{$idx}{'url'}; + my %ltitools = &Apache::lonnet::get_domain_lti($cdom,'consumer'); + if (ref($ltitools{$toolhash{'id'}}) eq 'HASH') { + $exttoolremote = $ltitools{$toolhash{'id'}}{'url'}; } } if ($toolhash{'target'} eq 'window') { @@ -444,10 +255,10 @@ sub handler { $width = $toolhash{'width'}; $height = $toolhash{'height'}; } elsif ($toolhash{'target'} eq 'tab') { - $exttool = 'tab'; + $exttool = 'tab'; } if (($exttool eq 'window') || ($exttool eq 'tab')) { - $linktext = $toolhash{'linktext'}; + $linktext = $toolhash{'linktext'}; $explanation = $toolhash{'explanation'}; } elsif (($exttoolremote =~ /^http:/) && ($ENV{'SERVER_PORT'} == 443)) { $exttool = 'tab'; @@ -455,7 +266,7 @@ sub handler { } if (($is_ext) || ($exttool)) { &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'}, - ['forceedit','register','folderpath','symb','idx','title','anchor','only_body']); + ['forceedit','register','folderpath','symb','idx','title','anchor']); if (($env{'form.forceedit'}) && (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) && (($env{'form.folderpath'} =~ /^supplemental/) || @@ -469,7 +280,6 @@ sub handler { if ($env{'form.anchor'} ne '') { $url .= '#'.$env{'form.anchor'}; } - $is_supp = 1; } my $type = 'ext'; if ($exttool) { @@ -493,37 +303,8 @@ sub handler { $title = &mt('External Tool'); } } - $title = &HTML::Entities::encode($title,'\'"<>&'); - $is_supp = 1; - if ($env{'request.course.id'}) { - $cnum = $env{'course.'.$env{'request.course.id'}.'.num'}; - $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'}; - &Apache::loncommon::validate_folderpath(1,'',$cnum,$cdom); - } - unless ($env{'form.only_body'}) { - $brcrum = - &Apache::lonhtmlcommon::docs_breadcrumbs(undef,$crstype,undef,$title,1); - } - } - } elsif ($env{'request.course.id'}) { - my $courseurl = &Apache::lonnet::courseid_to_courseurl($env{'request.course.id'}); - $courseurl =~ s{^/}{}; - if ($url =~ m{^\Q/uploaded/$courseurl/supplemental/\E}) { - $is_supp = 1; - &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'}, - ['folderpath','title','only_body']); - if ($env{'form.folderpath'}) { - $cnum = $env{'course.'.$env{'request.course.id'}.'.num'}; - $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'}; - &Apache::loncommon::validate_folderpath(1,'',$cnum,$cdom); - } - my $title = $env{'form.title'}; - $title = &HTML::Entities::encode($title,'\'"<>&'); - my $crstype = &Apache::loncommon::course_type(); - unless ($env{'form.only_body'}) { - $brcrum = - &Apache::lonhtmlcommon::docs_breadcrumbs(undef,$crstype,undef,$title,1); - } + $brcrum = + &Apache::lonhtmlcommon::docs_breadcrumbs(undef,$crstype,undef,$title,1); } } @@ -555,9 +336,8 @@ sub handler { &Apache::lonenc::check_encrypt(\$url); } - $r->print( wrapper($r,$url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool, - $linktext,$explanation,undef,$width,$height,$reuse, - $is_supp) ); + $r->print( wrapper($url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool, + $linktext,$explanation,undef,$width,$height) ); } # not just the menu @@ -584,21 +364,14 @@ described at http://www.lon-capa.org. =over -=item wrapper($r,$url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,$linktext,$explanation,$title,$width,$height,$reuse,$is_supp) +=item wrapper($url,$brcrum,$absolute,$is_ext,$is_pdf,$linktext,$explanation,$title,$width,$height) =over -=item $r - -request object - =item $url -url to display either by including in an iframe within a -LON-CAPA page which has a standard LON-CAPA inline menu, -or in some cases launched in a separate tab or window, -launched via a link in a LON-CAPA page with standard inline -menu. +url to display by including in an iframe within a +LON-CAPA page which has a standard LON-CAPA inline menu. =item $brcrum @@ -627,89 +400,26 @@ in Firefox 23 and later, when serving fr =item $is_ext -true if URL is for an external resource. Default true value -is 1 (display in iframe, unless $uselink is true). -If external resource is to be displayed in a tab, -value of $is_ext will be tab, if to be displayed in a pop-up window, -value of $is_ext will be window. +true if URL is for an external resource. =item $is_pdf true if URL is for a PDF (based on file extension). -=item $exttool - -If URL is for an External Tool, will contain the target type: iframe, window or tab. - -=item $linktext - -optional. If URL is for an External Tool, and target type is window or tab, -then the link text may be an option set in the course for each tool instance, -or may be a default defined in the domain for all instances of the tool. - -=item $explanation - -optional. If URL is for an External Tool, and target type is window or tab, -then the explanation is an option set in the course for each tool instance, -or may be a default defined in the domain for all instances of the tool. - =item $title -optional. If wrapped item is a PDF, and $clientmobile is true, -a link to a PDF is shown. The "title" will be displayed +optional. If wrapped item is a PDF, and $env{'browser.mobile'} +is true, a link to a PDF is shown. The "title" will be displayed above the link, but if not provided as an arg, $env{'form.title'} will be used, otherwise, the filename will be displayed (unless hidden URL set for the resource). -=item $width - -optional. If URL is for an External Tool, and target type is window, -then a default width may have been defined in the domain for all instances of -the tool. If so, that width will be used for the window opened (via a link) -to launch the external tool. If the URL is for an External Resource, and -$is_ext is window, then a default width (px) may have been defined in the current -course for all external resource instances. - -=item $height - -optional. If URL is for an External Tool, and target type is window, -then a default height may have been defined in the domain for all instances of -the tool. If so, that height will be used for the window opened (via a link) -to launch the external tool. If the URL is for an External Resource, and -$is_ext is window, then a default height (px) may have been defined in the current -course for all external resource instances. - -=item $reuse - -optional. If the URL is for an External Resource, and $is_ext is tab or window, -then $reuse will be true if the same tab or window is to be reused for display -of all external resource instances in a a course. - =back Returns markup for the entire page. =item handler() -Content handler for requests for: /adm/wrapper/... -used for content to be displayed in an iframe, or launched in a separate tab -or window via a link. The target URL is extracted from the requested URL, by -removing the /adm/wrapper prefix. - -The target URL will typically be a PDF served from the current server, an -external resource URL served from a different server, or an external tool -(from an LTI Provider) launched from LON-CAPA (as LTI Consumer) and launched -via a link. - -If the request included forceedit in the query string, and the requester has -rights to modify course content, then the editor will be displayed to allow -changes to be made to the resource (e.g., change the URL of the external resource, -or change the setting for the external tool instance). - -If not in edit mode, then the wrapper() subroutine will be called to generate the -standard LON-CAPA inline menu, and then either a link to launch a separate tab or -window, or an iframe to display the content inline. - =back =cut