Annotation of rat/lonwrapper.pm, revision 1.72

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

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