Annotation of rat/lonwrapper.pm, revision 1.71
1.1 www 1: # The LearningOnline Network with CAPA
2: # Wrapper for external and binary files as standalone resources
3: #
1.71 ! raeburn 4: # $Id: lonwrapper.pm,v 1.70 2020/01/14 14:26:39 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://|;
296: s|http://https://|https://|;
1.70 raeburn 297: s|:|:|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>