[BACK]Return to lonroles.pm CVS log [TXT] [DIR] Up to [LON-CAPA] / loncom / auth

Diff for /loncom/auth/lonroles.pm between versions 1.11 and 1.117

version 1.11, 2000/10/04 15:29:50 version 1.117, 2005/03/03 07:32:49
Line 1 Line 1
 # The LearningOnline Network with CAPA  # The LearningOnline Network with CAPA
 # User Roles Screen  # User Roles Screen
 # (Directory Indexer  
 # (Login Screen  
 # 5/21/99,5/22,5/25,5/26,5/31,6/2,6/10,7/12,7/14 Gerd Kortemeyer)  
 # 11/23 Gerd Kortemeyer)  
 # 1/14,03/06,06/01,07/22,07/24,07/25,  
 # 09/04,09/06,09/28,09/29,09/30,10/2 Gerd Kortemeyer  
 #  #
   # $Id$
   #
   # Copyright Michigan State University Board of Trustees
   #
   # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
   #
   # LON-CAPA is free software; you can redistribute it and/or modify
   # it under the terms of the GNU General Public License as published by
   # the Free Software Foundation; either version 2 of the License, or
   # (at your option) any later version.
   #
   # LON-CAPA is distributed in the hope that it will be useful,
   # but WITHOUT ANY WARRANTY; without even the implied warranty of
   # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   # GNU General Public License for more details.
   #
   # You should have received a copy of the GNU General Public License
   # along with LON-CAPA; if not, write to the Free Software
   # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   #
   # /home/httpd/html/adm/gpl.txt
   #
   # http://www.lon-capa.org/
   #
   ###
   
 package Apache::lonroles;  package Apache::lonroles;
   
 use strict;  use strict;
