[BACK]Return to lonwrapper.pm CVS log [TXT] [DIR] Up to [LON-CAPA] / rat

Diff for /rat/lonwrapper.pm between versions 1.68 and 1.84

version 1.68, 2017/12/30 00:16:36 version 1.84, 2023/11/18 21:45:11
Line 39  use Apache::lonhtmlcommon(); Line 39  use Apache::lonhtmlcommon();
 use Apache::lonextresedit();  use Apache::lonextresedit();
 use Apache::lonexttool();  use Apache::lonexttool();
 use Apache::lonhomework();  use Apache::lonhomework();
   use Apache::lonnavmaps();
 use LONCAPA qw(:DEFAULT :match);  use LONCAPA qw(:DEFAULT :match);
 use HTML::Entities();  use HTML::Entities();
   use Digest::MD5();
   
 # ================================================================ Main Handler  # ================================================================ Main Handler
 sub wrapper {  sub wrapper {
     my ($url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,$linktext,$explanation,      my ($r,$url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,$linktext,$explanation,
         $title,$width,$height) = @_;          $title,$width,$height,$reuse,$is_supp) = @_;
   
     my $forcereg;      my $forcereg;
     unless ($env{'form.folderpath'}) {      unless ($env{'form.folderpath'}) {
Line 56  sub wrapper { Line 58  sub wrapper {
                                           'show' => 'Show content in pop-up window',                                            'show' => 'Show content in pop-up window',
                                         );                                          );
   
     my $anchor;      (undef,undef,undef,undef,undef,undef,my $clientmobile) =
           &Apache::loncommon::decode_user_agent($r);
   
       my ($anchor,$uselink);
     if ($is_ext) {      if ($is_ext) {
         if ($env{'form.symb'}) {          if ($env{'form.symb'}) {
             (undef,undef,my $res) = &Apache::lonnet::decode_symb($env{'form.symb'});              (undef,undef,my $res) = &Apache::lonnet::decode_symb($env{'form.symb'});
Line 66  sub wrapper { Line 71  sub wrapper {
         } elsif ($env{'form.anchor'} ne '') {          } elsif ($env{'form.anchor'} ne '') {
             $anchor = '#'.$env{'form.anchor'};              $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);      my $noiframe = &Apache::loncommon::modal_link(&HTML::Entities::encode($url.$anchor,'&<>"\''),$lt{'show'},500,400);
     my $args = {'bgcolor' => '#FFFFFF'};      my $args = {'bgcolor' => '#FFFFFF'};
     if ($forcereg) {      if ($forcereg) {
         $args->{'force_register'} = $forcereg;          $args->{'force_register'} = $forcereg;
Line 81  sub wrapper { Line 95  sub wrapper {
     }      }
     if ($env{'form.only_body'}) {      if ($env{'form.only_body'}) {
         $args->{'only_body'} = $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);      my ($countdown,$donemsg,$headjs);
     if (($exttool) && (&Apache::lonnet::EXT('resource.0.gradable') =~ /^yes$/i)) {      if (($exttool) && (&Apache::lonnet::EXT('resource.0.gradable') =~ /^yes$/i)) {
         $Apache::lonhomework::browse = &Apache::lonnet::allowed('bre',$url);          $Apache::lonhomework::browse = &Apache::lonnet::allowed('bre',$url);
         if ($env{'form.markaccess'}) {          if ($env{'form.markaccess'}) {
Line 129  sub wrapper { Line 145  sub wrapper {
         }          }
     }      }
   
     my $startpage = &Apache::loncommon::start_page('Menu',undef,$args).$countdown.$donemsg;  #
   # 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 = '
   <script type="text/javascript">
   // <![CDATA[
   var LCnotready = 0;
   var LCresizedef = 0;
   // ]]>
   </script>'."\n";
       }
   
       my $startpage = &Apache::loncommon::start_page('Menu',$headjs,$args).$countdown.$donemsg;
     my $endpage = &Apache::loncommon::end_page();      my $endpage = &Apache::loncommon::end_page();
   
     if (($env{'browser.mobile'}) || ($exttool eq 'window') || ($exttool eq 'tab')) {      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')) {
         my $output = $startpage;          my $output = $startpage;
         if ($is_pdf) {          if ($is_pdf) {
             if ($title eq '') {              $linktext = &mt('Link to PDF (for mobile devices)');
                 $title = $env{'form.title'};              $output .= &create_link($url,$anchor,$title,$linktext);
                 if ($title eq '') {          } elsif (($exttool eq 'window') || ($exttool eq 'tab') ||
                     unless ($env{'request.enc'}) {                   ($is_ext eq 'tab') || ($is_ext eq 'window')) {
                         ($title) = ($url =~ m{/([^/]+)$});              my $preamble;
                         $title =~ s/(\?[^\?]+)$//;              if ($linktext eq '') {
                     }                  if ($exttool) {
                       $linktext = &mt('Launch External Tool');
                   } else {
                       $linktext = &mt('Link to External Resource');
                 }                  }
             }              }
             unless ($title eq '') {              if ($exttool) {
                 $output .= $title.'<br />';                  $url = &HTML::Entities::encode($url,'"<>&');
             }              } else {
             $output .= '<a href="'.$url.'">'.&mt('Link to PDF (for mobile devices)').'</a>';                  $url = &HTML::Entities::encode($url.$anchor,'&<>"');
         } elsif (($exttool eq 'window') || ($exttool eq 'tab')) {  
             if ($linktext eq '') {  
                 $linktext = &mt('Launch External Tool');  
             }              }
             $url = &HTML::Entities::encode($url,'"<>&');              if (($exttool eq 'tab') || ($is_ext eq 'tab')) {
             if ($exttool eq 'tab') {                  my $target;
                 $output .= '<div>'.                  if ($exttool) {
                            '<a href="'.$url.'" target="LCExternalToolTab" style="padding:0;clear:both;margin:0;border:0">'.                      $target = 'LCExternalToolTab';
                   } else {
                       if ($reuse) {
                           $target = 'LCExternalResTab';
                       } else {
                           $target = '_blank';
                       }
                       if ($title ne '') {
                           $preamble = '<span style="font-weight:bold;">'.$title.'</span><br />';
                       }
                   }
                   $output .= '<div>'.$preamble.
                              '<a href="'.$url.'" target="'.$target.'" style="padding:0;clear:both;margin:0;border:0">'.
                            $linktext.'</a>'.                             $linktext.'</a>'.
                            '</div>';                             '</div>';
             } else {              } else {
                   my ($target,$extlinkimg);
                   if ($exttool) {
                       $target = 'LCExternalToolPopUp';
                   } else {
                       $target = 'LCExternalResPopUp';
                       if ($title ne '') {
                           $preamble = '<span style="font-weight:bold;">'.$title.'</span><br />';
                       }
                       $extlinkimg = '<img src="'.&Apache::loncommon::lonhttpdurl($r->dir_config('lonIconsURL').'/externallink.gif').'" width="19" height="18" border="0" />';
                       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";                  $output .= <<"ENDLINK";
 <script type="text/javascript">  <script type="text/javascript">
 // <![CDATA[  // <![CDATA[
 var windowObjectReference = null;   var windowObjectReference = null;
 var PreviousUrl;   var PreviousUrl;
                              
 function openSinglePopup(strUrl) {  function openSinglePopup(strUrl) {
     if (windowObjectReference == null || windowObjectReference.closed) {      if (windowObjectReference == null || windowObjectReference.closed) {
         windowObjectReference = window.open(strUrl, "LCExternalToolPopUp",          windowObjectReference = window.open(strUrl, "$target",
                                             "height=$height,width=$width,scrollbars=yes,resizable=yes,status=yes,menubar=no,location=no'");                                              "height=$height,width=$width,scrollbars=yes,resizable=yes,status=yes,menubar=no,location=no'");
     } else if(PreviousUrl != strUrl) {      } else if(PreviousUrl != strUrl) {
         windowObjectReference = window.open(strUrl, "LCExternalToolPopUp",          windowObjectReference = window.open(strUrl, "$target",
                                             "height=$height,width=$width,scrollbars=yes,resizable=yes,status=yes,menubar=no,location=no'");                                              "height=$height,width=$width,scrollbars=yes,resizable=yes,status=yes,menubar=no,location=no'");
         windowObjectReference.focus();          windowObjectReference.focus();
     } else {      } else {
Line 180  function openSinglePopup(strUrl) { Line 269  function openSinglePopup(strUrl) {
 }  }
 // ]]>  // ]]>
 </script>  </script>
 <div>  <div>$preamble
 <a href="$url" target="LCExternalToolPopUp" onclick="openSinglePopup(this.href); return false;">  <a href="$url" target="$target" onclick="openSinglePopup(this.href); return false;">
 $linktext</a>  $linktext$extlinkimg</a>
 </div>  </div>
 ENDLINK  ENDLINK
             }              }
             if ($explanation ne '') {              if ($exttool) {
                 $output .= '<div>'.$explanation.'</div>';                  if ($explanation ne '') {
             }                      $output .= '<div>'.$explanation.'</div>';
             if (&Apache::lonnet::EXT('resource.0.gradable')) {                  }
                 $output .= &Apache::lonfeedback::list_discussion('tool','OPEN');                  if (&Apache::lonnet::EXT('resource.0.gradable')) {
                       $output .= &Apache::lonfeedback::list_discussion('tool','OPEN');
                   }
             }              }
         } else {          } else {
             my $dest = &HTML::Entities::encode($url.$anchor,'&<>"');              if ($uselink) {
             $output .= '<div style="overflow:scroll; -webkit-overflow-scrolling:touch;">'."\n".                  $linktext = &mt('Link to resource');
                        '<iframe src="'.$dest.'" height="100%" width="100%" frameborder="0">'."\n".                  $output .= &create_link($url,$anchor,$title,$linktext);
                        "$lt{'noif'} $noiframe\n".              } else {
                        "</iframe>\n".                  my $dest = &HTML::Entities::encode($url.$anchor,'&<>"');
                        "</div>\n";                  $output .= '<div style="overflow:scroll; -webkit-overflow-scrolling:touch;">'."\n".
                              '<iframe src="'.$dest.'" height="100%" width="100%" frameborder="0">'."\n".
                              "$lt{'noif'} $noiframe\n".
                              "</iframe>\n".
                              "</div>\n";
               }
         }          }
         $output .= $endpage;          $output .= $endpage;
         return $output;          return $output;
       } elsif ($uselink) {
           $linktext = &mt('Link to resource');
           return $startpage.&create_link($url,$anchor,$title,$linktext).$endpage;
     } else {      } else {
         my $offset = 5;          my $offset = 5;
         &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['inhibitmenu']);          &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['inhibitmenu']);
         if ($env{'form.inhibitmenu'} eq 'yes') {          if (($env{'form.inhibitmenu'} eq 'yes') || ($env{'form.only_body'})) {
             $offset = 0;              $offset = 0;
         }          }
         my $script = &Apache::lonhtmlcommon::scripttag(<<SCRIPT);          my $script = &Apache::lonhtmlcommon::scripttag(<<SCRIPT);
Line 230  ENDLINK Line 329  ENDLINK
                 var pos = height + hdrtop + offset;                  var pos = height + hdrtop + offset;
                 \$('.LC_iframecontainer').css('top', pos);                  \$('.LC_iframecontainer').css('top', pos);
             });              });
               LCresizedef = 1;
               if (LCnotready == 1) {
                   LCnotready = 0;
                   \$(window).trigger('resize');
               }
         });          });
         window.onload = function(){  \$(window).trigger('resize') };          window.onload = function(){
                if (LCresizedef) {
                    LCnotready = 0;
                    \$(window).trigger('resize');
                } else {
                    LCnotready = 1;
                }
           };
 SCRIPT  SCRIPT
         # javascript will position the iframe if window was resized (or zoomed)          # javascript will position the iframe if window was resized (or zoomed)
         my $dest = &HTML::Entities::encode($url.$anchor,'&<>"');          my $dest = &HTML::Entities::encode($url.$anchor,'&<>"');
Line 246  ENDFRAME Line 357  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 = '<span style="font-weight:bold;">'.$title.'</span><br />';
       }
       my $dest = &HTML::Entities::encode($url.$anchor,'&<>"');
       $shownlink .= '<a href="'.$dest.'">'.$linktext.'</a>';
       return $shownlink;
   }
   
 sub handler {  sub handler {
     my $r=shift;      my $r=shift;
     &Apache::loncommon::content_type($r,'text/html');      &Apache::loncommon::content_type($r,'text/html');
Line 255  sub handler { Line 386  sub handler {
   
     my $url = $r->uri;      my $url = $r->uri;
     my ($is_ext,$brcrum,$absolute,$is_pdf,$exttool,$cdom,$cnum,$hostname,      my ($is_ext,$brcrum,$absolute,$is_pdf,$exttool,$cdom,$cnum,$hostname,
         $linktext,$explanation,$width,$height);          $linktext,$explanation,$width,$height,$reuse,$is_supp);
   
     for ($url){      for ($url){
         s|^/adm/wrapper||;          s|^/adm/wrapper||;
         $is_ext = $_ =~ s|^/ext/|http://|;                   $is_ext = $_ =~ s|^/ext/|http://|;
         s|http://https://|https://|;          s|http://https://|https://| if ($is_ext);
         s|&colon;|:|g;                        s|&colon;|:|g;
     }      }
   
   
     if ($url =~ /\.pdf$/i) {      if ($url =~ /\.pdf$/i) {
         $is_pdf = 1;          $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$}) {      } elsif ($url =~ m{^/adm/($match_domain)/($match_courseid)/(\d+)/ext\.tool$}) {
         $cdom = $1;          $cdom = $1;
         $cnum = $2;          $cnum = $2;
Line 276  sub handler { Line 427  sub handler {
         my %toolhash = &Apache::lonnet::get('exttool_'.$marker,['target','linktext','explanation','id','width','height'],          my %toolhash = &Apache::lonnet::get('exttool_'.$marker,['target','linktext','explanation','id','width','height'],
                                             $cdom,$cnum);                                              $cdom,$cnum);
         if ($toolhash{'id'}) {          if ($toolhash{'id'}) {
             my %ltitools = &Apache::lonnet::get_domain_lti($cdom,'consumer');              my ($idx,%ltitools);
             if (ref($ltitools{$toolhash{'id'}}) eq 'HASH') {              if ($toolhash{'id'} =~ /^c(\d+)$/) {
                 $exttoolremote = $ltitools{$toolhash{'id'}}{'url'};                  $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'};
             }              }
         }          }
         if ($toolhash{'target'} eq 'window') {          if ($toolhash{'target'} eq 'window') {
Line 286  sub handler { Line 444  sub handler {
             $width = $toolhash{'width'};              $width = $toolhash{'width'};
             $height = $toolhash{'height'};              $height = $toolhash{'height'};
         } elsif ($toolhash{'target'} eq 'tab') {          } elsif ($toolhash{'target'} eq 'tab') {
             $exttool = 'tab';               $exttool = 'tab';
         }          }
         if (($exttool eq 'window') || ($exttool eq 'tab')) {          if (($exttool eq 'window') || ($exttool eq 'tab')) {
             $linktext = $toolhash{'linktext'};               $linktext = $toolhash{'linktext'};
             $explanation = $toolhash{'explanation'};              $explanation = $toolhash{'explanation'};
         } elsif (($exttoolremote =~ /^http:/) && ($ENV{'SERVER_PORT'} == 443)) {          } elsif (($exttoolremote =~ /^http:/) && ($ENV{'SERVER_PORT'} == 443)) {
             $exttool = 'tab';              $exttool = 'tab';
Line 297  sub handler { Line 455  sub handler {
     }      }
     if (($is_ext) || ($exttool)) {      if (($is_ext) || ($exttool)) {
         &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},          &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
             ['forceedit','register','folderpath','symb','idx','title','anchor']);              ['forceedit','register','folderpath','symb','idx','title','anchor','only_body']);
         if (($env{'form.forceedit'}) &&          if (($env{'form.forceedit'}) &&
             (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) &&              (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) &&
             (($env{'form.folderpath'} =~ /^supplemental/) ||              (($env{'form.folderpath'} =~ /^supplemental/) ||
Line 311  sub handler { Line 469  sub handler {
                 if ($env{'form.anchor'} ne '') {                  if ($env{'form.anchor'} ne '') {
                     $url .= '#'.$env{'form.anchor'};                      $url .= '#'.$env{'form.anchor'};
                 }                  }
                   $is_supp = 1;
             }              }
             my $type = 'ext';              my $type = 'ext';
             if ($exttool) {              if ($exttool) {
Line 334  sub handler { Line 493  sub handler {
                     $title = &mt('External Tool');                      $title = &mt('External Tool');
                 }                  }
             }              }
             $brcrum =              $title = &HTML::Entities::encode($title,'\'"<>&');
                 &Apache::lonhtmlcommon::docs_breadcrumbs(undef,$crstype,undef,$title,1);              $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);
               }
         }          }
     }      }
   
Line 367  sub handler { Line 555  sub handler {
             &Apache::lonenc::check_encrypt(\$url);              &Apache::lonenc::check_encrypt(\$url);
         }          }
   
         $r->print( wrapper($url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,          $r->print( wrapper($r,$url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,
                            $linktext,$explanation,undef,$width,$height) );                             $linktext,$explanation,undef,$width,$height,$reuse,
                              $is_supp) );
   
     } # not just the menu      } # not just the menu
           
Line 395  described at http://www.lon-capa.org. Line 584  described at http://www.lon-capa.org.
   
 =over  =over
   
 =item wrapper($url,$brcrum,$absolute,$is_ext,$is_pdf,$linktext,$explanation,$title,$width,$height)  =item wrapper($r,$url,$brcrum,$absolute,$is_ext,$is_pdf,$exttool,$linktext,$explanation,$title,$width,$height,$reuse,$is_supp)
   
 =over  =over
   
   =item $r
   
   request object
   
 =item $url  =item $url
   
 url to display by including in an iframe within a  url to display either by including in an iframe within a
 LON-CAPA page which has a standard LON-CAPA inline menu.  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.
   
 =item $brcrum  =item $brcrum
   
Line 431  in Firefox 23 and later, when serving fr Line 627  in Firefox 23 and later, when serving fr
   
 =item $is_ext  =item $is_ext
   
 true if URL is for an external resource.  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.
   
 =item $is_pdf  =item $is_pdf
   
 true if URL is for a PDF (based on file extension).  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  =item $title
   
 optional. If wrapped item is a PDF, and $env{'browser.mobile'}   optional. If wrapped item is a PDF, and $clientmobile is true,
 is true, a link to a PDF is shown. The "title" will be displayed  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'}  above the link, but if not provided as an arg, $env{'form.title'}
 will be used, otherwise, the filename will be displayed (unless  will be used, otherwise, the filename will be displayed (unless
 hidden URL set for the resource).  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  =back
   
 Returns markup for the entire page.  Returns markup for the entire page.
   
 =item handler()  =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  =back
   
 =cut  =cut
Removed from v.1.68  
changed lines
  Added in v.1.84

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