File:
[LON-CAPA] /
loncom /
interface /
lonconfigsettings.pm
Revision
1.44:
download - view:
text,
annotated -
select for diffs
Tue Aug 14 21:42:40 2018 UTC (5 years, 11 months ago) by
raeburn
Branches:
MAIN
CVS tags:
HEAD
- Bug 6754 LON-CAPA as LTI Provider
- Support requests to /adm/service/passback and /adm/service/roster in
which OAuth data in request header.
- Support LTI Basic Outcomes Service (1.1) in which grade (a decimal) is
included in XML in the request body (with oauth_body_hash in the header).
- LTI Provider domain configuration to set grade passback using either
Outcomes Service (1.1) -- the default -- or Outcomes extension (1.0).
1: # The LearningOnline Network with CAPA
2: # Handler to set domain-wide configuration settings
3: #
4: # $Id: lonconfigsettings.pm,v 1.44 2018/08/14 21:42:40 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: # /home/httpd/html/adm/gpl.txt
24: #
25: # http://www.lon-capa.org/
26: #
27: #
28: ###############################################################
29: ##############################################################
30:
31: package Apache::lonconfigsettings;
32:
33: use strict;
34: use Apache::lonnet;
35: use Apache::loncommon();
36: use Apache::lonhtmlcommon();
37: use Apache::lonlocal;
38: use Apache::lonparmset();
39: use Apache::courseclassifier();
40: use LONCAPA qw(:DEFAULT :match);
41:
42: sub print_header {
43: my ($r,$phase,$context,$jscript,$container,$instcode,$dom,$values) = @_;
44: my ($pagetitle,$brcrumtitle,$action,$call_category_check,$instcode_check,
45: $crstype,@actions,@code_order);
46: if ($phase eq 'display') {
47: @actions = &Apache::loncommon::get_env_multiple('form.actions');
48: }
49: if ($context eq 'domain') {
50: ($pagetitle, $brcrumtitle) = ('View/Modify Domain Settings','View/Modify Domain Settings');
51: $action = '/adm/domainprefs';
52: if ($phase eq 'display') {
53: if (grep(/^coursecategories$/,@actions)) {
54: $call_category_check = qq|
55: if (formname == document.display) {
56: if (!categoryCheck(formname)) {
57: return;
58: }
59: }
60: |;
61: }
62: }
63: } else {
64: $crstype = &Apache::loncommon::course_type();
65: if ($crstype eq 'Community') {
66: ($pagetitle,$brcrumtitle) = ('Community Configuration','Community Configuration');
67: } else {
68: ($pagetitle,$brcrumtitle) = ('Course Configuration','Course Configuration');
69: }
70: $action = '/adm/courseprefs';
71: if ($phase eq 'display') {
72: if (grep(/^courseinfo$/,@actions)) {
73: my %codedefaults;
74: &Apache::lonnet::auto_instcode_defaults($env{'request.role.domain'},\%codedefaults,
75: \@code_order);
76: if (@code_order) {
77: my $noinstcodestr = &mt('You indicated cloning based on category, but did not select any categories.');
78: &js_escape(\$noinstcodestr);
79: $instcode_check = <<"ENDSCRIPT";
80: if (formname == document.display) {
81: if (formname.cloners_instcode.length) {
82: for (var j=0; j<formname.cloners_instcode.length; j++) {
83: if (formname.cloners_instcode[j].checked) {
84: if (formname.cloners_instcode[j].value == 1) {
85: var codes;
86: if (document.getElementsByClassName) {
87: codes = document.getElementsByClassName('LC_cloners_instcodes');
88: } else {
89: codes = getElementsByClassName(document.body,'LC_cloners_instcodes');
90: }
91: if (codes.length) {
92: var gotcode = 0;
93: for (var i=0; i<codes.length; i++) {
94: if (codes[i].selectedIndex != 0) {
95: gotcode = 1;
96: break;
97: }
98: }
99: if (!gotcode) {
100: for (var k=0; k<formname.cloners_instcode.length; k++) {
101: if (formname.cloners_instcode[k].value == 0) {
102: formname.cloners_instcode[k].checked = true;
103: }
104: }
105: toggleCloners(document.display.cloners_instcode);
106: alert('$noinstcodestr');
107: return false;
108: }
109: }
110: }
111: }
112: }
113: }
114: }
115:
116: ENDSCRIPT
117: }
118: }
119: }
120: }
121: my $alert = &mt('You must select at least one functionality type to display.');
122: &js_escape(\$alert);
123: my $js = '
124: <script type="text/javascript">
125: // <![CDATA[
126:
127: function changePage(formname,newphase) {
128: formname.phase.value = newphase;
129: numchecked = 0;
130: if (formname == document.pickactions) {
131: if (formname.actions.length > 0) {
132: for (var i = 0; i<formname.actions.length; i++) {
133: if (formname.actions[i].checked) {
134: numchecked ++;
135: }
136: }
137: } else {
138: if (formname.actions.checked) {
139: numchecked ++;
140: }
141: }
142: if (numchecked > 0) {
143: formname.submit();
144: } else {
145: alert("'.$alert.'");
146: return;
147: }
148: }
149: '.$instcode_check.$call_category_check.'
150: formname.submit();
151: }'."\n";
152: if ($phase eq 'pickactions') {
153: $js .= &Apache::lonhtmlcommon::color_picker();
154: $js .=
155: &Apache::lonhtmlcommon::set_form_elements({actions => 'checkbox'})."\n";
156: } elsif ($phase eq 'display') {
157: $js .= &Apache::lonhtmlcommon::color_picker();
158: $js .= &color_pick_js()."\n";
159: }
160: $js .= &Apache::loncommon::viewport_size_js().'
161:
162: // ]]>
163: </script>
164: ';
165: if ($jscript) {
166: $js .= "
167:
168: $jscript
169:
170: ";
171: }
172: my $additem;
173: if ($phase eq 'pickactions') {
174: my %loaditems = (
175: 'onload' => "setFormElements(document.pickactions);",
176: );
177: $additem = {'add_entries' => \%loaditems,};
178: } elsif ($phase eq 'display') {
179: if ($context eq 'domain') {
180: my $onload;
181: if (grep(/^coursedefaults$/,@actions)) {
182: $onload = "toggleDisplay(document.display,'cloneinstcode');".
183: "toggleDisplay(document.display,'credits');".
184: "toggleDisplay(document.display,'studentsubmission');";
185: }
186: if (grep(/^selfcreation$/,@actions)) {
187: my $prefix = 'cancreate_emailverified';
188: my $customclass = 'LC_selfcreate_email';
189: my $classprefix = 'LC_canmodify_emailusername_';
190: my $optionsprefix = 'LC_options_emailusername_';
191: $onload .= "toggleRows(document.display,'cancreate_email','selfassign','$customclass','$classprefix','$optionsprefix');";
192: my ($othertitle,$usertypes,$types) = &Apache::loncommon::sorted_inst_types($dom);
193: my $hascustom;
194: my ($emailrules,$emailruleorder) = &Apache::lonnet::inst_userrules($dom,'email');
195: if (ref($emailrules) eq 'HASH') {
196: if (keys(%{$emailrules}) > 0) {
197: $hascustom = 'cancreate_emailrule';
198: }
199: }
200: my @posstypes;
201: if (ref($types) eq 'ARRAY') {
202: @posstypes = @{$types};
203: push(@posstypes,'default');
204: foreach my $type (@posstypes) {
205: $onload .= "toggleEmailOptions(document.display,'cancreate_emailoptions','$hascustom',".
206: "'cancreate_emaildomain','$type');";
207: }
208: } else {
209: $onload .= "toggleEmailOptions(document.display,'cancreate_emailoptions','$hascustom',".
210: "'cancreate_emaildomain','default');";
211: }
212: }
213: if (grep(/^contacts$/,@actions)) {
214: my $customclass = 'LC_helpdesk_override';
215: my $optionsprefix = 'LC_options_helpdesk_';
216: $onload .= "toggleHelpdeskRow(document.display,'overrides','$customclass','$optionsprefix');";
217: }
218: if (grep(/^lti$/,@actions)) {
219: $onload .= "toggleLTI(document.display,'user','add');".
220: "toggleLTI(document.display,'crs','add');".
221: "toggleLTI(document.display,'sec','add');".
222: "toggleLTI(document.display,'lcauth','add');".
223: "toggleLTI(document.display,'lcmenu','add');".
224: "toggleLTI(document.display,'passback','add');";
225: if (ref($values) eq 'HASH') {
226: if (ref($values->{'lti'}) eq 'HASH') {
227: my $numlti = scalar(keys(%{$values->{'lti'}}));
228: for (my $i=0; $i<$numlti; $i++) {
229: $onload .= "toggleLTI(document.display,'user','$i');".
230: "toggleLTI(document.display,'crs','$i');".
231: "toggleLTI(document.display,'sec','$i');".
232: "toggleLTI(document.display,'lcauth','$i');".
233: "toggleLTI(document.display,'lcmenu','$i');".
234: "toggleLTI(document.display,'passback','$i');";
235: }
236: }
237: }
238: }
239: if (grep(/^ltitools$/,@actions)) {
240: $onload .= "toggleLTITools(document.display,'passback','add');".
241: "toggleLTITools(document.display,'roster','add');".
242: "toggleLTITools(document.display,'user','add');";
243: if (ref($values) eq 'HASH') {
244: if (ref($values->{'ltitools'}) eq 'HASH') {
245: my $numltitools = scalar(keys(%{$values->{'ltitools'}}));
246: for (my $i=0; $i<$numltitools; $i++) {
247: $onload .= "toggleLTITools(document.display,'passback','$i');".
248: "toggleLTITools(document.display,'roster','$i');".
249: "toggleLTITools(document.display,'user','$i');";
250: }
251: }
252: }
253: }
254: if ($onload) {
255: my %loaditems = (
256: 'onload' => $onload,
257: );
258: $additem = {'add_entries' => \%loaditems,};
259: }
260: } elsif ($context eq 'course') {
261: if (grep(/^courseinfo$/,@actions)) {
262: if (@code_order) {
263: $additem = {
264: add_entries => {'onload' => "courseSet('','load');toggleCloners(document.display.cloners_instcode);"},
265: };
266: }
267: }
268: }
269: }
270: $r->print(&Apache::loncommon::start_page($pagetitle,$js,$additem));
271: $r->print(&Apache::lonhtmlcommon::breadcrumbs($brcrumtitle));
272: $r->print('
273: <form name="parmform" action="">
274: <input type="hidden" name="pres_marker" />
275: <input type="hidden" name="pres_type" />
276: <input type="hidden" name="pres_value" />
277: </form>
278: ');
279: if ($container) {
280: &Apache::lonparmset::startSettingsScreen($r,$container,$crstype);
281: }
282: $r->print('<form method="post" name="'.$phase.'" action="'.$action.'"'.
283: ' enctype="multipart/form-data">');
284: return;
285: }
286:
287: sub print_footer {
288: my ($r,$phase,$newphase,$button_text,$actions,$container,$parm_permission) = @_;
289: $button_text = &mt($button_text);
290: $r->print('<input type="hidden" name="phase" value="" />');
291: if (defined($env{'form.origin'})) {
292: $r->print('<input type="hidden" name="origin" value="'.$env{'form.origin'}.'" />'."\n");
293: }
294: if (($phase eq 'display') || ($phase eq 'process')) {
295: if (ref($actions) eq 'ARRAY') {
296: foreach my $item (@{$actions}) {
297: $r->print('<input type="hidden" name="actions" value="'.$item.'" />'."\n");
298: }
299: }
300: }
301: my $dest='"javascript:changePage(document.'.$phase.','."'$newphase'".')"';
302: if ($phase eq 'process') {
303: $r->print(
304: &Apache::lonhtmlcommon::actionbox(
305: ['<a href='.$dest.'>'.$button_text.'</a>']));
306: } else {
307: my $onclick;
308: if ($phase eq 'display') {
309: $onclick = '"javascript:changePage(document.'.$phase.','."'$newphase'".')"';
310: } else {
311: $onclick = '"javascript:changePage(document.'.$phase.','."'$newphase'".')"';
312: }
313: my $showbutton = 1;
314: if (ref($parm_permission) eq 'HASH') {
315: unless (($parm_permission->{'process'}) || ($newphase eq 'display')) {
316: $showbutton = 0;
317: }
318: }
319: if ($showbutton) {
320: $r->print('<p><input type="button" name="store" value="'.
321: $button_text.'" onclick='.$onclick.' /></p>');
322: }
323: }
324: if ($phase eq 'process') {
325: $r->print('</form>');
326: if ($container) {
327: &Apache::lonparmset::endSettingsScreen($r);
328: }
329: $r->print(&Apache::loncommon::end_page());
330: }
331: return;
332: }
333:
334: sub make_changes {
335: my ($r,$dom,$phase,$context,$prefs_order,$prefs,$values,$confname,$roles,
336: $allitems,$container,$parm_permission) = @_;
337: my %brcrumtext = &get_crumb_text();
338: my @actions = &Apache::loncommon::get_env_multiple('form.actions');
339: my ($numchanged,%changes,%disallowed);
340: &Apache::lonhtmlcommon::add_breadcrumb
341: ({href=>"javascript:changePage(document.$phase,'display')",
342: text=>$brcrumtext{$context}},
343: {href=>"javascript:changePage(document.$phase,'$phase')",
344: text=>"Updated"});
345: &print_header($r,$phase,$context,undef,$container);
346: my ($crstype,%lastact);
347: if ($context eq 'course') {
348: $crstype = &Apache::loncommon::course_type();
349: }
350: if ((ref($prefs_order) eq 'ARRAY') && (ref($prefs) eq 'HASH') &&
351: (ref($prefs) eq 'HASH')) {
352: foreach my $item (@{$prefs_order}) {
353: if (grep(/^\Q$item\E$/,@actions)) {
354: if ($context eq 'domain') {
355: $r->print('<h3>'.&mt($prefs->{$item}{'text'}).'</h3>'.
356: &Apache::domainprefs::process_changes($r,$dom,
357: $confname,$item,$roles,$values,\%lastact));
358: } else {
359: $changes{$item} = {};
360: &Apache::courseprefs::process_changes($dom,$item,$values,
361: $prefs->{$item},$changes{$item},
362: $allitems,\%disallowed,$crstype);
363: if (keys(%{$changes{$item}}) > 0) {
364: $numchanged ++;
365: }
366: }
367: }
368: }
369: }
370: if ($context eq 'course') {
371: if ($numchanged) {
372: my $message = &Apache::courseprefs::store_changes($dom,$confname,$prefs_order,\@actions,
373: $prefs,$values,\%changes,$crstype);
374: $r->print(&Apache::loncommon::confirmwrapper($message));
375: } else {
376: if ($crstype eq 'Community') {
377: $r->print(&Apache::loncommon::confirmwrapper(&mt("No changes made to community configuration.")));
378: } else {
379: $r->print(&Apache::loncommon::confirmwrapper(&mt("No changes made to course configuration.")));
380: }
381: }
382: if (keys(%disallowed) > 0) {
383: $r->print('<p>');
384: foreach my $item ('cloners','rolenames','feedback','discussion','localization') {
385: if (ref($disallowed{$item}) eq 'HASH') {
386: if (keys(%{$disallowed{$item}}) > 0) {
387: $r->print(&Apache::courseprefs::display_disallowed($item,$disallowed{$item},
388: $prefs,$crstype));
389: }
390: }
391: }
392: $r->print('</p>');
393: }
394: }
395: $r->print('<p>');
396: my $footer_text = 'Back to configuration display';
397: if ($context eq 'course') {
398: $footer_text = 'Back to display/edit settings';
399: }
400: &print_footer($r,$phase,'display',$footer_text,\@actions,$container,$parm_permission);
401: $r->print('</p>');
402: return \%lastact;
403: }
404:
405: sub display_settings {
406: my ($r,$dom,$phase,$context,$prefs_order,$prefs,$values,$confname,$jscript,
407: $allitems,$crstype,$container,$parm_permission) = @_;
408: my %brcrumtext = &get_crumb_text();
409: my @actions = &Apache::loncommon::get_env_multiple('form.actions');
410: &Apache::lonhtmlcommon::add_breadcrumb
411: ({href=>"javascript:changePage(document.$phase,'display')",
412: text=>"Display/Edit Settings"});
413: my $instcode;
414: if (ref($values) eq 'HASH') {
415: $instcode = $values->{'internal.coursecode'};
416: }
417: &print_header($r,$phase,$context,$jscript,$container,$instcode,$dom,$values);
418: my $divwidth = 900;
419: if ((ref($prefs_order) eq 'ARRAY') && (ref($prefs) eq 'HASH') && (ref($values) eq 'HASH')) {
420: if (@actions > 0) {
421: my $rowsum = 0;
422: my (%output,%rowtotal,@items,$got_check_uncheck);
423: foreach my $item (@{$prefs_order}) {
424: if (grep(/^\Q$item\E$/,@actions)) {
425: push(@items,$item);
426: if ($context eq 'domain') {
427: my $settings;
428: if (ref($values) eq 'HASH') {
429: $settings = $values->{$item};
430: }
431: if (($item eq 'usersessions') || ($item eq 'ssl')) {
432: unless ($got_check_uncheck) {
433: $r->print('<script type="text/javascript">'."\n".
434: '// <![CDATA['."\n".
435: &Apache::loncommon::check_uncheck_jscript()."\n".
436: '// ]]>'."\n".
437: '</script>'."\n");
438: $got_check_uncheck = 1;
439: }
440: } elsif ($item eq 'selfcreation') {
441: if (ref($values) eq 'HASH') {
442: $settings = $values->{'usercreation'};
443: }
444: } elsif ($item eq 'defaults') {
445: if (ref($values->{'inststatus'}) eq 'HASH') {
446: if (ref($values->{'defaults'}) eq 'HASH') {
447: $settings = {%{$values->{'inststatus'}},%{$values->{'defaults'}}};
448: } else {
449: $settings = $values->{'inststatus'};
450: }
451: } else {
452: my ($othertitle,$usertypes,$types) = &Apache::loncommon::sorted_inst_types($dom);
453: my $inststatus = {
454: inststatustypes => $usertypes,
455: inststatusorder => $types,
456: inststatusguest => [],
457: };
458: if (ref($values->{defaults}) eq 'HASH') {
459: $settings = {%{$inststatus},%{$values->{'defaults'}}};
460: } else {
461: $settings = $inststatus;
462: }
463: }
464: }
465: ($output{$item},$rowtotal{$item}) =
466: &Apache::domainprefs::print_config_box($r,$dom,$confname,
467: $phase,$item,$prefs->{$item},$settings);
468: } else {
469: ($output{$item},$rowtotal{$item}) =
470: &Apache::courseprefs::print_config_box($r,$dom,$phase,
471: $item,$prefs->{$item},$values,$allitems,$crstype,$parm_permission);
472: }
473: $rowsum += $rowtotal{$item};
474: }
475: }
476: $r->print('<div id="prefs" style="max-width:'.$divwidth.'px;margin: 10px auto 10px auto;">');
477: for (my $i=0; $i<@items; $i++) {
478: $r->print($output{$items[$i]});
479: }
480: $r->print('</div>');
481: $r->print(&print_footer($r,$phase,'process','Save Changes',\@actions,$container,$parm_permission));
482: } else {
483: $r->print('<input type="hidden" name="phase" value="" />'.
484: '<span class="LC_error">'.&mt('No settings chosen').
485: '</span>');
486: }
487: $r->print('</form>');
488: }
489: if ($container) {
490: &Apache::lonparmset::endSettingsScreen($r);
491: }
492: $r->print(&Apache::loncommon::end_page());
493: return;
494: }
495:
496: sub display_choices {
497: my ($r,$phase,$context,$prefs_order,$prefs,$container,$parm_permission) = @_;
498: if ($phase eq '') {
499: $phase = 'pickactions';
500: }
501: my %helphash;
502: &print_header($r,$phase,$context,undef,$container);
503: $r->print('<script type="text/javascript">'."\n".
504: '// <![CDATA['."\n".
505: &Apache::loncommon::check_uncheck_jscript()."\n".
506: '// ]]>'."\n".
507: '</script>'."\n");
508: my $heading = &mt('Settings to display/modify');
509: if (ref($parm_permission) eq 'HASH') {
510: unless ($parm_permission->{'process'}) {
511: $heading = &mt('Settings to display');
512: }
513: }
514: $r->print('<h3>'.$heading.'</h3>'.
515: '<div><input type="button" value="'.&mt('check all').'" '.
516: 'onclick="javascript:checkAll(document.pickactions.actions)"'.
517: ' />'.(' 'x2).
518: '<input type="button" value="'.&mt('uncheck all').'" '.
519: 'onclick="javascript:uncheckAll(document.pickactions.actions)" />'.
520: "\n".
521: '</div><div class="LC_left_float">');
522: my ($numitems,$maxincol,$firstthird,$secondthird,$seconddiv,$thirddiv,$count);
523: if (ref($prefs_order) eq 'ARRAY') {
524: $numitems = @{$prefs_order};
525: }
526: my $numcols = 3;
527: $maxincol = int($numitems/$numcols);
528: if ($numitems%$numcols) {
529: $maxincol ++;
530: }
531: $firstthird = $maxincol;
532: $secondthird = $firstthird + $maxincol;
533: $count = 0;
534: if ((ref($prefs_order) eq 'ARRAY') && (ref($prefs) eq 'HASH')) {
535: foreach my $item (@{$prefs_order}) {
536: $r->print('<h4>'.
537: &Apache::loncommon::help_open_topic($prefs->{$item}->{'help'}).
538: '<label><input type="checkbox" name="actions" value="'.$item.
539: '" /> '.&mt($prefs->{$item}->{'text'}).'</label></h4>');
540: $count ++;
541: if ((!$seconddiv) && ($count >= $firstthird)) {
542: $r->print('</div>'."\n".'<div class="LC_left_float">'."\n");
543: $seconddiv = 1;
544: }
545: if ((!$thirddiv) && ($count >= $secondthird)) {
546: $r->print('</div>'."\n".'<div class="LC_left_float">'."\n");
547: $thirddiv = 1;
548: }
549: }
550: $r->print('</div><br clear="all" />');
551: }
552: $r->print(&print_footer($r,$phase,'display','Display',undef,$container,$parm_permission));
553: $r->print('</form>');
554: if ($container) {
555: &Apache::lonparmset::endSettingsScreen($r);
556: }
557: $r->print(&Apache::loncommon::end_page());
558: return;
559: }
560:
561: sub color_pick_js {
562: my $pjump_def = &Apache::lonhtmlcommon::pjump_javascript_definition();
563: my $output = <<"ENDCOL";
564:
565: $pjump_def
566:
567: function psub() {
568: modalWindow.close();
569: if (document.parmform.pres_marker.value!='') {
570: if (document.parmform.pres_type.value!='') {
571: eval('document.display.'+
572: document.parmform.pres_marker.value+
573: '.value=document.parmform.pres_value.value;');
574: }
575: } else {
576: document.parmform.pres_value.value='';
577: document.parmform.pres_marker.value='';
578: }
579: }
580:
581: function get_id (span_id) {
582: if (document.getElementById) {
583: return document.getElementById(span_id);
584: }
585: if (document.all) {
586: return document.all[span_id];
587: }
588: return false;
589: }
590:
591: function colchg_span (span_id_str,new_color_item) {
592: var span_ref = get_id(span_id_str);
593: if (span_ref.style) { span_ref = span_ref.style; }
594: span_ref.background = new_color_item.value;
595: span_ref.backgroundColor = new_color_item.value;
596: span_ref.bgColor = new_color_item.value;
597: }
598:
599: ENDCOL
600: return $output;
601: }
602:
603: sub get_crumb_text {
604: my %brcrumbtext = (
605: domain => 'Domain Settings',
606: course => 'Display/Edit Settings',
607: );
608: return %brcrumbtext;
609: }
610:
611: 1;
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>