1: # The LearningOnline Network with CAPA
2: # User Roles Screen
3: #
4: # $Id: lonroles.pm,v 1.269.2.26 2016/08/13 21:17:38 raeburn Exp $
5: #
6: # Copyright Michigan State University Board of Trustees
7: #
8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
9: #
10: # LON-CAPA is free software; you can redistribute it and/or modify
11: # it under the terms of the GNU General Public License as published by
12: # the Free Software Foundation; either version 2 of the License, or
13: # (at your option) any later version.
14: #
15: # LON-CAPA is distributed in the hope that it will be useful,
16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18: # GNU General Public License for more details.
19: #
20: # You should have received a copy of the GNU General Public License
21: # along with LON-CAPA; if not, write to the Free Software
22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23: #
24: # /home/httpd/html/adm/gpl.txt
25: #
26: # http://www.lon-capa.org/
27: #
28: ###
29:
30: =pod
31:
32: =head1 NAME
33:
34: Apache::lonroles - User Roles Screen
35:
36: =head1 SYNOPSIS
37:
38: Invoked by /etc/httpd/conf/srm.conf:
39:
40: <Location /adm/roles>
41: PerlAccessHandler Apache::lonacc
42: SetHandler perl-script
43: PerlHandler Apache::lonroles
44: ErrorDocument 403 /adm/login
45: ErrorDocument 500 /adm/errorhandler
46: </Location>
47:
48: =head1 OVERVIEW
49:
50: =head2 Choosing Roles
51:
52: C<lonroles> is a handler that allows a user to switch roles in
53: mid-session. LON-CAPA attempts to work with "No Role Specified", the
54: default role that a user has before selecting a role, as widely as
55: possible, but certain handlers for example need specification which
56: course they should act on, etc. Both in this scenario, and when the
57: handler determines via C<lonnet>'s C<&allowed> function that a certain
58: action is not allowed, C<lonroles> is used as error handler. This
59: allows the user to select another role which may have permission to do
60: what they were trying to do.
61:
62: =begin latex
63:
64: \begin{figure}
65: \begin{center}
66: \includegraphics[width=0.45\paperwidth,keepaspectratio]{Sample_Roles_Screen}
67: \caption{\label{Sample_Roles_Screen}Sample Roles Screen}
68: \end{center}
69: \end{figure}
70:
71: =end latex
72:
73: =head2 Role Initialization
74:
75: The privileges for a user are established at login time and stored in the session environment. As a consequence, a new role does not become active till the next login. Handlers are able to query for privileges using C<lonnet>'s C<&allowed> function. When a user first logs in, their role is the "common" role, which means that they have the sum of all of their privileges. During a session it might become necessary to choose a particular role, which as a consequence also limits the user to only the privileges in that particular role.
76:
77: =head1 INTRODUCTION
78:
79: This module enables a user to select what role he wishes to
80: operate under (instructor, student, teaching assistant, course
81: coordinator, etc). These roles are pre-established by the actions
82: of upper-level users.
83:
84: This is part of the LearningOnline Network with CAPA project
85: described at http://www.lon-capa.org.
86:
87: =head1 HANDLER SUBROUTINE
88:
89: This routine is called by Apache and mod_perl.
90:
91: =over 4
92:
93: =item *
94:
95: Roles Initialization (yes/no)
96:
97: =item *
98:
99: Get Error Message from Environment
100:
101: =item *
102:
103: Who is this?
104:
105: =item *
106:
107: Generate Page Output
108:
109: =item *
110:
111: Choice or no choice
112:
113: =item *
114:
115: Table
116:
117: =item *
118:
119: Privileges
120:
121: =back
122:
123: =cut
124:
125:
126: package Apache::lonroles;
127:
128: use strict;
129: use Apache::lonnet;
130: use Apache::lonuserstate();
131: use Apache::Constants qw(:common REDIRECT);
132: use Apache::File();
133: use Apache::lonmenu;
134: use Apache::loncommon;
135: use Apache::lonhtmlcommon;
136: use Apache::lonannounce;
137: use Apache::lonlocal;
138: use Apache::lonpageflip();
139: use Apache::lonnavdisplay();
140: use Apache::loncoursequeueadmin;
141: use Apache::longroup;
142: use Apache::lonrss;
143: use GDBM_File;
144: use LONCAPA qw(:DEFAULT :match);
145: use HTML::Entities;
146:
147:
148: sub redirect_user {
149: my ($r,$title,$url,$msg) = @_;
150: $msg = $title if (! defined($msg));
151: &Apache::loncommon::content_type($r,'text/html');
152: &Apache::loncommon::no_cache($r);
153: $r->send_http_header;
154: my $swinfo=&Apache::lonmenu::rawconfig();
155:
156: # Breadcrumbs
157: my $brcrum = [{'href' => $url,
158: 'text' => 'Switching Role'},];
159: my $start_page = &Apache::loncommon::start_page('Switching Role',undef,
160: {'redirect' => [1,$url],
161: 'bread_crumbs' => $brcrum,});
162: my $end_page = &Apache::loncommon::end_page();
163:
164: # Note to style police:
165: # This must only replace the spaces, nothing else, or it bombs elsewhere.
166: $url=~s/ /\%20/g;
167: $r->print(<<ENDREDIR);
168: $start_page
169: <script type="text/javascript">
170: // <![CDATA[
171: $swinfo
172: // ]]>
173: </script>
174: <p>$msg</p>
175: $end_page
176: ENDREDIR
177: return;
178: }
179:
180: sub error_page {
181: my ($r,$error,$dest)=@_;
182: &Apache::loncommon::content_type($r,'text/html');
183: &Apache::loncommon::no_cache($r);
184: $r->send_http_header;
185: return OK if $r->header_only;
186: # Breadcrumbs
187: my $brcrum = [{'href' => $dest,
188: 'text' => 'Problems during Course Initialization'},];
189: $r->print(&Apache::loncommon::start_page('Problems during Course Initialization',
190: undef,
191: {'bread_crumbs' => $brcrum,})
192: );
193: $r->print(
194: '<script type="text/javascript">'.
195: '// <![CDATA['.
196: &Apache::lonmenu::rawconfig().
197: '// ]]>'.
198: '</script>'.
199: '<p class="LC_error">'.&mt('The following problems occurred:').
200: '<br />'.
201: $error.
202: '</p><br /><a href="'.$dest.'">'.&mt('Continue').'</a>'
203: );
204: $r->print(&Apache::loncommon::end_page());
205: }
206:
207: sub handler {
208:
209: my $r = shift;
210:
211: # Check for critical messages and redirect if present.
212: my ($redirect,$url) = &Apache::loncommon::critical_redirect(300);
213: if ($redirect) {
214: &Apache::loncommon::content_type($r,'text/html');
215: $r->header_out(Location => $url);
216: return REDIRECT;
217: }
218:
219: my $now=time;
220: my $then=$env{'user.login.time'};
221: my $refresh=$env{'user.refresh.time'};
222: my $update=$env{'user.update.time'};
223: if (!$refresh) {
224: $refresh = $then;
225: }
226: if (!$update) {
227: $update = $then;
228: }
229:
230: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'});
231:
232: # -------------------------------------------------- Check if setting hot list
233: my $hotlist;
234: if ($env{'form.action'} eq 'verify_and_change_rolespref') {
235: $hotlist = &Apache::lonpreferences::verify_and_change_rolespref($r);
236: }
237:
238: # -------------------------------------------------------- Check for new roles
239: my $updateresult;
240: if ($env{'form.state'} eq 'doupdate') {
241: my $show_course=&Apache::loncommon::show_course();
242: my $checkingtxt;
243: if ($show_course) {
244: $checkingtxt = &mt('Checking for new courses ...');
245: } else {
246: $checkingtxt = &mt('Checking for new roles ...');
247: }
248: $updateresult = $checkingtxt;
249: $updateresult .= &update_session_roles();
250: &Apache::lonnet::appenv({'user.update.time' => $now});
251: $update = $now;
252: &Apache::loncoursequeueadmin::reqauthor_check();
253: }
254:
255: # -------------------------------------------------- Check for author requests
256: my $reqauthor;
257: if ($env{'form.state'} eq 'requestauthor') {
258: $reqauthor = &Apache::loncoursequeueadmin::process_reqauthor(\$update);
259: }
260:
261: my $envkey;
262: my %dcroles = ();
263: my $numdc = &check_fordc(\%dcroles,$update,$then);
264: my $loncaparev = $r->dir_config('lonVersion');
265:
266: # ================================================================== Roles Init
267: if ($env{'form.selectrole'}) {
268:
269: my $locknum=&Apache::lonnet::get_locks();
270: if ($locknum) { return 409; }
271:
272: if ($env{'form.newrole'}) {
273: $env{'form.'.$env{'form.newrole'}}=1;
274: }
275: if ($env{'request.course.id'}) {
276: # Check if user is CC trying to select a course role
277: if ($env{'form.switchrole'}) {
278: my $switch_is_active;
279: if (defined($env{'user.role.'.$env{'form.switchrole'}})) {
280: my ($start,$end) = split(/\./,$env{'user.role.'.$env{'form.switchrole'}});
281: if (!$end || $end > $now) {
282: if (!$start || $start < $update) {
283: $switch_is_active = 1;
284: }
285: }
286: }
287: unless ($switch_is_active) {
288: &adhoc_course_role($refresh,$update,$then);
289: }
290: }
291: my %temp=('logout_'.$env{'request.course.id'} => time);
292: &Apache::lonnet::put('email_status',\%temp);
293: &Apache::lonnet::delenv('user.state.'.$env{'request.course.id'});
294: }
295: &Apache::lonnet::appenv({"request.course.id" => '',
296: "request.course.fn" => '',
297: "request.course.uri" => '',
298: "request.course.sec" => '',
299: "request.course.tied" => '',
300: "request.course.timechecked" => '',
301: "request.role" => 'cm',
302: "request.role.adv" => $env{'user.adv'},
303: "request.role.domain" => $env{'user.domain'}});
304: # Check if user is a DC trying to enter a course or author space and needs privs to be created
305: if ($numdc > 0) {
306: foreach my $envkey (keys(%env)) {
307: # Is this an ad-hoc Coordinator role?
308: if (my ($ccrole,$domain,$coursenum) =
309: ($envkey =~ m-^form\.(cc|co)\./($match_domain)/($match_courseid)$-)) {
310: if ($dcroles{$domain}) {
311: if (&Apache::lonnet::check_adhoc_privs($domain,$coursenum,
312: $update,$refresh,$now,$ccrole)) {
313: &Apache::lonnet::appenv({"environment.internal.$domain.$coursenum.$ccrole.adhoc" => time});
314: }
315: }
316: last;
317: }
318: # Is this an ad-hoc CA-role?
319: if (my ($domain,$user) =
320: ($envkey =~ m-^form\.ca\./($match_domain)/($match_username)$-)) {
321: if (($domain eq $env{'user.domain'}) && ($user eq $env{'user.name'})) {
322: delete($env{$envkey});
323: $env{'form.au./'.$domain.'/'} = 1;
324: my ($server_status,$home) = &check_author_homeserver($user,$domain);
325: if ($server_status eq 'switchserver') {
326: my $trolecode = 'au./'.$domain.'/';
327: my $switchserver = '/adm/switchserver?otherserver='.$home.'&role='.$trolecode;
328: $r->internal_redirect($switchserver);
329: return OK;
330: }
331: last;
332: }
333: if (my ($castart,$caend) = ($env{'user.role.ca./'.$domain.'/'.$user} =~ /^(\d*)\.(\d*)$/)) {
334: if (((($castart) && ($castart < $now)) || !$castart) &&
335: ((!$caend) || (($caend) && ($caend > $now)))) {
336: my ($server_status,$home) = &check_author_homeserver($user,$domain);
337: if ($server_status eq 'switchserver') {
338: my $trolecode = 'ca./'.$domain.'/'.$user;
339: my $switchserver = '/adm/switchserver?otherserver='.$home.'&role='.$trolecode;
340: $r->internal_redirect($switchserver);
341: return OK;
342: }
343: last;
344: }
345: }
346: # Check if author blocked ca-access
347: my %blocked=&Apache::lonnet::get('environment',['domcoord.author'],$domain,$user);
348: if ($blocked{'domcoord.author'} eq 'blocked') {
349: delete($env{$envkey});
350: $env{'user.error.msg'}=':::1:User '.$user.' in domain '.$domain.' blocked domain coordinator access';
351: last;
352: }
353: if ($dcroles{$domain}) {
354: my ($server_status,$home) = &check_author_homeserver($user,$domain);
355: if (($server_status eq 'ok') || ($server_status eq 'switchserver')) {
356: &Apache::lonnet::check_adhoc_privs($domain,$user,$update,
357: $refresh,$now,'ca');
358: if ($server_status eq 'switchserver') {
359: my $trolecode = 'ca./'.$domain.'/'.$user;
360: my $switchserver = '/adm/switchserver?'
361: .'otherserver='.$home.'&role='.$trolecode;
362: $r->internal_redirect($switchserver);
363: return OK;
364: }
365: } else {
366: delete($env{$envkey});
367: }
368: } else {
369: delete($env{$envkey});
370: }
371: last;
372: }
373: }
374: }
375:
376: foreach $envkey (keys(%env)) {
377: next if ($envkey!~/^user\.role\./);
378: my ($where,$trolecode,$role,$tstatus,$tend,$tstart);
379: &Apache::lonnet::role_status($envkey,$update,$refresh,$now,\$role,\$where,
380: \$trolecode,\$tstatus,\$tstart,\$tend);
381: if ($env{'form.'.$trolecode}) {
382: if ($tstatus eq 'is') {
383: $where=~s/^\///;
384: my ($cdom,$cnum,$csec)=split(/\//,$where);
385: if (($cnum) && ($role ne 'ca') && ($role ne 'aa')) {
386: my $home = $env{'course.'.$cdom.'_'.$cnum.'.home'};
387: my @ids = &Apache::lonnet::current_machine_ids();
388: unless ($loncaparev eq '' && $home && grep(/^\Q$home\E$/,@ids)) {
389: my %curr_reqd_hash = &Apache::lonnet::userenvironment($cdom,$cnum,'internal.releaserequired');
390: if ($curr_reqd_hash{'internal.releaserequired'} ne '') {
391: my ($switchserver,$switchwarning) =
392: &Apache::loncommon::check_release_required($loncaparev,$cdom.'_'.$cnum,$trolecode,
393: $curr_reqd_hash{'internal.releaserequired'});
394: if ($switchwarning ne '' || $switchserver ne '') {
395: &Apache::loncommon::content_type($r,'text/html');
396: &Apache::loncommon::no_cache($r);
397: $r->send_http_header;
398: $r->print(&Apache::loncommon::check_release_result($switchwarning,$switchserver));
399: return OK;
400: }
401: }
402: }
403: }
404: # check for course groups
405: my %coursegroups = &Apache::lonnet::get_active_groups(
406: $env{'user.domain'},$env{'user.name'},$cdom, $cnum);
407: my $cgrps = join(':',keys(%coursegroups));
408:
409: # store role if recent_role list being kept
410: if ($env{'environment.recentroles'}) {
411: my %frozen_roles =
412: &Apache::lonhtmlcommon::get_recent_frozen('roles',$env{'environment.recentrolesn'});
413: &Apache::lonhtmlcommon::store_recent('roles',
414: $trolecode,' ',$frozen_roles{$trolecode});
415: }
416:
417:
418: # check for keyed access
419: if (($role eq 'st') &&
420: ($env{'course.'.$cdom.'_'.$cnum.'.keyaccess'} eq 'yes')) {
421: # who is key authority?
422: my $authdom=$cdom;
423: my $authnum=$cnum;
424: if ($env{'course.'.$cdom.'_'.$cnum.'.keyauth'}) {
425: ($authnum,$authdom)=
426: split(/:/,$env{'course.'.$cdom.'_'.$cnum.'.keyauth'});
427: }
428: # check with key authority
429: unless (&Apache::lonnet::validate_access_key(
430: $env{'environment.key.'.$cdom.'_'.$cnum},
431: $authdom,$authnum)) {
432: # there is no valid key
433: if ($env{'form.newkey'}) {
434: # student attempts to register a new key
435: &Apache::loncommon::content_type($r,'text/html');
436: &Apache::loncommon::no_cache($r);
437: $r->send_http_header;
438: my $swinfo=&Apache::lonmenu::rawconfig();
439: my $start_page=&Apache::loncommon::start_page
440: ('Verifying Access Key to Unlock this Course');
441: my $end_page=&Apache::loncommon::end_page();
442: my $buttontext=&mt('Enter Course');
443: my $message=&mt('Successfully registered key');
444: my $assignresult=
445: &Apache::lonnet::assign_access_key(
446: $env{'form.newkey'},
447: $authdom,$authnum,
448: $cdom,$cnum,
449: $env{'user.domain'},
450: $env{'user.name'},
451: &mt('Assigned from [_1] at [_2] for [_3]'
452: ,$ENV{'REMOTE_ADDR'}
453: ,&Apache::lonlocal::locallocaltime()
454: ,$trolecode)
455: );
456: unless ($assignresult eq 'ok') {
457: $assignresult=~s/^error\:\s*//;
458: $message=&mt($assignresult).
459: '<br /><a href="/adm/logout">'.
460: &mt('Logout').'</a>';
461: $buttontext=&mt('Re-Enter Key');
462: }
463: $r->print(<<ENDENTEREDKEY);
464: $start_page
465: <script type="text/javascript">
466: // <![CDATA[
467: $swinfo
468: // ]]>
469: </script>
470: <form action="" method="post">
471: <input type="hidden" name="selectrole" value="1" />
472: <input type="hidden" name="$trolecode" value="1" />
473: <span class="LC_fontsize_large">$message</span><br />
474: <input type="submit" value="$buttontext" />
475: </form>
476: $end_page
477: ENDENTEREDKEY
478: return OK;
479: } else {
480: # print form to enter a new key
481: &Apache::loncommon::content_type($r,'text/html');
482: &Apache::loncommon::no_cache($r);
483: $r->send_http_header;
484: my $swinfo=&Apache::lonmenu::rawconfig();
485: my $start_page=&Apache::loncommon::start_page
486: ('Enter Access Key to Unlock this Course');
487: my $end_page=&Apache::loncommon::end_page();
488: $r->print(<<ENDENTERKEY);
489: $start_page
490: <script type="text/javascript">
491: // <![CDATA[
492: $swinfo
493: // ]]>
494: </script>
495: <form action="" method="post">
496: <input type="hidden" name="selectrole" value="1" />
497: <input type="hidden" name="$trolecode" value="1" />
498: <input type="text" size="20" name="newkey" value="$env{'form.newkey'}" />
499: <input type="submit" value="Enter key" />
500: </form>
501: $end_page
502: ENDENTERKEY
503: return OK;
504: }
505: }
506: }
507: &Apache::lonnet::log($env{'user.domain'},
508: $env{'user.name'},
509: $env{'user.home'},
510: "Role ".$trolecode);
511:
512: &Apache::lonnet::appenv(
513: {'request.role' => $trolecode,
514: 'request.role.domain' => $cdom,
515: 'request.course.sec' => $csec,
516: 'request.course.groups' => $cgrps});
517: my $tadv=0;
518:
519: if (($cnum) && ($role ne 'ca') && ($role ne 'aa')) {
520: my $msg;
521: my ($furl,$ferr)=
522: &Apache::lonuserstate::readmap($cdom.'/'.$cnum);
523: unless ($ferr) {
524: unless (($env{'form.switchrole'}) ||
525: ($env{"environment.internal.$cdom.$cnum.$role.adhoc"})) {
526: &Apache::lonnet::put('nohist_crslastlogin',
527: {$env{'user.name'}.':'.$env{'user.domain'}.
528: ':'.$csec.':'.$role => $now},$cdom,$cnum);
529: }
530: my ($feeds,$syllabus_time);
531: &Apache::lonrss::advertisefeeds($cnum,$cdom,undef,\$feeds);
532: &Apache::lonnet::appenv({'request.course.feeds' => $feeds});
533: &Apache::lonnet::get_numsuppfiles($cnum,$cdom,1);
534: unless ($env{'course.'.$cdom.'_'.$cnum.'.updatedsyllabus'}) {
535: unless (($env{'course.'.$cdom.'_'.$cnum.'.externalsyllabus'}) ||
536: ($env{'course.'.$cdom.'_'.$cnum.'.uploadedsyllabus'})) {
537: my %syllabus=&Apache::lonnet::dump('syllabus',$cdom,$cnum);
538: $syllabus_time = $syllabus{'uploaded.lastmodified'};
539: if ($syllabus_time) {
540: &Apache::lonnet::appenv({'request.course.syllabustime' => $syllabus_time});
541: }
542: }
543: }
544: }
545: if (($env{'form.orgurl'}) &&
546: ($env{'form.orgurl'}!~/^\/adm\/flip/) &&
547: ($env{'form.orgurl'} ne '/adm/roles')) {
548: my $dest=$env{'form.orgurl'};
549: if ($env{'form.symb'}) {
550: if ($dest =~ /\?/) {
551: $dest .= '&';
552: } else {
553: $dest .= '?';
554: }
555: $dest .= 'symb='.$env{'form.symb'};
556: }
557: if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
558: &Apache::lonnet::appenv({'request.role.adv'=>$tadv});
559: if (($ferr) && ($tadv)) {
560: &error_page($r,$ferr,$dest);
561: } else {
562: if ($dest =~ m{^/adm/coursedocs\?folderpath}) {
563: if ($env{'request.course.id'} eq $cdom.'_'.$cnum) {
564: my $chome = &Apache::lonnet::homeserver($cnum,$cdom);
565: &Apache::loncommon::update_content_constraints($cdom,$cnum,$chome,
566: $cdom.'_'.$cnum);
567: }
568: }
569: $r->internal_redirect($dest);
570: }
571: return OK;
572: } else {
573: if (!$env{'request.course.id'}) {
574: &Apache::lonnet::appenv(
575: {"request.course.id" => $cdom.'_'.$cnum});
576: $furl='/adm/roles?tryagain=1';
577: $msg='<p><span class="LC_error">'
578: .&mt('Could not initialize [_1] at this time.',
579: $env{'course.'.$cdom.'_'.$cnum.'.description'})
580: .'</span></p>'
581: .'<p>'.&mt('Please try again.').'</p>'
582: .'<p>'.$ferr.'</p>';
583: }
584: if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
585: &Apache::lonnet::appenv({'request.role.adv'=>$tadv});
586:
587: if (($ferr) && ($tadv)) {
588: &error_page($r,$ferr,$furl);
589: } else {
590: # Check to see if the user is a CC entering a course
591: # for the first time
592: if ((($role eq 'cc') || ($role eq 'co'))
593: && ($env{'course.'.$cdom.'_'.$cnum.'.course.helper.not.run'})) {
594: $furl = "/adm/helper/course.initialization.helper";
595: # Send the user to the course they selected
596: } elsif ($env{'request.course.id'}) {
597: my ($dest,$destsymb,$checkenc);
598: $dest = $env{'form.destinationurl'};
599: $destsymb = $env{'form.destsymb'};
600: if ($dest ne '') {
601: if ($env{'form.switchrole'}) {
602: if ($destsymb ne '') {
603: if ($destsymb !~ m{^/enc/}) {
604: unless ($env{'request.role.adv'}) {
605: $checkenc = 1;
606: }
607: }
608: }
609: if ($dest =~ m{^/enc/}) {
610: if ($env{'request.role.adv'}) {
611: $dest = &Apache::lonenc::unencrypted($dest);
612: if ($destsymb eq '') {
613: ($destsymb) = ($dest =~ /(?:\?|\&)symb=([^\&]*)/);
614: $destsymb = &unescape($destsymb);
615: }
616: }
617: } else {
618: if ($destsymb eq '') {
619: ($destsymb) = ($dest =~ /(?:\?|\&)symb=([^\&]+)/);
620: $destsymb = &unescape($destsymb);
621: }
622: unless ($env{'request.role.adv'}) {
623: $checkenc = 1;
624: }
625: }
626: if (($checkenc) && ($destsymb ne '')) {
627: my ($encstate,$unencsymb,$res);
628: $unencsymb = &Apache::lonnet::symbclean($destsymb);
629: (undef,undef,$res) = &Apache::lonnet::decode_symb($unencsymb);
630: &Apache::lonnet::symbverify($unencsymb,$res,\$encstate);
631: if ($encstate) {
632: if (($dest ne '') && ($dest !~ m{^/enc/})) {
633: $dest=&Apache::lonenc::encrypted($dest);
634: }
635: }
636: }
637: }
638: unless (($dest =~ m{^/enc/}) || ($dest =~ /(\?|\&)symb=.+___\d+___.+/)) {
639: if (($destsymb ne '') && ($destsymb !~ m{^/enc/})) {
640: my $esc_symb = &escape($destsymb);
641: $dest .= '?symb='.$esc_symb;
642: }
643: }
644: &redirect_user($r, &mt('Entering [_1]',
645: $env{'course.'.$cdom.'_'.$cnum.'.description'}),
646: $dest, $msg);
647: return OK;
648: }
649: if (&Apache::lonnet::allowed('whn',
650: $env{'request.course.id'})
651: || &Apache::lonnet::allowed('whn',
652: $env{'request.course.id'}.'/'
653: .$env{'request.course.sec'})
654: ) {
655: my $startpage = &courseloadpage($env{'request.course.id'});
656: unless ($startpage eq 'firstres') {
657: $msg = &mt('Entering [_1] ...',
658: $env{'course.'.$env{'request.course.id'}.'.description'});
659: &redirect_user($r, &mt('New in course'),
660: '/adm/whatsnew?refpage=start', $msg);
661: return OK;
662: }
663: }
664: }
665: # Are we allowed to look at the first resource?
666: my $access;
667: if ($furl =~ m{^(/adm/wrapper|)/ext/}) {
668: # If it's an external resource,
669: # strip off the symb argument and possible query
670: my ($exturl,$symb) = ($furl =~ m{^(.+)(?:\?|\&)symb=(.+)$});
671: # Unencode $symb
672: $symb = &unescape($symb);
673: # Then check for permission
674: $access = &Apache::lonnet::allowed('bre',$exturl,$symb);
675: # For other resources just check for permission
676: } else {
677: $access = &Apache::lonnet::allowed('bre',$furl);
678: }
679: if (!$access) {
680: $furl = &Apache::lonpageflip::first_accessible_resource();
681: } elsif ($access eq 'B') {
682: $furl = '/adm/navmaps?showOnlyHomework=1';
683: }
684: $msg = &mt('Entering [_1] ...',
685: $env{'course.'.$cdom.'_'.$cnum.'.description'});
686: &redirect_user($r, &mt('Entering [_1]',
687: $env{'course.'.$cdom.'_'.$cnum.'.description'}),
688: $furl, $msg);
689: }
690: return OK;
691: }
692: }
693: #
694: # Send the user to the construction space they selected
695: if ($role =~ /^(au|ca|aa)$/) {
696: my $redirect_url = '/priv/';
697: if ($role eq 'au') {
698: $redirect_url.=$env{'user.domain'}.'/'.$env{'user.name'};
699: } else {
700: $redirect_url .= $where;
701: }
702: $redirect_url .= '/';
703: &redirect_user($r,&mt('Entering Authoring Space'),
704: $redirect_url);
705: return OK;
706: }
707: if ($role eq 'dc') {
708: my $redirect_url = '/adm/menu/';
709: &redirect_user($r,&mt('Loading Domain Coordinator Menu'),
710: $redirect_url);
711: return OK;
712: }
713: if ($role eq 'sc') {
714: my $redirect_url = '/adm/grades?command=scantronupload';
715: &redirect_user($r,&mt('Loading Data Upload Page'),
716: $redirect_url);
717: return OK;
718: }
719: }
720: }
721: }
722: }
723:
724:
725: # =============================================================== No Roles Init
726:
727: &Apache::loncommon::content_type($r,'text/html');
728: &Apache::loncommon::no_cache($r);
729: $r->send_http_header;
730: return OK if $r->header_only;
731:
732: my $crumbtext = 'User Roles';
733: my $pagetitle = 'My Roles';
734: my $recent = &mt('Recent Roles');
735: my $standby = &mt('Role selected. Please stand by.');
736: my $show_course=&Apache::loncommon::show_course();
737: if ($show_course) {
738: $crumbtext = 'Courses';
739: $pagetitle = 'My Courses';
740: $recent = &mt('Recent Courses');
741: $standby = &mt('Course selected. Please stand by.');
742: }
743: my $brcrum =[{href=>"/adm/roles",text=>$crumbtext}];
744:
745: my %roles_in_env;
746: my $showcount = &roles_from_env(\%roles_in_env,$update);
747:
748: my $swinfo=&Apache::lonmenu::rawconfig();
749: my %domdefs=&Apache::lonnet::get_domain_defaults($env{'user.domain'});
750: my $cattype = 'std';
751: if ($domdefs{'catauth'}) {
752: $cattype = $domdefs{'catauth'};
753: }
754: my $funcs = &get_roles_functions($showcount,$cattype);
755: my $crumbsright;
756: if ($env{'browser.mobile'}) {
757: $crumbsright = $funcs;
758: undef($funcs);
759: }
760: my $start_page=&Apache::loncommon::start_page($pagetitle,undef,{bread_crumbs=>$brcrum,
761: bread_crumbs_component=>$crumbsright});
762: &js_escape(\$standby);
763: my $noscript='<br /><span class="LC_error">'.&mt('Use of LON-CAPA requires Javascript to be enabled in your web browser.').'<br />'.&mt('As this is not the case, most functionality in the system will be unavailable.').'</span><br />';
764:
765: $r->print(<<ENDHEADER);
766: $start_page
767: $funcs
768: <noscript>
769: $noscript
770: </noscript>
771: <script type="text/javascript">
772: // <![CDATA[
773: $swinfo
774: window.focus();
775:
776: active=true;
777:
778: function enterrole (thisform,rolecode,buttonname) {
779: if (active) {
780: active=false;
781: document.title='$standby';
782: window.status='$standby';
783: thisform.newrole.value=rolecode;
784: thisform.submit();
785: } else {
786: alert('$standby');
787: }
788: }
789:
790: function rolesView (caller) {
791: if ((caller == 'showall') || (caller == 'noshowall')) {
792: document.rolechoice.display.value = caller;
793: } else {
794: if ((caller == 'doupdate') || (caller == 'requestauthor') ||
795: (caller == 'queued')) {
796: document.rolechoice.state.value = caller;
797: }
798: }
799: document.rolechoice.selectrole.value='';
800: document.rolechoice.submit();
801: }
802:
803: // ]]>
804: </script>
805: ENDHEADER
806:
807: # ------------------------------------------ Get Error Message from Environment
808:
809: my ($fn,$priv,$nochoose,$error,$msg)=split(/:/,$env{'user.error.msg'});
810: if ($env{'user.error.msg'}) {
811: $r->log_reason(
812: "$msg for $env{'user.name'} domain $env{'user.domain'} access $priv",$fn);
813: }
814:
815: # ------------------------------------------------- Can this user re-init, etc?
816:
817: my $advanced=$env{'user.adv'};
818: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['tryagain']);
819: my $tryagain=$env{'form.tryagain'};
820: my $reinit=$env{'user.reinit'};
821: delete $env{'user.reinit'};
822:
823: # -------------------------------------------------------- Generate Page Output
824: # --------------------------------------------------------------- Error Header?
825: if ($error) {
826: $r->print("<h1>".&mt('LON-CAPA Access Control')."</h1>");
827: $r->print("<!-- LONCAPAACCESSCONTROLERRORSCREEN --><hr /><pre>");
828: if ($priv ne '') {
829: $r->print(&mt('Access : ').&Apache::lonnet::plaintext($priv)."\n");
830: }
831: if ($fn ne '') {
832: $r->print(&mt('Resource: ').&Apache::lonenc::check_encrypt($fn)."\n");
833: }
834: if ($msg ne '') {
835: $r->print(&mt('Action : ').$msg."\n");
836: }
837: $r->print("</pre><hr />");
838: my $url=$fn;
839: my $last;
840: if (tie(my %hash,'GDBM_File',$env{'request.course.fn'}.'_symb.db',
841: &GDBM_READER(),0640)) {
842: $last=$hash{'last_known'};
843: untie(%hash);
844: }
845: if ($last) { $fn.='?symb='.&escape($last); }
846:
847: &Apache::londocs::changewarning($r,undef,'You have modified your course recently, [_1] may fix this access problem.',
848: &Apache::lonenc::check_encrypt($fn));
849: } else {
850: if ($env{'user.error.msg'}) {
851: if ($reinit) {
852: $r->print(
853: '<h3><span class="LC_error">'.
854: &mt('As your session file for the course or community has expired, you will need to re-select it.').'</span></h3>');
855: } else {
856: $r->print(
857: '<h3><span class="LC_error">'.
858: &mt('You need to choose another user role or enter a specific course or community for this function.').
859: '</span></h3>');
860: }
861: }
862: }
863: if ($nochoose) {
864: $r->print("<h2>".&mt('Sorry ...')."</h2>\n<span class='LC_error'>".
865: &mt('This action is currently not authorized.').'</span>'.
866: &Apache::loncommon::end_page());
867: return OK;
868: } else {
869: if ($updateresult || $reqauthor || $hotlist) {
870: my $showresult = '<div>';
871: if ($updateresult) {
872: $showresult .= &Apache::lonhtmlcommon::confirm_success($updateresult);
873: }
874: if ($reqauthor) {
875: $showresult .= &Apache::lonhtmlcommon::confirm_success($reqauthor);
876: }
877: if ($hotlist) {
878: $showresult .= $hotlist;
879: }
880: $showresult .= '</div>';
881: $r->print($showresult);
882: } elsif ($env{'form.state'} eq 'queued') {
883: $r->print(&get_queued());
884: }
885: if (($ENV{'REDIRECT_QUERY_STRING'}) && ($fn)) {
886: $fn.='?'.$ENV{'REDIRECT_QUERY_STRING'};
887: }
888: my $display = ($env{'form.display'} =~ /^(showall)$/);
889: $r->print('<form method="post" name="rolechoice" action="'.(($fn)?$fn:$r->uri).'">');
890: $r->print('<input type="hidden" name="orgurl" value="'.$fn.'" />');
891: $r->print('<input type="hidden" name="selectrole" value="1" />');
892: $r->print('<input type="hidden" name="newrole" value="" />');
893: $r->print('<input type="hidden" name="display" value="'.$display.'" />');
894: $r->print('<input type="hidden" name="state" value="" />');
895: }
896: $r->rflush();
897:
898: my (%roletext,%sortrole,%roleclass,%futureroles,%timezones);
899: my ($countactive,$countfuture,$inrole,$possiblerole) =
900: &gather_roles($update,$refresh,$now,$reinit,$nochoose,\%roles_in_env,\%roletext,
901: \%sortrole,\%roleclass,\%futureroles,\%timezones,$loncaparev);
902: $refresh = $now;
903: &Apache::lonnet::appenv({'user.refresh.time' => $refresh});
904: if ((($cattype eq 'std') || ($cattype eq 'domonly')) && (!$env{'user.adv'})) {
905: if ($countactive > 0) {
906: my $domdesc = &Apache::lonnet::domain($env{'user.domain'},'description');
907: my $esc_dom = &HTML::Entities::encode($env{'user.domain'},'"<>&');
908: $r->print(
909: '<p>'
910: .&mt('[_1]Visit the [_2]Course/Community Catalog[_3][_4]'
911: .' to view all [_5] LON-CAPA courses and communities.'
912: ,'<b>'
913: ,'<a href="/adm/coursecatalog?showdom='.$esc_dom.'">'
914: ,'</a>'
915: ,'</b>'
916: ,'"'.$domdesc.'"')
917: .'<br />'
918: .&mt('If a course or community is [_1]not[_2] in your list of current courses and communities below,'
919: .' you may be able to enroll if self-enrollment is permitted.'
920: ,'<b>','</b>')
921: .'</p>'
922: );
923: }
924: }
925:
926: # No active roles
927: if ($countactive==0) {
928: &requestcourse_advice($r,$cattype,$inrole);
929: $r->print('</form>');
930: if ($countfuture) {
931: $r->print(&mt('The following [quant,_1,role,roles] will become active in the future:',$countfuture));
932: my $doheaders = &roletable_headers($r,\%roleclass,\%sortrole,
933: $nochoose);
934: &print_rolerows($r,$doheaders,\%roleclass,\%sortrole,\%dcroles,
935: \%roletext);
936: my $tremark='';
937: my $tbg;
938: if ($env{'request.role'} eq 'cm') {
939: $tbg="LC_roles_selected";
940: $tremark=&mt('Currently selected.').' ';
941: } else {
942: $tbg="LC_roles_is";
943: }
944: $r->print(&Apache::loncommon::start_data_table_row()
945: .'<td class="'.$tbg.'"> </td>'
946: .'<td colspan="3">'
947: .&mt('No role specified')
948: .'</td>'
949: .'<td>'.$tremark.' </td>'
950: .&Apache::loncommon::end_data_table_row()
951: );
952:
953: $r->print(&Apache::loncommon::end_data_table());
954: }
955: $r->print(&Apache::loncommon::end_page());
956: return OK;
957: }
958: # ----------------------------------------------------------------------- Table
959:
960: if ($numdc > 0) {
961: $r->print(&coursepick_jscript());
962: $r->print(&Apache::loncommon::coursebrowser_javascript().
963: &Apache::loncommon::authorbrowser_javascript());
964: }
965:
966: unless ((!&Apache::loncommon::show_course()) || ($nochoose) || ($countactive==1)) {
967: $r->print("<h2>".&mt('Select a Course to Enter')."</h2>\n");
968: }
969: if ($env{'form.destinationurl'}) {
970: $r->print('<input type="hidden" name="destinationurl" value="'.
971: $env{'form.destinationurl'}.'" />');
972: if ($env{'form.destsymb'} ne '') {
973: $r->print('<input type="hidden" name="destsymb" value="'.
974: $env{'form.destsymb'}.'" />');
975: }
976: }
977:
978: my $doheaders = &roletable_headers($r,\%roleclass,\%sortrole,$nochoose);
979: if ($env{'environment.recentroles'}) {
980: my %recent_roles =
981: &Apache::lonhtmlcommon::get_recent('roles',$env{'environment.recentrolesn'});
982: my $output='';
983: foreach my $role (sort(keys(%recent_roles))) {
984: if (ref($roletext{'user.role.'.$role}) eq 'ARRAY') {
985: $output.= &Apache::loncommon::start_data_table_row().
986: $roletext{'user.role.'.$role}->[0].
987: &Apache::loncommon::end_data_table_row();
988: if ($roletext{'user.role.'.$role}->[1] ne '') {
989: $output .= &Apache::loncommon::continue_data_table_row().
990: $roletext{'user.role.'.$role}->[1].
991: &Apache::loncommon::end_data_table_row();
992: }
993: if ($role =~ m{dc\./($match_domain)/}
994: && $dcroles{$1}) {
995: $output .= &adhoc_roles_row($1,'recent');
996: }
997: } elsif ($numdc > 0) {
998: unless ($role =~/^error\:/) {
999: my ($roletext,$role_text_end) = &display_cc_role('user.role.'.$role);
1000: if ($roletext) {
1001: $output.= &Apache::loncommon::start_data_table_row().
1002: $roletext.
1003: &Apache::loncommon::end_data_table_row();
1004: if ($role_text_end) {
1005: $output .= &Apache::loncommon::continue_data_table_row().
1006: $role_text_end.
1007: &Apache::loncommon::end_data_table_row();
1008: }
1009: }
1010: }
1011: }
1012: }
1013: if ($output) {
1014: $r->print(&Apache::loncommon::start_data_table_empty_row()
1015: .'<td align="center" colspan="5">'
1016: .$recent
1017: .'</td>'
1018: .&Apache::loncommon::end_data_table_empty_row()
1019: );
1020: $r->print($output);
1021: $doheaders ++;
1022: }
1023: }
1024: &print_rolerows($r,$doheaders,\%roleclass,\%sortrole,\%dcroles,\%roletext);
1025: if ($countactive > 1) {
1026: my $tremark='';
1027: my $tbg;
1028: if ($env{'request.role'} eq 'cm') {
1029: $tbg="LC_roles_selected";
1030: $tremark=&mt('Currently selected.').' ';
1031: } else {
1032: $tbg="LC_roles_is";
1033: }
1034: $r->print(&Apache::loncommon::start_data_table_row());
1035: unless ($nochoose) {
1036: if ($env{'request.role'} ne 'cm') {
1037: $r->print('<td class="'.$tbg.'"><input type="submit" value="'.
1038: &mt('Select').'" name="cm" /></td>');
1039: } else {
1040: $r->print('<td class="'.$tbg.'"> </td>');
1041: }
1042: }
1043: $r->print('<td colspan="3">'
1044: .&mt('No role specified')
1045: .'</td>'
1046: .'<td>'.$tremark.' </td>'
1047: .&Apache::loncommon::end_data_table_row()
1048: );
1049: }
1050: $r->print(&Apache::loncommon::end_data_table());
1051: unless ($nochoose) {
1052: $r->print("</form>\n");
1053: }
1054: # ------------------------------------------------------------ Privileges Info
1055: if (($advanced) && (($env{'user.error.msg'}) || ($error))) {
1056: $r->print('<hr /><h2>'.&mt('Current Privileges').'</h2>');
1057: $r->print(&privileges_info());
1058: }
1059: my $announcements = &Apache::lonnet::getannounce();
1060: $r->print(
1061: '<br />'.
1062: '<h2>'.&mt('Announcements').'</h2>'.
1063: $announcements
1064: ) unless (!$announcements);
1065: if ($advanced) {
1066: my $esc_dom = &HTML::Entities::encode($env{'user.domain'},'"<>&');
1067: $r->print('<p><small><i>'
1068: .&mt('This LON-CAPA server is version [_1]',$r->dir_config('lonVersion'))
1069: .'</i></small></p>');
1070: }
1071: $r->print(&Apache::loncommon::end_page());
1072: return OK;
1073: }
1074:
1075: sub roles_from_env {
1076: my ($roleshash,$update) = @_;
1077: my $count = 0;
1078: if (ref($roleshash) eq 'HASH') {
1079: foreach my $envkey (keys(%env)) {
1080: if ($envkey =~ m{^user\.role\.(\w+)[./]}) {
1081: next if ($1 eq 'gr');
1082: $roleshash->{$envkey} = $env{$envkey};
1083: my ($start,$end) = split(/\./,$env{$envkey});
1084: unless ($end && $end<$update) {
1085: $count ++;
1086: }
1087: }
1088: }
1089: }
1090: return $count;
1091: }
1092:
1093: sub gather_roles {
1094: my ($update,$refresh,$now,$reinit,$nochoose,$roles_in_env,$roletext,$sortrole,$roleclass,$futureroles,
1095: $timezones,$loncaparev) = @_;
1096: my ($countactive,$countfuture,$inrole,$possiblerole) = (0,0,0,'');
1097: my $advanced = $env{'user.adv'};
1098: my $tryagain = $env{'form.tryagain'};
1099: my @ids = &Apache::lonnet::current_machine_ids();
1100: if (ref($roles_in_env) eq 'HASH') {
1101: foreach my $envkey (sort(keys(%{$roles_in_env}))) {
1102: my $button = 1;
1103: my $switchserver='';
1104: my $switchwarning;
1105: my ($role_text,$role_text_end,$sortkey,$role,$where,$trolecode,$tstart,
1106: $tend,$tremark,$tstatus,$tpstart,$tpend);
1107: &Apache::lonnet::role_status($envkey,$update,$refresh,$now,\$role,\$where,
1108: \$trolecode,\$tstatus,\$tstart,\$tend);
1109: next if (!defined($role) || $role eq '' || $role =~ /^gr/);
1110: $tremark='';
1111: $tpstart=' ';
1112: $tpend=' ';
1113: if ($env{'request.role'} eq $trolecode) {
1114: $tstatus='selected';
1115: }
1116: my $tbg;
1117: if (($tstatus eq 'is')
1118: || ($tstatus eq 'selected')
1119: || ($tstatus eq 'future')
1120: || ($env{'form.display'} eq 'showall')) {
1121: my $timezone = &role_timezone($where,$timezones);
1122: if ($tstart) {
1123: $tpstart=&Apache::lonlocal::locallocaltime($tstart,$timezone);
1124: }
1125: if ($tend) {
1126: $tpend=&Apache::lonlocal::locallocaltime($tend,$timezone);
1127: }
1128: if ($tstatus eq 'is') {
1129: $tbg='LC_roles_is';
1130: $possiblerole=$trolecode;
1131: $countactive++;
1132: } elsif ($tstatus eq 'future') {
1133: $tbg='LC_roles_future';
1134: $button=0;
1135: $futureroles->{$trolecode} = $tstart.':'.$tend;
1136: $countfuture ++;
1137: } elsif ($tstatus eq 'expired') {
1138: $tbg='LC_roles_expired';
1139: $button=0;
1140: } elsif ($tstatus eq 'will_not') {
1141: $tbg='LC_roles_will_not';
1142: $tremark.=&mt('Expired after logout.').' ';
1143: } elsif ($tstatus eq 'selected') {
1144: $tbg='LC_roles_selected';
1145: $inrole=1;
1146: $countactive++;
1147: $tremark.=&mt('Currently selected.').' ';
1148: }
1149: my $trole;
1150: if ($role =~ /^cr\//) {
1151: my ($rdummy,$rdomain,$rauthor,$rrole)=split(/\//,$role);
1152: if ($tremark) { $tremark.='<br />'; }
1153: $tremark.=&mt('Custom role defined by [_1].',$rauthor.':'.$rdomain);
1154: }
1155: $trole=Apache::lonnet::plaintext($role);
1156: my $ttype;
1157: my $twhere;
1158: my ($tdom,$trest,$tsection)=
1159: split(/\//,Apache::lonnet::declutter($where));
1160: # First, Co-Authorship roles
1161: if (($role eq 'ca') || ($role eq 'aa')) {
1162: my $home = &Apache::lonnet::homeserver($trest,$tdom);
1163: my $allowed=0;
1164: foreach my $id (@ids) { if ($id eq $home) { $allowed=1; } }
1165: if (!$allowed) {
1166: $button=0;
1167: $switchserver='otherserver='.$home.'&role='.$trolecode;
1168: }
1169: #next if ($home eq 'no_host');
1170: $home = &Apache::lonnet::hostname($home);
1171: $ttype='Authoring Space';
1172: $twhere=&mt('User').': '.$trest.'<br />'.&mt('Domain').
1173: ': '.$tdom.'<br />'.
1174: ' '.&mt('Server').': '.$home;
1175: $env{'course.'.$tdom.'_'.$trest.'.description'}='ca';
1176: $tremark.=&Apache::lonhtmlcommon::authorbombs('/res/'.$tdom.'/'.$trest.'/');
1177: $sortkey=$role."$trest:$tdom";
1178: } elsif ($role eq 'au') {
1179: # Authors
1180: my $home = &Apache::lonnet::homeserver
1181: ($env{'user.name'},$env{'user.domain'});
1182: my $allowed=0;
1183: foreach my $id (@ids) { if ($id eq $home) { $allowed=1; } }
1184: if (!$allowed) {
1185: $button=0;
1186: $switchserver='otherserver='.$home.'&role='.$trolecode;
1187: }
1188: #next if ($home eq 'no_host');
1189: $home = &Apache::lonnet::hostname($home);
1190: $ttype='Authoring Space';
1191: $twhere=&mt('Domain').': '.$tdom.'<br />'.&mt('Server').
1192: ': '.$home;
1193: $env{'course.'.$tdom.'_'.$trest.'.description'}='ca';
1194: $tremark.=&Apache::lonhtmlcommon::authorbombs('/res/'.$tdom.'/'.$env{'user.name'}.'/');
1195: $sortkey=$role;
1196: } elsif ($trest) {
1197: my $tcourseid=$tdom.'_'.$trest;
1198: $ttype = &Apache::loncommon::course_type($tcourseid);
1199: $trole = &Apache::lonnet::plaintext($role,$ttype,$tcourseid);
1200: if ($env{'course.'.$tcourseid.'.description'}) {
1201: my $home=$env{'course.'.$tcourseid.'.home'};
1202: $twhere=$env{'course.'.$tcourseid.'.description'};
1203: $sortkey=$role."\0".$tdom."\0".$twhere."\0".$envkey;
1204: $twhere = &HTML::Entities::encode($twhere,'"<>&');
1205: unless ($twhere eq &mt('Currently not available')) {
1206: $twhere.=' <span class="LC_fontsize_small">'.
1207: &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$trest,$tdom).
1208: '</span>';
1209: unless ($home && grep(/^\Q$home\E$/,@ids) && $loncaparev eq '') {
1210: my $required = $env{'course.'.$tcourseid.'.internal.releaserequired'};
1211: if ($required ne '') {
1212: ($switchserver,$switchwarning) =
1213: &Apache::loncommon::check_release_required($loncaparev,$tcourseid,$trolecode,$required);
1214: if ($switchserver || $switchwarning) {
1215: $button = 0;
1216: }
1217: }
1218: }
1219: }
1220: } else {
1221: my %newhash=&Apache::lonnet::coursedescription($tcourseid);
1222: if (%newhash) {
1223: $sortkey=$role."\0".$tdom."\0".$newhash{'description'}.
1224: "\0".$envkey;
1225: $twhere=&HTML::Entities::encode($newhash{'description'},'"<>&').
1226: ' <span class="LC_fontsize_small">'.
1227: &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$trest,$tdom).
1228: '</span>';
1229: $ttype = $newhash{'type'};
1230: $trole = &Apache::lonnet::plaintext($role,$ttype,$tcourseid);
1231: my $home = $newhash{'home'};
1232: unless ($home && grep(/^\Q$home\E$/,@ids) && $loncaparev eq '') {
1233: my $required = $newhash{'internal.releaserequired'};
1234: if ($required ne '') {
1235: ($switchserver,$switchwarning) =
1236: &Apache::loncommon::check_release_required($loncaparev,$tcourseid,$trolecode,$required);
1237: if ($switchserver || $switchwarning) {
1238: $button = 0;
1239: }
1240: }
1241: }
1242: } else {
1243: $twhere=&mt('Currently not available');
1244: $env{'course.'.$tcourseid.'.description'}=$twhere;
1245: $sortkey=$role."\0".$tdom."\0".$twhere."\0".$envkey;
1246: $ttype = 'Unavailable';
1247: }
1248: }
1249: if ($tsection) {
1250: $twhere.='<br />'.&mt('Section').': '.$tsection;
1251: }
1252: if ($role ne 'st') { $twhere.="<br />".&mt('Domain').":".$tdom; }
1253: } elsif ($tdom) {
1254: $ttype='Domain';
1255: $twhere=$tdom;
1256: $sortkey=$role.$twhere;
1257: } else {
1258: $ttype='System';
1259: $twhere=&mt('system wide');
1260: $sortkey=$role.$twhere;
1261: }
1262: ($role_text,$role_text_end) =
1263: &build_roletext($trolecode,$tdom,$trest,$tstatus,$tryagain,
1264: $advanced,$tremark,$tbg,$trole,$twhere,$tpstart,
1265: $tpend,$nochoose,$button,$switchserver,$reinit,$switchwarning);
1266: $roletext->{$envkey}=[$role_text,$role_text_end];
1267: if (!$sortkey) {$sortkey=$twhere."\0".$envkey;}
1268: $sortrole->{$sortkey}=$envkey;
1269: $roleclass->{$envkey}=$ttype;
1270: }
1271: }
1272: }
1273: return ($countactive,$countfuture,$inrole,$possiblerole);
1274: }
1275:
1276: sub role_timezone {
1277: my ($where,$timezones) = @_;
1278: my $timezone;
1279: if (ref($timezones) eq 'HASH') {
1280: if ($where =~ m{^/($match_domain)/($match_courseid)}) {
1281: my $cdom = $1;
1282: my $cnum = $2;
1283: if ($cdom && $cnum) {
1284: if (!exists($timezones->{$cdom.'_'.$cnum})) {
1285: my $tz;
1286: if ($env{'course.'.$cdom.'_'.$cnum.'.description'}) {
1287: $tz = $env{'course.'.$cdom.'_'.$cnum.'.timezone'};
1288: } else {
1289: my %timehash =
1290: &Apache::lonnet::get('environment',['timezone'],$cdom,$cnum);
1291: $tz = $timehash{'timezone'};
1292: }
1293: if ($tz eq '') {
1294: if (!exists($timezones->{$cdom})) {
1295: my %domdefaults =
1296: &Apache::lonnet::get_domain_defaults($cdom);
1297: if ($domdefaults{'timezone_def'} eq '') {
1298: $timezones->{$cdom} = 'local';
1299: } else {
1300: $timezones->{$cdom} = $domdefaults{'timezone_def'};
1301: }
1302: }
1303: $timezones->{$cdom.'_'.$cnum} = $timezones->{$cdom};
1304: } else {
1305: $timezones->{$cdom.'_'.$cnum} =
1306: &Apache::lonlocal::gettimezone($tz);
1307: }
1308: }
1309: $timezone = $timezones->{$cdom.'_'.$cnum};
1310: }
1311: } else {
1312: my ($tdom) = ($where =~ m{^/($match_domain)});
1313: if ($tdom) {
1314: if (!exists($timezones->{$tdom})) {
1315: my %domdefaults = &Apache::lonnet::get_domain_defaults($tdom);
1316: if ($domdefaults{'timezone_def'} eq '') {
1317: $timezones->{$tdom} = 'local';
1318: } else {
1319: $timezones->{$tdom} = $domdefaults{'timezone_def'};
1320: }
1321: }
1322: $timezone = $timezones->{$tdom};
1323: }
1324: }
1325: if ($timezone eq 'local') {
1326: $timezone = undef;
1327: }
1328: }
1329: return $timezone;
1330: }
1331:
1332: sub roletable_headers {
1333: my ($r,$roleclass,$sortrole,$nochoose) = @_;
1334: my $doheaders;
1335: if ((ref($sortrole) eq 'HASH') && (ref($roleclass) eq 'HASH')) {
1336: $r->print('<br />'
1337: .&Apache::loncommon::start_data_table('LC_textsize_mobile')
1338: .&Apache::loncommon::start_data_table_header_row()
1339: );
1340: if (!$nochoose) { $r->print('<th> </th>'); }
1341: $r->print('<th>'.&mt('User Role').'</th>'
1342: .'<th>'.&mt('Extent').'</th>'
1343: .'<th>'.&mt('Start').'</th>'
1344: .'<th>'.&mt('End').'</th>'
1345: .&Apache::loncommon::end_data_table_header_row()
1346: );
1347: $doheaders=-1;
1348: my @roletypes = &roletypes();
1349: foreach my $type (@roletypes) {
1350: my $haverole=0;
1351: foreach my $which (sort {uc($a) cmp uc($b)} (keys(%{$sortrole}))) {
1352: if ($roleclass->{$sortrole->{$which}} =~ /^\Q$type\E/) {
1353: $haverole=1;
1354: }
1355: }
1356: if ($haverole) { $doheaders++; }
1357: }
1358: }
1359: return $doheaders;
1360: }
1361:
1362: sub roletypes {
1363: my @types = ('Domain','Authoring Space','Course','Community','Unavailable','System');
1364: return @types;
1365: }
1366:
1367: sub print_rolerows {
1368: my ($r,$doheaders,$roleclass,$sortrole,$dcroles,$roletext) = @_;
1369: if ((ref($roleclass) eq 'HASH') && (ref($sortrole) eq 'HASH')) {
1370: my @types = &roletypes();
1371: foreach my $type (@types) {
1372: my $output;
1373: foreach my $which (sort {uc($a) cmp uc($b)} (keys(%{$sortrole}))) {
1374: if ($roleclass->{$sortrole->{$which}} =~ /^\Q$type\E/) {
1375: if (ref($roletext) eq 'HASH') {
1376: if (ref($roletext->{$sortrole->{$which}}) eq 'ARRAY') {
1377: $output.= &Apache::loncommon::start_data_table_row().
1378: $roletext->{$sortrole->{$which}}->[0].
1379: &Apache::loncommon::end_data_table_row();
1380: if ($roletext->{$sortrole->{$which}}->[1] ne '') {
1381: $output .= &Apache::loncommon::continue_data_table_row().
1382: $roletext->{$sortrole->{$which}}->[1].
1383: &Apache::loncommon::end_data_table_row();
1384: }
1385: }
1386: if ($sortrole->{$which} =~ m-dc\./($match_domain)/-) {
1387: if (ref($dcroles) eq 'HASH') {
1388: if ($dcroles->{$1}) {
1389: $output .= &adhoc_roles_row($1,'');
1390: }
1391: }
1392: }
1393: }
1394: }
1395: }
1396: if ($output) {
1397: if ($doheaders > 0) {
1398: $r->print(&Apache::loncommon::start_data_table_empty_row()
1399: .'<td align="center" colspan="5">'
1400: .&mt($type)
1401: .'</td>'
1402: .&Apache::loncommon::end_data_table_empty_row()
1403: );
1404: }
1405: $r->print($output);
1406: }
1407: }
1408: }
1409: }
1410:
1411: sub findcourse_advice {
1412: my ($r,$cattype) = @_;
1413: my $domdesc = &Apache::lonnet::domain($env{'user.domain'},'description');
1414: my $esc_dom = &HTML::Entities::encode($env{'user.domain'},'"<>&');
1415: if (&Apache::lonnet::auto_run(undef,$env{'user.domain'})) {
1416: $r->print(&mt('If you were expecting to see an active role listed for a particular course in the [_1] domain, it may be missing for one of the following reasons:',$domdesc).'
1417: <ul>
1418: <li>'.&mt('The course has yet to be created.').'</li>
1419: <li>'.&mt('Automatic enrollment of registered students has not been enabled for the course.').'</li>
1420: <li>'.&mt('You are in a section of course for which automatic enrollment in the corresponding LON-CAPA course is not active.').'</li>
1421: <li>'.&mt('The start date for automated enrollment has yet to be reached.').'</li>
1422: <li>'.&mt('You registered for the course recently and there is a time lag between the time you register, and the time this information becomes available for the update of LON-CAPA course rosters.').'</li>
1423: </ul>');
1424: } else {
1425: $r->print(&mt('If you were expecting to see an active role listed for a particular course, that course may not have been created yet.').'<br />');
1426: }
1427: if (($cattype eq 'std') || ($cattype eq 'domonly')) {
1428: $r->print('<h3>'.&mt('Self-Enrollment').'</h3>'.
1429: '<p>'.&mt('The [_1]Course/Community Catalog[_2] provides information about all [_3] classes for which LON-CAPA courses have been created, as well as any communities in the domain.','<a href="/adm/coursecatalog?showdom='.$esc_dom.'">','</a>',$domdesc).'<br />');
1430: $r->print(&mt('You can search for courses and communities which permit self-enrollment, if you would like to enroll in one.').'</p>'.
1431: &Apache::loncoursequeueadmin::queued_selfenrollment());
1432: }
1433: return;
1434: }
1435:
1436: sub requestcourse_advice {
1437: my ($r,$cattype,$inrole) = @_;
1438: my $domdesc = &Apache::lonnet::domain($env{'user.domain'},'description');
1439: my $esc_dom = &HTML::Entities::encode($env{'user.domain'},'"<>&');
1440: my (%can_request,%request_doms,$output);
1441: &Apache::lonnet::check_can_request($env{'user.domain'},\%can_request,\%request_doms);
1442: if (keys(%request_doms) > 0) {
1443: my ($types,$typename) = &Apache::loncommon::course_types();
1444: if ((ref($types) eq 'ARRAY') && (ref($typename) eq 'HASH')) {
1445: my (@reqdoms,@reqtypes);
1446: foreach my $type (sort(keys(%request_doms))) {
1447: push(@reqtypes,$type);
1448: if (ref($request_doms{$type}) eq 'ARRAY') {
1449: my $domstr = join(', ',map { &Apache::lonnet::domain($_) } sort(@{$request_doms{$type}}));
1450: $output .=
1451: '<li>'
1452: .&mt('[_1]'.$typename->{$type}.'[_2] in domain: [_3]',
1453: '<i>',
1454: '</i>',
1455: '<b>'.$domstr.'</b>')
1456: .'</li>';
1457: foreach my $dom (@{$request_doms{$type}}) {
1458: unless (grep(/^\Q$dom\E/,@reqdoms)) {
1459: push(@reqdoms,$dom);
1460: }
1461: }
1462: }
1463: }
1464: my @showtypes;
1465: foreach my $type (@{$types}) {
1466: if (grep(/^\Q$type\E$/,@reqtypes)) {
1467: push(@showtypes,$type);
1468: }
1469: }
1470: my $requrl = '/adm/requestcourse';
1471: if (@reqdoms == 1) {
1472: $requrl .= '?showdom='.$reqdoms[0];
1473: }
1474: if (@showtypes > 0) {
1475: $requrl.=(($requrl=~/\?/)?'&':'?').'crstype='.$showtypes[0];
1476: }
1477: if (@reqdoms == 1 || @showtypes > 0) {
1478: $requrl .= '&state=crstype&action=new';
1479: }
1480: if ($output) {
1481: $r->print('<h3>'.&mt('Request creation of a course or community').'</h3>'.
1482: '<p>'.
1483: &mt('You have rights to request the creation of courses and/or communities in the following domain(s):').
1484: '<ul>'.
1485: $output.
1486: '</ul>'.
1487: &mt('Use the [_1]request form[_2] to submit a request for creation of a new course or community.',
1488: '<a href="'.$requrl.'">','</a>').
1489: '</p>');
1490: }
1491: }
1492: } elsif (!$env{'user.adv'}) {
1493: if ($inrole) {
1494: $r->print('<h3>'.&mt('Currently no additional roles, courses or communities').'</h3>');
1495: } else {
1496: $r->print('<h3>'.&mt('Currently no active roles, courses or communities').'</h3>');
1497: }
1498: &findcourse_advice($r,$cattype);
1499: }
1500: return;
1501: }
1502:
1503: sub privileges_info {
1504: my ($which) = @_;
1505: my $output;
1506:
1507: $which ||= $env{'request.role'};
1508:
1509: foreach my $envkey (sort(keys(%env))) {
1510: next if ($envkey!~/^user\.priv\.\Q$which\E\.(.*)/);
1511:
1512: my $where=$1;
1513: my $ttype;
1514: my $twhere;
1515: my (undef,$tdom,$trest,$tsec)=split(m{/},$where);
1516: if ($trest) {
1517: if ($env{'course.'.$tdom.'_'.$trest.'.description'} eq 'ca') {
1518: $ttype='Authoring Space';
1519: $twhere='User: '.$trest.', Domain: '.$tdom;
1520: } else {
1521: $ttype= &Apache::loncommon::course_type($tdom.'_'.$trest);
1522: $twhere=$env{'course.'.$tdom.'_'.$trest.'.description'};
1523: if ($tsec) {
1524: my $sec_type = 'Section';
1525: if (exists($env{"user.role.gr.$where"})) {
1526: $sec_type = 'Group';
1527: }
1528: $twhere.=' ('.$sec_type.': '.$tsec.')';
1529: }
1530: }
1531: } elsif ($tdom) {
1532: $ttype='Domain';
1533: $twhere=$tdom;
1534: } else {
1535: $ttype='System';
1536: $twhere='/';
1537: }
1538: $output .= "\n<h3>".&mt($ttype).': '.$twhere.'</h3>'."\n<ul>";
1539: foreach my $priv (sort(split(/:/,$env{$envkey}))) {
1540: next if (!$priv);
1541:
1542: my ($prv,$restr)=split(/\&/,$priv);
1543: my $trestr='';
1544: if ($restr ne 'F') {
1545: $trestr.=' ('.
1546: join(', ',
1547: map { &Apache::lonnet::plaintext($_) }
1548: (split('',$restr))).') ';
1549: }
1550: $output .= "\n\t".
1551: '<li>'.&Apache::lonnet::plaintext($prv).$trestr.'</li>';
1552: }
1553: $output .= "\n".'</ul>';
1554: }
1555: return $output;
1556: }
1557:
1558: sub build_roletext {
1559: my ($trolecode,$tdom,$trest,$tstatus,$tryagain,$advanced,$tremark,$tbg,$trole,$twhere,$tpstart,$tpend,$nochoose,$button,$switchserver,$reinit,$switchwarning) = @_;
1560: my ($roletext,$roletext_end);
1561: my $is_dc=($trolecode =~ m/^dc\./);
1562: my $rowspan=($is_dc) ? ''
1563: : ' rowspan="2" ';
1564:
1565: unless ($nochoose) {
1566: my $buttonname=$trolecode;
1567: $buttonname=~s/\W//g;
1568: if (!$button) {
1569: if ($switchserver) {
1570: $roletext.='<td'.$rowspan.' class="'.$tbg.'">'
1571: .'<a href="/adm/switchserver?'.$switchserver.'">'
1572: .&mt('Switch Server')
1573: .'</a></td>';
1574: } else {
1575: $roletext.=('<td'.$rowspan.' class="'.$tbg.'"> </td>');
1576: }
1577: if ($switchwarning) {
1578: if ($tremark eq '') {
1579: $tremark = $switchwarning;
1580: } else {
1581: $tremark .= '<br />'.$switchwarning;
1582: }
1583: }
1584: } elsif ($tstatus eq 'is') {
1585: $roletext.='<td'.$rowspan.' class="'.$tbg.'">'.
1586: '<input name="'.$buttonname.'" type="button" value="'.
1587: &mt('Select').'" onclick="javascript:enterrole(this.form,\''.
1588: $trolecode."','".$buttonname.'\');" /></td>';
1589: } elsif ($tryagain) {
1590: $roletext.=
1591: '<td'.$rowspan.' class="'.$tbg.'">'.
1592: '<input name="'.$buttonname.'" type="button" value="'.
1593: &mt('Try Selecting Again').'" onclick="javascript:enterrole(this.form,\''.
1594: $trolecode."','".$buttonname.'\');" /></td>';
1595: } elsif ($advanced) {
1596: $roletext.=
1597: '<td'.$rowspan.' class="'.$tbg.'">'.
1598: '<input name="'.$buttonname.'" type="button" value="'.
1599: &mt('Re-Initialize').'" onclick="javascript:enterrole(this.form,\''.
1600: $trolecode."','".$buttonname.'\');" /></td>';
1601: } elsif ($reinit) {
1602: $roletext.=
1603: '<td'.$rowspan.' class="'.$tbg.'">'.
1604: '<input name="'.$buttonname.'" type="button" value="'.
1605: &mt('Re-Select').'" onclick="javascript:enterrole(this.form,\''.
1606: $trolecode."','".$buttonname.'\');" /></td>';
1607: } else {
1608: $roletext.=
1609: '<td'.$rowspan.' class="'.$tbg.'">'.
1610: '<input name="'.$buttonname.'" type="button" value="'.
1611: &mt('Re-Select').'" onclick="javascript:enterrole(this.form,\''.
1612: $trolecode."','".$buttonname.'\');" /></td>';
1613: }
1614: }
1615: if ($trolecode !~ m/^(dc|ca|au|aa)\./) {
1616: $tremark.=&Apache::lonannounce::showday(time,1,
1617: &Apache::lonannounce::readcalendar($tdom.'_'.$trest));
1618: }
1619: $roletext.='<td>'.$trole.'</td>'
1620: .'<td>'.$twhere.'</td>'
1621: .'<td>'.$tpstart.'</td>'
1622: .'<td>'.$tpend.'</td>';
1623: if (!$is_dc) {
1624: $roletext_end = '<td colspan="4">'.
1625: $tremark.' '.
1626: '</td>';
1627: }
1628: return ($roletext,$roletext_end);
1629: }
1630:
1631: sub check_author_homeserver {
1632: my ($uname,$udom)=@_;
1633: if (($uname eq '') || ($udom eq '')) {
1634: return ('fail','');
1635: }
1636: my $home = &Apache::lonnet::homeserver($uname,$udom);
1637: if (&Apache::lonnet::host_domain($home) ne $udom) {
1638: return ('fail',$home);
1639: }
1640: my @ids=&Apache::lonnet::current_machine_ids();
1641: if (grep(/^\Q$home\E$/,@ids)) {
1642: return ('ok',$home);
1643: } else {
1644: return ('switchserver',$home);
1645: }
1646: }
1647:
1648: sub check_fordc {
1649: my ($dcroles,$update,$then) = @_;
1650: my $numdc = 0;
1651: if ($env{'user.adv'}) {
1652: foreach my $envkey (sort(keys(%env))) {
1653: if ($envkey=~/^user\.role\.dc\.\/($match_domain)\/$/) {
1654: my $dcdom = $1;
1655: my $livedc = 1;
1656: my ($tstart,$tend)=split(/\./,$env{$envkey});
1657: my $limit = $update;
1658: if ($env{'request.role'} eq 'dc./'.$dcdom.'/') {
1659: $limit = $then;
1660: }
1661: if ($tstart && $tstart>$limit) { $livedc = 0; }
1662: if ($tend && $tend <$limit) { $livedc = 0; }
1663: if ($livedc) {
1664: $$dcroles{$dcdom} = $envkey;
1665: $numdc++;
1666: }
1667: }
1668: }
1669: }
1670: return $numdc;
1671: }
1672:
1673: sub adhoc_course_role {
1674: my ($refresh,$update,$then) = @_;
1675: my ($cdom,$cnum,$crstype);
1676: $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
1677: $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
1678: $crstype = &Apache::loncommon::course_type();
1679: if (&check_forcc($cdom,$cnum,$refresh,$update,$then,$crstype)) {
1680: my $setprivs;
1681: if (!defined($env{'user.role.'.$env{'form.switchrole'}})) {
1682: $setprivs = 1;
1683: } else {
1684: my ($start,$end) = split(/\./,$env{'user.role.'.$env{'form.switchrole'}});
1685: if (($start && ($start>$refresh || $start == -1)) ||
1686: ($end && $end<$update)) {
1687: $setprivs = 1;
1688: }
1689: }
1690: unless ($setprivs) {
1691: if (!exists($env{'user.priv.'.$env{'form.switchrole'}.'./'})) {
1692: $setprivs = 1;
1693: }
1694: }
1695: if ($setprivs) {
1696: if ($env{'form.switchrole'} =~ m-^(in|ta|ep|ad|st|cr)(.*?)\./\Q$cdom\E/\Q$cnum\E/?(\w*)$-) {
1697: my $role = $1;
1698: my $custom_role = $2;
1699: my $usec = $3;
1700: if ($role eq 'cr') {
1701: if ($custom_role =~ m-^/$match_domain/$match_username/\w+$-) {
1702: $role .= $custom_role;
1703: } else {
1704: return;
1705: }
1706: }
1707: my (%userroles,%newrole,%newgroups,%group_privs);
1708: my %cgroups =
1709: &Apache::lonnet::get_active_groups($env{'user.domain'},
1710: $env{'user.name'},$cdom,$cnum);
1711: foreach my $group (keys(%cgroups)) {
1712: $group_privs{$group} =
1713: $env{'user.priv.cc./'.$cdom.'/'.$cnum.'./'.$cdom.'/'.$cnum.'/'.$group};
1714: }
1715: $newgroups{'/'.$cdom.'/'.$cnum} = \%group_privs;
1716: my $area = '/'.$cdom.'/'.$cnum;
1717: my $spec = $role.'.'.$area;
1718: if ($usec ne '') {
1719: $spec .= '/'.$usec;
1720: $area .= '/'.$usec;
1721: }
1722: if ($role =~ /^cr/) {
1723: &Apache::lonnet::custom_roleprivs(\%newrole,$role,$cdom,$cnum,$spec,$area);
1724: } else {
1725: &Apache::lonnet::standard_roleprivs(\%newrole,$role,$cdom,$spec,$cnum,$area);
1726: }
1727: &Apache::lonnet::set_userprivs(\%userroles,\%newrole,\%newgroups);
1728: my $adhocstart = $refresh-1;
1729: $userroles{'user.role.'.$spec} = $adhocstart.'.';
1730: &Apache::lonnet::appenv(\%userroles,[$role,'cm']);
1731: }
1732: }
1733: }
1734: return;
1735: }
1736:
1737: sub check_forcc {
1738: my ($cdom,$cnum,$refresh,$update,$then,$crstype) = @_;
1739: my ($is_cc,$ccrole);
1740: if ($crstype eq 'Community') {
1741: $ccrole = 'co';
1742: } else {
1743: $ccrole = 'cc';
1744: }
1745: if (&Apache::lonnet::is_course($cdom,$cnum)) {
1746: my $envkey = 'user.role.'.$ccrole.'./'.$cdom.'/'.$cnum;
1747: if (defined($env{$envkey})) {
1748: $is_cc = 1;
1749: my ($tstart,$tend)=split(/\./,$env{$envkey});
1750: my $limit = $update;
1751: if ($env{'request.role'} eq $ccrole.'./'.$cdom.'/'.$cnum) {
1752: $limit = $then;
1753: }
1754: if ($tstart && $tstart>$refresh) { $is_cc = 0; }
1755: if ($tend && $tend <$limit) { $is_cc = 0; }
1756: }
1757: }
1758: return $is_cc;
1759: }
1760:
1761: sub courselink {
1762: my ($dcdom,$rowtype) = @_;
1763: my $courseform=&Apache::loncommon::selectcourse_link
1764: ('rolechoice','dccourse'.$rowtype.'_'.$dcdom,
1765: 'dcdomain'.$rowtype.'_'.$dcdom,'coursedesc'.$rowtype.'_'.
1766: $dcdom,$dcdom,undef,'Course/Community');
1767: my $hiddenitems = '<input type="hidden" name="dcdomain'.$rowtype.'_'.$dcdom.'" value="'.$dcdom.'" />'.
1768: '<input type="hidden" name="origdom'.$rowtype.'_'.$dcdom.'" value="'.$dcdom.'" />'.
1769: '<input type="hidden" name="dccourse'.$rowtype.'_'.$dcdom.'" value="" />'.
1770: '<input type="hidden" name="coursedesc'.$rowtype.'_'.$dcdom.'" value="" />';
1771: return $courseform.$hiddenitems;
1772: }
1773:
1774: sub coursepick_jscript {
1775: my %js_lt = &Apache::lonlocal::texthash(
1776: plsu => "Please use the 'Select Course/Community' link to open a separate pick course window where you may select the course or community you wish to enter.",
1777: youc => 'You can only use this screen to select courses and communities in the current domain.',
1778: );
1779: &js_escape(\%js_lt);
1780: my $verify_script = <<"END";
1781: <script type="text/javascript">
1782: // <![CDATA[
1783: function verifyCoursePick(caller) {
1784: var numbutton = getIndex(caller)
1785: var pickedCourse = document.rolechoice.elements[numbutton+4].value
1786: var pickedDomain = document.rolechoice.elements[numbutton+2].value
1787: if (document.rolechoice.elements[numbutton+2].value == document.rolechoice.elements[numbutton+3].value) {
1788: if (pickedCourse != '') {
1789: if (numbutton != -1) {
1790: var courseTarget = "cc./"+pickedDomain+"/"+pickedCourse
1791: document.rolechoice.elements[numbutton+1].name = courseTarget
1792: document.rolechoice.submit()
1793: }
1794: }
1795: else {
1796: alert("$js_lt{'plsu'}");
1797: }
1798: }
1799: else {
1800: alert("$js_lt{'youc'}")
1801: }
1802: }
1803: function getIndex(caller) {
1804: for (var i=0;i<document.rolechoice.elements.length;i++) {
1805: if (document.rolechoice.elements[i] == caller) {
1806: return i;
1807: }
1808: }
1809: return -1;
1810: }
1811: // ]]>
1812: </script>
1813: END
1814: return $verify_script;
1815: }
1816:
1817: sub coauthorlink {
1818: my ($dcdom,$rowtype) = @_;
1819: my $coauthorform=&Apache::loncommon::selectauthor_link('rolechoice',$dcdom);
1820: my $hiddenitems = '<input type="hidden" name="adhoccauname'.$rowtype.'_'.$dcdom.'" value="" />';
1821: return $coauthorform.$hiddenitems;
1822: }
1823:
1824: sub display_cc_role {
1825: my $rolekey = shift;
1826: my ($roletext,$roletext_end);
1827: my $advanced = $env{'user.adv'};
1828: my $tryagain = $env{'form.tryagain'};
1829: unless ($rolekey =~/^error\:/) {
1830: if ($rolekey =~ m{^user\.role\.(cc|co)\./($match_domain)/($match_courseid)$}) {
1831: my $ccrole = $1;
1832: my $tdom = $2;
1833: my $trest = $3;
1834: my $tcourseid = $tdom.'_'.$trest;
1835: my $trolecode = $ccrole.'./'.$tdom.'/'.$trest;
1836: my $twhere;
1837: my $ttype;
1838: my $tbg='LC_roles_is';
1839: my %newhash=&Apache::lonnet::coursedescription($tcourseid);
1840: if (%newhash) {
1841: $twhere=$newhash{'description'}.
1842: ' <span class="LC_fontsize_small">'.
1843: &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$trest,$tdom).
1844: '</span>';
1845: $ttype = $newhash{'type'};
1846: } else {
1847: $twhere=&mt('Currently not available');
1848: $env{'course.'.$tcourseid.'.description'}=$twhere;
1849: }
1850: my $trole = &Apache::lonnet::plaintext($ccrole,$ttype,$tcourseid);
1851: $twhere.="<br />".&mt('Domain').":".$tdom;
1852: ($roletext,$roletext_end) = &build_roletext($trolecode,$tdom,$trest,'is',$tryagain,$advanced,'',$tbg,$trole,$twhere,'','','',1,'');
1853: }
1854: }
1855: return ($roletext,$roletext_end);
1856: }
1857:
1858: sub adhoc_roles_row {
1859: my ($dcdom,$rowtype) = @_;
1860: my $output = &Apache::loncommon::continue_data_table_row()
1861: .' <td colspan="5" class="LC_textsize_mobile">'
1862: .&mt('[_1]Ad hoc[_2] roles in domain [_3] --'
1863: ,'<span class="LC_cusr_emph">','</span>',$dcdom)
1864: .' ';
1865: my $selectcclink = &courselink($dcdom,$rowtype);
1866: my $ccrole = &Apache::lonnet::plaintext('co',undef,undef,1);
1867: my $carole = &Apache::lonnet::plaintext('ca');
1868: my $selectcalink = &coauthorlink($dcdom,$rowtype);
1869: $output.=$ccrole.': '.$selectcclink
1870: .' | '.$carole.': '.$selectcalink.'</td>'
1871: .&Apache::loncommon::end_data_table_row();
1872: return $output;
1873: }
1874:
1875: sub recent_filename {
1876: my $area=shift;
1877: return 'nohist_recent_'.&escape($area);
1878: }
1879:
1880: sub courseloadpage {
1881: my ($courseid) = @_;
1882: my $startpage;
1883: my %entry_settings = &Apache::lonnet::get('nohist_whatsnew',
1884: [$courseid.':courseinit']);
1885: my ($tmp) = %entry_settings;
1886: unless ($tmp =~ /^error: 2 /) {
1887: $startpage = $entry_settings{$courseid.':courseinit'};
1888: }
1889: if ($startpage eq '') {
1890: if (exists($env{'environment.course_init_display'})) {
1891: $startpage = $env{'environment.course_init_display'};
1892: }
1893: }
1894: return $startpage;
1895: }
1896:
1897: sub update_session_roles {
1898: my $then=$env{'user.login.time'};
1899: my $refresh=$env{'user.refresh.time'};
1900: if (!$refresh) {
1901: $refresh = $then;
1902: }
1903: my $update = $env{'user.update.time'};
1904: if (!$update) {
1905: $update = $then;
1906: }
1907: my $now = time;
1908: my %roleshash =
1909: &Apache::lonnet::get_my_roles('','','userroles',
1910: ['active','future','previous'],
1911: undef,undef,1);
1912: my ($msg,@newsec,$oldsec,$currrole_expired,@changed_roles,
1913: %changed_groups,%dbroles,%deletedroles,%allroles,%allgroups,
1914: %userroles,%checkedgroup,%crprivs,$hasgroups,%rolechange,
1915: %groupchange,%newrole,%newgroup,%customprivchg,%groups_roles,
1916: @rolecodes);
1917: my @possroles = ('cr','st','ta','ad','ep','in','co','cc');
1918: my %courseroles;
1919: foreach my $item (keys(%roleshash)) {
1920: my ($uname,$udom,$role,$remainder) = split(/:/,$item,4);
1921: my ($tstart,$tend) = split(/:/,$roleshash{$item});
1922: my ($section,$group,@group_privs);
1923: if ($role =~ m{^gr/(\w*)$}) {
1924: $role = 'gr';
1925: my $priv = $1;
1926: next if ($tstart eq '-1');
1927: if (&curr_role_status($tstart,$tend,$refresh,$now) eq 'active') {
1928: if ($priv ne '') {
1929: push(@group_privs,$priv);
1930: }
1931: }
1932: if ($remainder =~ /:/) {
1933: (my $additional_privs,$group) =
1934: ($remainder =~ /^([\w:]+):([^:]+)$/);
1935: if ($additional_privs ne '') {
1936: if (&curr_role_status($tstart,$tend,$refresh,$now) eq 'active') {
1937: push(@group_privs,split(/:/,$additional_privs));
1938: @group_privs = sort(@group_privs);
1939: }
1940: }
1941: } else {
1942: $group = $remainder;
1943: }
1944: } else {
1945: $section = $remainder;
1946: }
1947: my $where = "/$udom/$uname";
1948: if ($section ne '') {
1949: $where .= "/$section";
1950: } elsif ($group ne '') {
1951: $where .= "/$group";
1952: }
1953: my $rolekey = "$role.$where";
1954: my $envkey = "user.role.$rolekey";
1955: $dbroles{$envkey} = 1;
1956: if (($env{'request.role'} eq $rolekey) && ($role ne 'st')) {
1957: if (&curr_role_status($tstart,$tend,$refresh,$now) ne 'active') {
1958: $currrole_expired = 1;
1959: }
1960: }
1961: if ($env{$envkey} eq '') {
1962: my $status_in_db =
1963: &curr_role_status($tstart,$tend,$now,$now);
1964: &gather_roleprivs(\%allroles,\%allgroups,\%userroles,$where,$role,$tstart,$tend,$status_in_db);
1965: if (($role eq 'st') && ($env{'request.role'} =~ m{^\Q$role\E\.\Q/$udom/$uname\E})) {
1966: if ($status_in_db eq 'active') {
1967: if ($section eq '') {
1968: push(@newsec,'none');
1969: } else {
1970: push(@newsec,$section);
1971: }
1972: }
1973: } else {
1974: unless (grep(/^\Q$role\E$/,@changed_roles)) {
1975: push(@changed_roles,$role);
1976: }
1977: if ($status_in_db ne 'previous') {
1978: if ($role eq 'gr') {
1979: $newgroup{$rolekey} = $status_in_db;
1980: if ($status_in_db eq 'active') {
1981: unless (ref($courseroles{$udom}) eq 'HASH') {
1982: %{$courseroles{$udom}} =
1983: &Apache::lonnet::get_my_roles('','','userroles',
1984: ['active'],\@possroles,
1985: [$udom],1);
1986: }
1987: &Apache::lonnet::get_groups_roles($udom,$uname,
1988: $courseroles{$udom},
1989: \@rolecodes,\%groups_roles);
1990: }
1991: } else {
1992: $newrole{$rolekey} = $status_in_db;
1993: }
1994: }
1995: }
1996: } else {
1997: my ($currstart,$currend) = split(/\./,$env{$envkey});
1998: if ($role eq 'gr') {
1999: if (&curr_role_status($currstart,$currend,$refresh,$update) ne 'previous') {
2000: $hasgroups = 1;
2001: }
2002: }
2003: if (($currstart ne $tstart) || ($currend ne $tend)) {
2004: my $status_in_env =
2005: &curr_role_status($currstart,$currend,$refresh,$update);
2006: my $status_in_db =
2007: &curr_role_status($tstart,$tend,$now,$now);
2008: if ($status_in_env ne $status_in_db) {
2009: if ($status_in_env eq 'active') {
2010: if ($role eq 'st') {
2011: if ($env{'request.role'} eq $rolekey) {
2012: my $switchsection;
2013: unless (ref($courseroles{$udom}) eq 'HASH') {
2014: %{$courseroles{$udom}} =
2015: &Apache::lonnet::get_my_roles('','','userroles',
2016: ['active'],
2017: \@possroles,[$udom],1);
2018: }
2019: foreach my $crsrole (keys(%{$courseroles{$udom}})) {
2020: if ($crsrole =~ /^\Q$uname\E:\Q$udom\E:st/) {
2021: $switchsection = 1;
2022: last;
2023: }
2024: }
2025: if ($switchsection) {
2026: if ($section eq '') {
2027: $oldsec = 'none';
2028: } else {
2029: $oldsec = $section;
2030: }
2031: &gather_roleprivs(\%allroles,\%allgroups,\%userroles,$where,$role,$tstart,$tend,$status_in_db);
2032: } else {
2033: $currrole_expired = 1;
2034: next;
2035: }
2036: }
2037: }
2038: unless ($rolekey eq $env{'request.role'}) {
2039: if ($role eq 'gr') {
2040: &Apache::lonnet::delete_env_groupprivs($where,\%courseroles,\@possroles);
2041: } else {
2042: &Apache::lonnet::delenv("user.priv.$rolekey",undef,[$role]);
2043: &Apache::lonnet::delenv("user.priv.cm.$where",undef,['cm']);
2044: }
2045: &gather_roleprivs(\%allroles,\%allgroups,\%userroles,$where,$role,$tstart,$tend,$status_in_db);
2046: }
2047: } elsif ($status_in_db eq 'active') {
2048: if (($role eq 'st') &&
2049: ($env{'request.role'} =~ m{^\Q$role\E\.\Q/$udom/$uname\E})) {
2050: if ($section eq '') {
2051: push(@newsec,'none');
2052: } else {
2053: push(@newsec,$section);
2054: }
2055: } elsif ($role eq 'gr') {
2056: unless (ref($courseroles{$udom}) eq 'HASH') {
2057: %{$courseroles{$udom}} =
2058: &Apache::lonnet::get_my_roles('','','userroles',
2059: ['active'],
2060: \@possroles,[$udom],1);
2061: }
2062: &Apache::lonnet::get_groups_roles($udom,$uname,
2063: $courseroles{$udom},
2064: \@rolecodes,\%groups_roles);
2065: }
2066: &gather_roleprivs(\%allroles,\%allgroups,\%userroles,$where,$role,$tstart,$tend,$status_in_db);
2067: }
2068: unless (grep(/^\Q$role\E$/,@changed_roles)) {
2069: push(@changed_roles,$role);
2070: }
2071: if ($role eq 'gr') {
2072: $groupchange{"/$udom/$uname"}{$group} = $status_in_db;
2073: } else {
2074: $rolechange{$rolekey} = $status_in_db;
2075: }
2076: }
2077: } else {
2078: if ($role eq 'gr') {
2079: unless ($checkedgroup{$where}) {
2080: my $status_in_db =
2081: &curr_role_status($tstart,$tend,$refresh,$now);
2082: if ($tstart eq '-1') {
2083: $status_in_db = 'deleted';
2084: }
2085: unless (ref($courseroles{$udom}) eq 'HASH') {
2086: %{$courseroles{$udom}} =
2087: &Apache::lonnet::get_my_roles('','','userroles',
2088: ['active'],
2089: \@possroles,[$udom],1);
2090: }
2091: if (ref($courseroles{$udom}) eq 'HASH') {
2092: foreach my $item (keys(%{$courseroles{$udom}})) {
2093: next unless ($item =~ /^\Q$uname\E/);
2094: my ($cnum,$cdom,$crsrole,$crssec) = split(/:/,$item);
2095: my $area = '/'.$cdom.'/'.$cnum;
2096: if ($crssec ne '') {
2097: $area .= '/'.$crssec;
2098: }
2099: my $crsrolekey = $crsrole.'.'.$area;
2100: my $currprivs = $env{'user.priv.'.$crsrole.'.'.$area.'.'.$where};
2101: $currprivs =~ s/^://;
2102: $currprivs =~ s/\&F$//;
2103: my @curr_grp_privs = split(/\&F:/,$currprivs);
2104: @curr_grp_privs = sort(@curr_grp_privs);
2105: my @diffs;
2106: if (@group_privs > 0 || @curr_grp_privs > 0) {
2107: @diffs = &Apache::loncommon::compare_arrays(\@group_privs,\@curr_grp_privs);
2108: }
2109: if (@diffs == 0) {
2110: last;
2111: } else {
2112: unless(grep(/^\Qgr\E$/,@rolecodes)) {
2113: push(@rolecodes,'gr');
2114: }
2115: &gather_roleprivs(\%allroles,\%allgroups,
2116: \%userroles,$where,$role,
2117: $tstart,$tend,$status_in_db);
2118: if ($status_in_db eq 'active') {
2119: &Apache::lonnet::get_groups_roles($udom,$uname,
2120: $courseroles{$udom},
2121: \@rolecodes,\%groups_roles);
2122: }
2123: $changed_groups{$udom.'_'.$uname}{$group} = $status_in_db;
2124: last;
2125: }
2126: }
2127: }
2128: $checkedgroup{$where} = 1;
2129: }
2130: } elsif ($role =~ /^cr/) {
2131: my $status_in_db =
2132: &curr_role_status($tstart,$tend,$refresh,$now);
2133: my ($rdummy,$rest) = split(/\//,$role,2);
2134: my %currpriv;
2135: unless (exists($crprivs{$rest})) {
2136: my ($rdomain,$rauthor,$rrole)=split(/\//,$rest);
2137: my $homsvr=&Apache::lonnet::homeserver($rauthor,$rdomain);
2138: if (&Apache::lonnet::hostname($homsvr) ne '') {
2139: my ($rdummy,$roledef)=
2140: &Apache::lonnet::get('roles',["rolesdef_$rrole"],
2141: $rdomain,$rauthor);
2142: if (($rdummy ne 'con_lost') && ($roledef ne '')) {
2143: my $i = 0;
2144: my @scopes = ('sys','dom','crs');
2145: my @privs = split(/\_/,$roledef);
2146: foreach my $priv (@privs) {
2147: my ($blank,@prv) = split(/:/,$priv);
2148: @prv = map { $_ .= (/\&\w+$/ ? '':'&F') } @prv;
2149: if (@prv) {
2150: $priv = ':'.join(':',sort(@prv));
2151: }
2152: $crprivs{$rest}{$scopes[$i]} = $priv;
2153: $i++;
2154: }
2155: }
2156: }
2157: }
2158: my $status_in_env =
2159: &curr_role_status($currstart,$currend,$refresh,$update);
2160: if ($status_in_env eq 'active') {
2161: $currpriv{sys} = $env{"user.priv.$rolekey./"};
2162: $currpriv{dom} = $env{"user.priv.$rolekey./$udom/"};
2163: $currpriv{crs} = $env{"user.priv.$rolekey.$where"};
2164: if (keys(%crprivs)) {
2165: if (($crprivs{$rest}{sys} ne $currpriv{sys}) ||
2166: ($crprivs{$rest}{dom} ne $currpriv{dom})
2167: ||
2168: ($crprivs{$rest}{crs} ne $currpriv{crs})) {
2169: &gather_roleprivs(\%allroles,\%allgroups,
2170: \%userroles,$where,$role,
2171: $tstart,$tend,$status_in_db);
2172: unless (grep(/^\Q$role\E$/,@changed_roles)) {
2173: push(@changed_roles,$role);
2174: }
2175: $customprivchg{$rolekey} = $status_in_env;
2176: }
2177: }
2178: }
2179: }
2180: }
2181: }
2182: }
2183: foreach my $envkey (keys(%env)) {
2184: next unless ($envkey =~ /^user\.role\./);
2185: next if ($dbroles{$envkey});
2186: next if ($envkey eq 'user.role.'.$env{'request.role'});
2187: my ($currstart,$currend) = split(/\./,$env{$envkey});
2188: my $status_in_env =
2189: &curr_role_status($currstart,$currend,$refresh,$update);
2190: my ($rolekey) = ($envkey =~ /^user\.role\.(.+)$/);
2191: my ($role,$rest)=split(m{\./},$rolekey,2);
2192: $rest = '/'.$rest;
2193: if (&Apache::lonnet::delenv($envkey,undef,[$role])) {
2194: if ($status_in_env eq 'active') {
2195: if ($role eq 'gr') {
2196: &Apache::lonnet::delete_env_groupprivs($rest,\%courseroles,
2197: \@possroles);
2198: } else {
2199: &Apache::lonnet::delenv("user.priv.$rolekey",undef,[$role]);
2200: &Apache::lonnet::delenv("user.priv.cm.$rest",undef,['cm']);
2201: }
2202: unless (grep(/^\Q$role\E$/,@changed_roles)) {
2203: push(@changed_roles,$role);
2204: }
2205: $deletedroles{$rolekey} = 1;
2206: }
2207: }
2208: }
2209: if (($oldsec) && (@newsec > 0)) {
2210: if (@newsec > 1) {
2211: $msg = '<p class="LC_warning">'.&mt('The section has changed for your current role. Log-out and log-in again to select a role for the new section.').'</p>';
2212: } else {
2213: my $newrole = $env{'request.role'};
2214: if ($newsec[0] eq 'none') {
2215: $newrole =~ s{(/[^/])$}{};
2216: } elsif ($oldsec eq 'none') {
2217: $newrole .= '/'.$newsec[0];
2218: } else {
2219: $newrole =~ s{([^/]+)$}{$newsec[0]};
2220: }
2221: my $coursedesc = $env{'course.'.$env{'request.course.id'}.'.description'};
2222: my ($curr_role) = ($env{'request.role'} =~ m{^(\w+)\./$match_domain/$match_courseid});
2223: my %temp=('logout_'.$env{'request.course.id'} => time);
2224: &Apache::lonnet::put('email_status',\%temp);
2225: &Apache::lonnet::delenv('user.state.'.$env{'request.course.id'});
2226: &Apache::lonnet::appenv({"request.course.id" => '',
2227: "request.course.fn" => '',
2228: "request.course.uri" => '',
2229: "request.course.sec" => '',
2230: "request.role" => 'cm',
2231: "request.role.adv" => $env{'user.adv'},
2232: "request.role.domain" => $env{'user.domain'}});
2233: my $rolename = &Apache::loncommon::plainname($curr_role);
2234: $msg = '<p><form name="reselectrole" action="/adm/roles" method="post" />'.
2235: '<input type="hidden" name="newrole" value="" />'.
2236: '<input type="hidden" name="selectrole" value="1" />'.
2237: '<span class="LC_info">'.
2238: &mt('Your section has changed for your current [_1] role in [_2].',$rolename,$coursedesc).'</span><br />';
2239: my $button = '<input type="button" name="sectionchanged" value="'.
2240: &mt('Re-Select').'" onclick="javascript:enterrole(this.form,'."'$newrole','sectionchanged'".')" />';
2241: if ($newsec[0] eq 'none') {
2242: $msg .= &mt('[_1] to continue with your new section-less role.',$button);
2243: } else {
2244: $msg .= &mt('[_1] to continue with your new role in section ([_2]).',$button,$newsec[0]);
2245: }
2246: $msg .= '</form></p>';
2247: }
2248: } elsif ($currrole_expired) {
2249: $msg .= '<p class="LC_warning">';
2250: if (&Apache::loncommon::show_course()) {
2251: $msg .= &mt('Your role in the current course has expired.');
2252: } else {
2253: $msg .= &mt('Your current role has expired.');
2254: }
2255: $msg .= '<br />'.&mt('However you can continue to use this role until you logout, click the "Re-Select" button, or your session has been idle for more than 24 hours.').'</p>';
2256: }
2257: &Apache::lonnet::set_userprivs(\%userroles,\%allroles,\%allgroups,\%groups_roles);
2258: my ($curr_is_adv,$curr_role_adv,$curr_author,$curr_role_author);
2259: $curr_author = $env{'user.author'};
2260: if (($env{'request.role'} =~/^au/) || ($env{'request.role'} =~/^ca/) ||
2261: ($env{'request.role'} =~/^aa/)) {
2262: $curr_role_author=1;
2263: }
2264: $curr_is_adv = $env{'user.adv'};
2265: $curr_role_adv = $env{'request.role.adv'};
2266: if (keys(%userroles) > 0) {
2267: foreach my $role (@changed_roles) {
2268: unless(grep(/^\Q$role\E$/,@rolecodes)) {
2269: push(@rolecodes,$role);
2270: }
2271: }
2272: unless(grep(/^\Qcm\E$/,@rolecodes)) {
2273: push(@rolecodes,'cm');
2274: }
2275: &Apache::lonnet::appenv(\%userroles,\@rolecodes);
2276: }
2277: my %newenv;
2278: if (&Apache::lonnet::is_advanced_user($env{'user.domain'},$env{'user.name'})) {
2279: unless ($curr_is_adv) {
2280: $newenv{'user.adv'} = 1;
2281: }
2282: } elsif ($curr_is_adv && !$curr_role_adv) {
2283: &Apache::lonnet::delenv('user.adv');
2284: }
2285: my %authorroleshash =
2286: &Apache::lonnet::get_my_roles('','','userroles',['active'],['au','ca','aa']);
2287: if (keys(%authorroleshash)) {
2288: unless ($curr_author) {
2289: $newenv{'user.author'} = 1;
2290: }
2291: } elsif ($curr_author && !$curr_role_author) {
2292: &Apache::lonnet::delenv('user.author');
2293: }
2294: if ($env{'request.course.id'}) {
2295: my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
2296: my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
2297: my (@activecrsgroups,$crsgroupschanged);
2298: if ($env{'request.course.groups'}) {
2299: @activecrsgroups = split(/:/,$env{'request.course.groups'});
2300: foreach my $item (keys(%deletedroles)) {
2301: if ($item =~ m{^gr\./\Q$cdom\E/\Q$cnum\E/(\w+)$}) {
2302: if (grep(/^\Q$1\E$/,@activecrsgroups)) {
2303: $crsgroupschanged = 1;
2304: last;
2305: }
2306: }
2307: }
2308: }
2309: unless ($crsgroupschanged) {
2310: foreach my $item (keys(%newgroup)) {
2311: if ($item =~ m{^gr\./\Q$cdom\E/\Q$cnum\E/(\w+)$}) {
2312: if ($newgroup{$item} eq 'active') {
2313: $crsgroupschanged = 1;
2314: last;
2315: }
2316: }
2317: }
2318: }
2319: if ((ref($changed_groups{$env{'request.course.id'}}) eq 'HASH') ||
2320: (ref($groupchange{"/$cdom/$cnum"}) eq 'HASH') ||
2321: ($crsgroupschanged)) {
2322: my %grouproles = &Apache::lonnet::get_my_roles('','','userroles',
2323: ['active'],['gr'],[$cdom],1);
2324: my @activegroups;
2325: foreach my $item (keys(%grouproles)) {
2326: next unless($item =~ /^\Q$cnum\E:\Q$cdom\E/);
2327: my $group;
2328: my ($crsn,$crsd,$role,$remainder) = split(/:/,$item,4);
2329: if ($remainder =~ /:/) {
2330: (my $other,$group) = ($remainder =~ /^([\w:]+):([^:]+)$/);
2331: } else {
2332: $group = $remainder;
2333: }
2334: if ($group ne '') {
2335: push(@activegroups,$group);
2336: }
2337: }
2338: $newenv{'request.course.groups'} = join(':',@activegroups);
2339: }
2340: }
2341: if (keys(%newenv)) {
2342: &Apache::lonnet::appenv(\%newenv);
2343: }
2344: if (!@changed_roles || !(keys(%changed_groups))) {
2345: my ($rolesmsg,$groupsmsg);
2346: if (!@changed_roles) {
2347: if (&Apache::loncommon::show_course()) {
2348: $rolesmsg = &mt('No new courses or communities');
2349: } else {
2350: $rolesmsg = &mt('No role changes');
2351: }
2352: }
2353: if ($hasgroups && !(keys(%changed_groups)) && !(grep(/gr/,@changed_roles))) {
2354: $groupsmsg = &mt('No changes in course/community groups');
2355: }
2356: if (!@changed_roles && !(keys(%changed_groups))) {
2357: if (($msg ne '') || ($groupsmsg ne '')) {
2358: $msg .= '<ul>';
2359: if ($rolesmsg) {
2360: $msg .= '<li>'.$rolesmsg.'</li>';
2361: }
2362: if ($groupsmsg) {
2363: $msg .= '<li>'.$groupsmsg.'</li>';
2364: }
2365: $msg .= '</ul>';
2366: } else {
2367: $msg = ' <span class="LC_cusr_emph">'.$rolesmsg.'</span><br />';
2368: }
2369: return $msg;
2370: }
2371: }
2372: my $changemsg;
2373: if (@changed_roles > 0) {
2374: if (keys(%newgroup) > 0) {
2375: my $groupmsg;
2376: my (%curr_groups,%groupdescs,$currcrs);
2377: foreach my $item (sort(keys(%newgroup))) {
2378: if (&is_active_course($item,$refresh,$update,\%roleshash)) {
2379: if ($item =~ m{^gr\./($match_domain/$match_courseid)/(\w+)$}) {
2380: my ($cdom,$cnum) = split(/\//,$1);
2381: my $group = $2;
2382: if ($currcrs ne $cdom.'_'.$cnum) {
2383: if ($currcrs) {
2384: $groupmsg .= '</ul><li>';
2385: }
2386: $groupmsg .= '<li><b>'.
2387: $env{'course.'.$cdom.'_'.$cnum.'.description'}.'</b><ul>';
2388: $currcrs = $cdom.'_'.$cnum;
2389: }
2390: my $groupdesc;
2391: unless (ref($curr_groups{$cdom.'_'.$cnum}) eq 'HASH') {
2392: %{$curr_groups{$cdom.'_'.$cnum}} =
2393: &Apache::longroup::coursegroups($cdom,$cnum);
2394: }
2395: unless ((ref($groupdescs{$cdom.'_'.$cnum}) eq 'HASH') &&
2396: ($groupdescs{$cdom.'_'.$cnum}{$group})) {
2397:
2398: my %groupinfo =
2399: &Apache::longroup::get_group_settings($curr_groups{$cdom.'_'.$cnum}{$group});
2400: $groupdescs{$cdom.'_'.$cnum}{$group} =
2401: &unescape($groupinfo{'description'});
2402: }
2403: $groupdesc = $groupdescs{$cdom.'_'.$cnum}{$group};
2404: if ($groupdesc) {
2405: $groupmsg .= '<li>'.
2406: &mt('[_1] with status: [_2].',
2407: '<b>'.$groupdesc.'</b>',$newgroup{$item}).'</li>';
2408: }
2409: }
2410: }
2411: if ($groupmsg) {
2412: $groupmsg .= '</ul></li>';
2413: }
2414: }
2415: if ($groupmsg) {
2416: $changemsg .= '<li>'.
2417: &mt('Courses with new groups').'</li>'.
2418: '<ul>'.$groupmsg.'</ul></li>';
2419: }
2420: }
2421: if (keys(%newrole) > 0) {
2422: my $newmsg;
2423: foreach my $item (sort(keys(%newrole))) {
2424: my $desc = &role_desc($item,$update,$refresh,$now);
2425: if ($desc) {
2426: $newmsg .= '<li>'.
2427: &mt('[_1] with status: [_2].',
2428: $desc,&mt($newrole{$item})).'</li>';
2429: }
2430: }
2431: if ($newmsg) {
2432: $changemsg .= '<li>'.&mt('New roles').
2433: '<ul>'.$newmsg.'</ul>'.
2434: '</li>';
2435: }
2436: }
2437: if (keys(%customprivchg) > 0) {
2438: my $privmsg;
2439: foreach my $item (sort(keys(%customprivchg))) {
2440: my $desc = &role_desc($item,$update,$refresh,$now);
2441: if ($desc) {
2442: $privmsg .= '<li>'.$desc.'</li>';
2443: }
2444: }
2445: if ($privmsg) {
2446: $changemsg .= '<li>'.
2447: &mt('Custom roles with privilege changes').
2448: '<ul>'.$privmsg.'</ul>'.
2449: '</li>';
2450: }
2451: }
2452: if (keys(%rolechange) > 0) {
2453: my $rolemsg;
2454: foreach my $item (sort(keys(%rolechange))) {
2455: my $desc = &role_desc($item,$update,$refresh,$now);
2456: if ($desc) {
2457: $rolemsg .= '<li>'.
2458: &mt('[_1] status now: [_2].',$desc,
2459: $rolechange{$item}).'</li>';
2460: }
2461: }
2462: if ($rolemsg) {
2463: $changemsg .= '<li>'.
2464: &mt('Existing roles with status changes').'</li>'.
2465: '<ul>'.$rolemsg.'</ul>'.
2466: '</li>';
2467: }
2468: }
2469: if (keys(%deletedroles) > 0) {
2470: my $delmsg;
2471: foreach my $item (sort(keys(%deletedroles))) {
2472: my $desc = &role_desc($item,$update,$refresh,$now);
2473: if ($desc) {
2474: $delmsg .= '<li>'.$desc.'</li>';
2475: }
2476: }
2477: if ($delmsg) {
2478: $changemsg .= '<li>'.
2479: &mt('Existing roles now expired').'</li>'.
2480: '<ul>'.$delmsg.'</ul>'.
2481: '</li>';
2482: }
2483: }
2484: }
2485: if ((keys(%changed_groups) > 0) || (keys(%groupchange) > 0)) {
2486: my $groupchgmsg;
2487: foreach my $key (sort(keys(%changed_groups))) {
2488: my $crs = 'gr/'.$key;
2489: $crs =~ s/_/\//;
2490: if (&is_active_course($crs,$refresh,$update,\%roleshash)) {
2491: if (ref($changed_groups{$key}) eq 'HASH') {
2492: my @showgroups;
2493: foreach my $group (sort(keys(%{$changed_groups{$key}}))) {
2494: if ($changed_groups{$key}{$group} eq 'active') {
2495: push(@showgroups,$group);
2496: }
2497: }
2498: if (@showgroups > 0) {
2499: $groupchgmsg .= '<li>'.
2500: &mt('Course: [_1], groups: [_2].',$key,
2501: join(', ',@showgroups)).
2502: '</li>';
2503: }
2504: }
2505: }
2506: }
2507: if (keys(%groupchange) > 0) {
2508: $groupchgmsg .= '<li>'.
2509: &mt('Existing course/community groups with status changes').'</li>'.
2510: '<ul>';
2511: foreach my $crs (sort(keys(%groupchange))) {
2512: my $cid = $crs;
2513: $cid=~s{^/}{};
2514: $cid=~s{/}{_};
2515: my $crsdesc = $env{'course.'.$cid.'.description'};
2516: my $cdom = $env{'course.'.$cid.'.domain'};
2517: my $cnum = $env{'course.'.$cid.'.num'};
2518: my %curr_groups = &Apache::longroup::coursegroups($cdom,$cnum);
2519: my %groupdesc;
2520: if (ref($groupchange{$crs}) eq 'HASH') {
2521: $groupchgmsg .= '<li>'.&mt('Course/Community: [_1]','<b>'.$crsdesc.'</b><ul>');
2522: foreach my $group (sort(keys(%{$groupchange{$crs}}))) {
2523: unless ($groupdesc{$group}) {
2524: my %groupinfo = &Apache::longroup::get_group_settings($curr_groups{$group});
2525: $groupdesc{$group} = &unescape($groupinfo{'description'});
2526: }
2527: $groupchgmsg .= '<li>'.&mt('Group: [_1] status now: [_2].','<b>'.$groupdesc{$group}.'</b>',$groupchange{$crs}{$group}).'</li>';
2528: }
2529: $groupchgmsg .= '</ul></li>';
2530: }
2531: }
2532: $groupchgmsg .= '</ul></li>';
2533: }
2534: if ($groupchgmsg) {
2535: $changemsg .= '<li>'.
2536: &mt('Courses with changes in groups').'</li>'.
2537: '<ul>'.$groupchgmsg.'</ul></li>';
2538: }
2539: }
2540: if ($changemsg) {
2541: $msg .= '<ul>'.$changemsg.'</ul>';
2542: } else {
2543: if (&Apache::loncommon::show_course()) {
2544: $msg = &mt('No new courses or communities');
2545: } else {
2546: $msg = &mt('No role changes');
2547: }
2548: }
2549: return $msg;
2550: }
2551:
2552: sub role_desc {
2553: my ($item,$update,$refresh,$now) = @_;
2554: my ($where,$trolecode,$role,$tstatus,$tend,$tstart,$twhere,
2555: $trole,$tremark);
2556: &Apache::lonnet::role_status('user.role.'.$item,$update,$refresh,
2557: $now,\$role,\$where,\$trolecode,
2558: \$tstatus,\$tstart,\$tend);
2559: return unless ($role);
2560: if ($role =~ /^cr\//) {
2561: my ($rdummy,$rdomain,$rauthor,$rrole)=split(/\//,$role);
2562: $tremark = &mt('Custom role defined by [_1].',$rauthor.':'.$rdomain);
2563: }
2564: $trole=Apache::lonnet::plaintext($role);
2565: my ($tdom,$trest,$tsection)=
2566: split(/\//,Apache::lonnet::declutter($where));
2567: if (($role eq 'ca') || ($role eq 'aa')) {
2568: my $home = &Apache::lonnet::homeserver($trest,$tdom);
2569: $home = &Apache::lonnet::hostname($home);
2570: $twhere=&mt('User').': '.$trest.' '.&mt('Domain').
2571: ': '.$tdom.' '.&mt('Server').': '.$home;
2572: } elsif ($role eq 'au') {
2573: my $home = &Apache::lonnet::homeserver
2574: ($env{'user.name'},$env{'user.domain'});
2575: $home = &Apache::lonnet::hostname($home);
2576: $twhere=&mt('Domain').': '.$tdom.' '.&mt('Server').
2577: ': '.$home;
2578: } elsif ($trest) {
2579: my $tcourseid=$tdom.'_'.$trest;
2580: my $crstype = &Apache::loncommon::course_type($tcourseid);
2581: $trole = &Apache::lonnet::plaintext($role,$crstype,$tcourseid);
2582: if ($env{'course.'.$tcourseid.'.description'}) {
2583: $twhere=$env{'course.'.$tcourseid.'.description'};
2584: } else {
2585: my %newhash=&Apache::lonnet::coursedescription($tcourseid);
2586: if (%newhash) {
2587: $twhere=$newhash{'description'};
2588: } else {
2589: $twhere=&mt('Currently not available');
2590: }
2591: }
2592: if ($tsection) {
2593: $twhere.= ' '.&mt('Section').': '.$tsection;
2594: }
2595: if ($role ne 'st') {
2596: $twhere.= ' '.&mt('Domain').': '.$tdom;
2597: }
2598: } elsif ($tdom) {
2599: $twhere = &mt('Domain').': '.$tdom;
2600: }
2601: my $output;
2602: if ($trole) {
2603: $output = $trole;
2604: if ($twhere) {
2605: $output .= " -- $twhere";
2606: }
2607: if ($tremark) {
2608: $output .= '<br />'.$tremark;
2609: }
2610: }
2611: return $output;
2612: }
2613:
2614: sub curr_role_status {
2615: my ($start,$end,$refresh,$update) = @_;
2616: if (($start) && ($start<0)) { return 'deleted' };
2617: my $status = 'active';
2618: if (($end) && ($end<=$update)) {
2619: $status = 'previous';
2620: }
2621: if (($start) && ($refresh<$start)) {
2622: $status = 'future';
2623: }
2624: return $status;
2625: }
2626:
2627: sub gather_roleprivs {
2628: my ($allroles,$allgroups,$userroles,$area,$role,$tstart,$tend,$status) = @_;
2629: return unless ((ref($allroles) eq 'HASH') && (ref($allgroups) eq 'HASH') && (ref($userroles) eq 'HASH'));
2630: if (($area ne '') && ($role ne '')) {
2631: &Apache::lonnet::userrolelog($role,$env{'user.name'},$env{'user.domain'},
2632: $area,$tstart,$tend);
2633: my $spec=$role.'.'.$area;
2634: $userroles->{'user.role.'.$spec} = $tstart.'.'.$tend;
2635: my ($tdummy,$tdomain,$trest)=split(/\//,$area);
2636: if ($status eq 'active') {
2637: if ($role =~ /^cr\//) {
2638: &Apache::lonnet::custom_roleprivs($allroles,$role,$tdomain,$trest,$spec,$area);
2639: } elsif ($role eq 'gr') {
2640: my %rolehash = &Apache::lonnet::get('roles',[$area.'_'.$role],
2641: $env{'user.domain'},
2642: $env{'user.name'});
2643: my ($trole) = split(/_/,$rolehash{$area.'_'.$role},2);
2644: (undef,my $group_privs) = split(/\//,$trole);
2645: $group_privs = &unescape($group_privs);
2646: &Apache::lonnet::group_roleprivs($allgroups,$area,$group_privs,$tend,$tstart);
2647: } else {
2648: &Apache::lonnet::standard_roleprivs($allroles,$role,$tdomain,$spec,$trest,$area);
2649: }
2650: }
2651: }
2652: return;
2653: }
2654:
2655: sub is_active_course {
2656: my ($rolekey,$refresh,$update,$roleshashref) = @_;
2657: return unless(ref($roleshashref) eq 'HASH');
2658: my ($role,$cdom,$cnum) = split(/\//,$rolekey);
2659: my $is_active;
2660: foreach my $key (keys(%{$roleshashref})) {
2661: if ($key =~ /^\Q$cnum\E:\Q$cdom\E:/) {
2662: my ($tstart,$tend) = split(/:/,$roleshashref->{$key});
2663: my $status = &curr_role_status($tstart,$tend,$refresh,$update);
2664: if ($status eq 'active') {
2665: $is_active = 1;
2666: last;
2667: }
2668: }
2669: }
2670: return $is_active;
2671: }
2672:
2673: sub get_roles_functions {
2674: my ($rolescount,$cattype) = @_;
2675: my @links;
2676: push(@links,["javascript:rolesView('doupdate');",'start-here-22x22',&mt('Check for changes')]);
2677: if ($env{'environment.canrequest.author'}) {
2678: unless (&Apache::loncoursequeueadmin::is_active_author()) {
2679: push(@links,["javascript:rolesView('requestauthor');",'list-add-22x22',&mt('Request author role')]);
2680: }
2681: }
2682: if (($rolescount > 3) || ($env{'environment.recentroles'})) {
2683: push(@links,['/adm/preferences?action=changerolespref&returnurl=/adm/roles','role_hotlist-22x22',&mt('Hotlist')]);
2684: }
2685: if (&Apache::lonmenu::check_for_rcrs()) {
2686: push(@links,['/adm/requestcourse','rcrs-22x22',&mt('Request course')]);
2687: }
2688: if ($env{'form.state'} eq 'queued') {
2689: push(@links,["javascript:rolesView('noqueued');",'selfenrl-queue-22x22',&mt('Hide queued')]);
2690: } else {
2691: push(@links,["javascript:rolesView('queued');",'selfenrl-queue-22x22',&mt('Show queued')]);
2692: }
2693: if ($env{'user.adv'}) {
2694: if ($env{'form.display'} eq 'showall') {
2695: push(@links,["javascript:rolesView('noshowall');",'edit-redo-22x22',&mt('Exclude expired')]);
2696: } else {
2697: push(@links,["javascript:rolesView('showall');",'edit-undo-22x22',&mt('Include expired')]);
2698: }
2699: }
2700: unless ($cattype eq 'none') {
2701: push(@links,['/adm/coursecatalog','ccat-22x22',&mt('Course catalog')]);
2702: }
2703: my $funcs;
2704: if ($env{'browser.mobile'}) {
2705: my @functions;
2706: foreach my $link (@links) {
2707: push(@functions,[$link->[0],$link->[2]]);
2708: }
2709: my $title = 'Display options';
2710: if ($env{'user.adv'}) {
2711: $title = 'Roles options';
2712: }
2713: $funcs = &Apache::lonmenu::create_submenu('','',$title,\@functions,1,'LC_breadcrumbs_hoverable');
2714: $funcs = '<ol class="LC_primary_menu LC_floatright">'.$funcs.'</ol>';
2715: } else {
2716: $funcs = &Apache::lonhtmlcommon::start_funclist();
2717: foreach my $link (@links) {
2718: $funcs .= &Apache::lonhtmlcommon::add_item_funclist(
2719: '<a href="'.$link->[0].'" class="LC_menubuttons_link">'.
2720: '<img src="/res/adm/pages/'.$link->[1].'.png" class="LC_icon" alt="'.$link->[2].'" />'.
2721: $link->[2].'</a>');
2722: }
2723: $funcs .= &Apache::lonhtmlcommon::end_funclist();
2724: $funcs = &Apache::loncommon::head_subbox($funcs);
2725: }
2726: return $funcs;
2727: }
2728:
2729: sub get_queued {
2730: my ($output,%reqcrs);
2731: my ($types,$typenames) = &Apache::loncommon::course_types();
2732: my %statusinfo = &Apache::lonnet::dump('courserequests',$env{'user.domain'},
2733: $env{'user.name'},'^status:');
2734: foreach my $key (keys(%statusinfo)) {
2735: next unless (($statusinfo{$key} eq 'approval') || ($statusinfo{$key} eq 'pending'));
2736: (undef,my($cdom,$cnum)) = split(/:/,$key);
2737: my $requestkey = $cdom.'_'.$cnum;
2738: if ($requestkey =~ /^($match_domain)_($match_courseid)$/) {
2739: my %history = &Apache::lonnet::restore($requestkey,'courserequests',
2740: $env{'user.domain'},$env{'user.name'});
2741: next if ((exists($history{'status'})) && ($history{'status'} eq 'created'));
2742: my $reqtime = $history{'reqtime'};
2743: my $lastupdate = $history{'timestamp'};
2744: my $showtype = $history{'crstype'};
2745: if (defined($typenames->{$history{'crstype'}})) {
2746: $showtype = $typenames->{$history{'crstype'}};
2747: }
2748: my $description;
2749: if (ref($history{'details'}) eq 'HASH') {
2750: $description = $history{details}{'cdescr'};
2751: }
2752: @{$reqcrs{$reqtime}} = ($description,$showtype);
2753: }
2754: }
2755: my @sortedtimes = sort {$a <=> $b} (keys(%reqcrs));
2756: if (@sortedtimes > 0) {
2757: $output .= '<p><b>'.&mt('Course/Community requests').'</b><br />'.
2758: &Apache::loncommon::start_data_table().
2759: &Apache::loncommon::start_data_table_header_row().
2760: '<th>'.&mt('Date requested').'</th>'.
2761: '<th>'.&mt('Course title').'</th>'.
2762: '<th>'.&mt('Course type').'</th>';
2763: &Apache::loncommon::end_data_table_header_row();
2764: foreach my $reqtime (@sortedtimes) {
2765: next unless (ref($reqcrs{$reqtime}) eq 'ARRAY');
2766: $output .= &Apache::loncommon::start_data_table_row().
2767: '<td>'.&Apache::lonlocal::locallocaltime($reqtime).'</td>'.
2768: '<td>'.join('</td><td>',@{$reqcrs{$reqtime}}).'</td>'.
2769: &Apache::loncommon::end_data_table_row();
2770: }
2771: $output .= &Apache::loncommon::end_data_table().
2772: '<br /></p>';
2773: }
2774: my $queuedselfenroll = &Apache::loncoursequeueadmin::queued_selfenrollment(1);
2775: if ($queuedselfenroll) {
2776: $output .= '<p><b>'.&mt('Enrollment requests').'</b><br />'.
2777: $queuedselfenroll.'<br /></p>';
2778: }
2779: if ($env{'environment.canrequest.author'}) {
2780: unless (&Apache::loncoursequeueadmin::is_active_author()) {
2781: my $requestauthor;
2782: my ($status,$timestamp) = split(/:/,$env{'environment.requestauthorqueued'});
2783: if (($status eq 'approval') || ($status eq 'approved')) {
2784: $output .= '<p><b>'.&mt('Author role request').'</b><br />';
2785: if ($status eq 'approval') {
2786: $output .= &mt('A request for Authoring Space submitted on [_1] is awaiting approval',
2787: &Apache::lonlocal::locallocaltime($timestamp));
2788: } elsif ($status eq 'approved') {
2789: my %roleshash =
2790: &Apache::lonnet::get_my_roles($env{'user.name'},$env{'user.domain'},'userroles',
2791: ['active'],['au'],[$env{'user.domain'}]);
2792: if (keys(%roleshash)) {
2793: $output .= '<span class="LC_info">'.
2794: &mt('Your request for an author role has been approved.').'<br />'.
2795: &mt('Use the "Check for changes" link to update your list of roles.').
2796: '</span>';
2797: }
2798: }
2799: $output .= '</p>';
2800: }
2801: }
2802: }
2803: unless ($output) {
2804: if ($env{'environment.canrequest.author'} || $env{'environment.canrequest.official'} ||
2805: $env{'environment.canrequest.unofficial'} || $env{'environment.canrequest.community'}) {
2806: $output = &mt('No requests for courses, communities or authoring currently queued');
2807: } else {
2808: $output = &mt('No enrollment requests currently queued awaiting approval');
2809: }
2810: }
2811: return '<div class="LC_left_float"><fieldset><legend>'.&mt('Queued requests').'</legend>'.
2812: $output.'</fieldset></div><br clear="all" />';
2813: }
2814:
2815: 1;
2816: __END__
2817:
2818: =head1 NAME
2819:
2820: Apache::lonroles - User Roles Screen
2821:
2822: =head1 SYNOPSIS
2823:
2824: Invoked by /etc/httpd/conf/srm.conf:
2825:
2826: <Location /adm/roles>
2827: PerlAccessHandler Apache::lonacc
2828: SetHandler perl-script
2829: PerlHandler Apache::lonroles
2830: ErrorDocument 403 /adm/login
2831: ErrorDocument 500 /adm/errorhandler
2832: </Location>
2833:
2834: =head1 OVERVIEW
2835:
2836: =head2 Choosing Roles
2837:
2838: C<lonroles> is a handler that allows a user to switch roles in
2839: mid-session. LON-CAPA attempts to work with "No Role Specified", the
2840: default role that a user has before selecting a role, as widely as
2841: possible, but certain handlers for example need specification which
2842: course they should act on, etc. Both in this scenario, and when the
2843: handler determines via C<lonnet>'s C<&allowed> function that a certain
2844: action is not allowed, C<lonroles> is used as error handler. This
2845: allows the user to select another role which may have permission to do
2846: what they were trying to do.
2847:
2848: =begin latex
2849:
2850: \begin{figure}
2851: \begin{center}
2852: \includegraphics[width=0.45\paperwidth,keepaspectratio]{Sample_Roles_Screen}
2853: \caption{\label{Sample_Roles_Screen}Sample Roles Screen}
2854: \end{center}
2855: \end{figure}
2856:
2857: =end latex
2858:
2859: =head2 Role Initialization
2860:
2861: The privileges for a user are established at login time and stored in the session environment. As a consequence, a new role does not become active till the next login. Handlers are able to query for privileges using C<lonnet>'s C<&allowed> function. When a user first logs in, their role is the "common" role, which means that they have the sum of all of their privileges. During a session it might become necessary to choose a particular role, which as a consequence also limits the user to only the privileges in that particular role.
2862:
2863: =head1 INTRODUCTION
2864:
2865: This module enables a user to select what role he wishes to
2866: operate under (instructor, student, teaching assistant, course
2867: coordinator, etc). These roles are pre-established by the actions
2868: of upper-level users.
2869:
2870: This is part of the LearningOnline Network with CAPA project
2871: described at http://www.lon-capa.org.
2872:
2873: =head1 HANDLER SUBROUTINE
2874:
2875: This routine is called by Apache and mod_perl.
2876:
2877: =over 4
2878:
2879: =item *
2880:
2881: Roles Initialization (yes/no)
2882:
2883: =item *
2884:
2885: Get Error Message from Environment
2886:
2887: =item *
2888:
2889: Who is this?
2890:
2891: =item *
2892:
2893: Generate Page Output
2894:
2895: =item *
2896:
2897: Choice or no choice
2898:
2899: =item *
2900:
2901: Table
2902:
2903: =item *
2904:
2905: Privileges
2906:
2907: =back
2908:
2909: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>