Line 14  use Apache::lonnet(); Line 34  use Apache::lonnet();
 use Apache::lonuserstate();  use Apache::lonuserstate();
 use Apache::Constants qw(:common);  use Apache::Constants qw(:common);
 use Apache::File();  use Apache::File();
   use Apache::lonmenu;
   use Apache::loncommon;
   use Apache::lonhtmlcommon;
   use Apache::lonannounce;
   use Apache::lonlocal;
   
   sub redirect_user {
       my ($r,$title,$url,$msg,$launch_nav) = @_;
       $msg = $title if (! defined($msg));
       &Apache::loncommon::content_type($r,'text/html');
       &Apache::loncommon::no_cache($r);
       $r->send_http_header;
       my $swinfo=&Apache::lonmenu::rawconfig();
       my $navwindow;
       if ($launch_nav eq 'on') {
    $navwindow.=&Apache::lonnavmaps::launch_win('now');
       } else {
    $navwindow.=&Apache::lonnavmaps::close();
       }
       my $bodytag=&Apache::loncommon::bodytag('Switching Role');
   # Note to style police: 
   # This must only replace the spaces, nothing else, or it bombs elsewhere.
       $url=~s/ /\%20/g;
       $r->print(<<ENDREDIR);
   <head><title>$title</title>
   <meta HTTP-EQUIV="Refresh" CONTENT="1; url=$url">
   </head>
   <html>
   $bodytag
   <script type="text/javascript">
   $swinfo
   </script>
   $navwindow
   <h1>$msg</h1>
   <a href="$url">Continue</a>
   </body>
   </html>
   ENDREDIR
       return;
   }
   
 sub handler {  sub handler {
   
Line 22  sub handler { Line 82  sub handler {
     my $now=time;      my $now=time;
     my $then=$ENV{'user.login.time'};      my $then=$ENV{'user.login.time'};
     my $envkey;      my $envkey;
       my %dcroles = ();
       my $numdc = &check_fordc(\%dcroles,$then);
   
 # ================================================================== Roles Init  # ================================================================== Roles Init
   
     if ($ENV{'form.selectrole'}) {      if ($ENV{'form.selectrole'}) {
        foreach $envkey (keys %ENV) {   if ($ENV{'request.course.id'}) {
           if ($envkey=~/^user\.role\./) {      my %temp=('logout_'.$ENV{'request.course.id'} => time);
     my ($dum1,$dum2,$role,@pwhere)=split(/\./,$envkey);      &Apache::lonnet::put('email_status',\%temp);
             my $where=join('.',@pwhere);      &Apache::lonnet::delenv('user.state.'.$ENV{'request.course.id'});
             my $trolecode=$role.'.'.$where;   }
    &Apache::lonnet::appenv("request.course.id"   => '',
    "request.course.fn"   => '',
    "request.course.uri"  => '',
    "request.course.sec"  => '',
    "request.role"        => 'cm',
                                   "request.role.adv"    => $ENV{'user.adv'},
    "request.role.domain" => $ENV{'user.domain'});
   
   # Check if user is a DC trying to enter a course and needs privs to be created
           if ($numdc > 0) {
               foreach my $envkey (keys %ENV) {
                   if ($envkey =~ m-^form\.cc\./(\w+)/(\w+)$-) {
                       if ($dcroles{$1}) {
                           my $cckey = 'user.role.cc./'.$1.'/'.$2;
                           &check_privs($cckey,$then,$now);
                       }
                       last;
                   }
               }
           }
   
           foreach $envkey (keys %ENV) {
               next if ($envkey!~/^user\.role\./);
               my ($where,$trolecode,$role,$tstatus,$tend,$tstart);
               &role_status($envkey,$then,$now,\$role,\$where,\$trolecode,\$tstatus,\$tstart,\$tend);
             if ($ENV{'form.'.$trolecode}) {              if ($ENV{'form.'.$trolecode}) {
                my ($tstart,$tend)=split(/\./,$ENV{$envkey});   if ($tstatus eq 'is') {
                my $tstatus='is';      $where=~s/^\///;
                if ($tstart) {      my ($cdom,$cnum,$csec)=split(/\//,$where);
        if ($tstart>$then) {   # store role if recent_role list being kept
                      $tstatus='future';                      if ($ENV{'environment.recentroles'}) {
                   }   &Apache::lonhtmlcommon::store_recent('roles',
                }       $trolecode,' ');
                if ($tend) {                      }
                   if ($tend<$then) { $tstatus='expired'; }  
                   if ($tend>$now) { $tstatus='will_not'; }  
                }  # check for keyed access
                if ($tstatus eq 'is') {      if (($role eq 'st') && 
                    &Apache::lonnet::appenv('request.role' => $trolecode);                         ($ENV{'course.'.$cdom.'_'.$cnum.'.keyaccess'} eq 'yes')) {
                    my ($cdom,$cnum)=split(/\//,$where);  # who is key authority?
                    if ($cnum) {   my $authdom=$cdom;
       &Apache::lonuserstate::readmap($where);   my $authnum=$cnum;
                       if ($ENV{'form.orgurl'}) {   if ($ENV{'course.'.$cdom.'_'.$cnum.'.keyauth'}) {
                          $r->internal_redirect($ENV{'form.orgurl'});      ($authnum,$authdom)=
                          return OK;   split(/\W/,$ENV{'course.'.$cdom.'_'.$cnum.'.keyauth'});
       }   }
                    }  # check with key authority
                }   unless (&Apache::lonnet::validate_access_key(
             }        $ENV{'environment.key.'.$cdom.'_'.$cnum},
   }       $authdom,$authnum)) {
   # there is no valid key
        if ($ENV{'form.newkey'}) {
   # student attempts to register a new key
    &Apache::loncommon::content_type($r,'text/html');
    &Apache::loncommon::no_cache($r);
    $r->send_http_header;
    my $swinfo=&Apache::lonmenu::rawconfig();
    my $bodytag=&Apache::loncommon::bodytag
       ('Verifying Access Key to Unlock this Course');
    my $buttontext=&mt('Enter Course');
    my $message=&mt('Successfully registered key');
    my $assignresult=
        &Apache::lonnet::assign_access_key(
        $ENV{'form.newkey'},
        $authdom,$authnum,
        $cdom,$cnum,
                                                        $ENV{'user.domain'},
        $ENV{'user.name'},
         'Assigned from '.$ENV{'REMOTE_ADDR'}.' at '.localtime().' for '.
                                                        $trolecode);
    unless ($assignresult eq 'ok') {
        $assignresult=~s/^error\:\s*//;
        $message=&mt($assignresult).
        '<br /><a href="/adm/logout">'.
        &mt('Logout').'</a>';
        $buttontext=&mt('Re-Enter Key');
    }
    $r->print(<<ENDENTEREDKEY);
   <head><title>Verifying Course Access Key</title>
   </head>
   <html>
   $bodytag
   <script>
   $swinfo
   </script>
   <form method="post">
   <input type="hidden" name="selectrole" value="1" />
   <input type="hidden" name="$trolecode" value="1" />
   <font size="+2">$message</font><br />
   <input type="submit" value="$buttontext" />
   </form>
   </body></html>
   ENDENTEREDKEY
                                    return OK;
        } else {
   # print form to enter a new key
    &Apache::loncommon::content_type($r,'text/html');
    &Apache::loncommon::no_cache($r);
    $r->send_http_header;
    my $swinfo=&Apache::lonmenu::rawconfig();
    my $bodytag=&Apache::loncommon::bodytag
       ('Enter Access Key to Unlock this Course');
    $r->print(<<ENDENTERKEY);
   <head><title>Entering Course Access Key</title>
   </head>
   <html>
   $bodytag
   <script>
   $swinfo
   </script>
   <form method="post">
   <input type="hidden" name="selectrole" value="1" />
   <input type="hidden" name="$trolecode" value="1" />
   <input type="text" size="20" name="newkey" value="$ENV{'form.newkey'}" />
   <input type="submit" value="Enter key" />
   </form>
   </body></html>
   ENDENTERKEY
    return OK;
        }
    }
        }
       &Apache::lonnet::log($ENV{'user.domain'},
    $ENV{'user.name'},
    $ENV{'user.home'},
    "Role ".$trolecode);
       
       &Apache::lonnet::appenv(
      'request.role'        => $trolecode,
      'request.role.domain' => $cdom,
      'request.course.sec'  => $csec);
                       my $tadv=0;
       my $msg=&mt('Entering course ...');
   
       if (($cnum) && ($role ne 'ca')) {
    my ($furl,$ferr)=
       &Apache::lonuserstate::readmap($cdom.'/'.$cnum);
    if (($ENV{'form.orgurl'}) && 
       ($ENV{'form.orgurl'}!~/^\/adm\/flip/)) {
       my $dest=$ENV{'form.orgurl'};
       if ( &Apache::lonnet::mod_perl_version() == 2 ) {
    &Apache::lonnet::cleanenv();
       }
       if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
       &Apache::lonnet::appenv('request.role.adv'=>$tadv);
       $r->internal_redirect($dest);
       return OK;
    } else {
       unless ($ENV{'request.course.id'}) {
    &Apache::lonnet::appenv(
         "request.course.id"  => $cdom.'_'.$cnum);
    $furl='/adm/roles?tryagain=1';
    $msg=
       '<h1><font color=red>'.
    &mt('Could not initialize course at this time.').
       '</font></h1><h3>'.&mt('Please try again.').'</h3>'.$ferr;
       }
       if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
       &Apache::lonnet::appenv('request.role.adv'=>$tadv);
   
       # Check to see if the user is a CC entering a course 
       # for the first time
       my (undef, undef, $role, $courseid) = split(/\./, $envkey);
       if (substr($courseid, 0, 1) eq '/') {
    $courseid = substr($courseid, 1);
       }
       $courseid =~ s/\//_/;
       if ($role eq 'cc' && $ENV{'course.' . $courseid . 
     '.course.helper.not.run'}) {
    $furl = "/adm/helper/course.initialization.helper";
       }
                               # Send the user to the course they selected
                               &redirect_user($r,&mt('Entering Course'),
                                              $furl,$msg,
      $ENV{'environment.remotenavmap'});
                               return OK;
    }
       }
                       #
                       # Send the user to the construction space they selected
                       if ($role =~ /^(au|ca)$/) {
                           my $redirect_url = '/priv/';
                           if ($role eq 'au') {
                               $redirect_url.=$ENV{'user.name'};
                           } else {
                               $where =~ /\/(.*)$/;
                               $redirect_url .= $1;
                           }
                           $redirect_url .= '/';
                           &redirect_user($r,&mt('Entering Construction Space'),
                                          $redirect_url);
                           return OK;
                       }
                       if ($role eq 'dc') {
                           my $redirect_url = '/adm/menu/';
                           &redirect_user($r,&mt('Loading Domain Coordinator Menu'),
                                          $redirect_url);
                           return OK;
                       }
    }
               }
         }          }
     }      }
           
   
 # =============================================================== No Roles Init  # =============================================================== No Roles Init
   
     $r->content_type('text/html');      &Apache::loncommon::content_type($r,'text/html');
       &Apache::loncommon::no_cache($r);
     $r->send_http_header;      $r->send_http_header;
     return OK if $r->header_only;      return OK if $r->header_only;
   
       my $swinfo=&Apache::lonmenu::rawconfig();
       my $bodytag=&Apache::loncommon::bodytag('User Roles');
       my $helptag='<table><tr><td>'.&Apache::loncommon::help_open_menu('','General Intro','General_Intro','User Roles',1,undef,undef,undef,undef,,&mt("Click here for help")).'</td></td></tr></table>';
     $r->print(<<ENDHEADER);      $r->print(<<ENDHEADER);
 <html>  <html>
 <head>  <head>
 <title>LON-CAPA User Roles</title>  <title>LON-CAPA User Roles</title>
 </head><body bgcolor="#FFFFFF">  </head>
   $bodytag
   $helptag<br />
   <script>
   $swinfo
   window.focus();
   </script>
 ENDHEADER  ENDHEADER
   
 # ------------------------------------------ Get Error Message from Environment  # ------------------------------------------ Get Error Message from Environment
   
     my ($fn,$priv,$nochoose,$error,$msg)=split(/:/,$ENV{'user.error.msg'});      my ($fn,$priv,$nochoose,$error,$msg)=split(/:/,$ENV{'user.error.msg'});
     $r->log_reason(      if ($ENV{'user.error.msg'}) {
  "$msg for $ENV{'user.name'} domain $ENV{'user.domain'} access $priv",$fn);   $r->log_reason(
      "$msg for $ENV{'user.name'} domain $ENV{'user.domain'} access $priv",$fn);
 # ---------------------------------------------------------------- Who is this?  
   
     my $advanced=0;  
     foreach $envkey (keys %ENV) {  
         if ($envkey=~/^user\.role\./) {  
     my ($dum1,$dum2,$role,@pwhere)=split(/\./,$envkey);  
             if ($role ne 'st') { $advanced=1; }  
         }  
     }      }
   
 # ---------------------------------------------- Get cached course descriptions  # ------------------------------------------------- Can this user re-init, etc?
   
     my %cdes=Apache::lonnet::dump('coursedescriptions');      my $advanced=$ENV{'user.adv'};
       &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['tryagain']);
       my $tryagain=$ENV{'form.tryagain'};
   
 # -------------------------------------------------------- Generate Page Output  # -------------------------------------------------------- Generate Page Output
 # --------------------------------------------------------------- Error Header?  # --------------------------------------------------------------- Error Header?
Line 100  ENDHEADER Line 340  ENDHEADER
  $r->print("<h1>LON-CAPA Access Control</h1>");   $r->print("<h1>LON-CAPA Access Control</h1>");
         $r->print("<hr><pre>Access  : ".          $r->print("<hr><pre>Access  : ".
                   Apache::lonnet::plaintext($priv)."\n");                    Apache::lonnet::plaintext($priv)."\n");
         $r->print("Resource: $fn\n");          $r->print("Resource: ".&Apache::lonenc::check_encrypt($fn)."\n");
         $r->print("Action  : $msg\n</pre><hr>");          $r->print("Action  : $msg\n</pre><hr>");
     } else {      } else {
         $r->print("<h1>LON-CAPA User Roles</h1>");          if ($ENV{'user.error.msg'}) {
       $r->print(
    '<h3><font color=red>'.
    &mt('You need to choose another user role or enter a specific course for this function').'</font></h3>');
    }
     }      }
 # -------------------------------------------------------- Choice or no choice?  # -------------------------------------------------------- Choice or no choice?
     if ($nochoose) {      if ($nochoose) {
         if ($advanced) {          if ($advanced) {
    $r->print("<h2>Assigned User Roles</h2>\n");      $r->print("<h2>".&mt('Assigned User Roles')."</h2>\n");
         } else {          } else {
            $r->print("<h2>Sorry ...</h2>\nThis resource might be part of");      $r->print("<h2>".&mt('Sorry ...')."</h2>\n".
            if ($ENV{'request.course.id'}) {        &mt('This resource might be part of'));
        $r->print(' another');      if ($ENV{'request.course.id'}) {
            } else {   $r->print(&mt(' another'));
                $r->print(' a certain');      } else {
            }    $r->print(&mt(' a certain'));
            $r->print(' course.</body></html>');      } 
            return OK;      $r->print(&mt(' course.').'</body></html>');
       return OK;
         }           } 
     } else {      } else {
         if ($advanced) {          if ($advanced) {
            $r->print("<h2>Select a User Role</h2>\n");      $r->print(&mt("Your home server is ").
         } else {        $Apache::lonnet::hostname{&Apache::lonnet::homeserver
    $r->print("<h2>Enter a Course</h2>\n");                        ($ENV{'user.name'},$ENV{'user.domain'})}.
         "<br />\n");
       $r->print(&mt(
         "Author and Co-Author roles may not be available on servers other than your home server."));
           }
           if (($ENV{'REDIRECT_QUERY_STRING'}) && ($fn)) {
          $fn.='?'.$ENV{'REDIRECT_QUERY_STRING'};
         }          }
         $r->print('<form method=post action="'.(($fn)?$fn:$r->uri).'">');          $r->print('<form method="post" name="rolechoice" action="'.(($fn)?$fn:$r->uri).'">');
         $r->print('<input type=hidden name=orgurl value="'.$fn.'">');          $r->print('<input type="hidden" name="orgurl" value="'.$fn.'" />');
         $r->print('<input type=hidden name=selectrole value=1>');          $r->print('<input type="hidden" name="selectrole" value="1" />');
     }      }
 # ----------------------------------------------------------------------- Table      if ($ENV{'user.adv'}) {
     $r->print('<table><tr>');   $r->print(
     unless ($nochoose) { $r->print('<th>&nbsp;</th>'); }        '<br /><label>'.&mt('Show all roles').': <input type="checkbox" name="showall"');
     if ($advanced) {   if ($ENV{'form.showall'}) { $r->print(' checked="checked" '); }
        $r->print('<th>User Role</th><th colspan=2>Extent</th>'.   $r->print(' /></label><input type="submit" value="'.&mt('Display').'" />');
                  '<th>Start</th><th>End</th><th>Remark</th></tr>'."\n");  
     } else {  
  $r->print('<th>Course</th></tr>'."\n");  
     }      }
   
       my (%roletext,%sortrole,%roleclass);
       my $countactive=0;
       my $inrole=0;
       my $possiblerole='';
     foreach $envkey (sort keys %ENV) {      foreach $envkey (sort keys %ENV) {
           my $button = 1;
           my $switchserver='';
    my $roletext;
    my $sortkey;
         if ($envkey=~/^user\.role\./) {          if ($envkey=~/^user\.role\./) {
     my ($dum1,$dum2,$role,@pwhere)=split(/\./,$envkey);              my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus,$tpstart,$tpend,$tfont);
             my $where=join('.',@pwhere);              &role_status($envkey,$then,$now,\$role,\$where,\$trolecode,\$tstatus,\$tstart,\$tend);
             my $trolecode=$role.'.'.$where;              next if (!defined($role) || $role eq '');
             my ($tstart,$tend)=split(/\./,$ENV{$envkey});              $tremark='';
             my $tremark='';              $tpstart='&nbsp;';
             my $tstatus='is';              $tpend='&nbsp;';
             my $tpstart='&nbsp;';              $tfont='#000000';
             my $tpend='&nbsp;';  
             if ($tstart) {              if ($tstart) {
  if ($tstart>$then) {                   $tpstart=&Apache::lonlocal::locallocaltime($tstart);
                    $tstatus='future';  
                    if ($tstart<$now) { $tstatus='will'; }  
                 }  
                 $tpstart=localtime($tstart);  
             }              }
             if ($tend) {              if ($tend) {
                 if ($tend<$then) { $tstatus='expired'; }                  $tpend=&Apache::lonlocal::locallocaltime($tend);
                 if ($tend>$now) { $tstatus='will_not'; }  
                 $tpend=localtime($tend);  
             }              }
             if ($ENV{'request.role'} eq $trolecode) {              if ($ENV{'request.role'} eq $trolecode) {
  $tstatus='selected';   $tstatus='selected';
             }              }
             my $tbg;              my $tbg;
             if ($tstatus eq 'is') {              if (($tstatus eq 'is') || ($tstatus eq 'selected') ||
  $tbg='#77FF77';                  ($ENV{'form.showall'})) {
             } elsif ($tstatus eq 'future') {                  if ($tstatus eq 'is') {
                 $tbg='#FFFF77';                      $tbg='#77FF77';
             } elsif ($tstatus eq 'will') {                      $tfont='#003300';
                 $tbg='#FFAA77';      $possiblerole=$trolecode;
                 $tremark.='Active at next login. ';      $countactive++;
             } elsif ($tstatus eq 'expired') {                  } elsif ($tstatus eq 'future') {
                 $tbg='#FF7777';                      $tbg='#FFFF77';
     } elsif ($tstatus eq 'will_not') {                      $button=0;
                 $tbg='#AAFF77';                  } elsif ($tstatus eq 'will') {
                 $tremark.='Expired after logout. ';                      $tbg='#FFAA77';
             } elsif ($tstatus eq 'selected') {                      $tremark.=&mt('Active at next login. ');
                 $tbg='#33FF33';                  } elsif ($tstatus eq 'expired') {
                 $tremark.='Currently selected. ';                      $tbg='#FF7777';
             }                      $tfont='#330000';
             my $trole;                      $button=0;
             if ($role =~ /^cr\//) {                  } elsif ($tstatus eq 'will_not') {
        my ($rdummy,$rdomain,$rauthor,$rrole)=split(/\//,$role);                      $tbg='#AAFF77';
                $tremark.='<br>Defined by '.$rauthor.' at '.$rdomain.'.';                      $tremark.=&mt('Expired after logout. ');
                $trole=$rrole;                  } elsif ($tstatus eq 'selected') {
     } else {                      $tbg='#11CC55';
                $trole=Apache::lonnet::plaintext($role);                      $tfont='#002200';
             }      $inrole=1;
             my $ttype;      $countactive++;
             my $twhere;                      $tremark.=&mt('Currently selected. ');
             my ($tdom,$trest)=                  }
                split(/\//,Apache::lonnet::declutter($where));                  my $trole;
             if ($trest) {                  if ($role =~ /^cr\//) {
  $ttype='Course';                      my ($rdummy,$rdomain,$rauthor,$rrole)=split(/\//,$role);
                 my $tcourseid=$tdom.'/'.$trest;                      $tremark.='<br>'.&mt('Defined by ').$rauthor.
                 if ($cdes{$tcourseid}) {   &mt(' at ').$rdomain.'.';
     $twhere=$cdes{$tcourseid};                      $trole=$rrole;
                 } else {                  } else {
                     my %newhash=Apache::lonnet::coursedescription($tcourseid);                      $trole=Apache::lonnet::plaintext($role);
                     if (%newhash) {                  }
  $twhere=$newhash{'description'};                  my $ttype;
                   my $twhere;
                   my ($tdom,$trest,$tsection)=
                       split(/\//,Apache::lonnet::declutter($where));
                   # First, Co-Authorship roles
                   if ($role eq 'ca') {
                       my $home = &Apache::lonnet::homeserver($trest,$tdom);
       my $allowed=0;
       my @ids=&Apache::lonnet::current_machine_ids();
       foreach my $id (@ids) { if ($id eq $home) { $allowed=1; } }
                       if (!$allowed) {
    $button=0;
                           $switchserver=&Apache::lonnet::escape('http://'.
                            $Apache::lonnet::hostname{$home}.
                            '/adm/login?domain='.$ENV{'user.domain'}.
     '&username='.$ENV{'user.name'}.
                             '&firsturl=/priv/'.$trest.'/');
                       }
                       #next if ($home eq 'no_host');
                       $home = $Apache::lonnet::hostname{$home};
                       $ttype='Construction Space';
                       $twhere=&mt('User').': '.$trest.'<br />'.&mt('Domain').
    ': '.$tdom.'<br />'.
                           ' '.&mt('Server').':&nbsp;'.$home;
                       $ENV{'course.'.$tdom.'_'.$trest.'.description'}='ca';
       $tremark.=&Apache::lonhtmlcommon::authorbombs('/res/'.$tdom.'/'.$trest.'/');
       $sortkey=$role."$trest:$tdom";
                   } elsif ($role eq 'au') {
                       # Authors
                       my $home = &Apache::lonnet::homeserver
                           ($ENV{'user.name'},$ENV{'user.domain'});
       my $allowed=0;
       my @ids=&Apache::lonnet::current_machine_ids();
       foreach my $id (@ids) { if ($id eq $home) { $allowed=1; } }
                       if (!$allowed) {
    $button=0;
                           $switchserver=&Apache::lonnet::escape('http://'.
                            $Apache::lonnet::hostname{$home}.
                             '/adm/login?domain='.$ENV{'user.domain'}.
      '&username='.$ENV{'user.name'}.
                              '&firsturl=/priv/'.$ENV{'user.name'}.'/');
                       }
                       #next if ($home eq 'no_host');
                       $home = $Apache::lonnet::hostname{$home};
                       $ttype='Construction Space';
                       $twhere=&mt('Domain').': '.$tdom.'<br />'.&mt('Server').
    ':&nbsp;'.$home;
                       $ENV{'course.'.$tdom.'_'.$trest.'.description'}='ca';
       $tremark.=&Apache::lonhtmlcommon::authorbombs('/res/'.$tdom.'/'.$ENV{'user.name'}.'/');
       $sortkey=$role;
                   } elsif ($trest) {
                       $ttype='Course';
                       if ($tsection) {
                           $ttype.='<br>'.&mt('Section/Group').': '.$tsection;
       }
                       my $tcourseid=$tdom.'_'.$trest;
                       if ($ENV{'course.'.$tcourseid.'.description'}) {
                           $twhere=$ENV{'course.'.$tcourseid.'.description'};
    $sortkey=$role."\0".$tdom."\0".$twhere."\0".$envkey;
                           unless ($twhere eq &mt('Currently not available')) {
       $twhere.=' <font size="-2">'.
           &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$trest,$tdom,$tfont).
                                       '</font>';
    }
                     } else {                      } else {
                         $twhere='Currently not available';                          my %newhash=&Apache::lonnet::coursedescription($tcourseid);
                           if (%newhash) {
       $sortkey=$role."\0".$tdom."\0".$newhash{'description'}.
    "\0".$envkey;
                               $twhere=$newhash{'description'}.
                                 ' <font size="-2">'.
           &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$trest,$tdom,$tfont).
                                 '</font>';
                           } else {
                               $twhere=&mt('Currently not available');
                               $ENV{'course.'.$tcourseid.'.description'}=$twhere;
       $sortkey=$role."\0".$tdom."\0".$twhere."\0".$envkey;
                           }
                     }                      }
                     $cdes{$tcourseid}=$twhere;      if ($role ne 'st') { $twhere.="<br />".&mt('Domain').":".$tdom; }
                 }                       } elsif ($tdom) {
             } elsif ($tdom) {                      $ttype='Domain';
                 $ttype='Domain';                      $twhere=$tdom;
                 $twhere=$tdom;      $sortkey=$role.$twhere;
             } else {  
                 $ttype='System';  
                 $twhere='system wide';  
             }  
                  
             $r->print('<tr bgcolor='.$tbg.'>');  
             unless ($nochoose) {  
  if ($tstatus eq 'is') {  
                     $r->print('<td><input type=submit value=Select name="'.  
                               $trolecode.'"></td>');  
                 } else {                  } else {
                     $r->print('<td>&nbsp;</td>');                      $ttype='System';
                       $twhere=&mt('system wide');
       $sortkey=$role.$twhere;
                 }                  }
             }   
             $r->print('<td>'.$trole.'</td><td>'.                  $roletext.=&build_roletext($trolecode,$tdom,$trest,$tstatus,$tryagain,$advanced,$tremark,$tbg,$tfont,$trole,$ttype,$twhere,$tpstart,$tpend,$nochoose,$button,$switchserver);
       $ttype.'</td><td>'.$twhere.'</td><td>'.$tpstart.   $roletext{$envkey}=$roletext;
                       '</td><td>'.$tpend.   if (!$sortkey) {$sortkey=$twhere."\0".$envkey;}
                       '</td><td>'.$tremark.'&nbsp;</td></tr>'."\n");   $sortrole{$sortkey}=$envkey;
    $roleclass{$envkey}=$ttype;
       }
         }          }
     }      }
   # No active roles
       if ($countactive==0) {
    if ($inrole) {
       $r->print('<h2>'.&mt('Currently no additional roles or courses').'</h2>');
    } else {
       $r->print('<h2>'.&mt('Currently no active roles or courses').'</h2>');
    }
    $r->print('</form></body></html>');
    return OK;
   # Is there only one choice?
       } elsif (($countactive==1) && ($ENV{'request.role'} eq 'cm')) {
    $r->print('<h3>'.&mt('Please stand by.').'</h3>'.
       '<input type="hidden" name="'.$possiblerole.'" value="1" />');
    $r->print("</form>\n");
    $r->rflush();
    $r->print('<script>document.forms.rolechoice.submit();</script>');
    $r->print('</body></html>');
    return OK;
       }
   # More than one possible role
   # ----------------------------------------------------------------------- Table
       unless (($advanced) || ($nochoose)) {
    $r->print("<h2>".&mt('Select a Course to Enter')."</h2>\n");
       }
       $r->print('<br /><table><tr>');
       unless ($nochoose) { $r->print('<th>&nbsp;</th>'); }
       $r->print('<th>'.&mt('User Role').'</th><th colspan=2>'.&mt('Extent').
            '</th><th>'.&mt('Start').'</th><th>'.&mt('End').'</th><th>'.
         &mt('Remarks and Calendar Announcements').'</th></tr>'."\n");
       my $doheaders=-1;
       foreach my $type ('Construction Space','Course','Domain','System') {
    my $haverole=0;
    foreach my $which (sort {uc($a) cmp uc($b)} (keys(%sortrole))) {
       if ($roleclass{$sortrole{$which}} =~ /^\Q$type\E/) { 
    $haverole=1;
       }
    }
    if ($haverole) { $doheaders++; }
       }
   
       if ($ENV{'environment.recentroles'}) {
           my %recent_roles =
                  &Apache::lonhtmlcommon::get_recent('roles',$ENV{'environment.recentrolesn'});
    my $output='';
    foreach (sort(keys(%recent_roles))) {
       if (defined($roletext{'user.role.'.$_})) {
    $output.=$roletext{'user.role.'.$_};
       } elsif ($numdc > 0) {
                   unless ($_ =~/^error\:/) {
                       $output.=&display_cc_role('user.role.'.$_);
                   }
               } 
    }
    if ($output) {
       $r->print("<tr bgcolor='#BBffBB'><td align='center' colspan='7'>".
         &mt('Recent Roles')."</td>");
       $r->print($output);
       $r->print("</tr>");
               $doheaders ++;
    }
       }
   
       if ($numdc > 0) {
           $r->print(&coursepick_jscript());
           $r->print(&Apache::loncommon::coursebrowser_javascript());
       }
       foreach my $type ('Construction Space','Course','Domain','System') {
    my $output;
    foreach my $which (sort {uc($a) cmp uc($b)} (keys(%sortrole))) {
       if ($roleclass{$sortrole{$which}} =~ /^\Q$type\E/) { 
    $output.=$roletext{$sortrole{$which}};
                   if ($sortrole{$which} =~ m-dc\./(\w+)/-) {
                       if ($dcroles{$1}) {
                           $output .= &allcourses_row($1);
                       }
                   }
       }
    }
    if ($output) {
       if ($doheaders > 0) {
    $r->print("<tr bgcolor='#BBffBB'>".
     "<td align='center' colspan='7'>".&mt($type)."</td></tr>");
       }
       $r->print($output);
    }
       }
       my $tremark='';
       my $tfont='#003300';
       if ($ENV{'request.role'} eq 'cm') {
    $r->print('<tr bgcolor="#11CC55">');
           $tremark=&mt('Currently selected. ');
           $tfont='#002200';
       } else {
           $r->print('<tr bgcolor="#77FF77">');
       }
       unless ($nochoose) {
    if ($ENV{'request.role'} ne 'cm') {
       $r->print('<td><input type=submit value="'.
         &mt('Select').'" name="cm"></td>');
    } else {
       $r->print('<td>&nbsp;</td>');
    }
       }
       $r->print('<td colspan=5><font color="'.$tfont.'">'.&mt('No role specified').
         '</font></td><td><font color="'.$tfont.'">'.$tremark.
         '&nbsp;</font></td></tr>'."\n");
   
     $r->print('</table>');      $r->print('</table>');
     unless ($nochoose) {      unless ($nochoose) {
  $r->print("</form>\n");   $r->print("</form>\n");
     }      }
 # ------------------------------------------------------------ Priviledges Info  # ------------------------------------------------------------ Privileges Info
   if ($advanced) {      if (($advanced) && (($ENV{'user.error.msg'}) || ($error))) {
     $r->print('<hr><h2>Priviledges</h2>');   $r->print('<hr><h2>Current Privileges</h2>');
   
    foreach $envkey (sort keys %ENV) {
       if ($envkey=~/^user\.priv\.$ENV{'request.role'}\./) {
    my $where=$envkey;
    $where=~s/^user\.priv\.$ENV{'request.role'}\.//;
    my $ttype;
    my $twhere;
    my ($tdom,$trest,$tsec)=
       split(/\//,Apache::lonnet::declutter($where));
    if ($trest) {
       if ($ENV{'course.'.$tdom.'_'.$trest.'.description'} eq 'ca') {
    $ttype='Construction Space';
    $twhere='User: '.$trest.', Domain: '.$tdom;
       } else {
    $ttype='Course';
    $twhere=$ENV{'course.'.$tdom.'_'.$trest.'.description'};
    if ($tsec) {
       $twhere.=' (Section/Group: '.$tsec.')';
    }
       }
    } elsif ($tdom) {
       $ttype='Domain';
       $twhere=$tdom;
    } else {
       $ttype='System';
       $twhere='/';
    }
    $r->print("\n<h3>".$ttype.': '.$twhere.'</h3><ul>');
    foreach (sort split(/:/,$ENV{$envkey})) {
       if ($_) {
    my ($prv,$restr)=split(/\&/,$_);
    my $trestr='';
    if ($restr ne 'F') {
       my $i;
       $trestr.=' (';
       for ($i=0;$i<length($restr);$i++) {
    $trestr.=
          Apache::lonnet::plaintext(substr($restr,$i,1));
    if ($i<length($restr)-1) { $trestr.=', '; }
       }
       $trestr.=')';
    }
    $r->print('<li>'.
     Apache::lonnet::plaintext($prv).$trestr.
     '</li>');
       }
    }
    $r->print('</ul>');
       }
    }
       }
       $r->print(&Apache::lonnet::getannounce());
       if ($advanced) {
    $r->print('<p><small><i>This is LON-CAPA '.
     $r->dir_config('lonVersion').'</i><br />'.
     '<a href="/adm/logout">'.&mt('Logout').'</a></small></p>');
       }
       $r->print("</body></html>\n");
       return OK;
   }
   
     foreach $envkey (sort keys %ENV) {  sub role_status {
         if ($envkey=~/^user\.priv\./) {      my ($rolekey,$then,$now,$role,$where,$trolecode,$tstatus,$tstart,$tend) = @_;
     my ($dum1,$dum2,@pwhere)=split(/\./,$envkey);      my @pwhere = ();
             my $where=join('.',@pwhere);      if (exists($ENV{$rolekey}) && $ENV{$rolekey} ne '') {
             my $ttype;          (undef,undef,$$role,@pwhere)=split(/\./,$rolekey);
             my $twhere;          unless (!defined($$role) || $$role eq '') {
             my ($tdom,$trest)=              $$where=join('.',@pwhere);
                split(/\//,Apache::lonnet::declutter($where));              $$trolecode=$$role.'.'.$$where;
             if ($trest) {              ($$tstart,$$tend)=split(/\./,$ENV{$rolekey});
  $ttype='Course';              $$tstatus='is';
                 $twhere=$cdes{$tdom.'/'.$trest};              if ($$tstart && $$tstart>$then) {
             } elsif ($tdom) {   $$tstatus='future';
                 $ttype='Domain';   if ($$tstart<$now) { $$tstatus='will'; }
                 $twhere=$tdom;              }
               if ($$tend) {
                   if ($$tend<$then) {
                       $$tstatus='expired';
                   } elsif ($$tend<$now) {
                       $$tstatus='will_not';
                   }
               }
           }
       }
   }
   
   sub build_roletext {
       my ($trolecode,$tdom,$trest,$tstatus,$tryagain,$advanced,$tremark,$tbg,$tfont,$trole,$ttype,$twhere,$tpstart,$tpend,$nochoose,$button,$switchserver) = @_;
       my $roletext='<tr bgcolor="'.$tbg.'">';
       unless ($nochoose) {
           if (!$button) {
               if ($switchserver) {
                   $roletext.='<td><a href="/adm/logout?handover='.
                   $switchserver.'">'.&mt('Switch Server').'</a></td>';
             } else {              } else {
                 $ttype='System';                  $roletext.=('<td>&nbsp;</td>');
                 $twhere='/';  
             }              }
             $r->print("\n<h3>".$ttype.': '.$twhere.'</h3><ul>');          } elsif ($tstatus eq 'is') {
             map {              $roletext.=('<td><input type=submit value="'.
               if ($_) {                          &mt('Select').'" name="'.
   my ($prv,$restr)=split(/\&/,$_);                          $trolecode.'"></td>');
                   my $trestr='';          } elsif ($tryagain) {
                   if ($restr ne 'F') {              $roletext.=
                       my $i;                  '<td><input type=submit value="'.
                       $trestr.=' (';                  &mt('Try Selecting Again').'" name="'.$trolecode.'"></td>';
                       for ($i=0;$i<length($restr);$i++) {          } elsif ($advanced) {
          $trestr.=              $roletext.=
                            Apache::lonnet::plaintext(substr($restr,$i,1));                  '<td><input type=submit value="'.
                          if ($i<length($restr)-1) { $trestr.=', '; }                  &mt('Re-Initialize').'" name="'.$trolecode.'"></td>';
       }          } else {
                       $trestr.=')';              $roletext.='<td>&nbsp;</td>';
                   }  
                   $r->print('<li>'.Apache::lonnet::plaintext($prv).$trestr.  
                             '</li>');  
       }  
             } sort split(/:/,$ENV{$envkey});  
             $r->print('</ul>');  
         }          }
     }      }
   }      $tremark.=&Apache::lonannounce::showday(time,1,
 # -------------------------------------------------------------- Debug - remove                   &Apache::lonannounce::readcalendar($tdom.'_'.$trest));
   
     $->print("<hr><h1>Debugging</h1><hr>\n");  
           $roletext.='<td><font color="'.$tfont.'">'.$trole.
     foreach $envkey (sort keys %ENV) {                 '</font></td><td><font color="'.$tfont.'">'.$ttype.
  $r->print("$envkey ---- $ENV{$envkey}<br>");                 '</font></td><td><font color="'.$tfont.'">'.$twhere.
                  '</font></td><td><font color="'.$tfont.'">'.$tpstart.
                  '</font></td><td><font color="'.$tfont.'">'.$tpend.
                  '</font></td><td><font color="'.$tfont.'">'.$tremark.
                  '&nbsp;</font></td></tr>'."\n";
       return $roletext;
   }
   
   sub check_privs {
       my ($cckey,$then,$now) = @_;
       if ($ENV{$cckey}) {
           my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus,$tpstart,$tpend,$tfont);
           &role_status($cckey,$then,$now,\$role,\$where,\$trolecode,\$tstatus,\$tstart,\$tend);
           unless (($tstatus eq 'is') || ($tstatus eq 'will_not')) {
               &set_privileges($1,$2);
           }
       } else {
           &set_privileges($1,$2);
     }      }
   }
   
 # ------------------------------------------------------------------- End Debug  sub check_fordc {
       my ($dcroles,$then) = @_;
       my $numdc = 0;
       if ($ENV{'user.adv'}) {
           foreach my $envkey (sort keys %ENV) {
               if ($envkey=~/^user\.role\.dc\.\/(\w+)\/$/) {
                   my $dcdom = $1;
                   my $livedc = 1;
                   my ($tstart,$tend)=split(/\./,$ENV{$envkey});
                   if ($tstart && $tstart>$then) { $livedc = 0; }
                   if ($tend   && $tend  <$then) { $livedc = 0; }
                   if ($livedc) {
                       $$dcroles{$dcdom} = $envkey;
                       $numdc++;
                   }
               }
           }
       }
       return $numdc;
   }
   
     $r->print("</body></html>\n");  sub courselink {
     return OK;      my ($dcdom) = @_;
 }       my $courseform=&Apache::loncommon::selectcourse_link
                        ('rolechoice','dccourse_'.$dcdom,'dcdomain_'.$dcdom,'coursedesc_'.$dcdom,$dcdom);
       my $hiddenitems = '<input type="hidden" name="dcdomain_'.$dcdom.'" value="'.$dcdom.'" />'.
                         '<input type="hidden" name="origdom_'.$dcdom.'" value="'.$dcdom.'" />'.
                         '<input type="hidden" name="dccourse_'.$dcdom.'" value="" />'.
                         '<input type="hidden" name="coursedesc_'.$dcdom.'" value="" />';
       return $courseform.$hiddenitems;
   }
   
   sub coursepick_jscript {
       my $verify_script = <<"END";
   <script>
   function verifyCoursePick(caller) {
       var numbutton = getIndex(caller)
       var pickedCourse = document.rolechoice.elements[numbutton+4].value
       var pickedDomain = document.rolechoice.elements[numbutton+2].value
       if (document.rolechoice.elements[numbutton+2].value == document.rolechoice.elements[numbutton+3].value) {
           if (pickedCourse != '') {
               if (numbutton != -1) {
                   var courseTarget = "cc./"+pickedDomain+"/"+pickedCourse
                   document.rolechoice.elements[numbutton+1].name = courseTarget
                   document.rolechoice.submit()
               }
           }
           else {
               alert("Please use the 'Select Course' link to open a separate pick course window where you may select the course you wish to enter.");
           }
       }
       else {
           alert("You can only use this screen to select courses in the current domain")
       }
   }
   function getIndex(caller) {
       for (var i=0;i<document.rolechoice.elements.length;i++) {
           if (document.rolechoice.elements[i] == caller) {
               return i;
           }
       }
       return -1;
   }
   </script>
   END
       return $verify_script;
   }
   
   sub processpick {
       my $dcdom = shift;
       my $process_pick = <<"END";
   <script>
   function process_pick(dom) {
       var numbutton = getIndex(dom)
       var pickedCourse = opener.document.rolechoice.dccourse_$dcdom.value
       var pickedDomain = opener.document.rolechoice.dcdomain_$dcdom.value
       if (opener.document.rolechoice.dcdomain_$dcdom.value == opener.document.rolechoice.origdom_$dcdom.value) {
           if (pickedCourse != '') {
               if (numbutton != -1) {
                   var courseTarget = "cc./"+pickedDomain+"/"+pickedCourse
                   opener.document.rolechoice.elements[numbutton+1].name = courseTarget
                   opener.document.rolechoice.submit()
               }
           }
       }
   }
    
   function getIndex(dom) {
       var callername = 'ccpick_'+dom
       for (var i=0;i<opener.document.rolechoice.elements.length;i++) {
           var elemname = opener.document.rolechoice.elements[i].name
           if (elemname == callername) {
               return i;
           }
       }
       return -1;
   }
   </script>
   END
       return $process_pick;
   }
   
   sub display_cc_role {
       my $rolekey = shift;
       my $roletext;
       my $advanced = $ENV{'user.adv'};
       my $tryagain = $ENV{'form.tryagain'};
       unless ($rolekey =~/^error\:/) {
           if ($rolekey =~ m-^user\.role.cc\./(\w+)/(\w+)$-) {
               my $tcourseid = $1.'_'.$2;
               my $trolecode = 'cc./'.$1.'/'.$2;
               my $trole = Apache::lonnet::plaintext('cc');
               my $twhere;
               my $tbg='#77FF77';
               my $tfont='#003300';
               my %newhash=&Apache::lonnet::coursedescription($tcourseid);
               if (%newhash) {
                   $twhere=$newhash{'description'}.
                           ' <font size="-2">'.
                           &Apache::loncommon::syllabuswrapper(&mt('Syllabus'),$2,$1,$tfont).
                           '</font>';
               } else {
                   $twhere=&mt('Currently not available');
                   $ENV{'course.'.$tcourseid.'.description'}=$twhere;
               }
               $twhere.="<br />".&mt('Domain').":".$1;
               $roletext = &build_roletext($trolecode,$1,$2,'is',$tryagain,$advanced,'',$tbg,$tfont,$trole,&mt('Course'),$twhere,'','','',1,'');
           }
       }
       return $roletext;
   }
   
   sub allcourses_row {
       my $dcdom = shift;
       my $ccrole = Apache::lonnet::plaintext('cc');
       my $selectlink = &courselink($dcdom);
       my $output = '<tr bgcolor="#77FF77">'.
                 '<td><input type="button" value="'.
                 &mt('Select').'" name="ccpick_'.$dcdom.'"'.
                 'onClick="verifyCoursePick(this)">'.
                 '<input type="hidden" name="pick_'.$dcdom.'" value="1"></td>'.
                 '<td><font color="#002200">'.
                 $ccrole.'</font></td><td>'.&mt('Course').'</td>'.
                 '<td><font color="#002200">'.&mt('All courses').':<b>&nbsp;'.
                 $selectlink.'</b>'.
                 '<br />'.&mt('Domain').':'.$dcdom.'</font>'.
                 '<td colspan="4"><font color="#002200">'.
                 &mt('Course Coordinator access to all courses in domain').
                 ': <b>'.$dcdom.'</b></font></td></tr>'."\n";
       return $output;
   }
   
   sub recent_filename {
       my $area=shift;
       return 'nohist_recent_'.&Apache::lonnet::escape($area);
   }
   
   sub set_privileges {
       my ($dcdom,$pickedcourse) = @_;
       my $area = '/'.$dcdom.'/'.$pickedcourse;
       my $role = 'cc';
       my $spec = $role.'.'.$area;
       my $userroles = &Apache::lonnet::set_arearole($role,$area,'','',$dcdom,$ENV{'user.name'});
       my %ccrole = ();
       &Apache::lonnet::standard_roleprivs(\%ccrole,$role,$dcdom,$spec,$pickedcourse,$area);
       my ($author,$adv)= &Apache::lonnet::set_userprivs(\$userroles,\%ccrole);
       my @newprivs = split/\n/,$userroles;
       my %newccroles = ();
       foreach (@newprivs) {
           my ($key,$val) = split/=/,$_;
           $newccroles{$key} = $val;
       }
       &Apache::lonnet::appenv(%newccroles);
       &Apache::lonnet::log($ENV{'user.domain'},
                            $ENV{'user.name'},
                            $ENV{'user.home'},
                           "Role ".$role);
       &Apache::lonnet::appenv(
                             'request.role'        => $role,
                             'request.role.domain' => $dcdom,
                             'request.course.sec'  => '');
       my $tadv=0;
       if (&Apache::lonnet::allowed('adv') eq 'F') { $tadv=1; }
       &Apache::lonnet::appenv('request.role.adv'    => $tadv);
   }
   
 1;  1;
 __END__  __END__
   
   =head1 NAME
   
   Apache::lonroles - User Roles Screen
   
   =head1 SYNOPSIS
   
   Invoked by /etc/httpd/conf/srm.conf:
   
    <Location /adm/roles>
    PerlAccessHandler       Apache::lonacc
    SetHandler perl-script
    PerlHandler Apache::lonroles
    ErrorDocument     403 /adm/login
    ErrorDocument  500 /adm/errorhandler
    </Location>
   
   =head1 OVERVIEW
   
   =head2 Choosing Roles
   
   C<lonroles> is a handler that allows a user to switch roles in
   mid-session. LON-CAPA attempts to work with "No Role Specified", the
   default role that a user has before selecting a role, as widely as
   possible, but certain handlers for example need specification which
   course they should act on, etc. Both in this scenario, and when the
   handler determines via C<lonnet>'s C<&allowed> function that a certain
   action is not allowed, C<lonroles> is used as error handler. This
   allows the user to select another role which may have permission to do
   what they were trying to do. C<lonroles> can also be accessed via the
   B<CRS> button in the Remote Control. 
   
   =begin latex
   
   \begin{figure}
   \begin{center}
   \includegraphics[width=0.45\paperwidth,keepaspectratio]{Sample_Roles_Screen}
     \caption{\label{Sample_Roles_Screen}Sample Roles Screen} 
   \end{center}
   \end{figure}
   
   =end latex
   
   =head2 Role Initialization
   
   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.
   
   =head1 INTRODUCTION
   
   This module enables a user to select what role he wishes to
   operate under (instructor, student, teaching assistant, course
   coordinator, etc).  These roles are pre-established by the actions
   of upper-level users.
   
   This is part of the LearningOnline Network with CAPA project
   described at http://www.lon-capa.org.
   
   =head1 HANDLER SUBROUTINE
   
   This routine is called by Apache and mod_perl.
   
   =over 4
   
   =item *
   
   Roles Initialization (yes/no)
   
   =item *
   
   Get Error Message from Environment
   
   =item *
   
   Who is this?
   
   =item *
   
   Generate Page Output
   
   =item *
   
   Choice or no choice
   
   =item *
   
   Table
   
   =item *
   
   Privileges
   
   =back
   
   =cut
Removed from v.1.11  
changed lines
  Added in v.1.117

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
500 Internal Server Error

Internal Server Error

The server encountered an internal error or misconfiguration and was unable to complete your request.

Please contact the server administrator at root@localhost to inform them of the time this error occurred, and the actions you performed just before this error.

More information about this error may be available in the server error log.