Annotation of loncom/auth/lonroles.pm, revision 1.209.4.1
1.1 harris41 1: # The LearningOnline Network with CAPA
2: # User Roles Screen
1.31 www 3: #
1.209.4.1! raeburn 4: # $Id: lonroles.pm,v 1.209 2008/10/20 03:25:48 raeburn Exp $
1.31 www 5: #
6: # Copyright Michigan State University Board of Trustees
7: #
8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
9: #
10: # LON-CAPA is free software; you can redistribute it and/or modify
11: # it under the terms of the GNU General Public License as published by
12: # the Free Software Foundation; either version 2 of the License, or
13: # (at your option) any later version.
14: #
15: # LON-CAPA is distributed in the hope that it will be useful,
16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18: # GNU General Public License for more details.
19: #
20: # You should have received a copy of the GNU General Public License
21: # along with LON-CAPA; if not, write to the Free Software
22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23: #
24: # /home/httpd/html/adm/gpl.txt
25: #
26: # http://www.lon-capa.org/
27: #
1.32 harris41 28: ###
1.22 harris41 29:
1.1 harris41 30: package Apache::lonroles;
31:
32: use strict;
1.118 albertel 33: use Apache::lonnet;
1.7 www 34: use Apache::lonuserstate();
1.1 harris41 35: use Apache::Constants qw(:common);
1.2 www 36: use Apache::File();
1.26 www 37: use Apache::lonmenu;
1.29 albertel 38: use Apache::loncommon;
1.104 raeburn 39: use Apache::lonhtmlcommon;
1.57 www 40: use Apache::lonannounce;
1.72 www 41: use Apache::lonlocal;
1.151 www 42: use Apache::lonpageflip();
1.167 albertel 43: use Apache::lonnavdisplay();
1.120 albertel 44: use GDBM_File;
1.170 albertel 45: use LONCAPA qw(:DEFAULT :match);
1.201 raeburn 46: use HTML::Entities;
1.149 www 47:
1.1 harris41 48:
1.62 matthew 49: sub redirect_user {
1.95 albertel 50: my ($r,$title,$url,$msg,$launch_nav) = @_;
1.62 matthew 51: $msg = $title if (! defined($msg));
1.73 www 52: &Apache::loncommon::content_type($r,'text/html');
1.62 matthew 53: &Apache::loncommon::no_cache($r);
54: $r->send_http_header;
55: my $swinfo=&Apache::lonmenu::rawconfig();
1.96 albertel 56: my $navwindow;
1.95 albertel 57: if ($launch_nav eq 'on') {
1.166 albertel 58: $navwindow.=&Apache::lonnavdisplay::launch_win('now',undef,undef,
59: ($url =~ m-^/adm/whatsnew-));
1.96 albertel 60: } else {
61: $navwindow.=&Apache::lonnavmaps::close();
1.95 albertel 62: }
1.147 albertel 63: my $start_page = &Apache::loncommon::start_page('Switching Role',undef,
64: {'redirect' => [1,$url],});
65: my $end_page = &Apache::loncommon::end_page();
66:
1.92 www 67: # Note to style police:
68: # This must only replace the spaces, nothing else, or it bombs elsewhere.
69: $url=~s/ /\%20/g;
1.93 albertel 70: $r->print(<<ENDREDIR);
1.147 albertel 71: $start_page
1.96 albertel 72: <script type="text/javascript">
1.62 matthew 73: $swinfo
74: </script>
1.96 albertel 75: $navwindow
1.62 matthew 76: <h1>$msg</h1>
1.147 albertel 77: $end_page
1.62 matthew 78: ENDREDIR
79: return;
80: }
81:
1.150 www 82: sub error_page {
83: my ($r,$error,$dest)=@_;
84: &Apache::loncommon::content_type($r,'text/html');
85: &Apache::loncommon::no_cache($r);
86: $r->send_http_header;
87: return OK if $r->header_only;
88: $r->print(&Apache::loncommon::start_page('Problems during Course Initialization').
89: '<script type="text/javascript">'.
90: &Apache::lonmenu::rawconfig().'</script>'.
91: '<p>'.&mt('The following problems occurred:').
92: $error.
1.156 albertel 93: '</p><br /><a href="'.$dest.'">'.&mt('Continue').'</a>'.
1.150 www 94: &Apache::loncommon::end_page());
95: }
96:
1.1 harris41 97: sub handler {
1.10 www 98:
1.1 harris41 99: my $r = shift;
100:
1.6 www 101: my $now=time;
1.118 albertel 102: my $then=$env{'user.login.time'};
1.6 www 103: my $envkey;
1.107 raeburn 104: my %dcroles = ();
105: my $numdc = &check_fordc(\%dcroles,$then);
1.148 albertel 106: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'});
1.10 www 107:
1.6 www 108: # ================================================================== Roles Init
1.118 albertel 109: if ($env{'form.selectrole'}) {
1.188 www 110:
111: my $locknum=&Apache::lonnet::get_locks();
112: if ($locknum) { return 409; }
113:
1.134 www 114: if ($env{'form.newrole'}) {
115: $env{'form.'.$env{'form.newrole'}}=1;
116: }
1.118 albertel 117: if ($env{'request.course.id'}) {
1.185 raeburn 118: # Check if user is CC trying to select a course role
119: if ($env{'form.switchrole'}) {
120: if (!defined($env{'user.role.'.$env{'form.switchrole'}})) {
121: &adhoc_course_role($then);
122: }
123: }
1.118 albertel 124: my %temp=('logout_'.$env{'request.course.id'} => time);
1.33 www 125: &Apache::lonnet::put('email_status',\%temp);
1.118 albertel 126: &Apache::lonnet::delenv('user.state.'.$env{'request.course.id'});
1.100 albertel 127: }
1.186 raeburn 128: &Apache::lonnet::appenv({"request.course.id" => '',
129: "request.course.fn" => '',
130: "request.course.uri" => '',
131: "request.course.sec" => '',
132: "request.role" => 'cm',
133: "request.role.adv" => $env{'user.adv'},
134: "request.role.domain" => $env{'user.domain'}});
1.182 www 135: # Check if user is a DC trying to enter a course or author space and needs privs to be created
1.107 raeburn 136: if ($numdc > 0) {
1.118 albertel 137: foreach my $envkey (keys %env) {
1.182 www 138: # Is this an ad-hoc CC-role?
1.146 raeburn 139: if (my ($domain,$coursenum) =
1.171 albertel 140: ($envkey =~ m-^form\.cc\./($match_domain)/($match_courseid)$-)) {
1.146 raeburn 141: if ($dcroles{$domain}) {
1.182 www 142: &check_privs($domain,$coursenum,$then,$now,'cc');
143: }
144: last;
145: }
1.193 raeburn 146: # Is this an ad-hoc CA-role?
1.183 www 147: if (my ($domain,$user) =
148: ($envkey =~ m-^form\.ca\./($match_domain)/($match_username)$-)) {
1.206 raeburn 149: if (($domain eq $env{'user.domain'}) && ($user eq $env{'user.name'})) {
150: delete($env{$envkey});
151: $env{'form.au./'.$domain.'/'} = 1;
152: my ($server_status,$home) = &check_author_homeserver($user,$domain);
153: if ($server_status eq 'switchserver') {
154: my $trolecode = 'au./'.$domain.'/';
155: my $switchserver = '/adm/switchserver?otherserver='.$home.'&role='.$trolecode;
156: $r->internal_redirect($switchserver);
157: }
158: last;
159: }
160: if (my ($castart,$caend) = ($env{'user.role.ca./'.$domain.'/'.$user} =~ /^(\d*)\.(\d*)$/)) {
161: if (((($castart) && ($castart < $now)) || !$castart) &&
162: ((!$caend) || (($caend) && ($caend > $now)))) {
163: my ($server_status,$home) = &check_author_homeserver($user,$domain);
164: if ($server_status eq 'switchserver') {
165: my $trolecode = 'ca./'.$domain.'/'.$user;
166: my $switchserver = '/adm/switchserver?otherserver='.$home.'&role='.$trolecode;
167: $r->internal_redirect($switchserver);
168: }
169: last;
170: }
171: }
172: # Check if author blocked ca-access
1.190 www 173: my %blocked=&Apache::lonnet::get('environment',['domcoord.author'],$domain,$user);
174: if ($blocked{'domcoord.author'} eq 'blocked') {
1.206 raeburn 175: delete($env{$envkey});
176: $env{'user.error.msg'}=':::1:User '.$user.' in domain '.$domain.' blocked domain coordinator access';
177: last;
1.190 www 178: }
1.193 raeburn 179: if ($dcroles{$domain}) {
180: my ($server_status,$home) = &check_author_homeserver($user,$domain);
181: if (($server_status eq 'ok') || ($server_status eq 'switchserver')) {
182: &check_privs($domain,$user,$then,$now,'ca');
183: if ($server_status eq 'switchserver') {
184: my $trolecode = 'ca./'.$domain.'/'.$user;
185: my $switchserver = '/adm/switchserver?'
186: .'otherserver='.$home.'&role='.$trolecode;
187: $r->internal_redirect($switchserver);
188: }
189: } else {
190: delete($env{$envkey});
191: }
1.183 www 192: } else {
193: delete($env{$envkey});
1.182 www 194: }
195: last;
196: }
1.107 raeburn 197: }
198: }
199:
1.118 albertel 200: foreach $envkey (keys %env) {
1.40 matthew 201: next if ($envkey!~/^user\.role\./);
1.102 raeburn 202: my ($where,$trolecode,$role,$tstatus,$tend,$tstart);
203: &role_status($envkey,$then,$now,\$role,\$where,\$trolecode,\$tstatus,\$tstart,\$tend);
1.118 albertel 204: if ($env{'form.'.$trolecode}) {
1.55 albertel 205: if ($tstatus eq 'is') {
206: $where=~s/^\///;
207: my ($cdom,$cnum,$csec)=split(/\//,$where);
1.137 raeburn 208: # check for course groups
209: my %coursegroups = &Apache::lonnet::get_active_groups(
210: $env{'user.domain'},$env{'user.name'},$cdom, $cnum);
211: my $cgrps = join(':',keys(%coursegroups));
212:
1.111 albertel 213: # store role if recent_role list being kept
1.118 albertel 214: if ($env{'environment.recentroles'}) {
1.158 albertel 215: my %frozen_roles =
216: &Apache::lonhtmlcommon::get_recent_frozen('roles',$env{'environment.recentrolesn'});
1.111 albertel 217: &Apache::lonhtmlcommon::store_recent('roles',
1.158 albertel 218: $trolecode,' ',$frozen_roles{$trolecode});
1.111 albertel 219: }
220:
221:
1.53 www 222: # check for keyed access
1.55 albertel 223: if (($role eq 'st') &&
1.118 albertel 224: ($env{'course.'.$cdom.'_'.$cnum.'.keyaccess'} eq 'yes')) {
1.89 www 225: # who is key authority?
226: my $authdom=$cdom;
227: my $authnum=$cnum;
1.118 albertel 228: if ($env{'course.'.$cdom.'_'.$cnum.'.keyauth'}) {
1.89 www 229: ($authnum,$authdom)=
1.172 albertel 230: split(/:/,$env{'course.'.$cdom.'_'.$cnum.'.keyauth'});
1.89 www 231: }
232: # check with key authority
233: unless (&Apache::lonnet::validate_access_key(
1.118 albertel 234: $env{'environment.key.'.$cdom.'_'.$cnum},
1.89 www 235: $authdom,$authnum)) {
1.53 www 236: # there is no valid key
1.118 albertel 237: if ($env{'form.newkey'}) {
1.53 www 238: # student attempts to register a new key
1.89 www 239: &Apache::loncommon::content_type($r,'text/html');
240: &Apache::loncommon::no_cache($r);
241: $r->send_http_header;
242: my $swinfo=&Apache::lonmenu::rawconfig();
1.147 albertel 243: my $start_page=&Apache::loncommon::start_page
1.89 www 244: ('Verifying Access Key to Unlock this Course');
1.147 albertel 245: my $end_page=&Apache::loncommon::end_page();
1.90 www 246: my $buttontext=&mt('Enter Course');
247: my $message=&mt('Successfully registered key');
248: my $assignresult=
249: &Apache::lonnet::assign_access_key(
1.118 albertel 250: $env{'form.newkey'},
1.90 www 251: $authdom,$authnum,
1.91 www 252: $cdom,$cnum,
1.118 albertel 253: $env{'user.domain'},
254: $env{'user.name'},
1.204 bisitz 255: &mt('Assigned from [_1] at [_2] for [_3]'
256: ,$ENV{'REMOTE_ADDR'}
257: ,&Apache::lonlocal::locallocaltime()
258: ,$trolecode)
259: );
1.90 www 260: unless ($assignresult eq 'ok') {
261: $assignresult=~s/^error\:\s*//;
262: $message=&mt($assignresult).
263: '<br /><a href="/adm/logout">'.
1.89 www 264: &mt('Logout').'</a>';
1.90 www 265: $buttontext=&mt('Re-Enter Key');
266: }
1.89 www 267: $r->print(<<ENDENTEREDKEY);
1.147 albertel 268: $start_page
1.179 raeburn 269: <script type="text/javascript">
1.89 www 270: $swinfo
271: </script>
272: <form method="post">
273: <input type="hidden" name="selectrole" value="1" />
274: <input type="hidden" name="$trolecode" value="1" />
1.90 www 275: <font size="+2">$message</font><br />
1.89 www 276: <input type="submit" value="$buttontext" />
277: </form>
1.147 albertel 278: $end_page
1.89 www 279: ENDENTEREDKEY
280: return OK;
1.55 albertel 281: } else {
1.53 www 282: # print form to enter a new key
1.73 www 283: &Apache::loncommon::content_type($r,'text/html');
1.55 albertel 284: &Apache::loncommon::no_cache($r);
285: $r->send_http_header;
286: my $swinfo=&Apache::lonmenu::rawconfig();
1.147 albertel 287: my $start_page=&Apache::loncommon::start_page
1.55 albertel 288: ('Enter Access Key to Unlock this Course');
1.147 albertel 289: my $end_page=&Apache::loncommon::end_page();
1.55 albertel 290: $r->print(<<ENDENTERKEY);
1.147 albertel 291: $start_page
1.179 raeburn 292: <script type="text/javascript">
1.53 www 293: $swinfo
294: </script>
295: <form method="post">
1.89 www 296: <input type="hidden" name="selectrole" value="1" />
297: <input type="hidden" name="$trolecode" value="1" />
1.118 albertel 298: <input type="text" size="20" name="newkey" value="$env{'form.newkey'}" />
1.53 www 299: <input type="submit" value="Enter key" />
300: </form>
1.147 albertel 301: $end_page
1.53 www 302: ENDENTERKEY
1.55 albertel 303: return OK;
304: }
305: }
306: }
1.118 albertel 307: &Apache::lonnet::log($env{'user.domain'},
308: $env{'user.name'},
309: $env{'user.home'},
1.87 www 310: "Role ".$trolecode);
1.101 albertel 311:
1.56 www 312: &Apache::lonnet::appenv(
1.186 raeburn 313: {'request.role' => $trolecode,
314: 'request.role.domain' => $cdom,
315: 'request.course.sec' => $csec,
316: 'request.course.groups' => $cgrps});
1.101 albertel 317: my $tadv=0;
1.62 matthew 318:
1.125 www 319: if (($cnum) && ($role ne 'ca') && ($role ne 'aa')) {
1.152 raeburn 320: my $msg;
1.55 albertel 321: my ($furl,$ferr)=
322: &Apache::lonuserstate::readmap($cdom.'/'.$cnum);
1.118 albertel 323: if (($env{'form.orgurl'}) &&
324: ($env{'form.orgurl'}!~/^\/adm\/flip/)) {
325: my $dest=$env{'form.orgurl'};
1.117 albertel 326: if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
1.186 raeburn 327: &Apache::lonnet::appenv({'request.role.adv'=>$tadv});
1.150 www 328: if (($ferr) && ($tadv)) {
329: &error_page($r,$ferr,$dest);
330: } else {
331: $r->internal_redirect($dest);
332: }
1.55 albertel 333: return OK;
334: } else {
1.155 albertel 335: if (!$env{'request.course.id'}) {
1.55 albertel 336: &Apache::lonnet::appenv(
1.186 raeburn 337: {"request.course.id" => $cdom.'_'.$cnum});
1.61 www 338: $furl='/adm/roles?tryagain=1';
1.55 albertel 339: $msg=
1.157 albertel 340: '<h1><span class="LC_error">'.
1.162 albertel 341: &mt('Could not initialize [_1] at this time.',
342: $env{'course.'.$cdom.'_'.$cnum.'.description'}).
1.157 albertel 343: '</span></h1><h3>'.&mt('Please try again.').'</h3>'.$ferr;
1.55 albertel 344: }
1.117 albertel 345: if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
1.186 raeburn 346: &Apache::lonnet::appenv({'request.role.adv'=>$tadv});
1.152 raeburn 347:
1.150 www 348: if (($ferr) && ($tadv)) {
349: &error_page($r,$ferr,$furl);
350: } else {
351: # Check to see if the user is a CC entering a course
352: # for the first time
353: my (undef, undef, $role, $courseid) = split(/\./, $envkey);
354: if (substr($courseid, 0, 1) eq '/') {
355: $courseid = substr($courseid, 1);
356: }
357: $courseid =~ s/\//_/;
358: if ($role eq 'cc' && $env{'course.' . $courseid .
359: '.course.helper.not.run'}) {
360: $furl = "/adm/helper/course.initialization.helper";
361: # Send the user to the course they selected
362: } elsif ($env{'request.course.id'}) {
1.185 raeburn 363: if ($env{'form.destinationurl'}) {
364: my $dest = $env{'form.destinationurl'};
1.203 raeburn 365: if ($env{'form.destsymb'} ne '') {
366: my $esc_symb = &HTML::Entities::encode($env{'form.destsymb'},'"<>&');
367: $dest .= '?symb='.$esc_symb;
368: }
1.185 raeburn 369: &redirect_user($r,&mt('Entering [_1]',
370: $env{'course.'.$courseid.'.description'}),
371: $dest,$msg,
372: $env{'environment.remotenavmap'});
373: return OK;
374: }
1.150 www 375: if (&Apache::lonnet::allowed('whn',
376: $env{'request.course.id'})
377: || &Apache::lonnet::allowed('whn',
378: $env{'request.course.id'}.'/'
379: .$env{'request.course.sec'})
380: ) {
381: my $startpage = &courseloadpage($courseid);
382: unless ($startpage eq 'firstres') {
1.204 bisitz 383: $msg = &mt('Entering [_1] ...',
1.162 albertel 384: $env{'course.'.$courseid.'.description'});
1.150 www 385: &redirect_user($r,&mt('New in course'),
386: '/adm/whatsnew?refpage=start',$msg,
387: $env{'environment.remotenavmap'});
388: return OK;
389: }
390: }
391: }
1.151 www 392: # Are we allowed to look at the first resource?
1.169 albertel 393: if ($furl !~ m|^/adm/|) {
1.151 www 394: # Guess not ...
395: $furl=&Apache::lonpageflip::first_accessible_resource();
396: }
1.162 albertel 397: $msg = &mt('Entering [_1] ...',
398: $env{'course.'.$courseid.'.description'});
399: &redirect_user($r,&mt('Entering [_1]',
400: $env{'course.'.$courseid.'.description'}),
1.150 www 401: $furl,$msg,
402: $env{'environment.remotenavmap'});
1.58 bowersj2 403: }
1.124 albertel 404: return OK;
1.55 albertel 405: }
406: }
1.62 matthew 407: #
408: # Send the user to the construction space they selected
1.125 www 409: if ($role =~ /^(au|ca|aa)$/) {
1.62 matthew 410: my $redirect_url = '/priv/';
411: if ($role eq 'au') {
1.118 albertel 412: $redirect_url.=$env{'user.name'};
1.62 matthew 413: } else {
414: $where =~ /\/(.*)$/;
415: $redirect_url .= $1;
416: }
417: $redirect_url .= '/';
1.78 sakharuk 418: &redirect_user($r,&mt('Entering Construction Space'),
1.62 matthew 419: $redirect_url);
420: return OK;
421: }
1.104 raeburn 422: if ($role eq 'dc') {
1.108 raeburn 423: my $redirect_url = '/adm/menu/';
424: &redirect_user($r,&mt('Loading Domain Coordinator Menu'),
1.104 raeburn 425: $redirect_url);
1.108 raeburn 426: return OK;
1.104 raeburn 427: }
1.55 albertel 428: }
429: }
1.6 www 430: }
1.40 matthew 431: }
1.44 www 432:
1.10 www 433:
1.6 www 434: # =============================================================== No Roles Init
1.10 www 435:
1.73 www 436: &Apache::loncommon::content_type($r,'text/html');
1.30 albertel 437: &Apache::loncommon::no_cache($r);
1.10 www 438: $r->send_http_header;
439: return OK if $r->header_only;
440:
1.52 www 441: my $swinfo=&Apache::lonmenu::rawconfig();
1.147 albertel 442: my $start_page=&Apache::loncommon::start_page('User Roles');
1.134 www 443: my $standby=&mt('Role selected. Please stand by.');
1.135 albertel 444: $standby=~s/\n/\\n/g;
1.184 raeburn 445: my $noscript='<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 />';
1.163 www 446:
1.10 www 447: $r->print(<<ENDHEADER);
1.147 albertel 448: $start_page
1.163 www 449: <br />
1.179 raeburn 450: <noscript>
451: $noscript
452: </noscript>
453: <script type="text/javascript">
1.26 www 454: $swinfo
455: window.focus();
1.134 www 456:
457: active=true;
458:
459: function enterrole (thisform,rolecode,buttonname) {
460: if (active) {
461: active=false;
462: document.title='$standby';
463: window.status='$standby';
464: thisform.newrole.value=rolecode;
465: thisform.submit();
466: } else {
467: alert('$standby');
468: }
469: }
1.26 www 470: </script>
1.10 www 471: ENDHEADER
1.6 www 472:
1.2 www 473: # ------------------------------------------ Get Error Message from Environment
474:
1.118 albertel 475: my ($fn,$priv,$nochoose,$error,$msg)=split(/:/,$env{'user.error.msg'});
476: if ($env{'user.error.msg'}) {
1.55 albertel 477: $r->log_reason(
1.118 albertel 478: "$msg for $env{'user.name'} domain $env{'user.domain'} access $priv",$fn);
1.12 www 479: }
1.1 harris41 480:
1.61 www 481: # ------------------------------------------------- Can this user re-init, etc?
1.6 www 482:
1.118 albertel 483: my $advanced=$env{'user.adv'};
1.61 www 484: &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['tryagain']);
1.118 albertel 485: my $tryagain=$env{'form.tryagain'};
1.209 raeburn 486: my $reinit=$env{'user.reinit'};
487: delete $env{'user.reinit'};
1.6 www 488:
1.2 www 489: # -------------------------------------------------------- Generate Page Output
1.6 www 490: # --------------------------------------------------------------- Error Header?
1.2 www 491: if ($error) {
1.187 bisitz 492: $r->print("<h1>".&mt('LON-CAPA Access Control')."</h1>");
1.174 albertel 493: $r->print("<!-- LONCAPAACCESSCONTROLERRORSCREEN --><hr /><pre>");
494: if ($priv ne '') {
1.187 bisitz 495: $r->print(&mt('Access : ').&Apache::lonnet::plaintext($priv)."\n");
1.174 albertel 496: }
497: if ($fn ne '') {
1.187 bisitz 498: $r->print(&mt('Resource: ').&Apache::lonenc::check_encrypt($fn)."\n");
1.174 albertel 499: }
500: if ($msg ne '') {
1.187 bisitz 501: $r->print(&mt('Action : ').$msg."\n");
1.174 albertel 502: }
503: $r->print("</pre><hr />");
1.120 albertel 504: my $url=$fn;
505: my $last;
506: if (tie(my %hash,'GDBM_File',$env{'request.course.fn'}.'_symb.db',
507: &GDBM_READER(),0640)) {
508: $last=$hash{'last_known'};
509: untie(%hash);
510: }
1.149 www 511: if ($last) { $fn.='?symb='.&escape($last); }
1.120 albertel 512:
513: &Apache::londocs::changewarning($r,undef,'You have modified your course recently, [_1] may fix this access problem.',
514: &Apache::lonenc::check_encrypt($fn));
1.2 www 515: } else {
1.118 albertel 516: if ($env{'user.error.msg'}) {
1.209 raeburn 517: if ($reinit) {
518: $r->print(
519: '<h3><span class="LC_error">'.
520: &mt('As your session file for the course has expired, you will need to re-select the course.').'</span></h3>');
521: } else {
522: $r->print(
1.157 albertel 523: '<h3><span class="LC_error">'.
524: &mt('You need to choose another user role or enter a specific course for this function').'</span></h3>');
1.209 raeburn 525: }
526: }
1.2 www 527: }
1.6 www 528: # -------------------------------------------------------- Choice or no choice?
1.2 www 529: if ($nochoose) {
1.177 www 530: $r->print("<h2>".&mt('Sorry ...')."</h2>\n<span class='LC_error'>".
531: &mt('This action is currently not authorized.').'</span>'.
1.150 www 532: &Apache::loncommon::end_page());
533: return OK;
1.6 www 534: } else {
1.18 www 535: if (($ENV{'REDIRECT_QUERY_STRING'}) && ($fn)) {
536: $fn.='?'.$ENV{'REDIRECT_QUERY_STRING'};
1.6 www 537: }
1.84 www 538: $r->print('<form method="post" name="rolechoice" action="'.(($fn)?$fn:$r->uri).'">');
1.116 albertel 539: $r->print('<input type="hidden" name="orgurl" value="'.$fn.'" />');
540: $r->print('<input type="hidden" name="selectrole" value="1" />');
1.134 www 541: $r->print('<input type="hidden" name="newrole" value="" />');
1.6 www 542: }
1.75 albertel 543: my (%roletext,%sortrole,%roleclass);
1.84 www 544: my $countactive=0;
1.191 raeburn 545: my $countfuture=0;
546: my $countwill=0;
1.84 www 547: my $inrole=0;
548: my $possiblerole='';
1.191 raeburn 549: my %futureroles;
550: my %roles_nextlogin;
1.209.4.1! raeburn 551: my %timezones;
1.118 albertel 552: foreach $envkey (sort keys %env) {
1.35 matthew 553: my $button = 1;
1.49 www 554: my $switchserver='';
1.75 albertel 555: my $roletext;
556: my $sortkey;
1.2 www 557: if ($envkey=~/^user\.role\./) {
1.102 raeburn 558: my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus,$tpstart,$tpend,$tfont);
559: &role_status($envkey,$then,$now,\$role,\$where,\$trolecode,\$tstatus,\$tstart,\$tend);
1.136 raeburn 560: next if (!defined($role) || $role eq '' || $role =~ /^gr/);
1.209.4.1! raeburn 561: my $timezone = &role_timezone($where,\%timezones);
1.102 raeburn 562: $tremark='';
563: $tpstart=' ';
564: $tpend=' ';
565: $tfont='#000000';
1.4 www 566: if ($tstart) {
1.209.4.1! raeburn 567: $tpstart=&Apache::lonlocal::locallocaltime($tstart,$timezone);
1.4 www 568: }
569: if ($tend) {
1.209.4.1! raeburn 570: $tpend=&Apache::lonlocal::locallocaltime($tend,$timezone);
1.4 www 571: }
1.118 albertel 572: if ($env{'request.role'} eq $trolecode) {
1.6 www 573: $tstatus='selected';
574: }
1.4 www 575: my $tbg;
1.164 albertel 576: if (($tstatus eq 'is')
577: || ($tstatus eq 'selected')
578: || ($tstatus eq 'will')
579: || ($tstatus eq 'future')
580: || ($env{'form.showall'})) {
1.35 matthew 581: if ($tstatus eq 'is') {
582: $tbg='#77FF77';
1.47 www 583: $tfont='#003300';
1.84 www 584: $possiblerole=$trolecode;
585: $countactive++;
1.35 matthew 586: } elsif ($tstatus eq 'future') {
587: $tbg='#FFFF77';
1.49 www 588: $button=0;
1.191 raeburn 589: $futureroles{$trolecode} = $tstart.':'.$tend;
590: $countfuture ++;
1.35 matthew 591: } elsif ($tstatus eq 'will') {
592: $tbg='#FFAA77';
1.204 bisitz 593: $tremark.=&mt('Active at next login.').' ';
1.191 raeburn 594: $roles_nextlogin{$trolecode} = $tstart.':'.$tend;
595: $countwill ++;
1.35 matthew 596: } elsif ($tstatus eq 'expired') {
597: $tbg='#FF7777';
1.47 www 598: $tfont='#330000';
1.49 www 599: $button=0;
1.35 matthew 600: } elsif ($tstatus eq 'will_not') {
601: $tbg='#AAFF77';
1.204 bisitz 602: $tremark.=&mt('Expired after logout.').' ';
1.35 matthew 603: } elsif ($tstatus eq 'selected') {
604: $tbg='#11CC55';
1.47 www 605: $tfont='#002200';
1.84 www 606: $inrole=1;
1.86 albertel 607: $countactive++;
1.204 bisitz 608: $tremark.=&mt('Currently selected.').' ';
1.35 matthew 609: }
610: my $trole;
611: if ($role =~ /^cr\//) {
612: my ($rdummy,$rdomain,$rauthor,$rrole)=split(/\//,$role);
1.132 albertel 613: if ($tremark) { $tremark.='<br />'; }
1.204 bisitz 614: $tremark.=&mt('Defined by [_1] at [_2].',$rauthor,$rdomain);
1.159 albertel 615: }
616: $trole=Apache::lonnet::plaintext($role);
1.35 matthew 617: my $ttype;
618: my $twhere;
619: my ($tdom,$trest,$tsection)=
620: split(/\//,Apache::lonnet::declutter($where));
621: # First, Co-Authorship roles
1.125 www 622: if (($role eq 'ca') || ($role eq 'aa')) {
1.39 stredwic 623: my $home = &Apache::lonnet::homeserver($trest,$tdom);
1.83 albertel 624: my $allowed=0;
625: my @ids=&Apache::lonnet::current_machine_ids();
626: foreach my $id (@ids) { if ($id eq $home) { $allowed=1; } }
627: if (!$allowed) {
1.49 www 628: $button=0;
1.130 albertel 629: $switchserver='otherserver='.$home.'&role='.$trolecode;
1.49 www 630: }
1.35 matthew 631: #next if ($home eq 'no_host');
1.176 albertel 632: $home = &Apache::lonnet::hostname($home);
1.78 sakharuk 633: $ttype='Construction Space';
1.72 www 634: $twhere=&mt('User').': '.$trest.'<br />'.&mt('Domain').
635: ': '.$tdom.'<br />'.
636: ' '.&mt('Server').': '.$home;
1.118 albertel 637: $env{'course.'.$tdom.'_'.$trest.'.description'}='ca';
1.82 www 638: $tremark.=&Apache::lonhtmlcommon::authorbombs('/res/'.$tdom.'/'.$trest.'/');
1.75 albertel 639: $sortkey=$role."$trest:$tdom";
1.35 matthew 640: } elsif ($role eq 'au') {
641: # Authors
642: my $home = &Apache::lonnet::homeserver
1.118 albertel 643: ($env{'user.name'},$env{'user.domain'});
1.83 albertel 644: my $allowed=0;
645: my @ids=&Apache::lonnet::current_machine_ids();
646: foreach my $id (@ids) { if ($id eq $home) { $allowed=1; } }
647: if (!$allowed) {
1.49 www 648: $button=0;
1.143 albertel 649: $switchserver='otherserver='.$home.'&role='.$trolecode;
1.49 www 650: }
1.35 matthew 651: #next if ($home eq 'no_host');
1.176 albertel 652: $home = &Apache::lonnet::hostname($home);
1.78 sakharuk 653: $ttype='Construction Space';
1.72 www 654: $twhere=&mt('Domain').': '.$tdom.'<br />'.&mt('Server').
655: ': '.$home;
1.118 albertel 656: $env{'course.'.$tdom.'_'.$trest.'.description'}='ca';
657: $tremark.=&Apache::lonhtmlcommon::authorbombs('/res/'.$tdom.'/'.$env{'user.name'}.'/');
1.75 albertel 658: $sortkey=$role;
1.35 matthew 659: } elsif ($trest) {
660: my $tcourseid=$tdom.'_'.$trest;
1.153 raeburn 661: $ttype = &Apache::loncommon::course_type($tcourseid);
662: $trole = &Apache::lonnet::plaintext($role,$ttype);
1.118 albertel 663: if ($env{'course.'.$tcourseid.'.description'}) {
664: $twhere=$env{'course.'.$tcourseid.'.description'};
1.80 albertel 665: $sortkey=$role."\0".$tdom."\0".$twhere."\0".$envkey;
1.72 www 666: unless ($twhere eq &mt('Currently not available')) {
1.55 albertel 667: $twhere.=' <font size="-2">'.
1.72 www 668: &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$trest,$tdom,$tfont).
1.49 www 669: '</font>';
1.55 albertel 670: }
1.8 www 671: } else {
1.105 raeburn 672: my %newhash=&Apache::lonnet::coursedescription($tcourseid);
1.35 matthew 673: if (%newhash) {
1.80 albertel 674: $sortkey=$role."\0".$tdom."\0".$newhash{'description'}.
1.77 albertel 675: "\0".$envkey;
1.49 www 676: $twhere=$newhash{'description'}.
677: ' <font size="-2">'.
1.72 www 678: &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$trest,$tdom,$tfont).
1.49 www 679: '</font>';
1.152 raeburn 680: $ttype = $newhash{'type'};
1.153 raeburn 681: $trole = &Apache::lonnet::plaintext($role,$ttype);
1.35 matthew 682: } else {
1.72 www 683: $twhere=&mt('Currently not available');
1.118 albertel 684: $env{'course.'.$tcourseid.'.description'}=$twhere;
1.80 albertel 685: $sortkey=$role."\0".$tdom."\0".$twhere."\0".$envkey;
1.152 raeburn 686: $ttype = 'Unavailable';
1.35 matthew 687: }
1.8 www 688: }
1.121 albertel 689: if ($tsection) {
1.175 albertel 690: $twhere.='<br />'.&mt('Section').': '.$tsection;
1.121 albertel 691: }
1.72 www 692: if ($role ne 'st') { $twhere.="<br />".&mt('Domain').":".$tdom; }
1.35 matthew 693: } elsif ($tdom) {
1.78 sakharuk 694: $ttype='Domain';
1.35 matthew 695: $twhere=$tdom;
1.75 albertel 696: $sortkey=$role.$twhere;
1.35 matthew 697: } else {
1.78 sakharuk 698: $ttype='System';
1.72 www 699: $twhere=&mt('system wide');
1.75 albertel 700: $sortkey=$role.$twhere;
1.13 www 701: }
1.209 raeburn 702: $roletext.=&build_roletext($trolecode,$tdom,$trest,$tstatus,$tryagain,$advanced,$tremark,$tbg,$tfont,$trole,$twhere,$tpstart,$tpend,$nochoose,$button,$switchserver,$reinit);
1.75 albertel 703: $roletext{$envkey}=$roletext;
704: if (!$sortkey) {$sortkey=$twhere."\0".$envkey;}
705: $sortrole{$sortkey}=$envkey;
706: $roleclass{$envkey}=$ttype;
1.55 albertel 707: }
1.4 www 708: }
1.75 albertel 709: }
1.196 raeburn 710: if ($env{'user.adv'}) {
711: $r->print(
712: '<br /><span class="LC_rolesinfo"><label>'.&mt('Show all roles').': <input type="checkbox" name="showall"');
713: if ($env{'form.showall'}) { $r->print(' checked="checked" '); }
714: $r->print(' /></label><input type="submit" value="'.&mt('Display').'" /></span>');
715: } else {
716: if ($countactive > 0) {
717: my $domdesc = &Apache::lonnet::domain($env{'user.domain'},'description');
1.201 raeburn 718: my $esc_dom = &HTML::Entities::encode($env{'user.domain'},'"<>&');
719: $r->print('<p>'.&mt('[_1]Visit the [_2]Course Catalog[_3] to view all [_4] LON-CAPA courses.','<b>','<a href="/adm/coursecatalog?showdom='.$esc_dom.'">','</a></b>',$domdesc).'<br />'.&mt('If a course is [_1]not[_2] in your list of current courses below, you may be able to enroll if self-enrollment is permitted.','<b>','</b>').'</p>');
1.196 raeburn 720: }
721: }
722:
1.84 www 723: # No active roles
724: if ($countactive==0) {
725: if ($inrole) {
726: $r->print('<h2>'.&mt('Currently no additional roles or courses').'</h2>');
727: } else {
728: $r->print('<h2>'.&mt('Currently no active roles or courses').'</h2>');
729: }
1.191 raeburn 730: &findcourse_advice($r);
731: $r->print('</form>');
732: if ($countfuture) {
733: $r->print(&mt('The following [quant,_1,role,roles] will become active in the future:',$countfuture));
734: my $doheaders = &roletable_headers($r,\%roleclass,\%sortrole,
735: $nochoose);
736: &print_rolerows($r,$doheaders,\%roleclass,\%sortrole,\%dcroles,
737: \%roletext);
738: my $tremark='';
739: my $tfont='#003300';
740: if ($env{'request.role'} eq 'cm') {
741: $r->print('<tr bgcolor="#11CC55">');
1.204 bisitz 742: $tremark=&mt('Currently selected.').' ';
1.191 raeburn 743: $tfont='#002200';
744: } else {
745: $r->print('<tr bgcolor="#77FF77">');
746: }
747: $r->print('<td></td><td colspan="3"><font color="'.$tfont.'"><span class="LC_rolesinfo">'.&mt('No role specified').
1.192 raeburn 748: '</span></font></td><td><font color="'.$tfont.'">'.$tremark.
1.191 raeburn 749: ' </font></td></tr>'."\n");
750:
751: $r->print('</table>');
752: }
753: $r->print(&Apache::loncommon::end_page());
1.84 www 754: return OK;
755: }
756: # ----------------------------------------------------------------------- Table
1.202 raeburn 757: unless ((!&Apache::lonmenu::show_course()) || ($nochoose) || ($countactive==1)) {
1.173 albertel 758: $r->print("<h2>".&mt('Select a Course to Enter')."</h2>\n");
1.84 www 759: }
1.191 raeburn 760: my $doheaders = &roletable_headers($r,\%roleclass,\%sortrole,$nochoose);
1.118 albertel 761: if ($env{'environment.recentroles'}) {
1.111 albertel 762: my %recent_roles =
1.118 albertel 763: &Apache::lonhtmlcommon::get_recent('roles',$env{'environment.recentrolesn'});
1.111 albertel 764: my $output='';
765: foreach (sort(keys(%recent_roles))) {
766: if (defined($roletext{'user.role.'.$_})) {
767: $output.=$roletext{'user.role.'.$_};
1.170 albertel 768: if ($_ =~ m-dc\./($match_domain)/-
769: && $dcroles{$1}) {
1.192 raeburn 770: $output .= &adhoc_roles_row($1,'recent');
1.133 albertel 771: }
1.113 raeburn 772: } elsif ($numdc > 0) {
773: unless ($_ =~/^error\:/) {
774: $output.=&display_cc_role('user.role.'.$_);
775: }
776: }
1.111 albertel 777: }
778: if ($output) {
1.132 albertel 779: $r->print("<tr><td align='center' colspan='5'><font face='arial'>".
1.192 raeburn 780: &mt('Recent Roles')."</font></td></tr>");
1.111 albertel 781: $r->print($output);
1.114 raeburn 782: $doheaders ++;
1.111 albertel 783: }
784: }
785:
1.104 raeburn 786: if ($numdc > 0) {
1.112 raeburn 787: $r->print(&coursepick_jscript());
1.193 raeburn 788: $r->print(&Apache::loncommon::coursebrowser_javascript().
789: &Apache::loncommon::authorbrowser_javascript());
1.108 raeburn 790: }
1.191 raeburn 791: &print_rolerows($r,$doheaders,\%roleclass,\%sortrole,\%dcroles,\%roletext);
1.202 raeburn 792: if ($countactive > 1) {
793: my $tremark='';
794: my $tfont='#003300';
795: if ($env{'request.role'} eq 'cm') {
796: $r->print('<tr bgcolor="#11CC55">');
1.204 bisitz 797: $tremark=&mt('Currently selected.').' ';
1.202 raeburn 798: $tfont='#002200';
799: } else {
800: $r->print('<tr bgcolor="#77FF77">');
801: }
802: unless ($nochoose) {
803: if ($env{'request.role'} ne 'cm') {
804: $r->print('<td><input type="submit" value="'.
805: &mt('Select').'" name="cm" /></td>');
806: } else {
807: $r->print('<td> </td>');
808: }
809: }
810: $r->print('<td colspan="3"><font color="'.$tfont.'"><span class="LC_rolesinfo">'.&mt('No role specified').
811: '</span></font></td><td><font color="'.$tfont.'">'.$tremark.
812: ' </font></td></tr>'."\n");
813: }
1.4 www 814: $r->print('</table>');
815: unless ($nochoose) {
816: $r->print("</form>\n");
817: }
1.22 harris41 818: # ------------------------------------------------------------ Privileges Info
1.118 albertel 819: if (($advanced) && (($env{'user.error.msg'}) || ($error))) {
1.127 albertel 820: $r->print('<hr /><h2>Current Privileges</h2>');
1.175 albertel 821: $r->print(&privileges_info());
1.4 www 822: }
1.66 www 823: $r->print(&Apache::lonnet::getannounce());
1.65 www 824: if ($advanced) {
1.201 raeburn 825: my $esc_dom = &HTML::Entities::encode($env{'user.domain'},'"<>&');
1.195 bisitz 826: $r->print('<p><small><i>'
827: .&mt('This is LON-CAPA [_1]',$r->dir_config('lonVersion'))
828: .'</i><br />'
1.197 raeburn 829: .'<a href="/adm/logout">'.&mt('Logout').'</a> '
1.201 raeburn 830: .'<a href="/adm/coursecatalog?showdom='.$esc_dom.'">'
831: .&mt('Course Catalog')
1.197 raeburn 832: .'</small></p>');
1.65 www 833: }
1.147 albertel 834: $r->print(&Apache::loncommon::end_page());
1.1 harris41 835: return OK;
1.102 raeburn 836: }
837:
1.209.4.1! raeburn 838: sub role_timezone {
! 839: my ($where,$timezones) = @_;
! 840: my $timezone;
! 841: if (ref($timezones) eq 'HASH') {
! 842: if ($where =~ m{^/($match_domain)/($match_courseid)}) {
! 843: my $cdom = $1;
! 844: my $cnum = $2;
! 845: if ($cdom && $cnum) {
! 846: if (!exists($timezones->{$cdom.'_'.$cnum})) {
! 847: my %timehash =
! 848: &Apache::lonnet::get('environment',['timezone'],$cdom,$cnum);
! 849: if ($timehash{'timezone'} eq '') {
! 850: if (!exists($timezones->{$cdom})) {
! 851: my %domdefaults =
! 852: &Apache::lonnet::get_domain_defaults($cdom);
! 853: if ($domdefaults{'timezone_def'} eq '') {
! 854: $timezones->{$cdom} = 'local';
! 855: } else {
! 856: $timezones->{$cdom} = $domdefaults{'timezone_def'};
! 857: }
! 858: }
! 859: $timezones->{$cdom.'_'.$cnum} = $timezones->{$cdom};
! 860: } else {
! 861: $timezones->{$cdom.'_'.$cnum} =
! 862: &Apache::lonlocal::gettimezone($timehash{'timezone'});
! 863: }
! 864: }
! 865: $timezone = $timezones->{$cdom.'_'.$cnum};
! 866: }
! 867: } else {
! 868: my ($tdom) = ($where =~ m{^/($match_domain)});
! 869: if ($tdom) {
! 870: if (!exists($timezones->{$tdom})) {
! 871: my %domdefaults = &Apache::lonnet::get_domain_defaults($tdom);
! 872: if ($domdefaults{'timezone_def'} eq '') {
! 873: $timezones->{$tdom} = 'local';
! 874: } else {
! 875: $timezones->{$tdom} = $domdefaults{'timezone_def'};
! 876: }
! 877: }
! 878: $timezone = $timezones->{$tdom};
! 879: }
! 880: }
! 881: if ($timezone eq 'local') {
! 882: $timezone = undef;
! 883: }
! 884: }
! 885: return $timezone;
! 886: }
! 887:
1.191 raeburn 888: sub roletable_headers {
889: my ($r,$roleclass,$sortrole,$nochoose) = @_;
890: my $doheaders;
891: if ((ref($sortrole) eq 'HASH') && (ref($roleclass) eq 'HASH')) {
892: $r->print('<br /><table id="LC_rolesmenu"><tr>');
893: if (!$nochoose) { $r->print('<th> </th>'); }
894: $r->print('<th>'.&mt('User Role').'</th><th>'.&mt('Extent')
895: .'</th><th>'.&mt('Start').'</th><th>'.&mt('End')
896: .'</th></tr>'."\n");
897: $doheaders=-1;
898: my @roletypes = &roletypes();
899: foreach my $type (@roletypes) {
900: my $haverole=0;
901: foreach my $which (sort {uc($a) cmp uc($b)} (keys(%{$sortrole}))) {
902: if ($roleclass->{$sortrole->{$which}} =~ /^\Q$type\E/) {
903: $haverole=1;
904: }
905: }
906: if ($haverole) { $doheaders++; }
907: }
908: }
909: return $doheaders;
910: }
911:
912: sub roletypes {
913: my @types = ('Domain','Construction Space','Course','Unavailable','System');
914: return @types;
915: }
916:
917: sub print_rolerows {
918: my ($r,$doheaders,$roleclass,$sortrole,$dcroles,$roletext) = @_;
919: if ((ref($roleclass) eq 'HASH') && (ref($sortrole) eq 'HASH')) {
920: my @types = &roletypes();
921: foreach my $type (@types) {
922: my $output;
923: foreach my $which (sort {uc($a) cmp uc($b)} (keys(%{$sortrole}))) {
924: if ($roleclass->{$sortrole->{$which}} =~ /^\Q$type\E/) {
925: if (ref($roletext) eq 'HASH') {
926: $output.=$roletext->{$sortrole->{$which}};
927: if ($sortrole->{$which} =~ m-dc\./($match_domain)/-) {
928: if (ref($dcroles) eq 'HASH') {
929: if ($dcroles->{$1}) {
1.192 raeburn 930: $output .= &adhoc_roles_row($1,'');
1.191 raeburn 931: }
932: }
933: }
934: }
935: }
936: }
937: if ($output) {
938: if ($doheaders > 0) {
939: $r->print("<tr>".
940: "<td align='center' colspan='5'><font face='arial'>".
941: &mt($type)."</font></td></tr>");
942: }
943: $r->print($output);
944: }
945: }
946: }
947: }
948:
949: sub findcourse_advice {
950: my ($r) = @_;
951: my $domdesc = &Apache::lonnet::domain($env{'user.domain'},'description');
1.201 raeburn 952: my $esc_dom = &HTML::Entities::encode($env{'user.domain'},'"<>&');
1.200 raeburn 953: if (&Apache::lonnet::auto_run(undef,$env{'user.domain'})) {
1.191 raeburn 954: $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).'
955: <ul>
956: <li>'.&mt('The course has yet to be created.').'</li>
957: <li>'.&mt('Automatic enrollment of registered students has not been enabled for the course.').'</li>
958: <li>'.&mt('You are in a section of course for which automatic enrollment in the corresponding LON-CAPA course is not active.').'</li>
959: <li>'.&mt('The start date for automated enrollment has yet to be reached.').'</li>
960: <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>
961: </ul>');
962: } else {
963: $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 />');
964: }
1.201 raeburn 965: $r->print('<p>'.&mt('The [_1]Course Catalog[_2] provides information about all [_3] classes for which LON-CAPA courses have been created.','<a href="/adm/coursecatalog?showdom='.$esc_dom.'">','</a>',$domdesc).'<br />');
1.191 raeburn 966: $r->print(&mt('You can search the course catalog for courses which permit self-enrollment, if you would like to enroll in a course.').'</p>');
967: return;
968: }
969:
1.175 albertel 970: sub privileges_info {
971: my ($which) = @_;
972: my $output;
973:
974: $which ||= $env{'request.role'};
975:
976: foreach my $envkey (sort(keys(%env))) {
977: next if ($envkey!~/^user\.priv\.\Q$which\E\.(.*)/);
978:
979: my $where=$1;
980: my $ttype;
981: my $twhere;
982: my (undef,$tdom,$trest,$tsec)=split(m{/},$where);
983: if ($trest) {
984: if ($env{'course.'.$tdom.'_'.$trest.'.description'} eq 'ca') {
985: $ttype='Construction Space';
986: $twhere='User: '.$trest.', Domain: '.$tdom;
987: } else {
988: $ttype= &Apache::loncommon::course_type($tdom.'_'.$trest);
989: $twhere=$env{'course.'.$tdom.'_'.$trest.'.description'};
990: if ($tsec) {
991: my $sec_type = 'Section';
992: if (exists($env{"user.role.gr.$where"})) {
993: $sec_type = 'Group';
994: }
995: $twhere.=' ('.$sec_type.': '.$tsec.')';
996: }
997: }
998: } elsif ($tdom) {
999: $ttype='Domain';
1000: $twhere=$tdom;
1001: } else {
1002: $ttype='System';
1003: $twhere='/';
1004: }
1.204 bisitz 1005: $output .= "\n<h3>".&mt($ttype).': '.$twhere.'</h3>'."\n<ul>";
1.175 albertel 1006: foreach my $priv (sort(split(/:/,$env{$envkey}))) {
1007: next if (!$priv);
1008:
1009: my ($prv,$restr)=split(/\&/,$priv);
1010: my $trestr='';
1011: if ($restr ne 'F') {
1012: $trestr.=' ('.
1013: join(', ',
1014: map { &Apache::lonnet::plaintext($_) }
1015: (split('',$restr))).') ';
1016: }
1017: $output .= "\n\t".
1018: '<li>'.&Apache::lonnet::plaintext($prv).$trestr.'</li>';
1019: }
1020: $output .= "\n".'</ul>';
1021: }
1022: return $output;
1023: }
1024:
1.102 raeburn 1025: sub role_status {
1026: my ($rolekey,$then,$now,$role,$where,$trolecode,$tstatus,$tstart,$tend) = @_;
1027: my @pwhere = ();
1.118 albertel 1028: if (exists($env{$rolekey}) && $env{$rolekey} ne '') {
1.102 raeburn 1029: (undef,undef,$$role,@pwhere)=split(/\./,$rolekey);
1030: unless (!defined($$role) || $$role eq '') {
1031: $$where=join('.',@pwhere);
1032: $$trolecode=$$role.'.'.$$where;
1.118 albertel 1033: ($$tstart,$$tend)=split(/\./,$env{$rolekey});
1.102 raeburn 1034: $$tstatus='is';
1.105 raeburn 1035: if ($$tstart && $$tstart>$then) {
1036: $$tstatus='future';
1037: if ($$tstart<$now) { $$tstatus='will'; }
1.102 raeburn 1038: }
1039: if ($$tend) {
1040: if ($$tend<$then) {
1041: $$tstatus='expired';
1.103 raeburn 1042: } elsif ($$tend<$now) {
1.104 raeburn 1043: $$tstatus='will_not';
1.102 raeburn 1044: }
1045: }
1046: }
1047: }
1048: }
1.1 harris41 1049:
1.110 raeburn 1050: sub build_roletext {
1.209 raeburn 1051: my ($trolecode,$tdom,$trest,$tstatus,$tryagain,$advanced,$tremark,$tbg,$tfont,$trole,$twhere,$tpstart,$tpend,$nochoose,$button,$switchserver,$reinit) = @_;
1.177 www 1052: my $roletext='<tr bgcolor="'.$tbg.'" class="LC_rolesmenu_'.$tstatus.'">';
1.132 albertel 1053: my $is_dc=($trolecode =~ m/^dc\./);
1054: my $rowspan=($is_dc) ? ''
1055: : ' rowspan="2" ';
1056:
1.110 raeburn 1057: unless ($nochoose) {
1.134 www 1058: my $buttonname=$trolecode;
1059: $buttonname=~s/\W//g;
1.110 raeburn 1060: if (!$button) {
1061: if ($switchserver) {
1.177 www 1062: $roletext.='<td'.$rowspan.'><span class="LC_rolesinfo"><a href="/adm/switchserver?'.
1063: $switchserver.'">'.&mt('Switch Server').'</a></span></td>';
1.110 raeburn 1064: } else {
1.164 albertel 1065: $roletext.=('<td'.$rowspan.'> </td>');
1.110 raeburn 1066: }
1067: } elsif ($tstatus eq 'is') {
1.134 www 1068: $roletext.='<td'.$rowspan.'><input name="'.$buttonname.'" type="button" value="'.
1069: &mt('Select').'" onClick="javascript:enterrole(this.form,\''.
1.192 raeburn 1070: $trolecode."','".$buttonname.'\');" /></td>';
1.110 raeburn 1071: } elsif ($tryagain) {
1072: $roletext.=
1.134 www 1073: '<td'.$rowspan.'><input name="'.$buttonname.'" type="button" value="'.
1074: &mt('Try Selecting Again').'" onClick="javascript:enterrole(this.form,\''.
1.192 raeburn 1075: $trolecode."','".$buttonname.'\');" /></td>';
1.110 raeburn 1076: } elsif ($advanced) {
1077: $roletext.=
1.134 www 1078: '<td'.$rowspan.'><input name="'.$buttonname.'" type="button" value="'.
1079: &mt('Re-Initialize').'" onClick="javascript:enterrole(this.form,\''.
1.192 raeburn 1080: $trolecode."','".$buttonname.'\');" /></td>';
1.209 raeburn 1081: } elsif ($reinit) {
1082: $roletext.=
1083: '<td'.$rowspan.'><input name="'.$buttonname.'" type="button" value="'.
1084: &mt('Re-Select').'" onClick="javascript:enterrole(this.form,\''.
1085: $trolecode."','".$buttonname.'\');" /></td>';
1.110 raeburn 1086: } else {
1.209 raeburn 1087: $roletext.=
1088: '<td'.$rowspan.'><input name="'.$buttonname.'" type="button" value="'.
1089: &mt('Re-Initialize').'" onClick="javascript:enterrole(this.form,\''.
1090: $trolecode."','".$buttonname.'\');" /></td>';
1.110 raeburn 1091: }
1092: }
1.165 albertel 1093: if ($trolecode !~ m/^(dc|ca|au|aa)\./) {
1094: $tremark.=&Apache::lonannounce::showday(time,1,
1095: &Apache::lonannounce::readcalendar($tdom.'_'.$trest));
1096: }
1.110 raeburn 1097: $roletext.='<td><font color="'.$tfont.'">'.$trole.
1.121 albertel 1098: '</font></td><td><font color="'.$tfont.'">'.$twhere.
1.110 raeburn 1099: '</font></td><td><font color="'.$tfont.'">'.$tpstart.
1100: '</font></td><td><font color="'.$tfont.'">'.$tpend.
1.132 albertel 1101: '</font></td></tr>';
1102: if (!$is_dc) {
1.177 www 1103: $roletext.='<tr bgcolor="'.$tbg.'"><td colspan="4"><font color="'.$tfont.'"><span class="LC_rolesinfo">'.$tremark.
1104: '</span> </font></td></tr><tr><td colspan="5" height="3"></td></tr>'."\n";
1.132 albertel 1105: }
1.110 raeburn 1106: return $roletext;
1107: }
1108:
1.202 raeburn 1109: sub check_needs_switchserver {
1110: my ($possiblerole) = @_;
1111: my $needs_switchserver;
1112: my ($role,$where) = split(/\./,$possiblerole,2);
1113: my (undef,$tdom,$twho) = split(/\//,$where);
1114: my ($server_status,$home);
1115: if (($role eq 'ca') || ($role eq 'aa')) {
1116: ($server_status,$home) = &check_author_homeserver($twho,$tdom);
1117: } else {
1118: ($server_status,$home) = &check_author_homeserver($env{'user.name'},
1119: $env{'user.domain'});
1120: }
1121: if ($server_status eq 'switchserver') {
1122: $needs_switchserver = 1;
1123: }
1124: return $needs_switchserver;
1125: }
1126:
1.193 raeburn 1127: sub check_author_homeserver {
1.183 www 1128: my ($uname,$udom)=@_;
1.193 raeburn 1129: if (($uname eq '') || ($udom eq '')) {
1130: return ('fail','');
1131: }
1.183 www 1132: my $home = &Apache::lonnet::homeserver($uname,$udom);
1.193 raeburn 1133: if (&Apache::lonnet::host_domain($home) ne $udom) {
1134: return ('fail',$home);
1135: }
1.183 www 1136: my @ids=&Apache::lonnet::current_machine_ids();
1.193 raeburn 1137: if (grep(/^\Q$home\E$/,@ids)) {
1138: return ('ok',$home);
1139: } else {
1140: return ('switchserver',$home);
1.183 www 1141: }
1142: }
1143:
1.110 raeburn 1144: sub check_privs {
1.182 www 1145: my ($cdom,$cnum,$then,$now,$checkrole) = @_;
1146: my $cckey = 'user.role.'.$checkrole.'./'.$cdom.'/'.$cnum;
1.118 albertel 1147: if ($env{$cckey}) {
1.110 raeburn 1148: my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus,$tpstart,$tpend,$tfont);
1149: &role_status($cckey,$then,$now,\$role,\$where,\$trolecode,\$tstatus,\$tstart,\$tend);
1150: unless (($tstatus eq 'is') || ($tstatus eq 'will_not')) {
1.182 www 1151: &set_privileges($cdom,$cnum,$checkrole);
1.110 raeburn 1152: }
1153: } else {
1.182 www 1154: &set_privileges($cdom,$cnum,$checkrole);
1.110 raeburn 1155: }
1156: }
1157:
1.104 raeburn 1158: sub check_fordc {
1159: my ($dcroles,$then) = @_;
1160: my $numdc = 0;
1.118 albertel 1161: if ($env{'user.adv'}) {
1162: foreach my $envkey (sort keys %env) {
1.170 albertel 1163: if ($envkey=~/^user\.role\.dc\.\/($match_domain)\/$/) {
1.104 raeburn 1164: my $dcdom = $1;
1165: my $livedc = 1;
1.118 albertel 1166: my ($tstart,$tend)=split(/\./,$env{$envkey});
1.105 raeburn 1167: if ($tstart && $tstart>$then) { $livedc = 0; }
1168: if ($tend && $tend <$then) { $livedc = 0; }
1.104 raeburn 1169: if ($livedc) {
1170: $$dcroles{$dcdom} = $envkey;
1.105 raeburn 1171: $numdc++;
1.104 raeburn 1172: }
1173: }
1174: }
1175: }
1176: return $numdc;
1177: }
1178:
1.185 raeburn 1179: sub adhoc_course_role {
1180: my ($then) = @_;
1181: my ($cdom,$cnum);
1.201 raeburn 1182: $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
1183: $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
1.185 raeburn 1184: if (&check_forcc($cdom,$cnum,$then)) {
1185: my $setprivs;
1.198 raeburn 1186: if (!defined($env{'user.role.'.$env{'form.switchrole'}})) {
1.185 raeburn 1187: $setprivs = 1;
1188: } else {
1.198 raeburn 1189: my ($start,$end) = split(/\./,$env{'user.role.'.$env{'form.switchrole'}});
1.185 raeburn 1190: if (($start && ($start>$then || $start == -1)) ||
1191: ($end && $end<$then)) {
1192: $setprivs = 1;
1193: }
1194: }
1195: if ($setprivs) {
1.198 raeburn 1196: if ($env{'form.switchrole'} =~ m-^(in|ta|ep|ad|st|cr)([\w/]*)\./\Q$cdom\E/\Q$cnum\E/?(\w*)$-) {
1.185 raeburn 1197: my $role = $1;
1198: my $custom_role = $2;
1199: my $usec = $3;
1200: if ($role eq 'cr') {
1.199 raeburn 1201: if ($custom_role =~ m-^/$match_domain/$match_username/\w+$-) {
1.185 raeburn 1202: $role .= $custom_role;
1203: } else {
1204: return;
1205: }
1206: }
1.208 raeburn 1207: my (%userroles,%newrole,%newgroups,%group_privs);
1208: my %cgroups =
1209: &Apache::lonnet::get_active_groups($env{'user.domain'},
1210: $env{'user.name'},$cdom,$cnum);
1211: foreach my $group (keys(%cgroups)) {
1212: $group_privs{$group} =
1213: $env{'user.priv.cc./'.$cdom.'/'.$cnum.'./'.$cdom.'/'.$cnum.'/'.$group};
1214: }
1215: $newgroups{'/'.$cdom.'/'.$cnum} = \%group_privs;
1.185 raeburn 1216: my $area = '/'.$cdom.'/'.$cnum;
1217: my $spec = $role.'.'.$area;
1218: if ($usec ne '') {
1219: $spec .= '/'.$usec;
1220: $area .= '/'.$usec;
1221: }
1222: &Apache::lonnet::standard_roleprivs(\%newrole,$role,$cdom,$spec,$cnum,$area);
1.208 raeburn 1223: &Apache::lonnet::set_userprivs(\%userroles,\%newrole,\%newgroups);
1.185 raeburn 1224: my $adhocstart = $then-1;
1225: $userroles{'user.role.'.$spec} = $adhocstart.'.';
1.186 raeburn 1226: &Apache::lonnet::appenv(\%userroles,[$role,'cm']);
1.185 raeburn 1227: }
1228: }
1229: }
1230: return;
1231: }
1232:
1233: sub check_forcc {
1234: my ($cdom,$cnum,$then) = @_;
1235: my $is_cc;
1236: if ($cdom ne '' && $cnum ne '') {
1237: if (&Apache::lonnet::is_course($cdom,$cnum)) {
1238: my $envkey = 'user.role.cc./'.$cdom.'/'.$cnum;
1239: if (defined($env{$envkey})) {
1240: $is_cc = 1;
1241: my ($tstart,$tend)=split(/\./,$env{$envkey});
1242: if ($tstart && $tstart>$then) { $is_cc = 0; }
1243: if ($tend && $tend <$then) { $is_cc = 0; }
1244: }
1245: }
1246: }
1247: return $is_cc;
1248: }
1249:
1.108 raeburn 1250: sub courselink {
1.193 raeburn 1251: my ($dcdom,$rowtype) = @_;
1.109 raeburn 1252: my $courseform=&Apache::loncommon::selectcourse_link
1.152 raeburn 1253: ('rolechoice','dccourse'.$rowtype.'_'.$dcdom,
1254: 'dcdomain'.$rowtype.'_'.$dcdom,'coursedesc'.$rowtype.'_'.
1.173 albertel 1255: $dcdom,$dcdom,undef);
1.138 raeburn 1256: my $hiddenitems = '<input type="hidden" name="dcdomain'.$rowtype.'_'.$dcdom.'" value="'.$dcdom.'" />'.
1257: '<input type="hidden" name="origdom'.$rowtype.'_'.$dcdom.'" value="'.$dcdom.'" />'.
1258: '<input type="hidden" name="dccourse'.$rowtype.'_'.$dcdom.'" value="" />'.
1259: '<input type="hidden" name="coursedesc'.$rowtype.'_'.$dcdom.'" value="" />';
1.112 raeburn 1260: return $courseform.$hiddenitems;
1.109 raeburn 1261: }
1262:
1263: sub coursepick_jscript {
1.184 raeburn 1264: my %lt = &Apache::lonlocal::texthash(
1265: plsu => "Please use the 'Select Course' link to open a separate pick course window where you may select the course you wish to enter.",
1266: youc => 'You can only use this screen to select courses in the current domain.',
1267: );
1.104 raeburn 1268: my $verify_script = <<"END";
1.179 raeburn 1269: <script type="text/javascript">
1.108 raeburn 1270: function verifyCoursePick(caller) {
1271: var numbutton = getIndex(caller)
1.112 raeburn 1272: var pickedCourse = document.rolechoice.elements[numbutton+4].value
1273: var pickedDomain = document.rolechoice.elements[numbutton+2].value
1274: if (document.rolechoice.elements[numbutton+2].value == document.rolechoice.elements[numbutton+3].value) {
1.104 raeburn 1275: if (pickedCourse != '') {
1.108 raeburn 1276: if (numbutton != -1) {
1277: var courseTarget = "cc./"+pickedDomain+"/"+pickedCourse
1278: document.rolechoice.elements[numbutton+1].name = courseTarget
1279: document.rolechoice.submit()
1280: }
1.104 raeburn 1281: }
1282: else {
1.184 raeburn 1283: alert("$lt{'plsu'}");
1.104 raeburn 1284: }
1285: }
1286: else {
1.184 raeburn 1287: alert("$lt{'youc'}")
1.104 raeburn 1288: }
1289: }
1.109 raeburn 1290: function getIndex(caller) {
1.108 raeburn 1291: for (var i=0;i<document.rolechoice.elements.length;i++) {
1.109 raeburn 1292: if (document.rolechoice.elements[i] == caller) {
1.108 raeburn 1293: return i;
1294: }
1295: }
1296: return -1;
1297: }
1.104 raeburn 1298: </script>
1299: END
1.109 raeburn 1300: return $verify_script;
1.104 raeburn 1301: }
1302:
1.193 raeburn 1303: sub coauthorlink {
1304: my ($dcdom,$rowtype) = @_;
1305: my $coauthorform=&Apache::loncommon::selectauthor_link('rolechoice',$dcdom);
1306: my $hiddenitems = '<input type="hidden" name="adhoccauname'.$rowtype.'_'.$dcdom.'" value="" />';
1307: return $coauthorform.$hiddenitems;
1308: }
1309:
1.113 raeburn 1310: sub display_cc_role {
1311: my $rolekey = shift;
1312: my $roletext;
1.118 albertel 1313: my $advanced = $env{'user.adv'};
1314: my $tryagain = $env{'form.tryagain'};
1.113 raeburn 1315: unless ($rolekey =~/^error\:/) {
1.171 albertel 1316: if ($rolekey =~ m-^user\.role.cc\./($match_domain)/($match_courseid)$-) {
1.113 raeburn 1317: my $tcourseid = $1.'_'.$2;
1318: my $trolecode = 'cc./'.$1.'/'.$2;
1319: my $twhere;
1.152 raeburn 1320: my $ttype;
1.113 raeburn 1321: my $tbg='#77FF77';
1322: my $tfont='#003300';
1323: my %newhash=&Apache::lonnet::coursedescription($tcourseid);
1324: if (%newhash) {
1325: $twhere=$newhash{'description'}.
1326: ' <font size="-2">'.
1327: &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$2,$1,$tfont).
1328: '</font>';
1.153 raeburn 1329: $ttype = $newhash{'type'};
1.113 raeburn 1330: } else {
1331: $twhere=&mt('Currently not available');
1.118 albertel 1332: $env{'course.'.$tcourseid.'.description'}=$twhere;
1.110 raeburn 1333: }
1.153 raeburn 1334: my $trole = &Apache::lonnet::plaintext('cc',$ttype);
1.113 raeburn 1335: $twhere.="<br />".&mt('Domain').":".$1;
1.152 raeburn 1336: $roletext = &build_roletext($trolecode,$1,$2,'is',$tryagain,$advanced,'',$tbg,$tfont,$trole,$twhere,'','','',1,'');
1.104 raeburn 1337: }
1338: }
1.152 raeburn 1339: return ($roletext);
1.104 raeburn 1340: }
1341:
1.192 raeburn 1342: sub adhoc_roles_row {
1.138 raeburn 1343: my ($dcdom,$rowtype) = @_;
1.132 albertel 1344: my $output = '<tr bgcolor="#77FF77">'.
1.192 raeburn 1345: ' <td colspan="5"><table><tr><td><span class="LC_rolesinfo">'
1346: .&mt('[_1]Ad hoc[_2] roles in domain [_3] --',
1347: '<span class="LC_cusr_emph">','</span>',$dcdom).'</span></td><td>';
1.193 raeburn 1348: my $selectcclink = &courselink($dcdom,$rowtype);
1.173 albertel 1349: my $ccrole = &Apache::lonnet::plaintext('cc');
1.182 www 1350: my $carole = &Apache::lonnet::plaintext('ca');
1.193 raeburn 1351: my $selectcalink = &coauthorlink($dcdom,$rowtype);
1.182 www 1352: $output.= '<span class="LC_rolesinfo">'.
1.193 raeburn 1353: &mt('[_1]: [_2]',$ccrole,$selectcclink).
1.192 raeburn 1354: '</span><br /></td><td> </td><td><span class="LC_rolesinfo">'.
1.193 raeburn 1355: &mt('[_1]: [_2]',$carole,$selectcalink).
1.192 raeburn 1356: '</span><br /></td></tr></table></td></tr>'.
1357: '<tr><td colspan="5" height="3"></td></tr>'."\n";
1.108 raeburn 1358: return $output;
1359: }
1360:
1.104 raeburn 1361: sub recent_filename {
1362: my $area=shift;
1.149 www 1363: return 'nohist_recent_'.&escape($area);
1.104 raeburn 1364: }
1365:
1.106 raeburn 1366: sub set_privileges {
1.182 www 1367: # role can be cc or ca
1368: my ($dcdom,$pickedcourse,$role) = @_;
1.106 raeburn 1369: my $area = '/'.$dcdom.'/'.$pickedcourse;
1370: my $spec = $role.'.'.$area;
1.168 albertel 1371: my %userroles = &Apache::lonnet::set_arearole($role,$area,'','',
1372: $env{'user.domain'},
1373: $env{'user.name'});
1.106 raeburn 1374: my %ccrole = ();
1375: &Apache::lonnet::standard_roleprivs(\%ccrole,$role,$dcdom,$spec,$pickedcourse,$area);
1.154 albertel 1376: my ($author,$adv)= &Apache::lonnet::set_userprivs(\%userroles,\%ccrole);
1.186 raeburn 1377: &Apache::lonnet::appenv(\%userroles,[$role,'cm']);
1.184 raeburn 1378:
1.118 albertel 1379: &Apache::lonnet::log($env{'user.domain'},
1380: $env{'user.name'},
1381: $env{'user.home'},
1.106 raeburn 1382: "Role ".$role);
1383: &Apache::lonnet::appenv(
1.186 raeburn 1384: {'request.role' => $spec,
1.106 raeburn 1385: 'request.role.domain' => $dcdom,
1.186 raeburn 1386: 'request.course.sec' => ''});
1.106 raeburn 1387: my $tadv=0;
1388: if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
1.186 raeburn 1389: &Apache::lonnet::appenv({'request.role.adv' => $tadv});
1.106 raeburn 1390: }
1391:
1.139 raeburn 1392: sub courseloadpage {
1393: my ($courseid) = @_;
1394: my $startpage;
1.144 albertel 1395: my %entry_settings = &Apache::lonnet::get('nohist_whatsnew',
1396: [$courseid.':courseinit']);
1.139 raeburn 1397: my ($tmp) = %entry_settings;
1.144 albertel 1398: unless ($tmp =~ /^error: 2 /) {
1.139 raeburn 1399: $startpage = $entry_settings{$courseid.':courseinit'};
1400: }
1401: if ($startpage eq '') {
1402: if (exists($env{'environment.course_init_display'})) {
1403: $startpage = $env{'environment.course_init_display'};
1404: }
1405: }
1406: return $startpage;
1407: }
1408:
1.1 harris41 1409: 1;
1410: __END__
1.32 harris41 1411:
1412: =head1 NAME
1413:
1414: Apache::lonroles - User Roles Screen
1415:
1416: =head1 SYNOPSIS
1417:
1418: Invoked by /etc/httpd/conf/srm.conf:
1419:
1420: <Location /adm/roles>
1421: PerlAccessHandler Apache::lonacc
1422: SetHandler perl-script
1423: PerlHandler Apache::lonroles
1424: ErrorDocument 403 /adm/login
1425: ErrorDocument 500 /adm/errorhandler
1426: </Location>
1.64 bowersj2 1427:
1428: =head1 OVERVIEW
1429:
1430: =head2 Choosing Roles
1431:
1432: C<lonroles> is a handler that allows a user to switch roles in
1433: mid-session. LON-CAPA attempts to work with "No Role Specified", the
1434: default role that a user has before selecting a role, as widely as
1435: possible, but certain handlers for example need specification which
1436: course they should act on, etc. Both in this scenario, and when the
1437: handler determines via C<lonnet>'s C<&allowed> function that a certain
1438: action is not allowed, C<lonroles> is used as error handler. This
1439: allows the user to select another role which may have permission to do
1440: what they were trying to do. C<lonroles> can also be accessed via the
1441: B<CRS> button in the Remote Control.
1442:
1443: =begin latex
1444:
1445: \begin{figure}
1446: \begin{center}
1447: \includegraphics[width=0.45\paperwidth,keepaspectratio]{Sample_Roles_Screen}
1448: \caption{\label{Sample_Roles_Screen}Sample Roles Screen}
1449: \end{center}
1450: \end{figure}
1451:
1452: =end latex
1453:
1454: =head2 Role Initialization
1455:
1456: 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.
1.32 harris41 1457:
1458: =head1 INTRODUCTION
1459:
1460: This module enables a user to select what role he wishes to
1461: operate under (instructor, student, teaching assistant, course
1462: coordinator, etc). These roles are pre-established by the actions
1463: of upper-level users.
1464:
1465: This is part of the LearningOnline Network with CAPA project
1466: described at http://www.lon-capa.org.
1467:
1468: =head1 HANDLER SUBROUTINE
1469:
1470: This routine is called by Apache and mod_perl.
1471:
1472: =over 4
1473:
1474: =item *
1475:
1476: Roles Initialization (yes/no)
1477:
1478: =item *
1479:
1480: Get Error Message from Environment
1481:
1482: =item *
1483:
1484: Who is this?
1485:
1486: =item *
1487:
1488: Generate Page Output
1489:
1490: =item *
1491:
1492: Choice or no choice
1493:
1494: =item *
1495:
1496: Table
1497:
1498: =item *
1499:
1500: Privileges
1501:
1502: =back
1503:
1504: =cut
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/back.gif){kind=icon}
Return to lonroles.pm CVS log ![[TXT]](/icons/text.gif){kind=icon}
![[DIR]](/icons/dir.gif){kind=icon}
Up to [LON-CAPA] / loncom / auth