File:  [LON-CAPA] / rat / lonwrapper.pm
Revision 1.79: download - view: text, annotated - select for diffs
Tue Aug 30 11:41:27 2022 UTC (19 months, 4 weeks ago) by raeburn
Branches: MAIN
CVS tags: HEAD
- Remove trailing whitespace. Fix typo in documentation.

    1: # The LearningOnline Network with CAPA
    2: # Wrapper for external and binary files as standalone resources
    3: #
    4: # $Id: lonwrapper.pm,v 1.79 2022/08/30 11:41:27 raeburn Exp $
    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: #
   28: 
   29: 
   30: package Apache::lonwrapper;
   31: 
   32: use strict;
   33: use Apache::Constants qw(:common);
   34: use Apache::lonenc();
   35: use Apache::lonnet;
   36: use Apache::lonlocal;
   37: use Apache::loncommon();
   38: use Apache::lonhtmlcommon();
   39: use Apache::lonextresedit();
   40: use Apache::lonexttool();
   41: use Apache::lonhomework();
   42: use Apache::lonnavmaps();
   43: use LONCAPA qw(:DEFAULT :match);
   44: use HTML::Entities();
   45: use Digest::MD5();
   46: 
   47: # ================================================================ Main Handler
   48: sub wrapper {
   49:     my ($r,$url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,$linktext,$explanation,
   50:         $title,$width,$height,$reuse) = @_;
   51: 
   52:     my $forcereg;
   53:     unless ($env{'form.folderpath'}) {
   54:         $forcereg = 1;
   55:     }
   56:     my %lt = &Apache::lonlocal::texthash(
   57:                                           'noif' => 'No iframe support.',
   58:                                           'show' => 'Show content in pop-up window',
   59:                                         );
   60: 
   61:     (undef,undef,undef,undef,undef,undef,my $clientmobile) =
   62:         &Apache::loncommon::decode_user_agent($r);
   63: 
   64:     my ($anchor,$uselink);
   65:     if ($is_ext) {
   66:         if ($env{'form.symb'}) {
   67:             (undef,undef,my $res) = &Apache::lonnet::decode_symb($env{'form.symb'});
   68:             if ($res =~ /(#[^#]+)$/) {
   69:                 $anchor = $1;
   70:             }
   71:         } elsif ($env{'form.anchor'} ne '') {
   72:             $anchor = '#'.$env{'form.anchor'};
   73:         }
   74:         if (($is_ext eq 'tab') || ($is_ext eq 'window')) {
   75:             $uselink = 1;
   76:         }
   77:         unless (($is_pdf && $clientmobile) || $uselink) {
   78:             my $hostname = $r->hostname();
   79:             my $lonhost = $r->dir_config('lonHostID');
   80:             my $ip = &Apache::lonnet::get_host_ip($lonhost);
   81:             $uselink = &Apache::loncommon::is_nonframeable($url,$absolute,$hostname,$ip);
   82:         }
   83:     }
   84: 
   85:     my $noiframe = &Apache::loncommon::modal_link($url.$anchor,$lt{'show'},500,400);
   86:     my $args = {'bgcolor' => '#FFFFFF'};
   87:     if ($forcereg) {
   88:         $args->{'force_register'} = $forcereg;
   89:     }
   90:     if (ref($brcrum) eq 'ARRAY') {
   91:         $args->{'bread_crumbs'} = $brcrum;
   92:     }
   93:     if ($absolute) {
   94:         $args->{'use_absolute'} = $absolute;
   95:     }
   96:     if ($env{'form.only_body'}) {
   97:         $args->{'only_body'} = $env{'form.only_body'};
   98:     }
   99: 
  100:     my ($countdown,$donemsg,$headjs);
  101:     if (($exttool) && (&Apache::lonnet::EXT('resource.0.gradable') =~ /^yes$/i)) {
  102:         $Apache::lonhomework::browse = &Apache::lonnet::allowed('bre',$url);
  103:         if ($env{'form.markaccess'}) {
  104:             my $symb=&Apache::lonnet::symbread($url);
  105:             my @interval=&Apache::lonnet::EXT('resource.0.interval',$symb);
  106:             my ($timelimit) = split(/_/,$interval[0]);
  107:             my $setres = &Apache::lonnet::set_first_access($interval[1],$timelimit);
  108:             if ($setres eq 'ok') {
  109:                 delete($env{'form.markaccess'});
  110:             }
  111:         } elsif ($env{'form.LC_interval_done'} eq 'true') {
  112:             my $symb=&Apache::lonnet::symbread($url);
  113:             if ($symb) {
  114:                 (my $donebuttonresult,$donemsg) = &Apache::lonhomework::zero_timer($symb);
  115:                 undef($env{'form.LC_interval_done'});
  116:                 undef($env{'form.LC_interval_done_proctorpass'});
  117:             }
  118:         }
  119:         my ($status,$result,$resource_due) =
  120:             &Apache::lonexttool::gradabletool_access_check();
  121:         undef($Apache::lonhomework::browse);
  122:         if ($status eq 'CAN_ANSWER') {
  123:             if ($resource_due) {
  124:                 my $time_left = $resource_due - time();
  125:                 if ($resource_due && ($time_left > 0)) {
  126:                     $countdown ='
  127: <script type="text/javascript">
  128: // <![CDATA['."\n".
  129:                              &Apache::lonhtmlcommon::countdown().'
  130: // ]]>
  131: </script>'."\n".
  132:                     &Apache::lonhtmlcommon::set_due_date($resource_due);
  133:                 }
  134:             }
  135:         } else {
  136:             if ($status eq 'SHOW_ANSWER') {
  137:                 $result = &Apache::lonexttool::display_score().
  138:                           &Apache::lonfeedback::list_discussion('tool','OPEN');
  139:             }
  140:             return &Apache::loncommon::start_page('Menu',undef,$args).
  141:                    $result.
  142:                    &Apache::loncommon::end_page();
  143:         }
  144:     }
  145: 
  146: #
  147: # Where iframe is in use, if window.onload() executes before the custom resize function
  148: # has been defined (jQuery), two global javascript vars (LCnotready and LCresizedef)
  149: # are used to ensure document.ready() triggers a call to resize, so the iframe contents
  150: # do not obscure the Functions menu.
  151: #
  152: 
  153:     unless ($clientmobile || ($exttool eq 'window') || ($exttool eq 'tab') || $uselink) {
  154:         $headjs = '
  155: <script type="text/javascript">
  156: // <![CDATA[
  157: var LCnotready = 0;
  158: var LCresizedef = 0;
  159: // ]]>
  160: </script>'."\n";
  161:     }
  162: 
  163:     my $startpage = &Apache::loncommon::start_page('Menu',$headjs,$args).$countdown.$donemsg;
  164:     my $endpage = &Apache::loncommon::end_page();
  165: 
  166:     if (($uselink) && ($title eq '')) {
  167:         if ($env{'form.symb'}) {
  168:             $title=&Apache::lonnet::gettitle($env{'form.symb'});
  169:         } else {
  170:             my $symb=&Apache::lonnet::symbread($r->uri);
  171:             if ($symb) {
  172:                 $title=&Apache::lonnet::gettitle($symb);
  173:             }
  174:         }
  175:     }
  176:     if ($clientmobile || ($exttool eq 'window') || ($exttool eq 'tab') ||
  177:         ($is_ext eq 'tab') || ($is_ext eq 'window')) {
  178:         my $output = $startpage;
  179:         if ($is_pdf) {
  180:             $linktext = &mt('Link to PDF (for mobile devices)');
  181:             $output .= &create_link($url,$anchor,$title,$linktext);
  182:         } elsif (($exttool eq 'window') || ($exttool eq 'tab') ||
  183:                  ($is_ext eq 'tab') || ($is_ext eq 'window')) {
  184:             my $preamble;
  185:             if ($linktext eq '') {
  186:                 if ($exttool) {
  187:                     $linktext = &mt('Launch External Tool');
  188:                 } else {
  189:                     $linktext = &mt('Link to External Resource');
  190:                 }
  191:             }
  192:             if ($exttool) {
  193:                 $url = &HTML::Entities::encode($url,'"<>&');
  194:             } else {
  195:                 $url = &HTML::Entities::encode($url.$anchor,'&<>"');
  196:             }
  197:             if (($exttool eq 'tab') || ($is_ext eq 'tab')) {
  198:                 my $target;
  199:                 if ($exttool) {
  200:                     $target = 'LCExternalToolTab';
  201:                 } else {
  202:                     if ($reuse) {
  203:                         $target = 'LCExternalResTab';
  204:                     } else {
  205:                         $target = '_blank';
  206:                     }
  207:                     if ($title ne '') {
  208:                         $preamble = '<span style="font-weight:bold;">'.$title.'</span><br />';
  209:                     }
  210:                 }
  211:                 $output .= '<div>'.$preamble.
  212:                            '<a href="'.$url.'" target="'.$target.'" style="padding:0;clear:both;margin:0;border:0">'.
  213:                            $linktext.'</a>'.
  214:                            '</div>';
  215:             } else {
  216:                 my ($target,$extlinkimg);
  217:                 if ($exttool) {
  218:                     $target = 'LCExternalToolPopUp';
  219:                 } else {
  220:                     $target = 'LCExternalResPopUp';
  221:                     if ($title ne '') {
  222:                         $preamble = '<span style="font-weight:bold;">'.$title.'</span><br />';
  223:                     }
  224:                     $extlinkimg = '<img src="'.&Apache::loncommon::lonhttpdurl($r->dir_config('lonIconsURL').'/externallink.gif').'" width="19" height="18" border="0" />';
  225:                     unless ($reuse) {
  226:                         my $resid;
  227:                         if ($env{'request.course.id'}) {
  228:                             unless ($env{'form.folderpath'} =~ /^supplemental/) {
  229:                                 my $symb=&Apache::lonnet::symbread($r->uri);
  230:                                 if ($symb) {
  231:                                     my $navmap = Apache::lonnavmaps::navmap->new();
  232:                                     if (ref($navmap)) {
  233:                                         my $res = $navmap->getBySymb($symb);
  234:                                         if (ref($res)) {
  235:                                             $resid = $res->id;
  236:                                             $resid =~ s/\./_/g;
  237:                                         }
  238:                                     }
  239:                                 }
  240:                             }
  241:                         }
  242:                         if ($resid eq '') {
  243:                             $resid = substr(Digest::MD5::md5_hex(Digest::MD5::md5_hex(time(). {}. rand(). $$)), 0, 8);
  244:                         }
  245:                         &js_escape(\$resid);
  246:                         $target .= $resid;
  247:                     }
  248:                 }
  249:                 $output .= <<"ENDLINK";
  250: <script type="text/javascript">
  251: // <![CDATA[
  252: var windowObjectReference = null;
  253: var PreviousUrl;
  254: 
  255: function openSinglePopup(strUrl) {
  256:     if (windowObjectReference == null || windowObjectReference.closed) {
  257:         windowObjectReference = window.open(strUrl, "$target",
  258:                                             "height=$height,width=$width,scrollbars=yes,resizable=yes,status=yes,menubar=no,location=no'");
  259:     } else if(PreviousUrl != strUrl) {
  260:         windowObjectReference = window.open(strUrl, "$target",
  261:                                             "height=$height,width=$width,scrollbars=yes,resizable=yes,status=yes,menubar=no,location=no'");
  262:         windowObjectReference.focus();
  263:     } else {
  264:         windowObjectReference.focus();
  265:     };
  266:     PreviousUrl = strUrl;
  267: }
  268: // ]]>
  269: </script>
  270: <div>$preamble
  271: <a href="$url" target="$target" onclick="openSinglePopup(this.href); return false;">
  272: $linktext$extlinkimg</a>
  273: </div>
  274: ENDLINK
  275:             }
  276:             if ($exttool) {
  277:                 if ($explanation ne '') {
  278:                     $output .= '<div>'.$explanation.'</div>';
  279:                 }
  280:                 if (&Apache::lonnet::EXT('resource.0.gradable')) {
  281:                     $output .= &Apache::lonfeedback::list_discussion('tool','OPEN');
  282:                 }
  283:             }
  284:         } else {
  285:             if ($uselink) {
  286:                 $linktext = &mt('Link to resource');
  287:                 $output .= &create_link($url,$anchor,$title,$linktext);
  288:             } else {
  289:                 my $dest = &HTML::Entities::encode($url.$anchor,'&<>"');
  290:                 $output .= '<div style="overflow:scroll; -webkit-overflow-scrolling:touch;">'."\n".
  291:                            '<iframe src="'.$dest.'" height="100%" width="100%" frameborder="0">'."\n".
  292:                            "$lt{'noif'} $noiframe\n".
  293:                            "</iframe>\n".
  294:                            "</div>\n";
  295:             }
  296:         }
  297:         $output .= $endpage;
  298:         return $output;
  299:     } elsif ($uselink) {
  300:         $linktext = &mt('Link to resource');
  301:         return $startpage.&create_link($url,$anchor,$title,$linktext).$endpage;
  302:     } else {
  303:         my $offset = 5;
  304:         &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['inhibitmenu']);
  305:         if ($env{'form.inhibitmenu'} eq 'yes') {
  306:             $offset = 0;
  307:         }
  308:         my $script = &Apache::lonhtmlcommon::scripttag(<<SCRIPT);
  309:         \$(document).ready( function() {
  310:             \$(window).unbind('resize').resize(function(){
  311:                 var header = null;
  312:                 var offset = $offset;
  313:                 var height = 0;
  314:                 var hdrtop = 0;
  315:                 if (\$('div.LC_head_subbox:first').length) {
  316:                     header = \$('div.LC_head_subbox:first');
  317:                     offset = 9;
  318:                 } else {
  319:                     if (\$('#LC_breadcrumbs').length) {
  320:                         header = \$('#LC_breadcrumbs');
  321:                     }
  322:                 }
  323:                 if (header != null && header.length) {
  324:                     height = header.height();
  325:                     hdrtop = header.position().top;
  326:                 }
  327:                 var pos = height + hdrtop + offset;
  328:                 \$('.LC_iframecontainer').css('top', pos);
  329:             });
  330:             LCresizedef = 1;
  331:             if (LCnotready == 1) {
  332:                 LCnotready = 0;
  333:                 \$(window).trigger('resize');
  334:             }
  335:         });
  336:         window.onload = function(){
  337:              if (LCresizedef) {
  338:                  LCnotready = 0;
  339:                  \$(window).trigger('resize');
  340:              } else {
  341:                  LCnotready = 1;
  342:              }
  343:         };
  344: SCRIPT
  345:         # javascript will position the iframe if window was resized (or zoomed)
  346:         my $dest = &HTML::Entities::encode($url.$anchor,'&<>"');
  347:         return <<ENDFRAME;
  348:         $startpage
  349:         $script
  350:         <div class="LC_iframecontainer">
  351:             <iframe src="$dest">$lt{'noif'} $noiframe</iframe>
  352:         </div>
  353:         $endpage
  354: ENDFRAME
  355:     }
  356: }
  357: 
  358: sub create_link {
  359:     my ($url,$anchor,$title,$linktext) = @_;
  360:     my $shownlink;
  361:     if ($title eq '') {
  362:         $title = $env{'form.title'};
  363:         if ($title eq '') {
  364:             unless ($env{'request.enc'}) {
  365:                 ($title) = ($url =~ m{/([^/]+)$});
  366:                 $title =~ s/(\?[^\?]+)$//;
  367:             }
  368:         }
  369:     }
  370:     unless ($title eq '') {
  371:         $shownlink = '<span style="font-weight:bold;">'.$title.'</span><br />';
  372:     }
  373:     my $dest = &HTML::Entities::encode($url.$anchor,'&<>"');
  374:     $shownlink .= '<a href="'.$dest.'">'.$linktext.'</a>';
  375:     return $shownlink;
  376: }
  377: 
  378: sub handler {
  379:     my $r=shift;
  380:     &Apache::loncommon::content_type($r,'text/html');
  381:     $r->send_http_header;
  382: 
  383:     return OK if $r->header_only;
  384: 
  385:     my $url = $r->uri;
  386:     my ($is_ext,$brcrum,$absolute,$is_pdf,$exttool,$cdom,$cnum,$hostname,
  387:         $linktext,$explanation,$width,$height,$reuse);
  388: 
  389:     for ($url){
  390:         s|^/adm/wrapper||;
  391:         $is_ext = $_ =~ s|^/ext/|http://|;
  392:         s|http://https://|https://| if ($is_ext);
  393:         s|&colon;|:|g;
  394:     }
  395: 
  396:     if ($url =~ /\.pdf$/i) {
  397:         $is_pdf = 1;
  398:     } elsif (($is_ext) && ($env{'request.course.id'})) {
  399:         if ($env{'course.'.$env{'request.course.id'}.'.extresource'}) {
  400:             (my $selected,$reuse,$width,$height) = split(/:/,$env{'course.'.$env{'request.course.id'}.'.extresource'});
  401:             if ($selected eq 'tab') {
  402:                 $is_ext = 'tab';
  403:                 $width = '';
  404:                 $height = '';
  405:             } elsif ($selected eq 'window') {
  406:                 $is_ext = 'window';
  407:                 unless ($width =~ /^\d+$/) {
  408:                     $width = '';
  409:                 }
  410:                 unless ($height =~ /^\d+$/) {
  411:                     $height = '';
  412:                 }
  413:             } else {
  414:                 $width = '';
  415:                 $height = '';
  416:                 $reuse = '';
  417:             }
  418:         }
  419:     } elsif ($url =~ m{^/adm/($match_domain)/($match_courseid)/(\d+)/ext\.tool$}) {
  420:         $cdom = $1;
  421:         $cnum = $2;
  422:         my $marker = $3;
  423:         $exttool = 'iframe';
  424:         my $exttoolremote;
  425:         my %toolhash = &Apache::lonnet::get('exttool_'.$marker,['target','linktext','explanation','id','width','height'],
  426:                                             $cdom,$cnum);
  427:         if ($toolhash{'id'}) {
  428:             my %ltitools = &Apache::lonnet::get_domain_lti($cdom,'consumer');
  429:             if (ref($ltitools{$toolhash{'id'}}) eq 'HASH') {
  430:                 $exttoolremote = $ltitools{$toolhash{'id'}}{'url'};
  431:             }
  432:         }
  433:         if ($toolhash{'target'} eq 'window') {
  434:             $exttool = 'window';
  435:             $width = $toolhash{'width'};
  436:             $height = $toolhash{'height'};
  437:         } elsif ($toolhash{'target'} eq 'tab') {
  438:             $exttool = 'tab';
  439:         }
  440:         if (($exttool eq 'window') || ($exttool eq 'tab')) {
  441:             $linktext = $toolhash{'linktext'};
  442:             $explanation = $toolhash{'explanation'};
  443:         } elsif (($exttoolremote =~ /^http:/) && ($ENV{'SERVER_PORT'} == 443)) {
  444:             $exttool = 'tab';
  445:         }
  446:     }
  447:     if (($is_ext) || ($exttool)) {
  448:         &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
  449:             ['forceedit','register','folderpath','symb','idx','title','anchor']);
  450:         if (($env{'form.forceedit'}) &&
  451:             (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) &&
  452:             (($env{'form.folderpath'} =~ /^supplemental/) ||
  453:              ($env{'form.symb'} =~ /^uploaded/))) {
  454:             if ($env{'form.symb'}) {
  455:                 (undef,undef,my $res) = &Apache::lonnet::decode_symb($env{'form.symb'});
  456:                 if ($res =~ /(#[^#]+)$/) {
  457:                     $url .= $1;
  458:                 }
  459:             } elsif ($env{'form.folderpath'} =~ /^supplemental/) {
  460:                 if ($env{'form.anchor'} ne '') {
  461:                     $url .= '#'.$env{'form.anchor'};
  462:                 }
  463:             }
  464:             my $type = 'ext';
  465:             if ($exttool) {
  466:                 $type = 'tool';
  467:             } elsif (($url =~ /^http:/) && ($ENV{'SERVER_PORT'} == 443)) {
  468:                 $hostname = $r->hostname();
  469:             }
  470:             $r->print(
  471:                 &Apache::lonextresedit::display_editor($url,$env{'form.folderpath'},
  472:                                                        $env{'form.symb'},
  473:                                                        $env{'form.idx'},$type,$cdom,
  474:                                                        $cnum,$hostname));
  475:             return OK;
  476:         } elsif ($env{'form.folderpath'} =~ /^supplemental/) {
  477:             my $crstype = &Apache::loncommon::course_type();
  478:             my $title = $env{'form.title'};
  479:             if ($title eq '') {
  480:                 if ($is_ext) {
  481:                     $title = &mt('External Resource');
  482:                 } else {
  483:                     $title = &mt('External Tool');
  484:                 }
  485:             }
  486:             $brcrum =
  487:                 &Apache::lonhtmlcommon::docs_breadcrumbs(undef,$crstype,undef,$title,1);
  488:         }
  489:     }
  490: 
  491: #
  492: # Actual URL
  493: #
  494:     if (($url=~/$LONCAPA::assess_re/) && (!$exttool)) {
  495: #
  496: # This is uploaded homework
  497: #
  498:         $env{'request.state'}='uploaded';
  499:         &Apache::lonhomework::renderpage($r,$url);
  500:     } else {
  501: #
  502: # This is not homework
  503: #
  504:         if (($is_ext) || ($exttool)) {
  505:             $absolute = $env{'request.use_absolute'};
  506:             $ENV{'QUERY_STRING'} =~ s/(^|\&)symb=[^\&]*/$1/;
  507:             $ENV{'QUERY_STRING'} =~ s/\&$//;
  508:         }
  509: 
  510:         unless ($ENV{'QUERY_STRING'} eq '') {
  511:             $url.=(($url=~/\?/)?'&':'?').$ENV{'QUERY_STRING'};
  512:         }
  513: 
  514:         # encrypt url if not external
  515:         unless ($is_ext) {
  516:             &Apache::lonenc::check_encrypt(\$url);
  517:         }
  518: 
  519:         $r->print( wrapper($r,$url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,
  520:                            $linktext,$explanation,undef,$width,$height,$reuse) );
  521: 
  522:     } # not just the menu
  523:     
  524:     return OK;
  525: } # handler
  526: 
  527: 1;
  528: __END__
  529: 
  530: =pod
  531: 
  532: =head1 NAME
  533: 
  534: Apache::lonwrapper - External and binary file management.
  535: 
  536: =head1 SYNOPSIS
  537: 
  538: Wrapper for external and binary files as standalone resources. Edit handler for rat maps; TeX content handler.
  539: 
  540: This is part of the LearningOnline Network with CAPA project
  541: described at http://www.lon-capa.org.
  542: 
  543: =head1 Subroutines
  544: 
  545: =over
  546: 
  547: =item wrapper($r,$url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,$linktext,$explanation,$title,$width,$height,$reuse)
  548: 
  549: =over
  550: 
  551: =item $r
  552: 
  553: request object
  554: 
  555: =item $url
  556: 
  557: url to display either by including in an iframe within a
  558: LON-CAPA page which has a standard LON-CAPA inline menu,
  559: or in some cases launched in a separate tab or window,
  560: launched via a link in a LON-CAPA page with standard inline
  561: menu.
  562: 
  563: =item $brcrum
  564: 
  565: breadcrumbs for unregistered urls
  566: (i.e., external resources in Supplemental Content).
  567: 
  568: =item $absolute
  569: 
  570: contains protocol (http or https) followed by
  571: the hostname, if menu items in the standard LON-CAPA
  572: interface created by the call to loncommon::start_page()
  573: within &wrapper() need to use absolute URLs rather than
  574: relative URLs.
  575: 
  576: That will be the case where an external resource has been 
  577: served from port 80, when the server customarily serves
  578: requests using Apache/SSL (i.e., port 443). mod_rewrite 
  579: is used to switch requests for external resources and
  580: the syllabus: /public/<domain>/<courseid>/syllabus
  581: (which might also point at an external resource)
  582: from https:// to http:// where the the URL of the remote site 
  583: specified in the resource itself is http://.
  584: 
  585: This is done to avoid default mixed content blocking
  586: in Firefox 23 and later, when serving from Apache/SSL.
  587: 
  588: =item $is_ext
  589: 
  590: true if URL is for an external resource. Default true value
  591: is 1 (display in iframe, unless $uselink is true).
  592: If external resource is to be displayed in a tab,
  593: value of $is_ext will be tab, if to be displayed in a pop-up window,
  594: value of $is_ext will be window.
  595: 
  596: =item $is_pdf
  597: 
  598: true if URL is for a PDF (based on file extension).
  599: 
  600: =item $exttool
  601: 
  602: If URL is for an External Tool, will contain the target type: iframe, window or tab.
  603: 
  604: =item $linktext
  605: 
  606: optional. If URL is for an External Tool, and target type is window or tab,
  607: then the link text may be an option set in the course for each tool instance,
  608: or may be a default defined in the domain for all instances of the tool.
  609: 
  610: =item $explanation
  611: 
  612: optional. If URL is for an External Tool, and target type is window or tab,
  613: then the explanation is an option set in the course for each tool instance,
  614: or may be a default defined in the domain for all instances of the tool.
  615: 
  616: =item $title
  617: 
  618: optional. If wrapped item is a PDF, and $clientmobile is true,
  619: a link to a PDF is shown. The "title" will be displayed
  620: above the link, but if not provided as an arg, $env{'form.title'}
  621: will be used, otherwise, the filename will be displayed (unless
  622: hidden URL set for the resource).
  623: 
  624: =item $width
  625: 
  626: optional. If URL is for an External Tool, and target type is window,
  627: then a default width may have been defined in the domain for all instances of
  628: the tool.  If so, that width will be used for the window opened (via a link)
  629: to launch the external tool. If the URL is for an External Resource, and
  630: $is_ext is window, then a default width (px) may have been defined in the current
  631: course for all external resource instances.
  632: 
  633: =item $height
  634: 
  635: optional. If URL is for an External Tool, and target type is window,
  636: then a default height may have been defined in the domain for all instances of
  637: the tool.  If so, that height will be used for the window opened (via a link)
  638: to launch the external tool.  If the URL is for an External Resource, and
  639: $is_ext is window, then a default height (px) may have been defined in the current
  640: course for all external resource instances.
  641: 
  642: =item $reuse
  643: 
  644: optional. If the URL is for an External Resource, and $is_ext is tab or window,
  645: then $reuse will be true if the same tab or window is to be reused for display
  646: of all external resource instances in a a course.
  647: 
  648: =back
  649: 
  650: Returns markup for the entire page.
  651: 
  652: =item handler()
  653: 
  654: Content handler for requests for: /adm/wrapper/...
  655: used for content to be displayed in an iframe, or launched in a separate tab
  656: or window via a link.  The target URL is extracted from the requested URL, by
  657: removing the /adm/wrapper prefix.
  658: 
  659: The target URL will typically be a PDF served from the current server, an
  660: external resource URL served from a different server, or an external tool
  661: (from an LTI Provider) launched from LON-CAPA (as LTI Consumer) and launched
  662: via a link.
  663: 
  664: If the request included forceedit in the query string, and the requester has
  665: rights to modify course content, then the editor will be displayed to allow
  666: changes to be made to the resource (e.g., change the URL of the external resource,
  667: or change the setting for the external tool instance).
  668: 
  669: If not in edit mode, then the wrapper() subroutine will be called to generate the
  670: standard LON-CAPA inline menu, and then either a link to launch a separate tab or
  671: window, or an iframe to display the content inline.
  672: 
  673: =back
  674: 
  675: =cut
  676: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>