Annotation of loncom/interface/loncommon.pm, revision 1.656

1.10      albertel    1: # The LearningOnline Network with CAPA
1.1       albertel    2: # a pile of common routines
1.10      albertel    3: #
1.656   ! www         4: # $Id: loncommon.pm,v 1.655 2008/05/29 02:58:41 raeburn Exp $
1.10      albertel    5: #
                      6: # Copyright Michigan State University Board of Trustees
                      7: #
                      8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      9: #
                     10: # LON-CAPA is free software; you can redistribute it and/or modify
                     11: # it under the terms of the GNU General Public License as published by
                     12: # the Free Software Foundation; either version 2 of the License, or
                     13: # (at your option) any later version.
                     14: #
                     15: # LON-CAPA is distributed in the hope that it will be useful,
                     16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     18: # GNU General Public License for more details.
                     19: #
                     20: # You should have received a copy of the GNU General Public License
                     21: # along with LON-CAPA; if not, write to the Free Software
                     22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     23: #
                     24: # /home/httpd/html/adm/gpl.txt
                     25: #
                     26: # http://www.lon-capa.org/
                     27: #
1.1       albertel   28: 
                     29: # Makes a table out of the previous attempts
1.2       albertel   30: # Inputs result_from_symbread, user, domain, course_id
1.16      harris41   31: # Reads in non-network-related .tab files
1.1       albertel   32: 
1.35      matthew    33: # POD header:
                     34: 
1.45      matthew    35: =pod
                     36: 
1.35      matthew    37: =head1 NAME
                     38: 
                     39: Apache::loncommon - pile of common routines
                     40: 
                     41: =head1 SYNOPSIS
                     42: 
1.112     bowersj2   43: Common routines for manipulating connections, student answers,
                     44:     domains, common Javascript fragments, etc.
1.35      matthew    45: 
1.112     bowersj2   46: =head1 OVERVIEW
1.35      matthew    47: 
1.112     bowersj2   48: A collection of commonly used subroutines that don't have a natural
                     49: home anywhere else. This collection helps remove
1.35      matthew    50: redundancy from other modules and increase efficiency of memory usage.
                     51: 
                     52: =cut 
                     53: 
                     54: # End of POD header
1.1       albertel   55: package Apache::loncommon;
                     56: 
                     57: use strict;
1.258     albertel   58: use Apache::lonnet;
1.46      matthew    59: use GDBM_File;
1.51      www        60: use POSIX qw(strftime mktime);
1.82      www        61: use Apache::lonmenu();
1.498     albertel   62: use Apache::lonenc();
1.117     www        63: use Apache::lonlocal;
1.139     matthew    64: use HTML::Entities;
1.334     albertel   65: use Apache::lonhtmlcommon();
                     66: use Apache::loncoursedata();
1.344     albertel   67: use Apache::lontexconvert();
1.444     albertel   68: use Apache::lonclonecourse();
1.479     albertel   69: use LONCAPA qw(:DEFAULT :match);
1.117     www        70: 
1.517     raeburn    71: # ---------------------------------------------- Designs
                     72: use vars qw(%defaultdesign);
                     73: 
1.22      www        74: my $readit;
                     75: 
1.517     raeburn    76: 
1.157     matthew    77: ##
                     78: ## Global Variables
                     79: ##
1.46      matthew    80: 
1.643     foxr       81: 
                     82: # ----------------------------------------------- SSI with retries:
                     83: #
                     84: 
                     85: =pod
                     86: 
1.648     raeburn    87: =head1 Server Side include with retries:
1.643     foxr       88: 
                     89: =over 4
                     90: 
1.648     raeburn    91: =item * &ssi_with_retries(resource,retries form)
1.643     foxr       92: 
                     93: Performs an ssi with some number of retries.  Retries continue either
                     94: until the result is ok or until the retry count supplied by the
                     95: caller is exhausted.  
                     96: 
                     97: Inputs:
1.648     raeburn    98: 
                     99: =over 4
                    100: 
1.643     foxr      101: resource   - Identifies the resource to insert.
1.648     raeburn   102: 
1.643     foxr      103: retries    - Count of the number of retries allowed.
1.648     raeburn   104: 
1.643     foxr      105: form       - Hash that identifies the rendering options.
                    106: 
1.648     raeburn   107: =back
                    108: 
                    109: Returns:
                    110: 
                    111: =over 4
                    112: 
1.643     foxr      113: content    - The content of the response.  If retries were exhausted this is empty.
1.648     raeburn   114: 
1.643     foxr      115: response   - The response from the last attempt (which may or may not have been successful.
                    116: 
1.648     raeburn   117: =back
                    118: 
                    119: =back
                    120: 
1.643     foxr      121: =cut
                    122: 
                    123: sub ssi_with_retries {
                    124:     my ($resource, $retries, %form) = @_;
                    125: 
                    126: 
                    127:     my $ok = 0;			# True if we got a good response.
                    128:     my $content;
                    129:     my $response;
                    130: 
                    131:     # Try to get the ssi done. within the retries count:
                    132: 
                    133:     do {
                    134: 	($content, $response) = &Apache::lonnet::ssi($resource, %form);
                    135: 	$ok      = $response->is_success;
1.650     www       136:         if (!$ok) {
                    137:             &Apache::lonnet::logthis("Failed ssi_with_retries on $resource: ".$response->is_success.', '.$response->code.', '.$response->message);
                    138:         }
1.643     foxr      139: 	$retries--;
                    140:     } while (!$ok && ($retries > 0));
                    141: 
                    142:     if (!$ok) {
                    143: 	$content = '';		# On error return an empty content.
                    144:     }
                    145:     return ($content, $response);
                    146: 
                    147: }
                    148: 
                    149: 
                    150: 
1.20      www       151: # ----------------------------------------------- Filetypes/Languages/Copyright
1.12      harris41  152: my %language;
1.656   ! www       153: my %timezone;
1.124     www       154: my %supported_language;
1.12      harris41  155: my %cprtag;
1.192     taceyjo1  156: my %scprtag;
1.351     www       157: my %fe; my %fd; my %fm;
1.41      ng        158: my %category_extensions;
1.12      harris41  159: 
1.46      matthew   160: # ---------------------------------------------- Thesaurus variables
1.144     matthew   161: #
                    162: # %Keywords:
                    163: #      A hash used by &keyword to determine if a word is considered a keyword.
                    164: # $thesaurus_db_file 
                    165: #      Scalar containing the full path to the thesaurus database.
1.46      matthew   166: 
                    167: my %Keywords;
                    168: my $thesaurus_db_file;
                    169: 
1.144     matthew   170: #
                    171: # Initialize values from language.tab, copyright.tab, filetypes.tab,
                    172: # thesaurus.tab, and filecategories.tab.
                    173: #
1.18      www       174: BEGIN {
1.46      matthew   175:     # Variable initialization
                    176:     $thesaurus_db_file = $Apache::lonnet::perlvar{'lonTabDir'}."/thesaurus.db";
                    177:     #
1.22      www       178:     unless ($readit) {
1.12      harris41  179: # ------------------------------------------------------------------- languages
                    180:     {
1.158     raeburn   181:         my $langtabfile = $Apache::lonnet::perlvar{'lonTabDir'}.
                    182:                                    '/language.tab';
                    183:         if ( open(my $fh,"<$langtabfile") ) {
1.356     albertel  184:             while (my $line = <$fh>) {
                    185:                 next if ($line=~/^\#/);
                    186:                 chomp($line);
                    187:                 my ($key,$two,$country,$three,$enc,$val,$sup)=(split(/\t/,$line));
1.158     raeburn   188:                 $language{$key}=$val.' - '.$enc;
                    189:                 if ($sup) {
                    190:                     $supported_language{$key}=$sup;
                    191:                 }
                    192:             }
                    193:             close($fh);
                    194:         }
1.12      harris41  195:     }
1.656   ! www       196: # ------------------------------------------------------------------- timezones
        !           197:     {
        !           198:         my $timetabfile = $Apache::lonnet::perlvar{'lonTabDir'}.
        !           199:                                    '/timezone.tab';
        !           200:         if ( open(my $fh,"<$timetabfile") ) {
        !           201:             while (my $line = <$fh>) {
        !           202:                 next if ($line=~/^\#/);
        !           203:                 chomp($line);
        !           204:                 my $value=$line;
        !           205:                 $value=~s/\_/ /g;
        !           206:                 $timezone{$line}=$value;
        !           207:             }
        !           208:             close($fh);
        !           209:         }
        !           210:     }
        !           211: 
1.12      harris41  212: # ------------------------------------------------------------------ copyrights
                    213:     {
1.158     raeburn   214:         my $copyrightfile = $Apache::lonnet::perlvar{'lonIncludes'}.
                    215:                                   '/copyright.tab';
                    216:         if ( open (my $fh,"<$copyrightfile") ) {
1.356     albertel  217:             while (my $line = <$fh>) {
                    218:                 next if ($line=~/^\#/);
                    219:                 chomp($line);
                    220:                 my ($key,$val)=(split(/\s+/,$line,2));
1.158     raeburn   221:                 $cprtag{$key}=$val;
                    222:             }
                    223:             close($fh);
                    224:         }
1.12      harris41  225:     }
1.351     www       226: # ----------------------------------------------------------- source copyrights
1.192     taceyjo1  227:     {
                    228:         my $sourcecopyrightfile = $Apache::lonnet::perlvar{'lonIncludes'}.
                    229:                                   '/source_copyright.tab';
                    230:         if ( open (my $fh,"<$sourcecopyrightfile") ) {
1.356     albertel  231:             while (my $line = <$fh>) {
                    232:                 next if ($line =~ /^\#/);
                    233:                 chomp($line);
                    234:                 my ($key,$val)=(split(/\s+/,$line,2));
1.192     taceyjo1  235:                 $scprtag{$key}=$val;
                    236:             }
                    237:             close($fh);
                    238:         }
                    239:     }
1.63      www       240: 
1.517     raeburn   241: # -------------------------------------------------------------- default domain designs
1.63      www       242:     my $designdir=$Apache::lonnet::perlvar{'lonTabDir'}.'/lonDomColors';
1.517     raeburn   243:     my $designfile = $designdir.'/default.tab';
                    244:     if ( open (my $fh,"<$designfile") ) {
                    245:         while (my $line = <$fh>) {
                    246:             next if ($line =~ /^\#/);
                    247:             chomp($line);
                    248:             my ($key,$val)=(split(/\=/,$line));
                    249:             if ($val) { $defaultdesign{$key}=$val; }
                    250:         }
                    251:         close($fh);
1.63      www       252:     }
                    253: 
1.15      harris41  254: # ------------------------------------------------------------- file categories
                    255:     {
1.158     raeburn   256:         my $categoryfile = $Apache::lonnet::perlvar{'lonTabDir'}.
                    257:                                   '/filecategories.tab';
                    258:         if ( open (my $fh,"<$categoryfile") ) {
1.356     albertel  259: 	    while (my $line = <$fh>) {
                    260: 		next if ($line =~ /^\#/);
                    261: 		chomp($line);
                    262:                 my ($extension,$category)=(split(/\s+/,$line,2));
1.158     raeburn   263:                 push @{$category_extensions{lc($category)}},$extension;
                    264:             }
                    265:             close($fh);
                    266:         }
                    267: 
1.15      harris41  268:     }
1.12      harris41  269: # ------------------------------------------------------------------ file types
                    270:     {
1.158     raeburn   271:         my $typesfile = $Apache::lonnet::perlvar{'lonTabDir'}.
                    272:                '/filetypes.tab';
                    273:         if ( open (my $fh,"<$typesfile") ) {
1.356     albertel  274:             while (my $line = <$fh>) {
                    275: 		next if ($line =~ /^\#/);
                    276: 		chomp($line);
                    277:                 my ($ending,$emb,$mime,$descr)=split(/\s+/,$line,4);
1.158     raeburn   278:                 if ($descr ne '') {
                    279:                     $fe{$ending}=lc($emb);
                    280:                     $fd{$ending}=$descr;
1.351     www       281:                     if ($mime ne 'unk') { $fm{$ending}=$mime; }
1.158     raeburn   282:                 }
                    283:             }
                    284:             close($fh);
                    285:         }
1.12      harris41  286:     }
1.22      www       287:     &Apache::lonnet::logthis(
1.46      matthew   288:               "<font color=yellow>INFO: Read file types</font>");
1.22      www       289:     $readit=1;
1.46      matthew   290:     }  # end of unless($readit) 
1.32      matthew   291:     
                    292: }
1.112     bowersj2  293: 
1.42      matthew   294: ###############################################################
                    295: ##           HTML and Javascript Helper Functions            ##
                    296: ###############################################################
                    297: 
                    298: =pod 
                    299: 
1.112     bowersj2  300: =head1 HTML and Javascript Functions
1.42      matthew   301: 
1.112     bowersj2  302: =over 4
                    303: 
1.648     raeburn   304: =item * &browser_and_searcher_javascript()
1.112     bowersj2  305: 
                    306: X<browsing, javascript>X<searching, javascript>Returns a string
                    307: containing javascript with two functions, C<openbrowser> and
                    308: C<opensearcher>. Returned string does not contain E<lt>scriptE<gt>
                    309: tags.
1.42      matthew   310: 
1.648     raeburn   311: =item * &openbrowser(formname,elementname,only,omit) [javascript]
1.42      matthew   312: 
                    313: inputs: formname, elementname, only, omit
                    314: 
                    315: formname and elementname indicate the name of the html form and name of
                    316: the element that the results of the browsing selection are to be placed in. 
                    317: 
                    318: Specifying 'only' will restrict the browser to displaying only files
1.185     www       319: with the given extension.  Can be a comma separated list.
1.42      matthew   320: 
                    321: Specifying 'omit' will restrict the browser to NOT displaying files
1.185     www       322: with the given extension.  Can be a comma separated list.
1.42      matthew   323: 
1.648     raeburn   324: =item * &opensearcher(formname,elementname) [javascript]
1.42      matthew   325: 
                    326: Inputs: formname, elementname
                    327: 
                    328: formname and elementname specify the name of the html form and the name
                    329: of the element the selection from the search results will be placed in.
1.542     raeburn   330: 
1.42      matthew   331: =cut
                    332: 
                    333: sub browser_and_searcher_javascript {
1.199     albertel  334:     my ($mode)=@_;
                    335:     if (!defined($mode)) { $mode='edit'; }
1.453     albertel  336:     my $resurl=&escape_single(&lastresurl());
1.42      matthew   337:     return <<END;
1.219     albertel  338: // <!-- BEGIN LON-CAPA Internal
1.50      matthew   339:     var editbrowser = null;
1.135     albertel  340:     function openbrowser(formname,elementname,only,omit,titleelement) {
1.170     www       341:         var url = '$resurl/?';
1.42      matthew   342:         if (editbrowser == null) {
                    343:             url += 'launch=1&';
                    344:         }
                    345:         url += 'catalogmode=interactive&';
1.199     albertel  346:         url += 'mode=$mode&';
1.611     albertel  347:         url += 'inhibitmenu=yes&';
1.42      matthew   348:         url += 'form=' + formname + '&';
                    349:         if (only != null) {
                    350:             url += 'only=' + only + '&';
1.217     albertel  351:         } else {
                    352:             url += 'only=&';
                    353: 	}
1.42      matthew   354:         if (omit != null) {
                    355:             url += 'omit=' + omit + '&';
1.217     albertel  356:         } else {
                    357:             url += 'omit=&';
                    358: 	}
1.135     albertel  359:         if (titleelement != null) {
                    360:             url += 'titleelement=' + titleelement + '&';
1.217     albertel  361:         } else {
                    362: 	    url += 'titleelement=&';
                    363: 	}
1.42      matthew   364:         url += 'element=' + elementname + '';
                    365:         var title = 'Browser';
1.435     albertel  366:         var options = 'scrollbars=1,resizable=1,menubar=0,toolbar=1,location=1';
1.42      matthew   367:         options += ',width=700,height=600';
                    368:         editbrowser = open(url,title,options,'1');
                    369:         editbrowser.focus();
                    370:     }
                    371:     var editsearcher;
1.135     albertel  372:     function opensearcher(formname,elementname,titleelement) {
1.42      matthew   373:         var url = '/adm/searchcat?';
                    374:         if (editsearcher == null) {
                    375:             url += 'launch=1&';
                    376:         }
                    377:         url += 'catalogmode=interactive&';
1.199     albertel  378:         url += 'mode=$mode&';
1.42      matthew   379:         url += 'form=' + formname + '&';
1.135     albertel  380:         if (titleelement != null) {
                    381:             url += 'titleelement=' + titleelement + '&';
1.217     albertel  382:         } else {
                    383: 	    url += 'titleelement=&';
                    384: 	}
1.42      matthew   385:         url += 'element=' + elementname + '';
                    386:         var title = 'Search';
1.435     albertel  387:         var options = 'scrollbars=1,resizable=1,menubar=0,toolbar=1,location=1';
1.42      matthew   388:         options += ',width=700,height=600';
                    389:         editsearcher = open(url,title,options,'1');
                    390:         editsearcher.focus();
                    391:     }
1.219     albertel  392: // END LON-CAPA Internal -->
1.42      matthew   393: END
1.170     www       394: }
                    395: 
                    396: sub lastresurl {
1.258     albertel  397:     if ($env{'environment.lastresurl'}) {
                    398: 	return $env{'environment.lastresurl'}
1.170     www       399:     } else {
                    400: 	return '/res';
                    401:     }
                    402: }
                    403: 
                    404: sub storeresurl {
                    405:     my $resurl=&Apache::lonnet::clutter(shift);
                    406:     unless ($resurl=~/^\/res/) { return 0; }
                    407:     $resurl=~s/\/$//;
                    408:     &Apache::lonnet::put('environment',{'lastresurl' => $resurl});
1.646     raeburn   409:     &Apache::lonnet::appenv({'environment.lastresurl' => $resurl});
1.170     www       410:     return 1;
1.42      matthew   411: }
                    412: 
1.74      www       413: sub studentbrowser_javascript {
1.111     www       414:    unless (
1.258     albertel  415:             (($env{'request.course.id'}) && 
1.302     albertel  416:              (&Apache::lonnet::allowed('srm',$env{'request.course.id'})
                    417: 	      || &Apache::lonnet::allowed('srm',$env{'request.course.id'}.
                    418: 					  '/'.$env{'request.course.sec'})
                    419: 	      ))
1.258     albertel  420:          || ($env{'request.role'}=~/^(au|dc|su)/)
1.111     www       421:           ) { return ''; }  
1.74      www       422:    return (<<'ENDSTDBRW');
                    423: <script type="text/javascript" language="Javascript" >
                    424:     var stdeditbrowser;
1.558     albertel  425:     function openstdbrowser(formname,uname,udom,roleflag,ignorefilter) {
1.74      www       426:         var url = '/adm/pickstudent?';
                    427:         var filter;
1.558     albertel  428: 	if (!ignorefilter) {
                    429: 	    eval('filter=document.'+formname+'.'+uname+'.value;');
                    430: 	}
1.74      www       431:         if (filter != null) {
                    432:            if (filter != '') {
                    433:                url += 'filter='+filter+'&';
                    434: 	   }
                    435:         }
                    436:         url += 'form=' + formname + '&unameelement='+uname+
                    437:                                     '&udomelement='+udom;
1.111     www       438: 	if (roleflag) { url+="&roles=1"; }
1.102     www       439:         var title = 'Student_Browser';
1.74      www       440:         var options = 'scrollbars=1,resizable=1,menubar=0';
                    441:         options += ',width=700,height=600';
                    442:         stdeditbrowser = open(url,title,options,'1');
                    443:         stdeditbrowser.focus();
                    444:     }
                    445: </script>
                    446: ENDSTDBRW
                    447: }
1.42      matthew   448: 
1.74      www       449: sub selectstudent_link {
1.111     www       450:    my ($form,$unameele,$udomele)=@_;
1.258     albertel  451:    if ($env{'request.course.id'}) {  
1.302     albertel  452:        if (!&Apache::lonnet::allowed('srm',$env{'request.course.id'})
                    453: 	   && !&Apache::lonnet::allowed('srm',$env{'request.course.id'}.
                    454: 					'/'.$env{'request.course.sec'})) {
1.111     www       455: 	   return '';
                    456:        }
                    457:        return "<a href='".'javascript:openstdbrowser("'.$form.'","'.$unameele.
1.607     albertel  458:         '","'.$udomele.'");'."'>".&mt('Select User')."</a>";
1.74      www       459:    }
1.258     albertel  460:    if ($env{'request.role'}=~/^(au|dc|su)/) {
1.111     www       461:        return "<a href='".'javascript:openstdbrowser("'.$form.'","'.$unameele.
1.119     www       462:         '","'.$udomele.'",1);'."'>".&mt('Select User')."</a>";
1.111     www       463:    }
                    464:    return '';
1.91      www       465: }
                    466: 
1.653     raeburn   467: sub authorbrowser_javascript {
                    468:     return <<"ENDAUTHORBRW";
                    469: <script type="text/javascript">
                    470: var stdeditbrowser;
                    471: 
                    472: function openauthorbrowser(formname,udom) {
                    473:     var url = '/adm/pickauthor?';
                    474:     url += 'form='+formname+'&roledom='+udom;
                    475:     var title = 'Author_Browser';
                    476:     var options = 'scrollbars=1,resizable=1,menubar=0';
                    477:     options += ',width=700,height=600';
                    478:     stdeditbrowser = open(url,title,options,'1');
                    479:     stdeditbrowser.focus();
                    480: }
                    481: 
                    482: </script>
                    483: ENDAUTHORBRW
                    484: }
                    485: 
1.91      www       486: sub coursebrowser_javascript {
1.468     raeburn   487:     my ($domainfilter,$sec_element,$formname)=@_;
1.377     raeburn   488:     my $crs_or_grp_alert = &mt('Please select the type of LON-CAPA entity - Course or Group - for which you wish to add/modify a user role');
1.468     raeburn   489:    my $output = '
1.538     albertel  490: <script type="text/javascript">
1.468     raeburn   491:     var stdeditbrowser;'."\n";
                    492:    $output .= <<"ENDSTDBRW";
1.377     raeburn   493:     function opencrsbrowser(formname,uname,udom,desc,extra_element,multflag,crstype) {
1.91      www       494:         var url = '/adm/pickcourse?';
1.468     raeburn   495:         var domainfilter = '';
                    496:         var formid = getFormIdByName(formname);
                    497:         if (formid > -1) {
                    498:             var domid = getIndexByName(formid,udom);
                    499:             if (domid > -1) {
                    500:                 if (document.forms[formid].elements[domid].type == 'select-one') {
                    501:                     domainfilter=document.forms[formid].elements[domid].options[document.forms[formid].elements[domid].selectedIndex].value;
                    502:                 }
                    503:                 if (document.forms[formid].elements[domid].type == 'hidden') {
                    504:                     domainfilter=document.forms[formid].elements[domid].value;
                    505:                 }
                    506:             }
1.91      www       507:         }
1.128     albertel  508:         if (domainfilter != null) {
                    509:            if (domainfilter != '') {
                    510:                url += 'domainfilter='+domainfilter+'&';
                    511: 	   }
                    512:         }
1.91      www       513:         url += 'form=' + formname + '&cnumelement='+uname+
1.187     albertel  514: 	                            '&cdomelement='+udom+
                    515:                                     '&cnameelement='+desc;
1.468     raeburn   516:         if (extra_element !=null && extra_element != '') {
1.594     raeburn   517:             if (formname == 'rolechoice' || formname == 'studentform') {
1.468     raeburn   518:                 url += '&roleelement='+extra_element;
                    519:                 if (domainfilter == null || domainfilter == '') {
                    520:                     url += '&domainfilter='+extra_element;
                    521:                 }
1.234     raeburn   522:             }
1.468     raeburn   523:             else {
                    524:                 if (formname == 'portform') {
                    525:                     url += '&setroles='+extra_element;
                    526:                 }
                    527:             }     
1.230     raeburn   528:         }
1.293     raeburn   529:         if (multflag !=null && multflag != '') {
                    530:             url += '&multiple='+multflag;
                    531:         }
1.377     raeburn   532:         if (crstype == 'Course/Group') {
                    533:             if (formname == 'cu') {
                    534:                 crstype = document.cu.crstype.options[document.cu.crstype.selectedIndex].value; 
                    535:                 if (crstype == "") {
                    536:                     alert("$crs_or_grp_alert");
                    537:                     return;
                    538:                 }
                    539:             }
                    540:         }
                    541:         if (crstype !=null && crstype != '') {
                    542:             url += '&type='+crstype;
                    543:         }
1.102     www       544:         var title = 'Course_Browser';
1.91      www       545:         var options = 'scrollbars=1,resizable=1,menubar=0';
                    546:         options += ',width=700,height=600';
                    547:         stdeditbrowser = open(url,title,options,'1');
                    548:         stdeditbrowser.focus();
                    549:     }
1.468     raeburn   550: 
                    551:     function getFormIdByName(formname) {
                    552:         for (var i=0;i<document.forms.length;i++) {
                    553:             if (document.forms[i].name == formname) {
                    554:                 return i;
                    555:             }
                    556:         }
                    557:         return -1; 
                    558:     }
                    559: 
                    560:     function getIndexByName(formid,item) {
                    561:         for (var i=0;i<document.forms[formid].elements.length;i++) {
                    562:             if (document.forms[formid].elements[i].name == item) {
                    563:                 return i;
                    564:             }
                    565:         }
                    566:         return -1;
                    567:     }
1.91      www       568: ENDSTDBRW
1.468     raeburn   569:     if ($sec_element ne '') {
                    570:         $output .= &setsec_javascript($sec_element,$formname);
                    571:     }
                    572:     $output .= '
                    573: </script>';
                    574:     return $output;
                    575: }
                    576: 
                    577: sub setsec_javascript {
                    578:     my ($sec_element,$formname) = @_;
                    579:     my $setsections = qq|
                    580: function setSect(sectionlist) {
1.629     raeburn   581:     var sectionsArray = new Array();
                    582:     if ((sectionlist != '') && (typeof sectionlist != "undefined")) {
                    583:         sectionsArray = sectionlist.split(",");
                    584:     }
1.468     raeburn   585:     var numSections = sectionsArray.length;
                    586:     document.$formname.$sec_element.length = 0;
                    587:     if (numSections == 0) {
                    588:         document.$formname.$sec_element.multiple=false;
                    589:         document.$formname.$sec_element.size=1;
                    590:         document.$formname.$sec_element.options[0] = new Option('No existing sections','',false,false)
                    591:     } else {
                    592:         if (numSections == 1) {
                    593:             document.$formname.$sec_element.multiple=false;
                    594:             document.$formname.$sec_element.size=1;
                    595:             document.$formname.$sec_element.options[0] = new Option('Select','',true,true);
                    596:             document.$formname.$sec_element.options[1] = new Option('No section','',false,false)
                    597:             document.$formname.$sec_element.options[2] = new Option(sectionsArray[0],sectionsArray[0],false,false);
                    598:         } else {
                    599:             for (var i=0; i<numSections; i++) {
                    600:                 document.$formname.$sec_element.options[i] = new Option(sectionsArray[i],sectionsArray[i],false,false)
                    601:             }
                    602:             document.$formname.$sec_element.multiple=true
                    603:             if (numSections < 3) {
                    604:                 document.$formname.$sec_element.size=numSections;
                    605:             } else {
                    606:                 document.$formname.$sec_element.size=3;
                    607:             }
                    608:             document.$formname.$sec_element.options[0].selected = false
                    609:         }
                    610:     }
1.91      www       611: }
1.468     raeburn   612: |;
                    613:     return $setsections;
                    614: }
                    615: 
1.91      www       616: 
                    617: sub selectcourse_link {
1.377     raeburn   618:    my ($form,$unameele,$udomele,$desc,$extra_element,$multflag,$selecttype)=@_;
1.492     albertel  619:    return "<a href='".'javascript:opencrsbrowser("'.$form.'","'.$unameele.
                    620:         '","'.$udomele.'","'.$desc.'","'.$extra_element.'","'.$multflag.'","'.$selecttype.'");'."'>".&mt('Select Course')."</a>";
1.74      www       621: }
1.42      matthew   622: 
1.653     raeburn   623: sub selectauthor_link {
                    624:    my ($form,$udom)=@_;
                    625:    return '<a href="javascript:openauthorbrowser('."'$form','$udom'".');">'.
                    626:           &mt('Select Author').'</a>';
                    627: }
                    628: 
1.273     raeburn   629: sub check_uncheck_jscript {
                    630:     my $jscript = <<"ENDSCRT";
                    631: function checkAll(field) {
                    632:     if (field.length > 0) {
                    633:         for (i = 0; i < field.length; i++) {
                    634:             field[i].checked = true ;
                    635:         }
                    636:     } else {
                    637:         field.checked = true
                    638:     }
                    639: }
                    640:  
                    641: function uncheckAll(field) {
                    642:     if (field.length > 0) {
                    643:         for (i = 0; i < field.length; i++) {
                    644:             field[i].checked = false ;
1.543     albertel  645:         }
                    646:     } else {
1.273     raeburn   647:         field.checked = false ;
                    648:     }
                    649: }
                    650: ENDSCRT
                    651:     return $jscript;
                    652: }
                    653: 
1.656   ! www       654: sub select_timezone {
        !           655:    my ($name,$selected,$onchange)=@_;
        !           656:    my $output="<select name='$name' $onchange>\n";
        !           657:    foreach my $key (sort(keys(%timezone))) {
        !           658:       $output.="<option value='$timezone{$key}'";
        !           659:       if ($key eq $selected) {
        !           660:          $output.=" selected='selected'";
        !           661:       }
        !           662:       $output.=">$timezone{$key}</option>\n";
        !           663:    }
        !           664:    $output.="</select>";
        !           665:    return $output;
        !           666: }
1.273     raeburn   667: 
1.42      matthew   668: =pod
1.36      matthew   669: 
1.648     raeburn   670: =item * &linked_select_forms(...)
1.36      matthew   671: 
                    672: linked_select_forms returns a string containing a <script></script> block
                    673: and html for two <select> menus.  The select menus will be linked in that
                    674: changing the value of the first menu will result in new values being placed
                    675: in the second menu.  The values in the select menu will appear in alphabetical
1.609     raeburn   676: order unless a defined order is provided.
1.36      matthew   677: 
                    678: linked_select_forms takes the following ordered inputs:
                    679: 
                    680: =over 4
                    681: 
1.112     bowersj2  682: =item * $formname, the name of the <form> tag
1.36      matthew   683: 
1.112     bowersj2  684: =item * $middletext, the text which appears between the <select> tags
1.36      matthew   685: 
1.112     bowersj2  686: =item * $firstdefault, the default value for the first menu
1.36      matthew   687: 
1.112     bowersj2  688: =item * $firstselectname, the name of the first <select> tag
1.36      matthew   689: 
1.112     bowersj2  690: =item * $secondselectname, the name of the second <select> tag
1.36      matthew   691: 
1.112     bowersj2  692: =item * $hashref, a reference to a hash containing the data for the menus.
1.36      matthew   693: 
1.609     raeburn   694: =item * $menuorder, the order of values in the first menu
                    695: 
1.41      ng        696: =back 
                    697: 
1.36      matthew   698: Below is an example of such a hash.  Only the 'text', 'default', and 
                    699: 'select2' keys must appear as stated.  keys(%menu) are the possible 
                    700: values for the first select menu.  The text that coincides with the 
1.41      ng        701: first menu value is given in $menu{$choice1}->{'text'}.  The values 
1.36      matthew   702: and text for the second menu are given in the hash pointed to by 
                    703: $menu{$choice1}->{'select2'}.  
                    704: 
1.112     bowersj2  705:  my %menu = ( A1 => { text =>"Choice A1" ,
                    706:                        default => "B3",
                    707:                        select2 => { 
                    708:                            B1 => "Choice B1",
                    709:                            B2 => "Choice B2",
                    710:                            B3 => "Choice B3",
                    711:                            B4 => "Choice B4"
1.609     raeburn   712:                            },
                    713:                        order => ['B4','B3','B1','B2'],
1.112     bowersj2  714:                    },
                    715:                A2 => { text =>"Choice A2" ,
                    716:                        default => "C2",
                    717:                        select2 => { 
                    718:                            C1 => "Choice C1",
                    719:                            C2 => "Choice C2",
                    720:                            C3 => "Choice C3"
1.609     raeburn   721:                            },
                    722:                        order => ['C2','C1','C3'],
1.112     bowersj2  723:                    },
                    724:                A3 => { text =>"Choice A3" ,
                    725:                        default => "D6",
                    726:                        select2 => { 
                    727:                            D1 => "Choice D1",
                    728:                            D2 => "Choice D2",
                    729:                            D3 => "Choice D3",
                    730:                            D4 => "Choice D4",
                    731:                            D5 => "Choice D5",
                    732:                            D6 => "Choice D6",
                    733:                            D7 => "Choice D7"
1.609     raeburn   734:                            },
                    735:                        order => ['D4','D3','D2','D1','D7','D6','D5'],
1.112     bowersj2  736:                    }
                    737:                );
1.36      matthew   738: 
                    739: =cut
                    740: 
                    741: sub linked_select_forms {
                    742:     my ($formname,
                    743:         $middletext,
                    744:         $firstdefault,
                    745:         $firstselectname,
                    746:         $secondselectname, 
1.609     raeburn   747:         $hashref,
                    748:         $menuorder,
1.36      matthew   749:         ) = @_;
                    750:     my $second = "document.$formname.$secondselectname";
                    751:     my $first = "document.$formname.$firstselectname";
                    752:     # output the javascript to do the changing
                    753:     my $result = '';
1.219     albertel  754:     $result.="<script type=\"text/javascript\">\n";
1.36      matthew   755:     $result.="var select2data = new Object();\n";
                    756:     $" = '","';
                    757:     my $debug = '';
                    758:     foreach my $s1 (sort(keys(%$hashref))) {
                    759:         $result.="select2data.d_$s1 = new Object();\n";        
                    760:         $result.="select2data.d_$s1.def = new String('".
                    761:             $hashref->{$s1}->{'default'}."');\n";
1.609     raeburn   762:         $result.="select2data.d_$s1.values = new Array(";
1.36      matthew   763:         my @s2values = sort(keys( %{ $hashref->{$s1}->{'select2'} } ));
1.609     raeburn   764:         if (ref($hashref->{$s1}->{'order'}) eq 'ARRAY') {
                    765:             @s2values = @{$hashref->{$s1}->{'order'}};
                    766:         }
1.36      matthew   767:         $result.="\"@s2values\");\n";
                    768:         $result.="select2data.d_$s1.texts = new Array(";        
                    769:         my @s2texts;
                    770:         foreach my $value (@s2values) {
                    771:             push @s2texts, $hashref->{$s1}->{'select2'}->{$value};
                    772:         }
                    773:         $result.="\"@s2texts\");\n";
                    774:     }
                    775:     $"=' ';
                    776:     $result.= <<"END";
                    777: 
                    778: function select1_changed() {
                    779:     // Determine new choice
                    780:     var newvalue = "d_" + $first.value;
                    781:     // update select2
                    782:     var values     = select2data[newvalue].values;
                    783:     var texts      = select2data[newvalue].texts;
                    784:     var select2def = select2data[newvalue].def;
                    785:     var i;
                    786:     // out with the old
                    787:     for (i = 0; i < $second.options.length; i++) {
                    788:         $second.options[i] = null;
                    789:     }
                    790:     // in with the nuclear
                    791:     for (i=0;i<values.length; i++) {
                    792:         $second.options[i] = new Option(values[i]);
1.143     matthew   793:         $second.options[i].value = values[i];
1.36      matthew   794:         $second.options[i].text = texts[i];
                    795:         if (values[i] == select2def) {
                    796:             $second.options[i].selected = true;
                    797:         }
                    798:     }
                    799: }
                    800: </script>
                    801: END
                    802:     # output the initial values for the selection lists
                    803:     $result .= "<select size=\"1\" name=\"$firstselectname\" onchange=\"select1_changed()\">\n";
1.609     raeburn   804:     my @order = sort(keys(%{$hashref}));
                    805:     if (ref($menuorder) eq 'ARRAY') {
                    806:         @order = @{$menuorder};
                    807:     }
                    808:     foreach my $value (@order) {
1.36      matthew   809:         $result.="    <option value=\"$value\" ";
1.253     albertel  810:         $result.=" selected=\"selected\" " if ($value eq $firstdefault);
1.119     www       811:         $result.=">".&mt($hashref->{$value}->{'text'})."</option>\n";
1.36      matthew   812:     }
                    813:     $result .= "</select>\n";
                    814:     my %select2 = %{$hashref->{$firstdefault}->{'select2'}};
                    815:     $result .= $middletext;
                    816:     $result .= "<select size=\"1\" name=\"$secondselectname\">\n";
                    817:     my $seconddefault = $hashref->{$firstdefault}->{'default'};
1.609     raeburn   818:     
                    819:     my @secondorder = sort(keys(%select2));
                    820:     if (ref($hashref->{$firstdefault}->{'order'}) eq 'ARRAY') {
                    821:         @secondorder = @{$hashref->{$firstdefault}->{'order'}};
                    822:     }
                    823:     foreach my $value (@secondorder) {
1.36      matthew   824:         $result.="    <option value=\"$value\" ";        
1.253     albertel  825:         $result.=" selected=\"selected\" " if ($value eq $seconddefault);
1.119     www       826:         $result.=">".&mt($select2{$value})."</option>\n";
1.36      matthew   827:     }
                    828:     $result .= "</select>\n";
                    829:     #    return $debug;
                    830:     return $result;
                    831: }   #  end of sub linked_select_forms {
                    832: 
1.45      matthew   833: =pod
1.44      bowersj2  834: 
1.648     raeburn   835: =item * &help_open_topic($topic,$text,$stayOnPage,$width,$height)
1.44      bowersj2  836: 
1.112     bowersj2  837: Returns a string corresponding to an HTML link to the given help
                    838: $topic, where $topic corresponds to the name of a .tex file in
                    839: /home/httpd/html/adm/help/tex, with underscores replaced by
                    840: spaces. 
                    841: 
                    842: $text will optionally be linked to the same topic, allowing you to
                    843: link text in addition to the graphic. If you do not want to link
                    844: text, but wish to specify one of the later parameters, pass an
                    845: empty string. 
                    846: 
                    847: $stayOnPage is a value that will be interpreted as a boolean. If true,
                    848: the link will not open a new window. If false, the link will open
                    849: a new window using Javascript. (Default is false.) 
                    850: 
                    851: $width and $height are optional numerical parameters that will
                    852: override the width and height of the popped up window, which may
                    853: be useful for certain help topics with big pictures included. 
1.44      bowersj2  854: 
                    855: =cut
                    856: 
                    857: sub help_open_topic {
1.48      bowersj2  858:     my ($topic, $text, $stayOnPage, $width, $height) = @_;
                    859:     $text = "" if (not defined $text);
1.44      bowersj2  860:     $stayOnPage = 0 if (not defined $stayOnPage);
1.552     banghart  861:     if ($env{'browser.interface'} eq 'textual') {
1.79      www       862: 	$stayOnPage=1;
                    863:     }
1.44      bowersj2  864:     $width = 350 if (not defined $width);
                    865:     $height = 400 if (not defined $height);
                    866:     my $filename = $topic;
                    867:     $filename =~ s/ /_/g;
                    868: 
1.48      bowersj2  869:     my $template = "";
                    870:     my $link;
1.572     banghart  871:     
1.159     www       872:     $topic=~s/\W/\_/g;
1.44      bowersj2  873: 
1.572     banghart  874:     if (!$stayOnPage) {
1.72      bowersj2  875: 	$link = "javascript:void(open('/adm/help/${filename}.hlp', 'Help_for_$topic', 'menubar=0,toolbar=1,scrollbars=1,width=$width,height=$height,resizable=yes'))";
1.572     banghart  876:     } else {
1.48      bowersj2  877: 	$link = "/adm/help/${filename}.hlp";
                    878:     }
                    879: 
                    880:     # Add the text
1.572     banghart  881:     if ($text ne "") {
1.77      www       882: 	$template .= 
1.572     banghart  883:             "<table bgcolor='#3333AA' cellspacing='1' cellpadding='1' border='0'><tr>".
                    884:             "<td bgcolor='#5555FF'><a target=\"_top\" href=\"$link\"><font color='#FFFFFF' size='2'>$text</font></a>";
1.48      bowersj2  885:     }
                    886: 
                    887:     # Add the graphic
1.179     matthew   888:     my $title = &mt('Online Help');
1.649     www       889:     my $helpicon=&lonhttpdurl("/res/adm/pages/help.png");
1.48      bowersj2  890:     $template .= <<"ENDTEMPLATE";
1.436     albertel  891:  <a target="_top" href="$link" title="$title"><img src="$helpicon" border="0" alt="(Help: $topic)" /></a>
1.44      bowersj2  892: ENDTEMPLATE
1.78      www       893:     if ($text ne '') { $template.='</td></tr></table>' };
1.44      bowersj2  894:     return $template;
                    895: 
1.106     bowersj2  896: }
                    897: 
                    898: # This is a quicky function for Latex cheatsheet editing, since it 
                    899: # appears in at least four places
                    900: sub helpLatexCheatsheet {
                    901:     my $other = shift;
                    902:     my $addOther = '';
                    903:     if ($other) {
                    904: 	$addOther = Apache::loncommon::help_open_topic($other, shift,
                    905: 						       undef, undef, 600) .
                    906: 							   '</td><td>';
                    907:     }
                    908:     return '<table><tr><td>'.
                    909: 	$addOther .
1.636     raeburn   910: 	&Apache::loncommon::help_open_topic("Greek_Symbols",&mt('Greek Symbols'),
1.106     bowersj2  911: 					    undef,undef,600)
                    912: 	.'</td><td>'.
1.636     raeburn   913: 	&Apache::loncommon::help_open_topic("Other_Symbols",&mt('Other Symbols'),
1.106     bowersj2  914: 					    undef,undef,600)
                    915: 	.'</td></tr></table>';
1.172     www       916: }
                    917: 
1.430     albertel  918: sub general_help {
                    919:     my $helptopic='Student_Intro';
                    920:     if ($env{'request.role'}=~/^(ca|au)/) {
                    921: 	$helptopic='Authoring_Intro';
                    922:     } elsif ($env{'request.role'}=~/^cc/) {
                    923: 	$helptopic='Course_Coordination_Intro';
                    924:     }
                    925:     return $helptopic;
                    926: }
                    927: 
                    928: sub update_help_link {
                    929:     my ($topic,$component_help,$faq,$bug,$stayOnPage) = @_;
                    930:     my $origurl = $ENV{'REQUEST_URI'};
                    931:     $origurl=~s|^/~|/priv/|;
                    932:     my $timestamp = time;
                    933:     foreach my $datum (\$topic,\$component_help,\$faq,\$bug,\$origurl) {
                    934:         $$datum = &escape($$datum);
                    935:     }
                    936: 
                    937:     my $banner_link = "/adm/helpmenu?page=banner&amp;topic=$topic&amp;component_help=$component_help&amp;faq=$faq&amp;bug=$bug&amp;origurl=$origurl&amp;stamp=$timestamp&amp;stayonpage=$stayOnPage";
                    938:     my $output .= <<"ENDOUTPUT";
                    939: <script type="text/javascript">
                    940: banner_link = '$banner_link';
                    941: </script>
                    942: ENDOUTPUT
                    943:     return $output;
                    944: }
                    945: 
                    946: # now just updates the help link and generates a blue icon
1.193     raeburn   947: sub help_open_menu {
1.430     albertel  948:     my ($topic,$component_help,$faq,$bug,$stayOnPage,$width,$height,$text) 
1.552     banghart  949: 	= @_;    
1.430     albertel  950:     $stayOnPage = 0 if (not defined $stayOnPage);
1.572     banghart  951:     # only use pop-up help (stayOnPage == 0)
1.552     banghart  952:     # if environment.remote is on (using remote control UI)
1.572     banghart  953:     if ($env{'browser.interface'} eq 'textual' ||
                    954:     	$env{'environment.remote'} eq 'off' ) {
1.552     banghart  955:         $stayOnPage=1;
1.430     albertel  956:     }
                    957:     my $output;
                    958:     if ($component_help) {
                    959: 	if (!$text) {
                    960: 	    $output=&help_open_topic($component_help,undef,$stayOnPage,
                    961: 				       $width,$height);
                    962: 	} else {
                    963: 	    my $help_text;
                    964: 	    $help_text=&unescape($topic);
                    965: 	    $output='<table><tr><td>'.
                    966: 		&help_open_topic($component_help,$help_text,$stayOnPage,
                    967: 				 $width,$height).'</td></tr></table>';
                    968: 	}
                    969:     }
                    970:     my $banner_link = &update_help_link($topic,$component_help,$faq,$bug,$stayOnPage);
                    971:     return $output.$banner_link;
                    972: }
                    973: 
                    974: sub top_nav_help {
                    975:     my ($text) = @_;
1.436     albertel  976:     $text = &mt($text);
1.572     banghart  977:     my $stay_on_page = 
1.436     albertel  978: 	($env{'browser.interface'}  eq 'textual' ||
                    979: 	 $env{'environment.remote'} eq 'off' );
1.572     banghart  980:     my $link = ($stay_on_page) ? "javascript:helpMenu('display')"
1.436     albertel  981: 	                     : "javascript:helpMenu('open')";
1.572     banghart  982:     my $banner_link = &update_help_link(undef,undef,undef,undef,$stay_on_page);
1.436     albertel  983: 
1.201     raeburn   984:     my $title = &mt('Get help');
1.436     albertel  985: 
                    986:     return <<"END";
                    987: $banner_link
                    988:  <a href="$link" title="$title">$text</a>
                    989: END
                    990: }
                    991: 
                    992: sub help_menu_js {
                    993:     my ($text) = @_;
                    994: 
                    995:     my $stayOnPage = 
                    996: 	($env{'browser.interface'}  eq 'textual' ||
                    997: 	 $env{'environment.remote'} eq 'off' );
                    998: 
                    999:     my $width = 620;
                   1000:     my $height = 600;
1.430     albertel 1001:     my $helptopic=&general_help();
                   1002:     my $details_link = '/adm/help/'.$helptopic.'.hlp';
1.261     albertel 1003:     my $nothing=&Apache::lonhtmlcommon::javascript_nothing();
1.331     albertel 1004:     my $start_page =
                   1005:         &Apache::loncommon::start_page('Help Menu', undef,
                   1006: 				       {'frameset'    => 1,
                   1007: 					'js_ready'    => 1,
                   1008: 					'add_entries' => {
                   1009: 					    'border' => '0',
1.579     raeburn  1010: 					    'rows'   => "110,*",},});
1.331     albertel 1011:     my $end_page =
                   1012:         &Apache::loncommon::end_page({'frameset' => 1,
                   1013: 				      'js_ready' => 1,});
                   1014: 
1.436     albertel 1015:     my $template .= <<"ENDTEMPLATE";
                   1016: <script type="text/javascript">
1.253     albertel 1017: // <!-- BEGIN LON-CAPA Internal
                   1018: // <![CDATA[
1.430     albertel 1019: var banner_link = '';
1.243     raeburn  1020: function helpMenu(target) {
                   1021:     var caller = this;
                   1022:     if (target == 'open') {
                   1023:         var newWindow = null;
                   1024:         try {
1.262     albertel 1025:             newWindow =  window.open($nothing,"helpmenu","HEIGHT=$height,WIDTH=$width,resizable=yes,scrollbars=yes" )
1.243     raeburn  1026:         }
                   1027:         catch(error) {
                   1028:             writeHelp(caller);
                   1029:             return;
                   1030:         }
                   1031:         if (newWindow) {
                   1032:             caller = newWindow;
                   1033:         }
1.193     raeburn  1034:     }
1.243     raeburn  1035:     writeHelp(caller);
                   1036:     return;
                   1037: }
                   1038: function writeHelp(caller) {
1.430     albertel 1039:     caller.document.writeln('$start_page<frame name="bannerframe"  src="'+banner_link+'" /><frame name="bodyframe" src="$details_link" /> $end_page')
1.243     raeburn  1040:     caller.document.close()
                   1041:     caller.focus()
1.193     raeburn  1042: }
1.253     albertel 1043: // ]]>
1.219     albertel 1044: // END LON-CAPA Internal -->
1.436     albertel 1045: </script>
1.193     raeburn  1046: ENDTEMPLATE
                   1047:     return $template;
                   1048: }
                   1049: 
1.172     www      1050: sub help_open_bug {
                   1051:     my ($topic, $text, $stayOnPage, $width, $height) = @_;
1.258     albertel 1052:     unless ($env{'user.adv'}) { return ''; }
1.172     www      1053:     unless ($Apache::lonnet::perlvar{'BugzillaHost'}) { return ''; }
                   1054:     $text = "" if (not defined $text);
                   1055:     $stayOnPage = 0 if (not defined $stayOnPage);
1.258     albertel 1056:     if ($env{'browser.interface'} eq 'textual' ||
                   1057: 	$env{'environment.remote'} eq 'off' ) {
1.172     www      1058: 	$stayOnPage=1;
                   1059:     }
1.184     albertel 1060:     $width = 600 if (not defined $width);
                   1061:     $height = 600 if (not defined $height);
1.172     www      1062: 
                   1063:     $topic=~s/\W+/\+/g;
                   1064:     my $link='';
                   1065:     my $template='';
1.379     albertel 1066:     my $url=$Apache::lonnet::perlvar{'BugzillaHost'}.'enter_bug.cgi?product=LON-CAPA&amp;bug_file_loc='.
                   1067: 	&escape($ENV{'REQUEST_URI'}).'&amp;component='.$topic;
1.172     www      1068:     if (!$stayOnPage)
                   1069:     {
                   1070: 	$link = "javascript:void(open('$url', 'Bugzilla', 'menubar=0,toolbar=1,scrollbars=1,width=$width,height=$height,resizable=yes'))";
                   1071:     }
                   1072:     else
                   1073:     {
                   1074: 	$link = $url;
                   1075:     }
                   1076:     # Add the text
                   1077:     if ($text ne "")
                   1078:     {
                   1079: 	$template .= 
                   1080:   "<table bgcolor='#AA3333' cellspacing='1' cellpadding='1' border='0'><tr>".
1.436     albertel 1081:   "<td bgcolor='#FF5555'><a target=\"_top\" href=\"$link\"><font color='#FFFFFF' size='2'>$text</font></a>";
1.172     www      1082:     }
                   1083: 
                   1084:     # Add the graphic
1.179     matthew  1085:     my $title = &mt('Report a Bug');
1.215     albertel 1086:     my $bugicon=&lonhttpdurl("/adm/lonMisc/smallBug.gif");
1.172     www      1087:     $template .= <<"ENDTEMPLATE";
1.436     albertel 1088:  <a target="_top" href="$link" title="$title"><img src="$bugicon" border="0" alt="(Bug: $topic)" /></a>
1.172     www      1089: ENDTEMPLATE
                   1090:     if ($text ne '') { $template.='</td></tr></table>' };
                   1091:     return $template;
                   1092: 
                   1093: }
                   1094: 
                   1095: sub help_open_faq {
                   1096:     my ($topic, $text, $stayOnPage, $width, $height) = @_;
1.258     albertel 1097:     unless ($env{'user.adv'}) { return ''; }
1.172     www      1098:     unless ($Apache::lonnet::perlvar{'FAQHost'}) { return ''; }
                   1099:     $text = "" if (not defined $text);
                   1100:     $stayOnPage = 0 if (not defined $stayOnPage);
1.258     albertel 1101:     if ($env{'browser.interface'} eq 'textual' ||
                   1102: 	$env{'environment.remote'} eq 'off' ) {
1.172     www      1103: 	$stayOnPage=1;
                   1104:     }
                   1105:     $width = 350 if (not defined $width);
                   1106:     $height = 400 if (not defined $height);
                   1107: 
                   1108:     $topic=~s/\W+/\+/g;
                   1109:     my $link='';
                   1110:     my $template='';
                   1111:     my $url=$Apache::lonnet::perlvar{'FAQHost'}.'/fom/cache/'.$topic.'.html';
                   1112:     if (!$stayOnPage)
                   1113:     {
                   1114: 	$link = "javascript:void(open('$url', 'FAQ-O-Matic', 'menubar=0,toolbar=1,scrollbars=1,width=$width,height=$height,resizable=yes'))";
                   1115:     }
                   1116:     else
                   1117:     {
                   1118: 	$link = $url;
                   1119:     }
                   1120: 
                   1121:     # Add the text
                   1122:     if ($text ne "")
                   1123:     {
                   1124: 	$template .= 
1.173     www      1125:   "<table bgcolor='#337733' cellspacing='1' cellpadding='1' border='0'><tr>".
1.436     albertel 1126:   "<td bgcolor='#448844'><a target=\"_top\" href=\"$link\"><font color='#FFFFFF' size='2'>$text</font></a>";
1.172     www      1127:     }
                   1128: 
                   1129:     # Add the graphic
1.179     matthew  1130:     my $title = &mt('View the FAQ');
1.215     albertel 1131:     my $faqicon=&lonhttpdurl("/adm/lonMisc/smallFAQ.gif");
1.172     www      1132:     $template .= <<"ENDTEMPLATE";
1.436     albertel 1133:  <a target="_top" href="$link" title="$title"><img src="$faqicon" border="0" alt="(FAQ: $topic)" /></a>
1.172     www      1134: ENDTEMPLATE
                   1135:     if ($text ne '') { $template.='</td></tr></table>' };
                   1136:     return $template;
                   1137: 
1.44      bowersj2 1138: }
1.37      matthew  1139: 
1.180     matthew  1140: ###############################################################
                   1141: ###############################################################
                   1142: 
1.45      matthew  1143: =pod
                   1144: 
1.648     raeburn  1145: =item * &change_content_javascript():
1.256     matthew  1146: 
                   1147: This and the next function allow you to create small sections of an
                   1148: otherwise static HTML page that you can update on the fly with
                   1149: Javascript, even in Netscape 4.
                   1150: 
                   1151: The Javascript fragment returned by this function (no E<lt>scriptE<gt> tag)
                   1152: must be written to the HTML page once. It will prove the Javascript
                   1153: function "change(name, content)". Calling the change function with the
                   1154: name of the section 
                   1155: you want to update, matching the name passed to C<changable_area>, and
                   1156: the new content you want to put in there, will put the content into
                   1157: that area.
                   1158: 
                   1159: B<Note>: Netscape 4 only reserves enough space for the changable area
                   1160: to contain room for the original contents. You need to "make space"
                   1161: for whatever changes you wish to make, and be B<sure> to check your
                   1162: code in Netscape 4. This feature in Netscape 4 is B<not> powerful;
                   1163: it's adequate for updating a one-line status display, but little more.
                   1164: This script will set the space to 100% width, so you only need to
                   1165: worry about height in Netscape 4.
                   1166: 
                   1167: Modern browsers are much less limiting, and if you can commit to the
                   1168: user not using Netscape 4, this feature may be used freely with
                   1169: pretty much any HTML.
                   1170: 
                   1171: =cut
                   1172: 
                   1173: sub change_content_javascript {
                   1174:     # If we're on Netscape 4, we need to use Layer-based code
1.258     albertel 1175:     if ($env{'browser.type'} eq 'netscape' &&
                   1176: 	$env{'browser.version'} =~ /^4\./) {
1.256     matthew  1177: 	return (<<NETSCAPE4);
                   1178: 	function change(name, content) {
                   1179: 	    doc = document.layers[name+"___escape"].layers[0].document;
                   1180: 	    doc.open();
                   1181: 	    doc.write(content);
                   1182: 	    doc.close();
                   1183: 	}
                   1184: NETSCAPE4
                   1185:     } else {
                   1186: 	# Otherwise, we need to use semi-standards-compliant code
                   1187: 	# (technically, "innerHTML" isn't standard but the equivalent
                   1188: 	# is really scary, and every useful browser supports it
                   1189: 	return (<<DOMBASED);
                   1190: 	function change(name, content) {
                   1191: 	    element = document.getElementById(name);
                   1192: 	    element.innerHTML = content;
                   1193: 	}
                   1194: DOMBASED
                   1195:     }
                   1196: }
                   1197: 
                   1198: =pod
                   1199: 
1.648     raeburn  1200: =item * &changable_area($name,$origContent):
1.256     matthew  1201: 
                   1202: This provides a "changable area" that can be modified on the fly via
                   1203: the Javascript code provided in C<change_content_javascript>. $name is
                   1204: the name you will use to reference the area later; do not repeat the
                   1205: same name on a given HTML page more then once. $origContent is what
                   1206: the area will originally contain, which can be left blank.
                   1207: 
                   1208: =cut
                   1209: 
                   1210: sub changable_area {
                   1211:     my ($name, $origContent) = @_;
                   1212: 
1.258     albertel 1213:     if ($env{'browser.type'} eq 'netscape' &&
                   1214: 	$env{'browser.version'} =~ /^4\./) {
1.256     matthew  1215: 	# If this is netscape 4, we need to use the Layer tag
                   1216: 	return "<ilayer width='100%' id='${name}___escape' overflow='none'><layer width='100%' id='$name' overflow='none'>$origContent</layer></ilayer>";
                   1217:     } else {
                   1218: 	return "<span id='$name'>$origContent</span>";
                   1219:     }
                   1220: }
                   1221: 
                   1222: =pod
                   1223: 
1.648     raeburn  1224: =item * &viewport_geometry_js 
1.590     raeburn  1225: 
                   1226: Provides javascript object (Geometry) which can provide information about the viewport geometry for the client browser.
                   1227: 
                   1228: =cut
                   1229: 
                   1230: 
                   1231: sub viewport_geometry_js { 
                   1232:     return <<"GEOMETRY";
                   1233: var Geometry = {};
                   1234: function init_geometry() {
                   1235:     if (Geometry.init) { return };
                   1236:     Geometry.init=1;
                   1237:     if (window.innerHeight) {
                   1238:         Geometry.getViewportHeight   = function() { return window.innerHeight; };
                   1239:         Geometry.getViewportWidth   = function() { return window.innerWidth; };
                   1240:         Geometry.getHorizontalScroll = function() { return window.pageXOffset; };
                   1241:         Geometry.getVerticalScroll   = function() { return window.pageYOffset; };
                   1242:     }
                   1243:     else if (document.documentElement && document.documentElement.clientHeight) {
                   1244:         Geometry.getViewportHeight =
                   1245:             function() { return document.documentElement.clientHeight; };
                   1246:         Geometry.getViewportWidth =
                   1247:             function() { return document.documentElement.clientWidth; };
                   1248: 
                   1249:         Geometry.getHorizontalScroll =
                   1250:             function() { return document.documentElement.scrollLeft; };
                   1251:         Geometry.getVerticalScroll =
                   1252:             function() { return document.documentElement.scrollTop; };
                   1253:     }
                   1254:     else if (document.body.clientHeight) {
                   1255:         Geometry.getViewportHeight =
                   1256:             function() { return document.body.clientHeight; };
                   1257:         Geometry.getViewportWidth =
                   1258:             function() { return document.body.clientWidth; };
                   1259:         Geometry.getHorizontalScroll =
                   1260:             function() { return document.body.scrollLeft; };
                   1261:         Geometry.getVerticalScroll =
                   1262:             function() { return document.body.scrollTop; };
                   1263:     }
                   1264: }
                   1265: 
                   1266: GEOMETRY
                   1267: }
                   1268: 
                   1269: =pod
                   1270: 
1.648     raeburn  1271: =item * &viewport_size_js()
1.590     raeburn  1272: 
                   1273: Provides a javascript function to set values of two form elements - width and height (elements are passed in as arguments to the javascript function) to the dimensions of the user's browser window. 
                   1274: 
                   1275: =cut
                   1276: 
                   1277: sub viewport_size_js {
                   1278:     my $geometry = &viewport_geometry_js();
                   1279:     return <<"DIMS";
                   1280: 
                   1281: $geometry
                   1282: 
                   1283: function getViewportDims(width,height) {
                   1284:     init_geometry();
                   1285:     width.value = Geometry.getViewportWidth();
                   1286:     height.value = Geometry.getViewportHeight();
                   1287:     return;
                   1288: }
                   1289: 
                   1290: DIMS
                   1291: }
                   1292: 
                   1293: =pod
                   1294: 
1.648     raeburn  1295: =item * &resize_textarea_js()
1.565     albertel 1296: 
                   1297: emits the needed javascript to resize a textarea to be as big as possible
                   1298: 
                   1299: creates a function resize_textrea that takes two IDs first should be
                   1300: the id of the element to resize, second should be the id of a div that
                   1301: surrounds everything that comes after the textarea, this routine needs
                   1302: to be attached to the <body> for the onload and onresize events.
                   1303: 
1.648     raeburn  1304: =back
1.565     albertel 1305: 
                   1306: =cut
                   1307: 
                   1308: sub resize_textarea_js {
1.590     raeburn  1309:     my $geometry = &viewport_geometry_js();
1.565     albertel 1310:     return <<"RESIZE";
                   1311:     <script type="text/javascript">
1.590     raeburn  1312: $geometry
1.565     albertel 1313: 
1.588     albertel 1314: function getX(element) {
                   1315:     var x = 0;
                   1316:     while (element) {
                   1317: 	x += element.offsetLeft;
                   1318: 	element = element.offsetParent;
                   1319:     }
                   1320:     return x;
                   1321: }
                   1322: function getY(element) {
                   1323:     var y = 0;
                   1324:     while (element) {
                   1325: 	y += element.offsetTop;
                   1326: 	element = element.offsetParent;
                   1327:     }
                   1328:     return y;
                   1329: }
                   1330: 
                   1331: 
1.565     albertel 1332: function resize_textarea(textarea_id,bottom_id) {
                   1333:     init_geometry();
                   1334:     var textarea        = document.getElementById(textarea_id);
                   1335:     //alert(textarea);
                   1336: 
1.588     albertel 1337:     var textarea_top    = getY(textarea);
1.565     albertel 1338:     var textarea_height = textarea.offsetHeight;
                   1339:     var bottom          = document.getElementById(bottom_id);
1.588     albertel 1340:     var bottom_top      = getY(bottom);
1.565     albertel 1341:     var bottom_height   = bottom.offsetHeight;
                   1342:     var window_height   = Geometry.getViewportHeight();
1.588     albertel 1343:     var fudge           = 23;
1.565     albertel 1344:     var new_height      = window_height-fudge-textarea_top-bottom_height;
                   1345:     if (new_height < 300) {
                   1346: 	new_height = 300;
                   1347:     }
                   1348:     textarea.style.height=new_height+'px';
                   1349: }
                   1350: </script>
                   1351: RESIZE
                   1352: 
                   1353: }
                   1354: 
                   1355: =pod
                   1356: 
1.256     matthew  1357: =head1 Excel and CSV file utility routines
                   1358: 
                   1359: =over 4
                   1360: 
                   1361: =cut
                   1362: 
                   1363: ###############################################################
                   1364: ###############################################################
                   1365: 
                   1366: =pod
                   1367: 
1.648     raeburn  1368: =item * &csv_translate($text) 
1.37      matthew  1369: 
1.185     www      1370: Translate $text to allow it to be output as a 'comma separated values' 
1.37      matthew  1371: format.
                   1372: 
                   1373: =cut
                   1374: 
1.180     matthew  1375: ###############################################################
                   1376: ###############################################################
1.37      matthew  1377: sub csv_translate {
                   1378:     my $text = shift;
                   1379:     $text =~ s/\"/\"\"/g;
1.209     albertel 1380:     $text =~ s/\n/ /g;
1.37      matthew  1381:     return $text;
                   1382: }
1.180     matthew  1383: 
                   1384: ###############################################################
                   1385: ###############################################################
                   1386: 
                   1387: =pod
                   1388: 
1.648     raeburn  1389: =item * &define_excel_formats()
1.180     matthew  1390: 
                   1391: Define some commonly used Excel cell formats.
                   1392: 
                   1393: Currently supported formats:
                   1394: 
                   1395: =over 4
                   1396: 
                   1397: =item header
                   1398: 
                   1399: =item bold
                   1400: 
                   1401: =item h1
                   1402: 
                   1403: =item h2
                   1404: 
                   1405: =item h3
                   1406: 
1.256     matthew  1407: =item h4
                   1408: 
                   1409: =item i
                   1410: 
1.180     matthew  1411: =item date
                   1412: 
                   1413: =back
                   1414: 
                   1415: Inputs: $workbook
                   1416: 
                   1417: Returns: $format, a hash reference.
                   1418: 
                   1419: =cut
                   1420: 
                   1421: ###############################################################
                   1422: ###############################################################
                   1423: sub define_excel_formats {
                   1424:     my ($workbook) = @_;
                   1425:     my $format;
                   1426:     $format->{'header'} = $workbook->add_format(bold      => 1, 
                   1427:                                                 bottom    => 1,
                   1428:                                                 align     => 'center');
                   1429:     $format->{'bold'} = $workbook->add_format(bold=>1);
                   1430:     $format->{'h1'}   = $workbook->add_format(bold=>1, size=>18);
                   1431:     $format->{'h2'}   = $workbook->add_format(bold=>1, size=>16);
                   1432:     $format->{'h3'}   = $workbook->add_format(bold=>1, size=>14);
1.255     matthew  1433:     $format->{'h4'}   = $workbook->add_format(bold=>1, size=>12);
1.246     matthew  1434:     $format->{'i'}    = $workbook->add_format(italic=>1);
1.180     matthew  1435:     $format->{'date'} = $workbook->add_format(num_format=>
1.207     matthew  1436:                                             'mm/dd/yyyy hh:mm:ss');
1.180     matthew  1437:     return $format;
                   1438: }
                   1439: 
                   1440: ###############################################################
                   1441: ###############################################################
1.113     bowersj2 1442: 
                   1443: =pod
                   1444: 
1.648     raeburn  1445: =item * &create_workbook()
1.255     matthew  1446: 
                   1447: Create an Excel worksheet.  If it fails, output message on the
                   1448: request object and return undefs.
                   1449: 
                   1450: Inputs: Apache request object
                   1451: 
                   1452: Returns (undef) on failure, 
                   1453:     Excel worksheet object, scalar with filename, and formats 
                   1454:     from &Apache::loncommon::define_excel_formats on success
                   1455: 
                   1456: =cut
                   1457: 
                   1458: ###############################################################
                   1459: ###############################################################
                   1460: sub create_workbook {
                   1461:     my ($r) = @_;
                   1462:         #
                   1463:     # Create the excel spreadsheet
                   1464:     my $filename = '/prtspool/'.
1.258     albertel 1465:         $env{'user.name'}.'_'.$env{'user.domain'}.'_'.
1.255     matthew  1466:         time.'_'.rand(1000000000).'.xls';
                   1467:     my $workbook  = Spreadsheet::WriteExcel->new('/home/httpd'.$filename);
                   1468:     if (! defined($workbook)) {
                   1469:         $r->log_error("Error creating excel spreadsheet $filename: $!");
                   1470:         $r->print('<p>'.&mt("Unable to create new Excel file.  ".
                   1471:                             "This error has been logged.  ".
                   1472:                             "Please alert your LON-CAPA administrator").
                   1473:                   '</p>');
                   1474:         return (undef);
                   1475:     }
                   1476:     #
                   1477:     $workbook->set_tempdir('/home/httpd/perl/tmp');
                   1478:     #
                   1479:     my $format = &Apache::loncommon::define_excel_formats($workbook);
                   1480:     return ($workbook,$filename,$format);
                   1481: }
                   1482: 
                   1483: ###############################################################
                   1484: ###############################################################
                   1485: 
                   1486: =pod
                   1487: 
1.648     raeburn  1488: =item * &create_text_file()
1.113     bowersj2 1489: 
1.542     raeburn  1490: Create a file to write to and eventually make available to the user.
1.256     matthew  1491: If file creation fails, outputs an error message on the request object and 
                   1492: return undefs.
1.113     bowersj2 1493: 
1.256     matthew  1494: Inputs: Apache request object, and file suffix
1.113     bowersj2 1495: 
1.256     matthew  1496: Returns (undef) on failure, 
                   1497:     Filehandle and filename on success.
1.113     bowersj2 1498: 
                   1499: =cut
                   1500: 
1.256     matthew  1501: ###############################################################
                   1502: ###############################################################
                   1503: sub create_text_file {
                   1504:     my ($r,$suffix) = @_;
                   1505:     if (! defined($suffix)) { $suffix = 'txt'; };
                   1506:     my $fh;
                   1507:     my $filename = '/prtspool/'.
1.258     albertel 1508:         $env{'user.name'}.'_'.$env{'user.domain'}.'_'.
1.256     matthew  1509:         time.'_'.rand(1000000000).'.'.$suffix;
                   1510:     $fh = Apache::File->new('>/home/httpd'.$filename);
                   1511:     if (! defined($fh)) {
                   1512:         $r->log_error("Couldn't open $filename for output $!");
                   1513:         $r->print("Problems occured in creating the output file.  ".
                   1514:                   "This error has been logged.  ".
                   1515:                   "Please alert your LON-CAPA administrator.");
1.113     bowersj2 1516:     }
1.256     matthew  1517:     return ($fh,$filename)
1.113     bowersj2 1518: }
                   1519: 
                   1520: 
1.256     matthew  1521: =pod 
1.113     bowersj2 1522: 
                   1523: =back
                   1524: 
                   1525: =cut
1.37      matthew  1526: 
                   1527: ###############################################################
1.33      matthew  1528: ##        Home server <option> list generating code          ##
                   1529: ###############################################################
1.35      matthew  1530: 
1.169     www      1531: # ------------------------------------------
                   1532: 
                   1533: sub domain_select {
                   1534:     my ($name,$value,$multiple)=@_;
                   1535:     my %domains=map { 
1.514     albertel 1536: 	$_ => $_.' '. &Apache::lonnet::domain($_,'description') 
1.512     albertel 1537:     } &Apache::lonnet::all_domains();
1.169     www      1538:     if ($multiple) {
                   1539: 	$domains{''}=&mt('Any domain');
1.550     albertel 1540: 	$domains{'select_form_order'} = [sort {lc($a) cmp lc($b) } (keys(%domains))];
1.287     albertel 1541: 	return &multiple_select_form($name,$value,4,\%domains);
1.169     www      1542:     } else {
1.550     albertel 1543: 	$domains{'select_form_order'} = [sort {lc($a) cmp lc($b) } (keys(%domains))];
1.169     www      1544: 	return &select_form($name,$value,%domains);
                   1545:     }
                   1546: }
                   1547: 
1.282     albertel 1548: #-------------------------------------------
                   1549: 
                   1550: =pod
                   1551: 
1.519     raeburn  1552: =head1 Routines for form select boxes
                   1553: 
                   1554: =over 4
                   1555: 
1.648     raeburn  1556: =item * &multiple_select_form($name,$value,$size,$hash,$order)
1.282     albertel 1557: 
                   1558: Returns a string containing a <select> element int multiple mode
                   1559: 
                   1560: 
                   1561: Args:
                   1562:   $name - name of the <select> element
1.506     raeburn  1563:   $value - scalar or array ref of values that should already be selected
1.282     albertel 1564:   $size - number of rows long the select element is
1.283     albertel 1565:   $hash - the elements should be 'option' => 'shown text'
1.282     albertel 1566:           (shown text should already have been &mt())
1.506     raeburn  1567:   $order - (optional) array ref of the order to show the elements in
1.283     albertel 1568: 
1.282     albertel 1569: =cut
                   1570: 
                   1571: #-------------------------------------------
1.169     www      1572: sub multiple_select_form {
1.284     albertel 1573:     my ($name,$value,$size,$hash,$order)=@_;
1.169     www      1574:     my %selected = map { $_ => 1 } ref($value)?@{$value}:($value);
                   1575:     my $output='';
1.191     matthew  1576:     if (! defined($size)) {
                   1577:         $size = 4;
1.283     albertel 1578:         if (scalar(keys(%$hash))<4) {
                   1579:             $size = scalar(keys(%$hash));
1.191     matthew  1580:         }
                   1581:     }
1.169     www      1582:     $output.="\n<select name='$name' size='$size' multiple='1'>";
1.501     banghart 1583:     my @order;
1.506     raeburn  1584:     if (ref($order) eq 'ARRAY')  {
                   1585:         @order = @{$order};
                   1586:     } else {
                   1587:         @order = sort(keys(%$hash));
1.501     banghart 1588:     }
                   1589:     if (exists($$hash{'select_form_order'})) {
                   1590:         @order = @{$$hash{'select_form_order'}};
                   1591:     }
                   1592:         
1.284     albertel 1593:     foreach my $key (@order) {
1.356     albertel 1594:         $output.='<option value="'.&HTML::Entities::encode($key,'"<>&').'" ';
1.284     albertel 1595:         $output.='selected="selected" ' if ($selected{$key});
                   1596:         $output.='>'.$hash->{$key}."</option>\n";
1.169     www      1597:     }
                   1598:     $output.="</select>\n";
                   1599:     return $output;
                   1600: }
                   1601: 
1.88      www      1602: #-------------------------------------------
                   1603: 
                   1604: =pod
                   1605: 
1.648     raeburn  1606: =item * &select_form($defdom,$name,%hash)
1.88      www      1607: 
                   1608: Returns a string containing a <select name='$name' size='1'> form to 
                   1609: allow a user to select options from a hash option_name => displayed text.  
                   1610: See lonrights.pm for an example invocation and use.
                   1611: 
                   1612: =cut
                   1613: 
                   1614: #-------------------------------------------
                   1615: sub select_form {
                   1616:     my ($def,$name,%hash) = @_;
                   1617:     my $selectform = "<select name=\"$name\" size=\"1\">\n";
1.128     albertel 1618:     my @keys;
                   1619:     if (exists($hash{'select_form_order'})) {
                   1620: 	@keys=@{$hash{'select_form_order'}};
                   1621:     } else {
                   1622: 	@keys=sort(keys(%hash));
                   1623:     }
1.356     albertel 1624:     foreach my $key (@keys) {
                   1625:         $selectform.=
                   1626: 	    '<option value="'.&HTML::Entities::encode($key,'"<>&').'" '.
                   1627:             ($key eq $def ? 'selected="selected" ' : '').
                   1628:                 ">".&mt($hash{$key})."</option>\n";
1.88      www      1629:     }
                   1630:     $selectform.="</select>";
                   1631:     return $selectform;
                   1632: }
                   1633: 
1.475     www      1634: # For display filters
                   1635: 
                   1636: sub display_filter {
                   1637:     if (!$env{'form.show'}) { $env{'form.show'}=10; }
1.477     www      1638:     if (!$env{'form.displayfilter'}) { $env{'form.displayfilter'}='currentfolder'; }
1.475     www      1639:     return '<nobr><label>'.&mt('Records [_1]',
                   1640: 			       &Apache::lonmeta::selectbox('show',$env{'form.show'},undef,
                   1641: 							   (&mt('all'),10,20,50,100,1000,10000))).
1.478     www      1642: 	   '</label></nobr> <nobr>'.
1.475     www      1643:            &mt('Filter [_1]',
1.477     www      1644: 	   &select_form($env{'form.displayfilter'},
                   1645: 			'displayfilter',
                   1646: 			('currentfolder' => 'Current folder/page',
                   1647: 			 'containing' => 'Containing phrase',
                   1648: 			 'none' => 'None'))).
1.478     www      1649: 			 '<input type="text" name="containingphrase" size="30" value="'.&HTML::Entities::encode($env{'form.containingphrase'}).'" /></nobr>';
1.475     www      1650: }
                   1651: 
1.167     www      1652: sub gradeleveldescription {
                   1653:     my $gradelevel=shift;
                   1654:     my %gradelevels=(0 => 'Not specified',
                   1655: 		     1 => 'Grade 1',
                   1656: 		     2 => 'Grade 2',
                   1657: 		     3 => 'Grade 3',
                   1658: 		     4 => 'Grade 4',
                   1659: 		     5 => 'Grade 5',
                   1660: 		     6 => 'Grade 6',
                   1661: 		     7 => 'Grade 7',
                   1662: 		     8 => 'Grade 8',
                   1663: 		     9 => 'Grade 9',
                   1664: 		     10 => 'Grade 10',
                   1665: 		     11 => 'Grade 11',
                   1666: 		     12 => 'Grade 12',
                   1667: 		     13 => 'Grade 13',
                   1668: 		     14 => '100 Level',
                   1669: 		     15 => '200 Level',
                   1670: 		     16 => '300 Level',
                   1671: 		     17 => '400 Level',
                   1672: 		     18 => 'Graduate Level');
                   1673:     return &mt($gradelevels{$gradelevel});
                   1674: }
                   1675: 
1.163     www      1676: sub select_level_form {
                   1677:     my ($deflevel,$name)=@_;
                   1678:     unless ($deflevel) { $deflevel=0; }
1.167     www      1679:     my $selectform = "<select name=\"$name\" size=\"1\">\n";
                   1680:     for (my $i=0; $i<=18; $i++) {
                   1681:         $selectform.="<option value=\"$i\" ".
1.253     albertel 1682:             ($i==$deflevel ? 'selected="selected" ' : '').
1.167     www      1683:                 ">".&gradeleveldescription($i)."</option>\n";
                   1684:     }
                   1685:     $selectform.="</select>";
                   1686:     return $selectform;
1.163     www      1687: }
1.167     www      1688: 
1.35      matthew  1689: #-------------------------------------------
                   1690: 
1.45      matthew  1691: =pod
                   1692: 
1.648     raeburn  1693: =item * &select_dom_form($defdom,$name,$includeempty,$showdomdesc)
1.35      matthew  1694: 
                   1695: Returns a string containing a <select name='$name' size='1'> form to 
                   1696: allow a user to select the domain to preform an operation in.  
                   1697: See loncreateuser.pm for an example invocation and use.
                   1698: 
1.90      www      1699: If the $includeempty flag is set, it also includes an empty choice ("no domain
                   1700: selected");
                   1701: 
1.563     raeburn  1702: If the $showdomdesc flag is set, the domain name is followed by the domain description. 
                   1703: 
1.35      matthew  1704: =cut
                   1705: 
                   1706: #-------------------------------------------
1.34      matthew  1707: sub select_dom_form {
1.563     raeburn  1708:     my ($defdom,$name,$includeempty,$showdomdesc) = @_;
1.550     albertel 1709:     my @domains = sort {lc($a) cmp lc($b)} (&Apache::lonnet::all_domains());
1.90      www      1710:     if ($includeempty) { @domains=('',@domains); }
1.34      matthew  1711:     my $selectdomain = "<select name=\"$name\" size=\"1\">\n";
1.356     albertel 1712:     foreach my $dom (@domains) {
                   1713:         $selectdomain.="<option value=\"$dom\" ".
1.563     raeburn  1714:             ($dom eq $defdom ? 'selected="selected" ' : '').'>'.$dom;
                   1715:         if ($showdomdesc) {
                   1716:             if ($dom ne '') {
                   1717:                 my $domdesc = &Apache::lonnet::domain($dom,'description');
                   1718:                 if ($domdesc ne '') {
                   1719:                     $selectdomain .= ' ('.$domdesc.')';
                   1720:                 }
                   1721:             } 
                   1722:         }
                   1723:         $selectdomain .= "</option>\n";
1.34      matthew  1724:     }
                   1725:     $selectdomain.="</select>";
                   1726:     return $selectdomain;
                   1727: }
                   1728: 
1.35      matthew  1729: #-------------------------------------------
                   1730: 
1.45      matthew  1731: =pod
                   1732: 
1.648     raeburn  1733: =item * &home_server_form_item($domain,$name,$defaultflag)
1.35      matthew  1734: 
1.586     raeburn  1735: input: 4 arguments (two required, two optional) - 
                   1736:     $domain - domain of new user
                   1737:     $name - name of form element
                   1738:     $default - Value of 'default' causes a default item to be first 
                   1739:                             option, and selected by default. 
                   1740:     $hide - Value of 'hide' causes hiding of the name of the server, 
                   1741:                             if 1 server found, or default, if 0 found.
1.594     raeburn  1742: output: returns 2 items: 
1.586     raeburn  1743: (a) form element which contains either:
                   1744:    (i) <select name="$name">
                   1745:         <option value="$hostid1">$hostid $servers{$hostid}</option>
                   1746:         <option value="$hostid2">$hostid $servers{$hostid}</option>       
                   1747:        </select>
                   1748:        form item if there are multiple library servers in $domain, or
                   1749:    (ii) an <input type="hidden" name="$name" value="$hostid" /> form item 
                   1750:        if there is only one library server in $domain.
                   1751: 
                   1752: (b) number of library servers found.
                   1753: 
                   1754: See loncreateuser.pm for example of use.
1.35      matthew  1755: 
                   1756: =cut
                   1757: 
                   1758: #-------------------------------------------
1.586     raeburn  1759: sub home_server_form_item {
                   1760:     my ($domain,$name,$default,$hide) = @_;
1.513     albertel 1761:     my %servers = &Apache::lonnet::get_servers($domain,'library');
1.586     raeburn  1762:     my $result;
                   1763:     my $numlib = keys(%servers);
                   1764:     if ($numlib > 1) {
                   1765:         $result .= '<select name="'.$name.'" />'."\n";
                   1766:         if ($default) {
                   1767:             $result .= '<option value="default" selected>'.&mt('default').
                   1768:                        '</option>'."\n";
                   1769:         }
                   1770:         foreach my $hostid (sort(keys(%servers))) {
                   1771:             $result.= '<option value="'.$hostid.'">'.
                   1772: 	              $hostid.' '.$servers{$hostid}."</option>\n";
                   1773:         }
                   1774:         $result .= '</select>'."\n";
                   1775:     } elsif ($numlib == 1) {
                   1776:         my $hostid;
                   1777:         foreach my $item (keys(%servers)) {
                   1778:             $hostid = $item;
                   1779:         }
                   1780:         $result .= '<input type="hidden" name="'.$name.'" value="'.
                   1781:                    $hostid.'" />';
                   1782:                    if (!$hide) {
                   1783:                        $result .= $hostid.' '.$servers{$hostid};
                   1784:                    }
                   1785:                    $result .= "\n";
                   1786:     } elsif ($default) {
                   1787:         $result .= '<input type="hidden" name="'.$name.
                   1788:                    '" value="default" />';
                   1789:                    if (!$hide) {
                   1790:                        $result .= &mt('default');
                   1791:                    }
                   1792:                    $result .= "\n";
1.33      matthew  1793:     }
1.586     raeburn  1794:     return ($result,$numlib);
1.33      matthew  1795: }
1.112     bowersj2 1796: 
                   1797: =pod
                   1798: 
1.534     albertel 1799: =back 
                   1800: 
1.112     bowersj2 1801: =cut
1.87      matthew  1802: 
                   1803: ###############################################################
1.112     bowersj2 1804: ##                  Decoding User Agent                      ##
1.87      matthew  1805: ###############################################################
                   1806: 
                   1807: =pod
                   1808: 
1.112     bowersj2 1809: =head1 Decoding the User Agent
                   1810: 
                   1811: =over 4
                   1812: 
                   1813: =item * &decode_user_agent()
1.87      matthew  1814: 
                   1815: Inputs: $r
                   1816: 
                   1817: Outputs:
                   1818: 
                   1819: =over 4
                   1820: 
1.112     bowersj2 1821: =item * $httpbrowser
1.87      matthew  1822: 
1.112     bowersj2 1823: =item * $clientbrowser
1.87      matthew  1824: 
1.112     bowersj2 1825: =item * $clientversion
1.87      matthew  1826: 
1.112     bowersj2 1827: =item * $clientmathml
1.87      matthew  1828: 
1.112     bowersj2 1829: =item * $clientunicode
1.87      matthew  1830: 
1.112     bowersj2 1831: =item * $clientos
1.87      matthew  1832: 
                   1833: =back
                   1834: 
1.157     matthew  1835: =back 
                   1836: 
1.87      matthew  1837: =cut
                   1838: 
                   1839: ###############################################################
                   1840: ###############################################################
                   1841: sub decode_user_agent {
1.247     albertel 1842:     my ($r)=@_;
1.87      matthew  1843:     my @browsertype=split(/\&/,$Apache::lonnet::perlvar{"lonBrowsDet"});
                   1844:     my %mathcap=split(/\&/,$$Apache::lonnet::perlvar{"lonMathML"});
                   1845:     my $httpbrowser=$ENV{"HTTP_USER_AGENT"};
1.247     albertel 1846:     if (!$httpbrowser && $r) { $httpbrowser=$r->header_in('User-Agent'); }
1.87      matthew  1847:     my $clientbrowser='unknown';
                   1848:     my $clientversion='0';
                   1849:     my $clientmathml='';
                   1850:     my $clientunicode='0';
                   1851:     for (my $i=0;$i<=$#browsertype;$i++) {
                   1852:         my ($bname,$match,$notmatch,$vreg,$minv,$univ)=split(/\:/,$browsertype[$i]);
                   1853: 	if (($httpbrowser=~/$match/i)  && ($httpbrowser!~/$notmatch/i)) {
                   1854: 	    $clientbrowser=$bname;
                   1855:             $httpbrowser=~/$vreg/i;
                   1856: 	    $clientversion=$1;
                   1857:             $clientmathml=($clientversion>=$minv);
                   1858:             $clientunicode=($clientversion>=$univ);
                   1859: 	}
                   1860:     }
                   1861:     my $clientos='unknown';
                   1862:     if (($httpbrowser=~/linux/i) ||
                   1863:         ($httpbrowser=~/unix/i) ||
                   1864:         ($httpbrowser=~/ux/i) ||
                   1865:         ($httpbrowser=~/solaris/i)) { $clientos='unix'; }
                   1866:     if (($httpbrowser=~/vax/i) ||
                   1867:         ($httpbrowser=~/vms/i)) { $clientos='vms'; }
                   1868:     if ($httpbrowser=~/next/i) { $clientos='next'; }
                   1869:     if (($httpbrowser=~/mac/i) ||
                   1870:         ($httpbrowser=~/powerpc/i)) { $clientos='mac'; }
                   1871:     if ($httpbrowser=~/win/i) { $clientos='win'; }
                   1872:     if ($httpbrowser=~/embed/i) { $clientos='pda'; }
                   1873:     return ($httpbrowser,$clientbrowser,$clientversion,$clientmathml,
                   1874:             $clientunicode,$clientos,);
                   1875: }
                   1876: 
1.32      matthew  1877: ###############################################################
                   1878: ##    Authentication changing form generation subroutines    ##
                   1879: ###############################################################
                   1880: ##
                   1881: ## All of the authform_xxxxxxx subroutines take their inputs in a
                   1882: ## hash, and have reasonable default values.
                   1883: ##
                   1884: ##    formname = the name given in the <form> tag.
1.35      matthew  1885: #-------------------------------------------
                   1886: 
1.45      matthew  1887: =pod
                   1888: 
1.112     bowersj2 1889: =head1 Authentication Routines
                   1890: 
                   1891: =over 4
                   1892: 
1.648     raeburn  1893: =item * &authform_xxxxxx()
1.35      matthew  1894: 
                   1895: The authform_xxxxxx subroutines provide javascript and html forms which 
                   1896: handle some of the conveniences required for authentication forms.  
                   1897: This is not an optimal method, but it works.  
                   1898: 
                   1899: =over 4
                   1900: 
1.112     bowersj2 1901: =item * authform_header
1.35      matthew  1902: 
1.112     bowersj2 1903: =item * authform_authorwarning
1.35      matthew  1904: 
1.112     bowersj2 1905: =item * authform_nochange
1.35      matthew  1906: 
1.112     bowersj2 1907: =item * authform_kerberos
1.35      matthew  1908: 
1.112     bowersj2 1909: =item * authform_internal
1.35      matthew  1910: 
1.112     bowersj2 1911: =item * authform_filesystem
1.35      matthew  1912: 
                   1913: =back
                   1914: 
1.648     raeburn  1915: See loncreateuser.pm for invocation and use examples.
1.157     matthew  1916: 
1.35      matthew  1917: =cut
                   1918: 
                   1919: #-------------------------------------------
1.32      matthew  1920: sub authform_header{  
                   1921:     my %in = (
                   1922:         formname => 'cu',
1.80      albertel 1923:         kerb_def_dom => '',
1.32      matthew  1924:         @_,
                   1925:     );
                   1926:     $in{'formname'} = 'document.' . $in{'formname'};
                   1927:     my $result='';
1.80      albertel 1928: 
                   1929: #---------------------------------------------- Code for upper case translation
                   1930:     my $Javascript_toUpperCase;
                   1931:     unless ($in{kerb_def_dom}) {
                   1932:         $Javascript_toUpperCase =<<"END";
                   1933:         switch (choice) {
                   1934:            case 'krb': currentform.elements[choicearg].value =
                   1935:                currentform.elements[choicearg].value.toUpperCase();
                   1936:                break;
                   1937:            default:
                   1938:         }
                   1939: END
                   1940:     } else {
                   1941:         $Javascript_toUpperCase = "";
                   1942:     }
                   1943: 
1.165     raeburn  1944:     my $radioval = "'nochange'";
1.591     raeburn  1945:     if (defined($in{'curr_authtype'})) {
                   1946:         if ($in{'curr_authtype'} ne '') {
                   1947:             $radioval = "'".$in{'curr_authtype'}."arg'";
                   1948:         }
1.174     matthew  1949:     }
1.165     raeburn  1950:     my $argfield = 'null';
1.591     raeburn  1951:     if (defined($in{'mode'})) {
1.165     raeburn  1952:         if ($in{'mode'} eq 'modifycourse')  {
1.591     raeburn  1953:             if (defined($in{'curr_autharg'})) {
                   1954:                 if ($in{'curr_autharg'} ne '') {
1.165     raeburn  1955:                     $argfield = "'$in{'curr_autharg'}'";
                   1956:                 }
                   1957:             }
                   1958:         }
                   1959:     }
                   1960: 
1.32      matthew  1961:     $result.=<<"END";
                   1962: var current = new Object();
1.165     raeburn  1963: current.radiovalue = $radioval;
                   1964: current.argfield = $argfield;
1.32      matthew  1965: 
                   1966: function changed_radio(choice,currentform) {
                   1967:     var choicearg = choice + 'arg';
                   1968:     // If a radio button in changed, we need to change the argfield
                   1969:     if (current.radiovalue != choice) {
                   1970:         current.radiovalue = choice;
                   1971:         if (current.argfield != null) {
                   1972:             currentform.elements[current.argfield].value = '';
                   1973:         }
                   1974:         if (choice == 'nochange') {
                   1975:             current.argfield = null;
                   1976:         } else {
                   1977:             current.argfield = choicearg;
                   1978:             switch(choice) {
                   1979:                 case 'krb': 
                   1980:                     currentform.elements[current.argfield].value = 
                   1981:                         "$in{'kerb_def_dom'}";
                   1982:                 break;
                   1983:               default:
                   1984:                 break;
                   1985:             }
                   1986:         }
                   1987:     }
                   1988:     return;
                   1989: }
1.22      www      1990: 
1.32      matthew  1991: function changed_text(choice,currentform) {
                   1992:     var choicearg = choice + 'arg';
                   1993:     if (currentform.elements[choicearg].value !='') {
1.80      albertel 1994:         $Javascript_toUpperCase
1.32      matthew  1995:         // clear old field
                   1996:         if ((current.argfield != choicearg) && (current.argfield != null)) {
                   1997:             currentform.elements[current.argfield].value = '';
                   1998:         }
                   1999:         current.argfield = choicearg;
                   2000:     }
                   2001:     set_auth_radio_buttons(choice,currentform);
                   2002:     return;
1.20      www      2003: }
1.32      matthew  2004: 
                   2005: function set_auth_radio_buttons(newvalue,currentform) {
                   2006:     var i=0;
                   2007:     while (i < currentform.login.length) {
                   2008:         if (currentform.login[i].value == newvalue) { break; }
                   2009:         i++;
                   2010:     }
                   2011:     if (i == currentform.login.length) {
                   2012:         return;
                   2013:     }
                   2014:     current.radiovalue = newvalue;
                   2015:     currentform.login[i].checked = true;
                   2016:     return;
                   2017: }
                   2018: END
                   2019:     return $result;
                   2020: }
                   2021: 
                   2022: sub authform_authorwarning{
                   2023:     my $result='';
1.144     matthew  2024:     $result='<i>'.
                   2025:         &mt('As a general rule, only authors or co-authors should be '.
                   2026:             'filesystem authenticated '.
                   2027:             '(which allows access to the server filesystem).')."</i>\n";
1.32      matthew  2028:     return $result;
                   2029: }
                   2030: 
                   2031: sub authform_nochange{  
                   2032:     my %in = (
                   2033:               formname => 'document.cu',
                   2034:               kerb_def_dom => 'MSU.EDU',
                   2035:               @_,
                   2036:           );
1.586     raeburn  2037:     my ($authnum,%can_assign) =  &get_assignable_auth($in{'domain'}); 
                   2038:     my $result;
                   2039:     if (keys(%can_assign) == 0) {
                   2040:         $result = &mt('Under you current role you are not permitted to change login settings for this user');  
                   2041:     } else {
                   2042:         $result = '<label>'.&mt('[_1] Do not change login data',
                   2043:                   '<input type="radio" name="login" value="nochange" '.
                   2044:                   'checked="checked" onclick="'.
1.281     albertel 2045:             "javascript:changed_radio('nochange',$in{'formname'});".'" />').
                   2046: 	    '</label>';
1.586     raeburn  2047:     }
1.32      matthew  2048:     return $result;
                   2049: }
                   2050: 
1.591     raeburn  2051: sub authform_kerberos {
1.32      matthew  2052:     my %in = (
                   2053:               formname => 'document.cu',
                   2054:               kerb_def_dom => 'MSU.EDU',
1.80      albertel 2055:               kerb_def_auth => 'krb4',
1.32      matthew  2056:               @_,
                   2057:               );
1.586     raeburn  2058:     my ($check4,$check5,$krbcheck,$krbarg,$krbver,$result,$authtype,
                   2059:         $autharg,$jscall);
                   2060:     my ($authnum,%can_assign) =  &get_assignable_auth($in{'domain'});
1.80      albertel 2061:     if ($in{'kerb_def_auth'} eq 'krb5') {
1.586     raeburn  2062:        $check5 = ' checked="on"';
1.80      albertel 2063:     } else {
1.586     raeburn  2064:        $check4 = ' checked="on"';
1.80      albertel 2065:     }
1.165     raeburn  2066:     $krbarg = $in{'kerb_def_dom'};
1.591     raeburn  2067:     if (defined($in{'curr_authtype'})) {
                   2068:         if ($in{'curr_authtype'} eq 'krb') {
1.586     raeburn  2069:             $krbcheck = ' checked="on"';
1.623     raeburn  2070:             if (defined($in{'mode'})) {
                   2071:                 if ($in{'mode'} eq 'modifyuser') {
                   2072:                     $krbcheck = '';
                   2073:                 }
                   2074:             }
1.591     raeburn  2075:             if (defined($in{'curr_kerb_ver'})) {
                   2076:                 if ($in{'curr_krb_ver'} eq '5') {
                   2077:                     $check5 = ' checked="on"';
                   2078:                     $check4 = '';
                   2079:                 } else {
                   2080:                     $check4 = ' checked="on"';
                   2081:                     $check5 = '';
                   2082:                 }
1.586     raeburn  2083:             }
1.591     raeburn  2084:             if (defined($in{'curr_autharg'})) {
1.165     raeburn  2085:                 $krbarg = $in{'curr_autharg'};
                   2086:             }
1.586     raeburn  2087:             if (!$can_assign{'krb4'} && !$can_assign{'krb5'}) {
1.591     raeburn  2088:                 if (defined($in{'curr_autharg'})) {
1.586     raeburn  2089:                     $result = 
                   2090:     &mt('Currently Kerberos authenticated with domain [_1] Version [_2].',
                   2091:         $in{'curr_autharg'},$krbver);
                   2092:                 } else {
                   2093:                     $result =
                   2094:     &mt('Currently Kerberos authenticated, Version [_1].',$krbver);
                   2095:                 }
                   2096:                 return $result; 
                   2097:             }
                   2098:         }
                   2099:     } else {
                   2100:         if ($authnum == 1) {
                   2101:             $authtype = '<input type="hidden" name="login" value="krb">';
1.165     raeburn  2102:         }
                   2103:     }
1.586     raeburn  2104:     if (!$can_assign{'krb4'} && !$can_assign{'krb5'}) {
                   2105:         return;
1.587     raeburn  2106:     } elsif ($authtype eq '') {
1.591     raeburn  2107:         if (defined($in{'mode'})) {
1.587     raeburn  2108:             if ($in{'mode'} eq 'modifycourse') {
                   2109:                 if ($authnum == 1) {
                   2110:                     $authtype = '<input type="hidden" name="login" value="krb">';
                   2111:                 }
                   2112:             }
                   2113:         }
1.586     raeburn  2114:     }
                   2115:     $jscall = "javascript:changed_radio('krb',$in{'formname'});";
                   2116:     if ($authtype eq '') {
                   2117:         $authtype = '<input type="radio" name="login" value="krb" '.
                   2118:                     'onclick="'.$jscall.'" onchange="'.$jscall.'"'.
                   2119:                     $krbcheck.' />';
                   2120:     }
                   2121:     if (($can_assign{'krb4'} && $can_assign{'krb5'}) ||
                   2122:         ($can_assign{'krb4'} && !$can_assign{'krb5'} && 
                   2123:          $in{'curr_authtype'} eq 'krb5') ||
                   2124:         (!$can_assign{'krb4'} && $can_assign{'krb5'} && 
                   2125:          $in{'curr_authtype'} eq 'krb4')) {
                   2126:         $result .= &mt
1.144     matthew  2127:         ('[_1] Kerberos authenticated with domain [_2] '.
1.281     albertel 2128:          '[_3] Version 4 [_4] Version 5 [_5]',
1.586     raeburn  2129:          '<label>'.$authtype,
1.281     albertel 2130:          '</label><input type="text" size="10" name="krbarg" '.
1.165     raeburn  2131:              'value="'.$krbarg.'" '.
1.144     matthew  2132:              'onchange="'.$jscall.'" />',
1.281     albertel 2133:          '<label><input type="radio" name="krbver" value="4" '.$check4.' />',
                   2134:          '</label><label><input type="radio" name="krbver" value="5" '.$check5.' />',
                   2135: 	 '</label>');
1.586     raeburn  2136:     } elsif ($can_assign{'krb4'}) {
                   2137:         $result .= &mt
                   2138:         ('[_1] Kerberos authenticated with domain [_2] '.
                   2139:          '[_3] Version 4 [_4]',
                   2140:          '<label>'.$authtype,
                   2141:          '</label><input type="text" size="10" name="krbarg" '.
                   2142:              'value="'.$krbarg.'" '.
                   2143:              'onchange="'.$jscall.'" />',
                   2144:          '<label><input type="hidden" name="krbver" value="4" />',
                   2145:          '</label>');
                   2146:     } elsif ($can_assign{'krb5'}) {
                   2147:         $result .= &mt
                   2148:         ('[_1] Kerberos authenticated with domain [_2] '.
                   2149:          '[_3] Version 5 [_4]',
                   2150:          '<label>'.$authtype,
                   2151:          '</label><input type="text" size="10" name="krbarg" '.
                   2152:              'value="'.$krbarg.'" '.
                   2153:              'onchange="'.$jscall.'" />',
                   2154:          '<label><input type="hidden" name="krbver" value="5" />',
                   2155:          '</label>');
                   2156:     }
1.32      matthew  2157:     return $result;
                   2158: }
                   2159: 
                   2160: sub authform_internal{  
1.586     raeburn  2161:     my %in = (
1.32      matthew  2162:                 formname => 'document.cu',
                   2163:                 kerb_def_dom => 'MSU.EDU',
                   2164:                 @_,
                   2165:                 );
1.586     raeburn  2166:     my ($intcheck,$intarg,$result,$authtype,$autharg,$jscall);
                   2167:     my ($authnum,%can_assign) =  &get_assignable_auth($in{'domain'});
1.591     raeburn  2168:     if (defined($in{'curr_authtype'})) {
                   2169:         if ($in{'curr_authtype'} eq 'int') {
1.586     raeburn  2170:             if ($can_assign{'int'}) {
                   2171:                 $intcheck = 'checked="on" ';
1.623     raeburn  2172:                 if (defined($in{'mode'})) {
                   2173:                     if ($in{'mode'} eq 'modifyuser') {
                   2174:                         $intcheck = '';
                   2175:                     }
                   2176:                 }
1.591     raeburn  2177:                 if (defined($in{'curr_autharg'})) {
1.586     raeburn  2178:                     $intarg = $in{'curr_autharg'};
                   2179:                 }
                   2180:             } else {
                   2181:                 $result = &mt('Currently internally authenticated.');
                   2182:                 return $result;
1.165     raeburn  2183:             }
                   2184:         }
1.586     raeburn  2185:     } else {
                   2186:         if ($authnum == 1) {
                   2187:             $authtype = '<input type="hidden" name="login" value="int">';
                   2188:         }
                   2189:     }
                   2190:     if (!$can_assign{'int'}) {
                   2191:         return;
1.587     raeburn  2192:     } elsif ($authtype eq '') {
1.591     raeburn  2193:         if (defined($in{'mode'})) {
1.587     raeburn  2194:             if ($in{'mode'} eq 'modifycourse') {
                   2195:                 if ($authnum == 1) {
                   2196:                     $authtype = '<input type="hidden" name="login" value="int">';
                   2197:                 }
                   2198:             }
                   2199:         }
1.165     raeburn  2200:     }
1.586     raeburn  2201:     $jscall = "javascript:changed_radio('int',$in{'formname'});";
                   2202:     if ($authtype eq '') {
                   2203:         $authtype = '<input type="radio" name="login" value="int" '.$intcheck.
                   2204:                     ' onchange="'.$jscall.'" onclick="'.$jscall.'" />';
                   2205:     }
1.605     bisitz   2206:     $autharg = '<input type="password" size="10" name="intarg" value="'.
1.586     raeburn  2207:                $intarg.'" onchange="'.$jscall.'" />';
                   2208:     $result = &mt
1.144     matthew  2209:         ('[_1] Internally authenticated (with initial password [_2])',
1.586     raeburn  2210:          '<label>'.$authtype,'</label>'.$autharg);
1.620     www      2211:     $result.="<label><input type=\"checkbox\" name=\"visible\" onClick='if (this.checked) { this.form.intarg.type=\"text\" } else { this.form.intarg.type=\"password\" }' />".&mt('Visible input').'</label>';
1.32      matthew  2212:     return $result;
                   2213: }
                   2214: 
                   2215: sub authform_local{  
                   2216:     my %in = (
                   2217:               formname => 'document.cu',
                   2218:               kerb_def_dom => 'MSU.EDU',
                   2219:               @_,
                   2220:               );
1.586     raeburn  2221:     my ($loccheck,$locarg,$result,$authtype,$autharg,$jscall);
                   2222:     my ($authnum,%can_assign) =  &get_assignable_auth($in{'domain'});
1.591     raeburn  2223:     if (defined($in{'curr_authtype'})) {
                   2224:         if ($in{'curr_authtype'} eq 'loc') {
1.586     raeburn  2225:             if ($can_assign{'loc'}) {
                   2226:                 $loccheck = 'checked="on" ';
1.623     raeburn  2227:                 if (defined($in{'mode'})) {
                   2228:                     if ($in{'mode'} eq 'modifyuser') {
                   2229:                         $loccheck = '';
                   2230:                     }
                   2231:                 }
1.591     raeburn  2232:                 if (defined($in{'curr_autharg'})) {
1.586     raeburn  2233:                     $locarg = $in{'curr_autharg'};
                   2234:                 }
                   2235:             } else {
                   2236:                 $result = &mt('Currently using local (institutional) authentication.');
                   2237:                 return $result;
1.165     raeburn  2238:             }
                   2239:         }
1.586     raeburn  2240:     } else {
                   2241:         if ($authnum == 1) {
                   2242:             $authtype = '<input type="hidden" name="login" value="loc">';
                   2243:         }
                   2244:     }
                   2245:     if (!$can_assign{'loc'}) {
                   2246:         return;
1.587     raeburn  2247:     } elsif ($authtype eq '') {
1.591     raeburn  2248:         if (defined($in{'mode'})) {
1.587     raeburn  2249:             if ($in{'mode'} eq 'modifycourse') {
                   2250:                 if ($authnum == 1) {
                   2251:                     $authtype = '<input type="hidden" name="login" value="loc">';
                   2252:                 }
                   2253:             }
                   2254:         }
1.165     raeburn  2255:     }
1.586     raeburn  2256:     $jscall = "javascript:changed_radio('loc',$in{'formname'});";
                   2257:     if ($authtype eq '') {
                   2258:         $authtype = '<input type="radio" name="login" value="loc" '.
                   2259:                     $loccheck.' onchange="'.$jscall.'" onclick="'.
                   2260:                     $jscall.'" />';
                   2261:     }
                   2262:     $autharg = '<input type="text" size="10" name="locarg" value="'.
                   2263:                $locarg.'" onchange="'.$jscall.'" />';
                   2264:     $result = &mt('[_1] Local Authentication with argument [_2]',
                   2265:                   '<label>'.$authtype,'</label>'.$autharg);
1.32      matthew  2266:     return $result;
                   2267: }
                   2268: 
                   2269: sub authform_filesystem{  
                   2270:     my %in = (
                   2271:               formname => 'document.cu',
                   2272:               kerb_def_dom => 'MSU.EDU',
                   2273:               @_,
                   2274:               );
1.586     raeburn  2275:     my ($fsyscheck,$result,$authtype,$autharg,$jscall);
                   2276:     my ($authnum,%can_assign) =  &get_assignable_auth($in{'domain'});
1.591     raeburn  2277:     if (defined($in{'curr_authtype'})) {
                   2278:         if ($in{'curr_authtype'} eq 'fsys') {
1.586     raeburn  2279:             if ($can_assign{'fsys'}) {
                   2280:                 $fsyscheck = 'checked="on" ';
1.623     raeburn  2281:                 if (defined($in{'mode'})) {
                   2282:                     if ($in{'mode'} eq 'modifyuser') {
                   2283:                         $fsyscheck = '';
                   2284:                     }
                   2285:                 }
1.586     raeburn  2286:             } else {
                   2287:                 $result = &mt('Currently Filesystem Authenticated.');
                   2288:                 return $result;
                   2289:             }           
                   2290:         }
                   2291:     } else {
                   2292:         if ($authnum == 1) {
                   2293:             $authtype = '<input type="hidden" name="login" value="fsys">';
                   2294:         }
                   2295:     }
                   2296:     if (!$can_assign{'fsys'}) {
                   2297:         return;
1.587     raeburn  2298:     } elsif ($authtype eq '') {
1.591     raeburn  2299:         if (defined($in{'mode'})) {
1.587     raeburn  2300:             if ($in{'mode'} eq 'modifycourse') {
                   2301:                 if ($authnum == 1) {
                   2302:                     $authtype = '<input type="hidden" name="login" value="fsys">';
                   2303:                 }
                   2304:             }
                   2305:         }
1.586     raeburn  2306:     }
                   2307:     $jscall = "javascript:changed_radio('fsys',$in{'formname'});";
                   2308:     if ($authtype eq '') {
                   2309:         $authtype = '<input type="radio" name="login" value="fsys" '.
                   2310:                     $fsyscheck.' onchange="'.$jscall.'" onclick="'.
                   2311:                     $jscall.'" />';
                   2312:     }
                   2313:     $autharg = '<input type="text" size="10" name="fsysarg" value=""'.
                   2314:                ' onchange="'.$jscall.'" />';
                   2315:     $result = &mt
1.144     matthew  2316:         ('[_1] Filesystem Authenticated (with initial password [_2])',
1.281     albertel 2317:          '<label><input type="radio" name="login" value="fsys" '.
1.586     raeburn  2318:          $fsyscheck.'onchange="'.$jscall.'" onclick="'.$jscall.'" />',
1.605     bisitz   2319:          '</label><input type="password" size="10" name="fsysarg" value="" '.
1.144     matthew  2320:                   'onchange="'.$jscall.'" />');
1.32      matthew  2321:     return $result;
                   2322: }
                   2323: 
1.586     raeburn  2324: sub get_assignable_auth {
                   2325:     my ($dom) = @_;
                   2326:     if ($dom eq '') {
                   2327:         $dom = $env{'request.role.domain'};
                   2328:     }
                   2329:     my %can_assign = (
                   2330:                           krb4 => 1,
                   2331:                           krb5 => 1,
                   2332:                           int  => 1,
                   2333:                           loc  => 1,
                   2334:                      );
                   2335:     my %domconfig = &Apache::lonnet::get_dom('configuration',['usercreation'],$dom);
                   2336:     if (ref($domconfig{'usercreation'}) eq 'HASH') {
                   2337:         if (ref($domconfig{'usercreation'}{'authtypes'}) eq 'HASH') {
                   2338:             my $authhash = $domconfig{'usercreation'}{'authtypes'};
                   2339:             my $context;
                   2340:             if ($env{'request.role'} =~ /^au/) {
                   2341:                 $context = 'author';
                   2342:             } elsif ($env{'request.role'} =~ /^dc/) {
                   2343:                 $context = 'domain';
                   2344:             } elsif ($env{'request.course.id'}) {
                   2345:                 $context = 'course';
                   2346:             }
                   2347:             if ($context) {
                   2348:                 if (ref($authhash->{$context}) eq 'HASH') {
                   2349:                    %can_assign = %{$authhash->{$context}}; 
                   2350:                 }
                   2351:             }
                   2352:         }
                   2353:     }
                   2354:     my $authnum = 0;
                   2355:     foreach my $key (keys(%can_assign)) {
                   2356:         if ($can_assign{$key}) {
                   2357:             $authnum ++;
                   2358:         }
                   2359:     }
                   2360:     if ($can_assign{'krb4'} && $can_assign{'krb5'}) {
                   2361:         $authnum --;
                   2362:     }
                   2363:     return ($authnum,%can_assign);
                   2364: }
                   2365: 
1.80      albertel 2366: ###############################################################
                   2367: ##    Get Kerberos Defaults for Domain                 ##
                   2368: ###############################################################
                   2369: ##
                   2370: ## Returns default kerberos version and an associated argument
                   2371: ## as listed in file domain.tab. If not listed, provides
                   2372: ## appropriate default domain and kerberos version.
                   2373: ##
                   2374: #-------------------------------------------
                   2375: 
                   2376: =pod
                   2377: 
1.648     raeburn  2378: =item * &get_kerberos_defaults()
1.80      albertel 2379: 
                   2380: get_kerberos_defaults($target_domain) returns the default kerberos
1.641     raeburn  2381: version and domain. If not found, it defaults to version 4 and the 
                   2382: domain of the server.
1.80      albertel 2383: 
1.648     raeburn  2384: =over 4
                   2385: 
1.80      albertel 2386: ($def_version, $def_krb_domain) = &get_kerberos_defaults($target_domain);
                   2387: 
1.648     raeburn  2388: =back
                   2389: 
                   2390: =back
                   2391: 
1.80      albertel 2392: =cut
                   2393: 
                   2394: #-------------------------------------------
                   2395: sub get_kerberos_defaults {
                   2396:     my $domain=shift;
1.641     raeburn  2397:     my ($krbdef,$krbdefdom);
                   2398:     my %domdefaults = &Apache::lonnet::get_domain_defaults($domain);
                   2399:     if (($domdefaults{'auth_def'} =~/^krb(4|5)$/) && ($domdefaults{'auth_arg_def'} ne '')) {
                   2400:         $krbdef = $domdefaults{'auth_def'};
                   2401:         $krbdefdom = $domdefaults{'auth_arg_def'};
                   2402:     } else {
1.80      albertel 2403:         $ENV{'SERVER_NAME'}=~/(\w+\.\w+)$/;
                   2404:         my $krbdefdom=$1;
                   2405:         $krbdefdom=~tr/a-z/A-Z/;
                   2406:         $krbdef = "krb4";
                   2407:     }
                   2408:     return ($krbdef,$krbdefdom);
                   2409: }
1.112     bowersj2 2410: 
1.32      matthew  2411: 
1.46      matthew  2412: ###############################################################
                   2413: ##                Thesaurus Functions                        ##
                   2414: ###############################################################
1.20      www      2415: 
1.46      matthew  2416: =pod
1.20      www      2417: 
1.112     bowersj2 2418: =head1 Thesaurus Functions
                   2419: 
                   2420: =over 4
                   2421: 
1.648     raeburn  2422: =item * &initialize_keywords()
1.46      matthew  2423: 
                   2424: Initializes the package variable %Keywords if it is empty.  Uses the
                   2425: package variable $thesaurus_db_file.
                   2426: 
                   2427: =cut
                   2428: 
                   2429: ###################################################
                   2430: 
                   2431: sub initialize_keywords {
                   2432:     return 1 if (scalar keys(%Keywords));
                   2433:     # If we are here, %Keywords is empty, so fill it up
                   2434:     #   Make sure the file we need exists...
                   2435:     if (! -e $thesaurus_db_file) {
                   2436:         &Apache::lonnet::logthis("Attempt to access $thesaurus_db_file".
                   2437:                                  " failed because it does not exist");
                   2438:         return 0;
                   2439:     }
                   2440:     #   Set up the hash as a database
                   2441:     my %thesaurus_db;
                   2442:     if (! tie(%thesaurus_db,'GDBM_File',
1.53      albertel 2443:               $thesaurus_db_file,&GDBM_READER(),0640)){
1.46      matthew  2444:         &Apache::lonnet::logthis("Could not tie \%thesaurus_db to ".
                   2445:                                  $thesaurus_db_file);
                   2446:         return 0;
                   2447:     } 
                   2448:     #  Get the average number of appearances of a word.
                   2449:     my $avecount = $thesaurus_db{'average.count'};
                   2450:     #  Put keywords (those that appear > average) into %Keywords
                   2451:     while (my ($word,$data)=each (%thesaurus_db)) {
                   2452:         my ($count,undef) = split /:/,$data;
                   2453:         $Keywords{$word}++ if ($count > $avecount);
                   2454:     }
                   2455:     untie %thesaurus_db;
                   2456:     # Remove special values from %Keywords.
1.356     albertel 2457:     foreach my $value ('total.count','average.count') {
                   2458:         delete($Keywords{$value}) if (exists($Keywords{$value}));
1.586     raeburn  2459:   }
1.46      matthew  2460:     return 1;
                   2461: }
                   2462: 
                   2463: ###################################################
                   2464: 
                   2465: =pod
                   2466: 
1.648     raeburn  2467: =item * &keyword($word)
1.46      matthew  2468: 
                   2469: Returns true if $word is a keyword.  A keyword is a word that appears more 
                   2470: than the average number of times in the thesaurus database.  Calls 
                   2471: &initialize_keywords
                   2472: 
                   2473: =cut
                   2474: 
                   2475: ###################################################
1.20      www      2476: 
                   2477: sub keyword {
1.46      matthew  2478:     return if (!&initialize_keywords());
                   2479:     my $word=lc(shift());
                   2480:     $word=~s/\W//g;
                   2481:     return exists($Keywords{$word});
1.20      www      2482: }
1.46      matthew  2483: 
                   2484: ###############################################################
                   2485: 
                   2486: =pod 
1.20      www      2487: 
1.648     raeburn  2488: =item * &get_related_words()
1.46      matthew  2489: 
1.160     matthew  2490: Look up a word in the thesaurus.  Takes a scalar argument and returns
1.46      matthew  2491: an array of words.  If the keyword is not in the thesaurus, an empty array
                   2492: will be returned.  The order of the words returned is determined by the
                   2493: database which holds them.
                   2494: 
                   2495: Uses global $thesaurus_db_file.
                   2496: 
                   2497: =cut
                   2498: 
                   2499: ###############################################################
                   2500: sub get_related_words {
                   2501:     my $keyword = shift;
                   2502:     my %thesaurus_db;
                   2503:     if (! -e $thesaurus_db_file) {
                   2504:         &Apache::lonnet::logthis("Attempt to access $thesaurus_db_file ".
                   2505:                                  "failed because the file does not exist");
                   2506:         return ();
                   2507:     }
                   2508:     if (! tie(%thesaurus_db,'GDBM_File',
1.53      albertel 2509:               $thesaurus_db_file,&GDBM_READER(),0640)){
1.46      matthew  2510:         return ();
                   2511:     } 
                   2512:     my @Words=();
1.429     www      2513:     my $count=0;
1.46      matthew  2514:     if (exists($thesaurus_db{$keyword})) {
1.356     albertel 2515: 	# The first element is the number of times
                   2516: 	# the word appears.  We do not need it now.
1.429     www      2517: 	my (undef,@RelatedWords) = (split(/:/,$thesaurus_db{$keyword}));
                   2518: 	my (undef,$mostfrequentcount)=split(/\,/,$RelatedWords[0]);
                   2519: 	my $threshold=$mostfrequentcount/10;
                   2520:         foreach my $possibleword (@RelatedWords) {
                   2521:             my ($word,$wordcount)=split(/\,/,$possibleword);
                   2522:             if ($wordcount>$threshold) {
                   2523: 		push(@Words,$word);
                   2524:                 $count++;
                   2525:                 if ($count>10) { last; }
                   2526: 	    }
1.20      www      2527:         }
                   2528:     }
1.46      matthew  2529:     untie %thesaurus_db;
                   2530:     return @Words;
1.14      harris41 2531: }
1.46      matthew  2532: 
1.112     bowersj2 2533: =pod
                   2534: 
                   2535: =back
                   2536: 
                   2537: =cut
1.61      www      2538: 
                   2539: # -------------------------------------------------------------- Plaintext name
1.81      albertel 2540: =pod
                   2541: 
1.112     bowersj2 2542: =head1 User Name Functions
                   2543: 
                   2544: =over 4
                   2545: 
1.648     raeburn  2546: =item * &plainname($uname,$udom,$first)
1.81      albertel 2547: 
1.112     bowersj2 2548: Takes a users logon name and returns it as a string in
1.226     albertel 2549: "first middle last generation" form 
                   2550: if $first is set to 'lastname' then it returns it as
                   2551: 'lastname generation, firstname middlename' if their is a lastname
1.81      albertel 2552: 
                   2553: =cut
1.61      www      2554: 
1.295     www      2555: 
1.81      albertel 2556: ###############################################################
1.61      www      2557: sub plainname {
1.226     albertel 2558:     my ($uname,$udom,$first)=@_;
1.537     albertel 2559:     return if (!defined($uname) || !defined($udom));
1.295     www      2560:     my %names=&getnames($uname,$udom);
1.226     albertel 2561:     my $name=&Apache::lonnet::format_name($names{'firstname'},
                   2562: 					  $names{'middlename'},
                   2563: 					  $names{'lastname'},
                   2564: 					  $names{'generation'},$first);
                   2565:     $name=~s/^\s+//;
1.62      www      2566:     $name=~s/\s+$//;
                   2567:     $name=~s/\s+/ /g;
1.353     albertel 2568:     if ($name !~ /\S/) { $name=$uname.':'.$udom; }
1.62      www      2569:     return $name;
1.61      www      2570: }
1.66      www      2571: 
                   2572: # -------------------------------------------------------------------- Nickname
1.81      albertel 2573: =pod
                   2574: 
1.648     raeburn  2575: =item * &nickname($uname,$udom)
1.81      albertel 2576: 
                   2577: Gets a users name and returns it as a string as
                   2578: 
                   2579: "&quot;nickname&quot;"
1.66      www      2580: 
1.81      albertel 2581: if the user has a nickname or
                   2582: 
                   2583: "first middle last generation"
                   2584: 
                   2585: if the user does not
                   2586: 
                   2587: =cut
1.66      www      2588: 
                   2589: sub nickname {
                   2590:     my ($uname,$udom)=@_;
1.537     albertel 2591:     return if (!defined($uname) || !defined($udom));
1.295     www      2592:     my %names=&getnames($uname,$udom);
1.68      albertel 2593:     my $name=$names{'nickname'};
1.66      www      2594:     if ($name) {
                   2595:        $name='&quot;'.$name.'&quot;'; 
                   2596:     } else {
                   2597:        $name=$names{'firstname'}.' '.$names{'middlename'}.' '.
                   2598: 	     $names{'lastname'}.' '.$names{'generation'};
                   2599:        $name=~s/\s+$//;
                   2600:        $name=~s/\s+/ /g;
                   2601:     }
                   2602:     return $name;
                   2603: }
                   2604: 
1.295     www      2605: sub getnames {
                   2606:     my ($uname,$udom)=@_;
1.537     albertel 2607:     return if (!defined($uname) || !defined($udom));
1.433     albertel 2608:     if ($udom eq 'public' && $uname eq 'public') {
                   2609: 	return ('lastname' => &mt('Public'));
                   2610:     }
1.295     www      2611:     my $id=$uname.':'.$udom;
                   2612:     my ($names,$cached)=&Apache::lonnet::is_cached_new('namescache',$id);
                   2613:     if ($cached) {
                   2614: 	return %{$names};
                   2615:     } else {
                   2616: 	my %loadnames=&Apache::lonnet::get('environment',
                   2617:                     ['firstname','middlename','lastname','generation','nickname'],
                   2618: 					 $udom,$uname);
                   2619: 	&Apache::lonnet::do_cache_new('namescache',$id,\%loadnames);
                   2620: 	return %loadnames;
                   2621:     }
                   2622: }
1.61      www      2623: 
1.542     raeburn  2624: # -------------------------------------------------------------------- getemails
1.648     raeburn  2625: 
1.542     raeburn  2626: =pod
                   2627: 
1.648     raeburn  2628: =item * &getemails($uname,$udom)
1.542     raeburn  2629: 
                   2630: Gets a user's email information and returns it as a hash with keys:
                   2631: notification, critnotification, permanentemail
                   2632: 
                   2633: For notification and critnotification, values are comma-separated lists 
1.648     raeburn  2634: of e-mail addresses; for permanentemail, value is a single e-mail address.
1.542     raeburn  2635:  
1.648     raeburn  2636: 
1.542     raeburn  2637: =cut
                   2638: 
1.648     raeburn  2639: 
1.466     albertel 2640: sub getemails {
                   2641:     my ($uname,$udom)=@_;
                   2642:     if ($udom eq 'public' && $uname eq 'public') {
                   2643: 	return;
                   2644:     }
1.467     www      2645:     if (!$udom) { $udom=$env{'user.domain'}; }
                   2646:     if (!$uname) { $uname=$env{'user.name'}; }
1.466     albertel 2647:     my $id=$uname.':'.$udom;
                   2648:     my ($names,$cached)=&Apache::lonnet::is_cached_new('emailscache',$id);
                   2649:     if ($cached) {
                   2650: 	return %{$names};
                   2651:     } else {
                   2652: 	my %loadnames=&Apache::lonnet::get('environment',
                   2653:                     			   ['notification','critnotification',
                   2654: 					    'permanentemail'],
                   2655: 					   $udom,$uname);
                   2656: 	&Apache::lonnet::do_cache_new('emailscache',$id,\%loadnames);
                   2657: 	return %loadnames;
                   2658:     }
                   2659: }
                   2660: 
1.551     albertel 2661: sub flush_email_cache {
                   2662:     my ($uname,$udom)=@_;
                   2663:     if (!$udom)  { $udom =$env{'user.domain'}; }
                   2664:     if (!$uname) { $uname=$env{'user.name'};   }
                   2665:     return if ($udom eq 'public' && $uname eq 'public');
                   2666:     my $id=$uname.':'.$udom;
                   2667:     &Apache::lonnet::devalidate_cache_new('emailscache',$id);
                   2668: }
                   2669: 
1.61      www      2670: # ------------------------------------------------------------------ Screenname
1.81      albertel 2671: 
                   2672: =pod
                   2673: 
1.648     raeburn  2674: =item * &screenname($uname,$udom)
1.81      albertel 2675: 
                   2676: Gets a users screenname and returns it as a string
                   2677: 
                   2678: =cut
1.61      www      2679: 
                   2680: sub screenname {
                   2681:     my ($uname,$udom)=@_;
1.258     albertel 2682:     if ($uname eq $env{'user.name'} &&
                   2683: 	$udom eq $env{'user.domain'}) {return $env{'environment.screenname'};}
1.212     albertel 2684:     my %names=&Apache::lonnet::get('environment',['screenname'],$udom,$uname);
1.68      albertel 2685:     return $names{'screenname'};
1.62      www      2686: }
                   2687: 
1.212     albertel 2688: 
1.62      www      2689: # ------------------------------------------------------------- Message Wrapper
                   2690: 
                   2691: sub messagewrapper {
1.369     www      2692:     my ($link,$username,$domain,$subject,$text)=@_;
1.62      www      2693:     return 
1.441     albertel 2694:         '<a href="/adm/email?compose=individual&amp;'.
                   2695:         'recname='.$username.'&amp;recdom='.$domain.
                   2696: 	'&amp;subject='.&escape($subject).'&amp;text='.&escape($text).'" '.
1.200     matthew  2697:         'title="'.&mt('Send message').'">'.$link.'</a>';
1.74      www      2698: }
                   2699: # --------------------------------------------------------------- Notes Wrapper
                   2700: 
                   2701: sub noteswrapper {
                   2702:     my ($link,$un,$do)=@_;
                   2703:     return 
                   2704: "<a href='/adm/email?recordftf=retrieve&recname=$un&recdom=$do'>$link</a>";
1.62      www      2705: }
                   2706: # ------------------------------------------------------------- Aboutme Wrapper
                   2707: 
                   2708: sub aboutmewrapper {
1.166     www      2709:     my ($link,$username,$domain,$target)=@_;
1.447     raeburn  2710:     if (!defined($username)  && !defined($domain)) {
                   2711:         return;
                   2712:     }
1.205     www      2713:     return '<a href="/adm/'.$domain.'/'.$username.'/aboutme"'.
1.454     banghart 2714: 	($target?' target="$target"':'').' title="'.&mt("View this user's personal page").'">'.$link.'</a>';
1.62      www      2715: }
                   2716: 
                   2717: # ------------------------------------------------------------ Syllabus Wrapper
                   2718: 
                   2719: 
                   2720: sub syllabuswrapper {
1.109     matthew  2721:     my ($linktext,$coursedir,$domain,$fontcolor)=@_;
                   2722:     if ($fontcolor) { 
                   2723:         $linktext='<font color="'.$fontcolor.'">'.$linktext.'</font>'; 
                   2724:     }
1.208     matthew  2725:     return qq{<a href="/public/$domain/$coursedir/syllabus">$linktext</a>};
1.61      www      2726: }
1.14      harris41 2727: 
1.208     matthew  2728: sub track_student_link {
1.268     albertel 2729:     my ($linktext,$sname,$sdom,$target,$start) = @_;
                   2730:     my $link ="/adm/trackstudent?";
1.208     matthew  2731:     my $title = 'View recent activity';
                   2732:     if (defined($sname) && $sname !~ /^\s*$/ &&
                   2733:         defined($sdom)  && $sdom  !~ /^\s*$/) {
1.268     albertel 2734:         $link .= "selected_student=$sname:$sdom";
1.208     matthew  2735:         $title .= ' of this student';
1.268     albertel 2736:     } 
1.208     matthew  2737:     if (defined($target) && $target !~ /^\s*$/) {
                   2738:         $target = qq{target="$target"};
                   2739:     } else {
                   2740:         $target = '';
                   2741:     }
1.268     albertel 2742:     if ($start) { $link.='&amp;start='.$start; }
1.554     albertel 2743:     $title = &mt($title);
                   2744:     $linktext = &mt($linktext);
1.448     albertel 2745:     return qq{<a href="$link" title="$title" $target>$linktext</a>}.
                   2746: 	&help_open_topic('View_recent_activity');
1.208     matthew  2747: }
                   2748: 
1.508     www      2749: # ===================================================== Display a student photo
                   2750: 
                   2751: 
1.509     albertel 2752: sub student_image_tag {
1.508     www      2753:     my ($domain,$user)=@_;
                   2754:     my $imgsrc=&Apache::lonnet::studentphoto($domain,$user,'jpg');
                   2755:     if (($imgsrc) && ($imgsrc ne '/adm/lonKaputt/lonlogo_broken.gif')) {
                   2756: 	return '<img src="'.$imgsrc.'" align="right" />';
                   2757:     } else {
                   2758: 	return '';
                   2759:     }
                   2760: }
                   2761: 
1.112     bowersj2 2762: =pod
                   2763: 
                   2764: =back
                   2765: 
                   2766: =head1 Access .tab File Data
                   2767: 
                   2768: =over 4
                   2769: 
1.648     raeburn  2770: =item * &languageids() 
1.112     bowersj2 2771: 
                   2772: returns list of all language ids
                   2773: 
                   2774: =cut
                   2775: 
1.14      harris41 2776: sub languageids {
1.16      harris41 2777:     return sort(keys(%language));
1.14      harris41 2778: }
                   2779: 
1.112     bowersj2 2780: =pod
                   2781: 
1.648     raeburn  2782: =item * &languagedescription() 
1.112     bowersj2 2783: 
                   2784: returns description of a specified language id
                   2785: 
                   2786: =cut
                   2787: 
1.14      harris41 2788: sub languagedescription {
1.125     www      2789:     my $code=shift;
                   2790:     return  ($supported_language{$code}?'* ':'').
                   2791:             $language{$code}.
1.126     www      2792: 	    ($supported_language{$code}?' ('.&mt('interface available').')':'');
1.145     www      2793: }
                   2794: 
                   2795: sub plainlanguagedescription {
                   2796:     my $code=shift;
                   2797:     return $language{$code};
                   2798: }
                   2799: 
                   2800: sub supportedlanguagecode {
                   2801:     my $code=shift;
                   2802:     return $supported_language{$code};
1.97      www      2803: }
                   2804: 
1.112     bowersj2 2805: =pod
                   2806: 
1.648     raeburn  2807: =item * &copyrightids() 
1.112     bowersj2 2808: 
                   2809: returns list of all copyrights
                   2810: 
                   2811: =cut
                   2812: 
                   2813: sub copyrightids {
                   2814:     return sort(keys(%cprtag));
                   2815: }
                   2816: 
                   2817: =pod
                   2818: 
1.648     raeburn  2819: =item * &copyrightdescription() 
1.112     bowersj2 2820: 
                   2821: returns description of a specified copyright id
                   2822: 
                   2823: =cut
                   2824: 
                   2825: sub copyrightdescription {
1.166     www      2826:     return &mt($cprtag{shift(@_)});
1.112     bowersj2 2827: }
1.197     matthew  2828: 
                   2829: =pod
                   2830: 
1.648     raeburn  2831: =item * &source_copyrightids() 
1.192     taceyjo1 2832: 
                   2833: returns list of all source copyrights
                   2834: 
                   2835: =cut
                   2836: 
                   2837: sub source_copyrightids {
                   2838:     return sort(keys(%scprtag));
                   2839: }
                   2840: 
                   2841: =pod
                   2842: 
1.648     raeburn  2843: =item * &source_copyrightdescription() 
1.192     taceyjo1 2844: 
                   2845: returns description of a specified source copyright id
                   2846: 
                   2847: =cut
                   2848: 
                   2849: sub source_copyrightdescription {
                   2850:     return &mt($scprtag{shift(@_)});
                   2851: }
1.112     bowersj2 2852: 
                   2853: =pod
                   2854: 
1.648     raeburn  2855: =item * &filecategories() 
1.112     bowersj2 2856: 
                   2857: returns list of all file categories
                   2858: 
                   2859: =cut
                   2860: 
                   2861: sub filecategories {
                   2862:     return sort(keys(%category_extensions));
                   2863: }
                   2864: 
                   2865: =pod
                   2866: 
1.648     raeburn  2867: =item * &filecategorytypes() 
1.112     bowersj2 2868: 
                   2869: returns list of file types belonging to a given file
                   2870: category
                   2871: 
                   2872: =cut
                   2873: 
                   2874: sub filecategorytypes {
1.356     albertel 2875:     my ($cat) = @_;
                   2876:     return @{$category_extensions{lc($cat)}};
1.112     bowersj2 2877: }
                   2878: 
                   2879: =pod
                   2880: 
1.648     raeburn  2881: =item * &fileembstyle() 
1.112     bowersj2 2882: 
                   2883: returns embedding style for a specified file type
                   2884: 
                   2885: =cut
                   2886: 
                   2887: sub fileembstyle {
                   2888:     return $fe{lc(shift(@_))};
1.169     www      2889: }
                   2890: 
1.351     www      2891: sub filemimetype {
                   2892:     return $fm{lc(shift(@_))};
                   2893: }
                   2894: 
1.169     www      2895: 
                   2896: sub filecategoryselect {
                   2897:     my ($name,$value)=@_;
1.189     matthew  2898:     return &select_form($value,$name,
1.169     www      2899: 			'' => &mt('Any category'),
                   2900: 			map { $_,$_ } sort(keys(%category_extensions)));
1.112     bowersj2 2901: }
                   2902: 
                   2903: =pod
                   2904: 
1.648     raeburn  2905: =item * &filedescription() 
1.112     bowersj2 2906: 
                   2907: returns description for a specified file type
                   2908: 
                   2909: =cut
                   2910: 
                   2911: sub filedescription {
1.188     matthew  2912:     my $file_description = $fd{lc(shift())};
                   2913:     $file_description =~ s:([\[\]]):~$1:g;
                   2914:     return &mt($file_description);
1.112     bowersj2 2915: }
                   2916: 
                   2917: =pod
                   2918: 
1.648     raeburn  2919: =item * &filedescriptionex() 
1.112     bowersj2 2920: 
                   2921: returns description for a specified file type with
                   2922: extra formatting
                   2923: 
                   2924: =cut
                   2925: 
                   2926: sub filedescriptionex {
                   2927:     my $ex=shift;
1.188     matthew  2928:     my $file_description = $fd{lc($ex)};
                   2929:     $file_description =~ s:([\[\]]):~$1:g;
                   2930:     return '.'.$ex.' '.&mt($file_description);
1.112     bowersj2 2931: }
                   2932: 
                   2933: # End of .tab access
                   2934: =pod
                   2935: 
                   2936: =back
                   2937: 
                   2938: =cut
                   2939: 
                   2940: # ------------------------------------------------------------------ File Types
                   2941: sub fileextensions {
                   2942:     return sort(keys(%fe));
                   2943: }
                   2944: 
1.97      www      2945: # ----------------------------------------------------------- Display Languages
                   2946: # returns a hash with all desired display languages
                   2947: #
                   2948: 
                   2949: sub display_languages {
                   2950:     my %languages=();
1.356     albertel 2951:     foreach my $lang (&preferred_languages()) {
                   2952: 	$languages{$lang}=1;
1.97      www      2953:     }
                   2954:     &get_unprocessed_cgi($ENV{'QUERY_STRING'},['displaylanguage']);
1.258     albertel 2955:     if ($env{'form.displaylanguage'}) {
1.356     albertel 2956: 	foreach my $lang (split(/\s*(\,|\;|\:)\s*/,$env{'form.displaylanguage'})) {
                   2957: 	    $languages{$lang}=1;
1.97      www      2958:         }
                   2959:     }
                   2960:     return %languages;
1.14      harris41 2961: }
                   2962: 
1.117     www      2963: sub preferred_languages {
                   2964:     my @languages=();
1.654     www      2965:     if (($env{'request.role.adv'}) && ($env{'form.languages'})) {
                   2966:         @languages=(@languages,split(/\s*(\,|\;|\:)\s*/,$env{'form.languages'}));
                   2967:     }
1.258     albertel 2968:     if ($env{'course.'.$env{'request.course.id'}.'.languages'}) {
1.117     www      2969: 	@languages=(@languages,split(/\s*(\,|\;|\:)\s*/,
1.258     albertel 2970: 	         $env{'course.'.$env{'request.course.id'}.'.languages'}));
1.177     www      2971:     }
1.654     www      2972: 
1.258     albertel 2973:     if ($env{'environment.languages'}) {
1.459     albertel 2974: 	@languages=(@languages,
                   2975: 		    split(/\s*(\,|\;|\:)\s*/,$env{'environment.languages'}));
1.118     www      2976:     }
1.583     albertel 2977:     my $browser=$ENV{'HTTP_ACCEPT_LANGUAGE'};
1.162     www      2978:     if ($browser) {
1.583     albertel 2979: 	my @browser = 
                   2980: 	    map { (split(/\s*;\s*/,$_))[0] } (split(/\s*,\s*/,$browser));
                   2981: 	push(@languages,@browser);
1.162     www      2982:     }
1.641     raeburn  2983: 
                   2984:     foreach my $domtype ($env{'user.domain'},$env{'request.role.domain'},
                   2985:                          $Apache::lonnet::perlvar{'lonDefDomain'}) {
                   2986:         if ($domtype ne '') {
                   2987:             my %domdefs = &Apache::lonnet::get_domain_defaults($domtype);
                   2988:             if ($domdefs{'lang_def'} ne '') {
                   2989:                 push(@languages,$domdefs{'lang_def'});
                   2990:             }
                   2991:         }
1.118     www      2992:     }
                   2993: # turn "en-ca" into "en-ca,en"
                   2994:     my @genlanguages;
1.356     albertel 2995:     foreach my $lang (@languages) {
                   2996: 	unless ($lang=~/\w/) { next; }
1.583     albertel 2997: 	push(@genlanguages,$lang);
1.356     albertel 2998: 	if ($lang=~/(\-|\_)/) {
                   2999: 	    push(@genlanguages,(split(/(\-|\_)/,$lang))[0]);
1.118     www      3000: 	}
                   3001:     }
1.583     albertel 3002:     #uniqueify the languages list
                   3003:     my %count;
                   3004:     @genlanguages = map { $count{$_}++ == 0 ? $_ : () } @genlanguages;
1.118     www      3005:     return @genlanguages;
1.117     www      3006: }
                   3007: 
1.582     albertel 3008: sub languages {
                   3009:     my ($possible_langs) = @_;
                   3010:     my @preferred_langs = &preferred_languages();
                   3011:     if (!ref($possible_langs)) {
                   3012: 	if( wantarray ) {
                   3013: 	    return @preferred_langs;
                   3014: 	} else {
                   3015: 	    return $preferred_langs[0];
                   3016: 	}
                   3017:     }
                   3018:     my %possibilities = map { $_ => 1 } (@$possible_langs);
                   3019:     my @preferred_possibilities;
                   3020:     foreach my $preferred_lang (@preferred_langs) {
                   3021: 	if (exists($possibilities{$preferred_lang})) {
                   3022: 	    push(@preferred_possibilities, $preferred_lang);
                   3023: 	}
                   3024:     }
                   3025:     if( wantarray ) {
                   3026: 	return @preferred_possibilities;
                   3027:     }
                   3028:     return $preferred_possibilities[0];
                   3029: }
                   3030: 
1.112     bowersj2 3031: ###############################################################
                   3032: ##               Student Answer Attempts                     ##
                   3033: ###############################################################
                   3034: 
                   3035: =pod
                   3036: 
                   3037: =head1 Alternate Problem Views
                   3038: 
                   3039: =over 4
                   3040: 
1.648     raeburn  3041: =item * &get_previous_attempt($symb, $username, $domain, $course,
1.112     bowersj2 3042:     $getattempt, $regexp, $gradesub)
                   3043: 
                   3044: Return string with previous attempt on problem. Arguments:
                   3045: 
                   3046: =over 4
                   3047: 
                   3048: =item * $symb: Problem, including path
                   3049: 
                   3050: =item * $username: username of the desired student
                   3051: 
                   3052: =item * $domain: domain of the desired student
1.14      harris41 3053: 
1.112     bowersj2 3054: =item * $course: Course ID
1.14      harris41 3055: 
1.112     bowersj2 3056: =item * $getattempt: Leave blank for all attempts, otherwise put
                   3057:     something
1.14      harris41 3058: 
1.112     bowersj2 3059: =item * $regexp: if string matches this regexp, the string will be
                   3060:     sent to $gradesub
1.14      harris41 3061: 
1.112     bowersj2 3062: =item * $gradesub: routine that processes the string if it matches $regexp
1.14      harris41 3063: 
1.112     bowersj2 3064: =back
1.14      harris41 3065: 
1.112     bowersj2 3066: The output string is a table containing all desired attempts, if any.
1.16      harris41 3067: 
1.112     bowersj2 3068: =cut
1.1       albertel 3069: 
                   3070: sub get_previous_attempt {
1.43      ng       3071:   my ($symb,$username,$domain,$course,$getattempt,$regexp,$gradesub)=@_;
1.1       albertel 3072:   my $prevattempts='';
1.43      ng       3073:   no strict 'refs';
1.1       albertel 3074:   if ($symb) {
1.3       albertel 3075:     my (%returnhash)=
                   3076:       &Apache::lonnet::restore($symb,$course,$domain,$username);
1.1       albertel 3077:     if ($returnhash{'version'}) {
                   3078:       my %lasthash=();
                   3079:       my $version;
                   3080:       for ($version=1;$version<=$returnhash{'version'};$version++) {
1.356     albertel 3081:         foreach my $key (sort(split(/\:/,$returnhash{$version.':keys'}))) {
                   3082: 	  $lasthash{$key}=$returnhash{$version.':'.$key};
1.19      harris41 3083:         }
1.1       albertel 3084:       }
1.596     albertel 3085:       $prevattempts=&start_data_table().&start_data_table_header_row();
                   3086:       $prevattempts.='<th>'.&mt('History').'</th>';
1.356     albertel 3087:       foreach my $key (sort(keys(%lasthash))) {
                   3088: 	my ($ign,@parts) = split(/\./,$key);
1.41      ng       3089: 	if ($#parts > 0) {
1.31      albertel 3090: 	  my $data=$parts[-1];
                   3091: 	  pop(@parts);
1.596     albertel 3092: 	  $prevattempts.='<th>'.&mt('Part ').join('.',@parts).'<br />'.$data.'&nbsp;</th>';
1.31      albertel 3093: 	} else {
1.41      ng       3094: 	  if ($#parts == 0) {
                   3095: 	    $prevattempts.='<th>'.$parts[0].'</th>';
                   3096: 	  } else {
                   3097: 	    $prevattempts.='<th>'.$ign.'</th>';
                   3098: 	  }
1.31      albertel 3099: 	}
1.16      harris41 3100:       }
1.596     albertel 3101:       $prevattempts.=&end_data_table_header_row();
1.40      ng       3102:       if ($getattempt eq '') {
                   3103: 	for ($version=1;$version<=$returnhash{'version'};$version++) {
1.596     albertel 3104: 	  $prevattempts.=&start_data_table_row().
                   3105: 	      '<td>'.&mt('Transaction [_1]',$version).'</td>';
1.356     albertel 3106: 	    foreach my $key (sort(keys(%lasthash))) {
1.581     albertel 3107: 		my $value = &format_previous_attempt_value($key,
                   3108: 							   $returnhash{$version.':'.$key});
                   3109: 		$prevattempts.='<td>'.$value.'&nbsp;</td>';   
1.40      ng       3110: 	    }
1.596     albertel 3111: 	  $prevattempts.=&end_data_table_row();
1.40      ng       3112: 	 }
1.1       albertel 3113:       }
1.596     albertel 3114:       $prevattempts.=&start_data_table_row().'<td>'.&mt('Current').'</td>';
1.356     albertel 3115:       foreach my $key (sort(keys(%lasthash))) {
1.581     albertel 3116: 	my $value = &format_previous_attempt_value($key,$lasthash{$key});
1.356     albertel 3117: 	if ($key =~/$regexp$/ && (defined &$gradesub)) {$value = &$gradesub($value)}
1.40      ng       3118: 	$prevattempts.='<td>'.$value.'&nbsp;</td>';
1.16      harris41 3119:       }
1.596     albertel 3120:       $prevattempts.= &end_data_table_row().&end_data_table();
1.1       albertel 3121:     } else {
1.596     albertel 3122:       $prevattempts=
                   3123: 	  &start_data_table().&start_data_table_row().
                   3124: 	  '<td>'.&mt('Nothing submitted - no attempts.').'</td>'.
                   3125: 	  &end_data_table_row().&end_data_table();
1.1       albertel 3126:     }
                   3127:   } else {
1.596     albertel 3128:     $prevattempts=
                   3129: 	  &start_data_table().&start_data_table_row().
                   3130: 	  '<td>'.&mt('No data.').'</td>'.
                   3131: 	  &end_data_table_row().&end_data_table();
1.1       albertel 3132:   }
1.10      albertel 3133: }
                   3134: 
1.581     albertel 3135: sub format_previous_attempt_value {
                   3136:     my ($key,$value) = @_;
                   3137:     if ($key =~ /timestamp/) {
                   3138: 	$value = &Apache::lonlocal::locallocaltime($value);
                   3139:     } elsif (ref($value) eq 'ARRAY') {
                   3140: 	$value = '('.join(', ', @{ $value }).')';
                   3141:     } else {
                   3142: 	$value = &unescape($value);
                   3143:     }
                   3144:     return $value;
                   3145: }
                   3146: 
                   3147: 
1.107     albertel 3148: sub relative_to_absolute {
                   3149:     my ($url,$output)=@_;
                   3150:     my $parser=HTML::TokeParser->new(\$output);
                   3151:     my $token;
                   3152:     my $thisdir=$url;
                   3153:     my @rlinks=();
                   3154:     while ($token=$parser->get_token) {
                   3155: 	if ($token->[0] eq 'S') {
                   3156: 	    if ($token->[1] eq 'a') {
                   3157: 		if ($token->[2]->{'href'}) {
                   3158: 		    $rlinks[$#rlinks+1]=$token->[2]->{'href'};
                   3159: 		}
                   3160: 	    } elsif ($token->[1] eq 'img' || $token->[1] eq 'embed' ) {
                   3161: 		$rlinks[$#rlinks+1]=$token->[2]->{'src'};
                   3162: 	    } elsif ($token->[1] eq 'base') {
                   3163: 		$thisdir=$token->[2]->{'href'};
                   3164: 	    }
                   3165: 	}
                   3166:     }
                   3167:     $thisdir=~s-/[^/]*$--;
1.356     albertel 3168:     foreach my $link (@rlinks) {
                   3169: 	unless (($link=~/^http:\/\//i) ||
                   3170: 		($link=~/^\//) ||
                   3171: 		($link=~/^javascript:/i) ||
                   3172: 		($link=~/^mailto:/i) ||
                   3173: 		($link=~/^\#/)) {
                   3174: 	    my $newlocation=&Apache::lonnet::hreflocation($thisdir,$link);
                   3175: 	    $output=~s/(\"|\'|\=\s*)\Q$link\E(\"|\'|\s|\>)/$1$newlocation$2/;
1.107     albertel 3176: 	}
                   3177:     }
                   3178: # -------------------------------------------------- Deal with Applet codebases
                   3179:     $output=~s/(\<applet[^\>]+)(codebase\=[^\S\>]+)*([^\>]*)\>/$1.($2?$2:' codebase="'.$thisdir.'"').$3.'>'/gei;
                   3180:     return $output;
                   3181: }
                   3182: 
1.112     bowersj2 3183: =pod
                   3184: 
1.648     raeburn  3185: =item * &get_student_view()
1.112     bowersj2 3186: 
                   3187: show a snapshot of what student was looking at
                   3188: 
                   3189: =cut
                   3190: 
1.10      albertel 3191: sub get_student_view {
1.186     albertel 3192:   my ($symb,$username,$domain,$courseid,$target,$moreenv) = @_;
1.114     www      3193:   my ($map,$id,$feedurl) = &Apache::lonnet::decode_symb($symb);
1.186     albertel 3194:   my (%form);
1.10      albertel 3195:   my @elements=('symb','courseid','domain','username');
                   3196:   foreach my $element (@elements) {
1.186     albertel 3197:       $form{'grade_'.$element}=eval '$'.$element #'
1.10      albertel 3198:   }
1.186     albertel 3199:   if (defined($moreenv)) {
                   3200:       %form=(%form,%{$moreenv});
                   3201:   }
1.236     albertel 3202:   if (defined($target)) { $form{'grade_target'} = $target; }
1.107     albertel 3203:   $feedurl=&Apache::lonnet::clutter($feedurl);
1.650     www      3204:   my ($userview,$response)=&Apache::lonnet::ssi_body($feedurl,%form);
1.11      albertel 3205:   $userview=~s/\<body[^\>]*\>//gi;
                   3206:   $userview=~s/\<\/body\>//gi;
                   3207:   $userview=~s/\<html\>//gi;
                   3208:   $userview=~s/\<\/html\>//gi;
                   3209:   $userview=~s/\<head\>//gi;
                   3210:   $userview=~s/\<\/head\>//gi;
                   3211:   $userview=~s/action\s*\=/would_be_action\=/gi;
1.107     albertel 3212:   $userview=&relative_to_absolute($feedurl,$userview);
1.650     www      3213:   if (wantarray) {
                   3214:      return ($userview,$response);
                   3215:   } else {
                   3216:      return $userview;
                   3217:   }
                   3218: }
                   3219: 
                   3220: sub get_student_view_with_retries {
                   3221:   my ($symb,$retries,$username,$domain,$courseid,$target,$moreenv) = @_;
                   3222: 
                   3223:     my $ok = 0;                 # True if we got a good response.
                   3224:     my $content;
                   3225:     my $response;
                   3226: 
                   3227:     # Try to get the student_view done. within the retries count:
                   3228:     
                   3229:     do {
                   3230:          ($content, $response) = &get_student_view($symb,$username,$domain,$courseid,$target,$moreenv);
                   3231:          $ok      = $response->is_success;
                   3232:          if (!$ok) {
                   3233:             &Apache::lonnet::logthis("Failed get_student_view_with_retries on $symb: ".$response->is_success.', '.$response->code.', '.$response->message);
                   3234:          }
                   3235:          $retries--;
                   3236:     } while (!$ok && ($retries > 0));
                   3237:     
                   3238:     if (!$ok) {
                   3239:        $content = '';          # On error return an empty content.
                   3240:     }
1.651     www      3241:     if (wantarray) {
                   3242:        return ($content, $response);
                   3243:     } else {
                   3244:        return $content;
                   3245:     }
1.11      albertel 3246: }
                   3247: 
1.112     bowersj2 3248: =pod
                   3249: 
1.648     raeburn  3250: =item * &get_student_answers() 
1.112     bowersj2 3251: 
                   3252: show a snapshot of how student was answering problem
                   3253: 
                   3254: =cut
                   3255: 
1.11      albertel 3256: sub get_student_answers {
1.100     sakharuk 3257:   my ($symb,$username,$domain,$courseid,%form) = @_;
1.114     www      3258:   my ($map,$id,$feedurl) = &Apache::lonnet::decode_symb($symb);
1.186     albertel 3259:   my (%moreenv);
1.11      albertel 3260:   my @elements=('symb','courseid','domain','username');
                   3261:   foreach my $element (@elements) {
1.186     albertel 3262:     $moreenv{'grade_'.$element}=eval '$'.$element #'
1.10      albertel 3263:   }
1.186     albertel 3264:   $moreenv{'grade_target'}='answer';
                   3265:   %moreenv=(%form,%moreenv);
1.497     raeburn  3266:   $feedurl = &Apache::lonnet::clutter($feedurl);
                   3267:   my $userview=&Apache::lonnet::ssi($feedurl,%moreenv);
1.10      albertel 3268:   return $userview;
1.1       albertel 3269: }
1.116     albertel 3270: 
                   3271: =pod
                   3272: 
                   3273: =item * &submlink()
                   3274: 
1.242     albertel 3275: Inputs: $text $uname $udom $symb $target
1.116     albertel 3276: 
                   3277: Returns: A link to grades.pm such as to see the SUBM view of a student
                   3278: 
                   3279: =cut
                   3280: 
                   3281: ###############################################
                   3282: sub submlink {
1.242     albertel 3283:     my ($text,$uname,$udom,$symb,$target)=@_;
1.116     albertel 3284:     if (!($uname && $udom)) {
                   3285: 	(my $cursymb, my $courseid,$udom,$uname)=
1.463     albertel 3286: 	    &Apache::lonnet::whichuser($symb);
1.116     albertel 3287: 	if (!$symb) { $symb=$cursymb; }
                   3288:     }
1.254     matthew  3289:     if (!$symb) { $symb=&Apache::lonnet::symbread(); }
1.369     www      3290:     $symb=&escape($symb);
1.242     albertel 3291:     if ($target) { $target="target=\"$target\""; }
                   3292:     return '<a href="/adm/grades?&command=submission&'.
                   3293: 	'symb='.$symb.'&student='.$uname.
                   3294: 	'&userdom='.$udom.'" '.$target.'>'.$text.'</a>';
                   3295: }
                   3296: ##############################################
                   3297: 
                   3298: =pod
                   3299: 
                   3300: =item * &pgrdlink()
                   3301: 
                   3302: Inputs: $text $uname $udom $symb $target
                   3303: 
                   3304: Returns: A link to grades.pm such as to see the PGRD view of a student
                   3305: 
                   3306: =cut
                   3307: 
                   3308: ###############################################
                   3309: sub pgrdlink {
                   3310:     my $link=&submlink(@_);
                   3311:     $link=~s/(&command=submission)/$1&showgrading=yes/;
                   3312:     return $link;
                   3313: }
                   3314: ##############################################
                   3315: 
                   3316: =pod
                   3317: 
                   3318: =item * &pprmlink()
                   3319: 
                   3320: Inputs: $text $uname $udom $symb $target
                   3321: 
                   3322: Returns: A link to parmset.pm such as to see the PPRM view of a
1.283     albertel 3323: student and a specific resource
1.242     albertel 3324: 
                   3325: =cut
                   3326: 
                   3327: ###############################################
                   3328: sub pprmlink {
                   3329:     my ($text,$uname,$udom,$symb,$target)=@_;
                   3330:     if (!($uname && $udom)) {
                   3331: 	(my $cursymb, my $courseid,$udom,$uname)=
1.463     albertel 3332: 	    &Apache::lonnet::whichuser($symb);
1.242     albertel 3333: 	if (!$symb) { $symb=$cursymb; }
                   3334:     }
1.254     matthew  3335:     if (!$symb) { $symb=&Apache::lonnet::symbread(); }
1.369     www      3336:     $symb=&escape($symb);
1.242     albertel 3337:     if ($target) { $target="target=\"$target\""; }
1.595     albertel 3338:     return '<a href="/adm/parmset?command=set&amp;'.
                   3339: 	'symb='.$symb.'&amp;uname='.$uname.
                   3340: 	'&amp;udom='.$udom.'" '.$target.'>'.$text.'</a>';
1.116     albertel 3341: }
                   3342: ##############################################
1.37      matthew  3343: 
1.112     bowersj2 3344: =pod
                   3345: 
                   3346: =back
                   3347: 
                   3348: =cut
                   3349: 
1.37      matthew  3350: ###############################################
1.51      www      3351: 
                   3352: 
                   3353: sub timehash {
                   3354:     my @ltime=localtime(shift);
                   3355:     return ( 'seconds' => $ltime[0],
                   3356:              'minutes' => $ltime[1],
                   3357:              'hours'   => $ltime[2],
                   3358:              'day'     => $ltime[3],
                   3359:              'month'   => $ltime[4]+1,
                   3360:              'year'    => $ltime[5]+1900,
                   3361:              'weekday' => $ltime[6],
                   3362:              'dayyear' => $ltime[7]+1,
                   3363:              'dlsav'   => $ltime[8] );
                   3364: }
                   3365: 
1.370     www      3366: sub utc_string {
                   3367:     my ($date)=@_;
1.371     www      3368:     return strftime("%Y%m%dT%H%M%SZ",gmtime($date));
1.370     www      3369: }
                   3370: 
1.51      www      3371: sub maketime {
                   3372:     my %th=@_;
                   3373:     return POSIX::mktime(
                   3374:         ($th{'seconds'},$th{'minutes'},$th{'hours'},
1.210     www      3375:          $th{'day'},$th{'month'}-1,$th{'year'}-1900,0,0,-1));
1.70      www      3376: }
                   3377: 
                   3378: #########################################
1.51      www      3379: 
                   3380: sub findallcourses {
1.482     raeburn  3381:     my ($roles,$uname,$udom) = @_;
1.355     albertel 3382:     my %roles;
                   3383:     if (ref($roles)) { %roles = map { $_ => 1 } @{$roles}; }
1.348     albertel 3384:     my %courses;
1.51      www      3385:     my $now=time;
1.482     raeburn  3386:     if (!defined($uname)) {
                   3387:         $uname = $env{'user.name'};
                   3388:     }
                   3389:     if (!defined($udom)) {
                   3390:         $udom = $env{'user.domain'};
                   3391:     }
                   3392:     if (($uname ne $env{'user.name'}) || ($udom ne $env{'user.domain'})) {
                   3393:         my %roleshash = &Apache::lonnet::dump('roles',$udom,$uname);
                   3394:         if (!%roles) {
                   3395:             %roles = (
                   3396:                        cc => 1,
                   3397:                        in => 1,
                   3398:                        ep => 1,
                   3399:                        ta => 1,
                   3400:                        cr => 1,
                   3401:                        st => 1,
                   3402:              );
                   3403:         }
                   3404:         foreach my $entry (keys(%roleshash)) {
                   3405:             my ($trole,$tend,$tstart) = split(/_/,$roleshash{$entry});
                   3406:             if ($trole =~ /^cr/) { 
                   3407:                 next if (!exists($roles{$trole}) && !exists($roles{'cr'}));
                   3408:             } else {
                   3409:                 next if (!exists($roles{$trole}));
                   3410:             }
                   3411:             if ($tend) {
                   3412:                 next if ($tend < $now);
                   3413:             }
                   3414:             if ($tstart) {
                   3415:                 next if ($tstart > $now);
                   3416:             }
                   3417:             my ($cdom,$cnum,$sec,$cnumpart,$secpart,$role,$realsec);
                   3418:             (undef,$cdom,$cnumpart,$secpart) = split(/\//,$entry);
                   3419:             if ($secpart eq '') {
                   3420:                 ($cnum,$role) = split(/_/,$cnumpart); 
                   3421:                 $sec = 'none';
                   3422:                 $realsec = '';
                   3423:             } else {
                   3424:                 $cnum = $cnumpart;
                   3425:                 ($sec,$role) = split(/_/,$secpart);
                   3426:                 $realsec = $sec;
1.490     raeburn  3427:             }
1.482     raeburn  3428:             $courses{$cdom.'_'.$cnum}{$sec} = $trole.'/'.$cdom.'/'.$cnum.'/'.$realsec;
                   3429:         }
                   3430:     } else {
                   3431:         foreach my $key (keys(%env)) {
1.483     albertel 3432: 	    if ( $key=~m{^user\.role\.(\w+)\./($match_domain)/($match_courseid)/?(\w*)$} ||
                   3433:                  $key=~m{^user\.role\.(cr/$match_domain/$match_username/\w+)\./($match_domain)/($match_courseid)/?(\w*)$}) {
1.482     raeburn  3434: 	        my ($role,$cdom,$cnum,$sec) = ($1,$2,$3,$4);
                   3435: 	        next if ($role eq 'ca' || $role eq 'aa');
                   3436: 	        next if (%roles && !exists($roles{$role}));
                   3437: 	        my ($starttime,$endtime)=split(/\./,$env{$key});
                   3438:                 my $active=1;
                   3439:                 if ($starttime) {
                   3440: 		    if ($now<$starttime) { $active=0; }
                   3441:                 }
                   3442:                 if ($endtime) {
                   3443:                     if ($now>$endtime) { $active=0; }
                   3444:                 }
                   3445:                 if ($active) {
                   3446:                     if ($sec eq '') {
                   3447:                         $sec = 'none';
                   3448:                     }
                   3449:                     $courses{$cdom.'_'.$cnum}{$sec} = 
                   3450:                                      $role.'/'.$cdom.'/'.$cnum.'/'.$sec;
1.474     raeburn  3451:                 }
                   3452:             }
1.51      www      3453:         }
                   3454:     }
1.474     raeburn  3455:     return %courses;
1.51      www      3456: }
1.37      matthew  3457: 
1.54      www      3458: ###############################################
1.474     raeburn  3459: 
                   3460: sub blockcheck {
1.482     raeburn  3461:     my ($setters,$activity,$uname,$udom) = @_;
1.490     raeburn  3462: 
                   3463:     if (!defined($udom)) {
                   3464:         $udom = $env{'user.domain'};
                   3465:     }
                   3466:     if (!defined($uname)) {
                   3467:         $uname = $env{'user.name'};
                   3468:     }
                   3469: 
                   3470:     # If uname and udom are for a course, check for blocks in the course.
                   3471: 
                   3472:     if (&Apache::lonnet::is_course($udom,$uname)) {
                   3473:         my %records = &Apache::lonnet::dump('comm_block',$udom,$uname);
1.502     raeburn  3474:         my ($startblock,$endblock)=&get_blocks($setters,$activity,$udom,$uname);
1.490     raeburn  3475:         return ($startblock,$endblock);
                   3476:     }
1.474     raeburn  3477: 
1.502     raeburn  3478:     my $startblock = 0;
                   3479:     my $endblock = 0;
1.482     raeburn  3480:     my %live_courses = &findallcourses(undef,$uname,$udom);
1.474     raeburn  3481: 
1.490     raeburn  3482:     # If uname is for a user, and activity is course-specific, i.e.,
                   3483:     # boards, chat or groups, check for blocking in current course only.
1.474     raeburn  3484: 
1.490     raeburn  3485:     if (($activity eq 'boards' || $activity eq 'chat' ||
                   3486:          $activity eq 'groups') && ($env{'request.course.id'})) {
                   3487:         foreach my $key (keys(%live_courses)) {
                   3488:             if ($key ne $env{'request.course.id'}) {
                   3489:                 delete($live_courses{$key});
                   3490:             }
                   3491:         }
                   3492:     }
                   3493: 
                   3494:     my $otheruser = 0;
                   3495:     my %own_courses;
                   3496:     if ((($uname ne $env{'user.name'})) || ($udom ne $env{'user.domain'})) {
                   3497:         # Resource belongs to user other than current user.
                   3498:         $otheruser = 1;
                   3499:         # Gather courses for current user
                   3500:         %own_courses = 
                   3501:             &findallcourses(undef,$env{'user.name'},$env{'user.domain'});
                   3502:     }
                   3503: 
                   3504:     # Gather active course roles - course coordinator, instructor, 
                   3505:     # exam proctor, ta, student, or custom role.
1.474     raeburn  3506: 
                   3507:     foreach my $course (keys(%live_courses)) {
1.482     raeburn  3508:         my ($cdom,$cnum);
                   3509:         if ((defined($env{'course.'.$course.'.domain'})) && (defined($env{'course.'.$course.'.num'}))) {
                   3510:             $cdom = $env{'course.'.$course.'.domain'};
                   3511:             $cnum = $env{'course.'.$course.'.num'};
                   3512:         } else {
1.490     raeburn  3513:             ($cdom,$cnum) = split(/_/,$course); 
1.482     raeburn  3514:         }
                   3515:         my $no_ownblock = 0;
                   3516:         my $no_userblock = 0;
1.533     raeburn  3517:         if ($otheruser && $activity ne 'com') {
1.490     raeburn  3518:             # Check if current user has 'evb' priv for this
                   3519:             if (defined($own_courses{$course})) {
                   3520:                 foreach my $sec (keys(%{$own_courses{$course}})) {
                   3521:                     my $checkrole = 'cm./'.$cdom.'/'.$cnum;
                   3522:                     if ($sec ne 'none') {
                   3523:                         $checkrole .= '/'.$sec;
                   3524:                     }
                   3525:                     if (&Apache::lonnet::allowed('evb',undef,undef,$checkrole)) {
                   3526:                         $no_ownblock = 1;
                   3527:                         last;
                   3528:                     }
                   3529:                 }
                   3530:             }
                   3531:             # if they have 'evb' priv and are currently not playing student
                   3532:             next if (($no_ownblock) &&
                   3533:                  ($env{'request.role'} !~ m{^st\./$cdom/$cnum}));
                   3534:         }
1.474     raeburn  3535:         foreach my $sec (keys(%{$live_courses{$course}})) {
1.482     raeburn  3536:             my $checkrole = 'cm./'.$cdom.'/'.$cnum;
1.474     raeburn  3537:             if ($sec ne 'none') {
1.482     raeburn  3538:                 $checkrole .= '/'.$sec;
1.474     raeburn  3539:             }
1.490     raeburn  3540:             if ($otheruser) {
                   3541:                 # Resource belongs to user other than current user.
                   3542:                 # Assemble privs for that user, and check for 'evb' priv.
1.482     raeburn  3543:                 my ($trole,$tdom,$tnum,$tsec);
                   3544:                 my $entry = $live_courses{$course}{$sec};
                   3545:                 if ($entry =~ /^cr/) {
                   3546:                     ($trole,$tdom,$tnum,$tsec) = 
                   3547:                       ($entry =~ m|^(cr/$match_domain/$match_username/\w+)\./($match_domain)/($match_username)/?(\w*)$|);
                   3548:                 } else {
                   3549:                     ($trole,$tdom,$tnum,$tsec) = split(/\//,$entry);
                   3550:                 }
                   3551:                 my ($spec,$area,$trest,%allroles,%userroles);
                   3552:                 $area = '/'.$tdom.'/'.$tnum;
                   3553:                 $trest = $tnum;
                   3554:                 if ($tsec ne '') {
                   3555:                     $area .= '/'.$tsec;
                   3556:                     $trest .= '/'.$tsec;
                   3557:                 }
                   3558:                 $spec = $trole.'.'.$area;
                   3559:                 if ($trole =~ /^cr/) {
                   3560:                     &Apache::lonnet::custom_roleprivs(\%allroles,$trole,
                   3561:                                                       $tdom,$spec,$trest,$area);
                   3562:                 } else {
                   3563:                     &Apache::lonnet::standard_roleprivs(\%allroles,$trole,
                   3564:                                                        $tdom,$spec,$trest,$area);
                   3565:                 }
                   3566:                 my ($author,$adv) = &Apache::lonnet::set_userprivs(\%userroles,\%allroles);
1.486     raeburn  3567:                 if ($userroles{'user.priv.'.$checkrole} =~ /evb\&([^\:]*)/) {
                   3568:                     if ($1) {
                   3569:                         $no_userblock = 1;
                   3570:                         last;
                   3571:                     }
                   3572:                 }
1.490     raeburn  3573:             } else {
                   3574:                 # Resource belongs to current user
                   3575:                 # Check for 'evb' priv via lonnet::allowed().
1.482     raeburn  3576:                 if (&Apache::lonnet::allowed('evb',undef,undef,$checkrole)) {
                   3577:                     $no_ownblock = 1;
                   3578:                     last;
                   3579:                 }
1.474     raeburn  3580:             }
                   3581:         }
                   3582:         # if they have the evb priv and are currently not playing student
1.482     raeburn  3583:         next if (($no_ownblock) &&
1.491     albertel 3584:                  ($env{'request.role'} !~ m{^st\./\Q$cdom\E/\Q$cnum\E}));
1.482     raeburn  3585:         next if ($no_userblock);
1.474     raeburn  3586: 
1.490     raeburn  3587:         # Retrieve blocking times and identity of blocker for course
                   3588:         # of specified user, unless user has 'evb' privilege.
1.502     raeburn  3589:         
                   3590:         my ($start,$end)=&get_blocks($setters,$activity,$cdom,$cnum);
                   3591:         if (($start != 0) && 
                   3592:             (($startblock == 0) || ($startblock > $start))) {
                   3593:             $startblock = $start;
                   3594:         }
                   3595:         if (($end != 0)  &&
                   3596:             (($endblock == 0) || ($endblock < $end))) {
                   3597:             $endblock = $end;
                   3598:         }
1.490     raeburn  3599:     }
                   3600:     return ($startblock,$endblock);
                   3601: }
                   3602: 
                   3603: sub get_blocks {
                   3604:     my ($setters,$activity,$cdom,$cnum) = @_;
                   3605:     my $startblock = 0;
                   3606:     my $endblock = 0;
                   3607:     my $course = $cdom.'_'.$cnum;
                   3608:     $setters->{$course} = {};
                   3609:     $setters->{$course}{'staff'} = [];
                   3610:     $setters->{$course}{'times'} = [];
                   3611:     my %records = &Apache::lonnet::dump('comm_block',$cdom,$cnum);
                   3612:     foreach my $record (keys(%records)) {
                   3613:         my ($start,$end) = ($record =~ m/^(\d+)____(\d+)$/);
                   3614:         if ($start <= time && $end >= time) {
                   3615:             my ($staff_name,$staff_dom,$title,$blocks) =
                   3616:                 &parse_block_record($records{$record});
                   3617:             if ($blocks->{$activity} eq 'on') {
                   3618:                 push(@{$$setters{$course}{'staff'}},[$staff_name,$staff_dom]);
                   3619:                 push(@{$$setters{$course}{'times'}}, [$start,$end]);
1.491     albertel 3620:                 if ( ($startblock == 0) || ($startblock > $start) ) {
                   3621:                     $startblock = $start;
1.490     raeburn  3622:                 }
1.491     albertel 3623:                 if ( ($endblock == 0) || ($endblock < $end) ) {
                   3624:                     $endblock = $end;
1.474     raeburn  3625:                 }
                   3626:             }
                   3627:         }
                   3628:     }
                   3629:     return ($startblock,$endblock);
                   3630: }
                   3631: 
                   3632: sub parse_block_record {
                   3633:     my ($record) = @_;
                   3634:     my ($setuname,$setudom,$title,$blocks);
                   3635:     if (ref($record) eq 'HASH') {
                   3636:         ($setuname,$setudom) = split(/:/,$record->{'setter'});
                   3637:         $title = &unescape($record->{'event'});
                   3638:         $blocks = $record->{'blocks'};
                   3639:     } else {
                   3640:         my @data = split(/:/,$record,3);
                   3641:         if (scalar(@data) eq 2) {
                   3642:             $title = $data[1];
                   3643:             ($setuname,$setudom) = split(/@/,$data[0]);
                   3644:         } else {
                   3645:             ($setuname,$setudom,$title) = @data;
                   3646:         }
                   3647:         $blocks = { 'com' => 'on' };
                   3648:     }
                   3649:     return ($setuname,$setudom,$title,$blocks);
                   3650: }
                   3651: 
                   3652: sub build_block_table {
                   3653:     my ($startblock,$endblock,$setters) = @_;
                   3654:     my %lt = &Apache::lonlocal::texthash(
                   3655:         'cacb' => 'Currently active communication blocks',
                   3656:         'cour' => 'Course',
                   3657:         'dura' => 'Duration',
                   3658:         'blse' => 'Block set by'
                   3659:     );
                   3660:     my $output;
1.476     raeburn  3661:     $output = '<br />'.$lt{'cacb'}.':<br />';
1.474     raeburn  3662:     $output .= &start_data_table();
                   3663:     $output .= '
                   3664: <tr>
                   3665:  <th>'.$lt{'cour'}.'</th>
                   3666:  <th>'.$lt{'dura'}.'</th>
                   3667:  <th>'.$lt{'blse'}.'</th>
                   3668: </tr>
                   3669: ';
                   3670:     foreach my $course (keys(%{$setters})) {
                   3671:         my %courseinfo=&Apache::lonnet::coursedescription($course);
                   3672:         for (my $i=0; $i<@{$$setters{$course}{staff}}; $i++) {
                   3673:             my ($uname,$udom) = @{$$setters{$course}{staff}[$i]};
1.490     raeburn  3674:             my $fullname = &plainname($uname,$udom);
                   3675:             if (defined($env{'user.name'}) && defined($env{'user.domain'})
                   3676:                 && $env{'user.name'} ne 'public' 
                   3677:                 && $env{'user.domain'} ne 'public') {
                   3678:                 $fullname = &aboutmewrapper($fullname,$uname,$udom);
                   3679:             }
1.474     raeburn  3680:             my ($openblock,$closeblock) = @{$$setters{$course}{times}[$i]};
                   3681:             $openblock = &Apache::lonlocal::locallocaltime($openblock);
                   3682:             $closeblock= &Apache::lonlocal::locallocaltime($closeblock);
                   3683:             $output .= &Apache::loncommon::start_data_table_row().
                   3684:                        '<td>'.$courseinfo{'description'}.'</td>'.
                   3685:                        '<td>'.$openblock.' to '.$closeblock.'</td>'.
1.490     raeburn  3686:                        '<td>'.$fullname.'</td>'.
1.474     raeburn  3687:                         &Apache::loncommon::end_data_table_row();
                   3688:         }
                   3689:     }
                   3690:     $output .= &end_data_table();
                   3691: }
                   3692: 
1.490     raeburn  3693: sub blocking_status {
                   3694:     my ($activity,$uname,$udom) = @_;
                   3695:     my %setters;
                   3696:     my ($blocked,$output,$ownitem,$is_course);
                   3697:     my ($startblock,$endblock)=&blockcheck(\%setters,$activity,$uname,$udom);
                   3698:     if ($startblock && $endblock) {
                   3699:         $blocked = 1;
                   3700:         if (wantarray) {
                   3701:             my $category;
                   3702:             if ($activity eq 'boards') {
                   3703:                 $category = 'Discussion posts in this course';
                   3704:             } elsif ($activity eq 'blogs') {
                   3705:                 $category = 'Blogs';
                   3706:             } elsif ($activity eq 'port') {
                   3707:                 if (defined($uname) && defined($udom)) {
                   3708:                     if ($uname eq $env{'user.name'} &&
                   3709:                         $udom eq $env{'user.domain'}) {
                   3710:                         $ownitem = 1;
                   3711:                     }
                   3712:                 }
                   3713:                 $is_course = &Apache::lonnet::is_course($udom,$uname);
                   3714:                 if ($ownitem) { 
                   3715:                     $category = 'Your portfolio files';  
                   3716:                 } elsif ($is_course) {
                   3717:                     my $coursedesc;
                   3718:                     foreach my $course (keys(%setters)) {
                   3719:                         my %courseinfo =
                   3720:                              &Apache::lonnet::coursedescription($course);
                   3721:                         $coursedesc = $courseinfo{'description'};
                   3722:                     }
                   3723:                     $category = "Group files in the course '$coursedesc'";
                   3724:                 } else {
                   3725:                     $category = 'Portfolio files belonging to ';
                   3726:                     if ($env{'user.name'} eq 'public' && 
                   3727:                         $env{'user.domain'} eq 'public') {
                   3728:                         $category .= &plainname($uname,$udom);
                   3729:                     } else {
                   3730:                         $category .= &aboutmewrapper(&plainname($uname,$udom),$uname,$udom);  
                   3731:                     }
                   3732:                 }
                   3733:             } elsif ($activity eq 'groups') {
                   3734:                 $category = 'Groups in this course';
                   3735:             }
                   3736:             my $showstart = &Apache::lonlocal::locallocaltime($startblock);
                   3737:             my $showend = &Apache::lonlocal::locallocaltime($endblock);
                   3738:             $output = '<br />'.&mt('[_1] will be inaccessible between [_2] and [_3] because communication is being blocked.',$category,$showstart,$showend).'<br />';
                   3739:             if (!($activity eq 'port' && !($ownitem) && !($is_course))) { 
                   3740:                 $output .= &build_block_table($startblock,$endblock,\%setters);
                   3741:             }
                   3742:         }
                   3743:     }
                   3744:     if (wantarray) {
                   3745:         return ($blocked,$output);
                   3746:     } else {
                   3747:         return $blocked;
                   3748:     }
                   3749: }
                   3750: 
1.60      matthew  3751: ###############################################
                   3752: 
                   3753: =pod
                   3754: 
1.112     bowersj2 3755: =head1 Domain Template Functions
                   3756: 
                   3757: =over 4
                   3758: 
                   3759: =item * &determinedomain()
1.60      matthew  3760: 
                   3761: Inputs: $domain (usually will be undef)
                   3762: 
1.63      www      3763: Returns: Determines which domain should be used for designs
1.60      matthew  3764: 
                   3765: =cut
1.54      www      3766: 
1.60      matthew  3767: ###############################################
1.63      www      3768: sub determinedomain {
                   3769:     my $domain=shift;
1.531     albertel 3770:     if (! $domain) {
1.60      matthew  3771:         # Determine domain if we have not been given one
                   3772:         $domain = $Apache::lonnet::perlvar{'lonDefDomain'};
1.258     albertel 3773:         if ($env{'user.domain'}) { $domain=$env{'user.domain'}; }
                   3774:         if ($env{'request.role.domain'}) { 
                   3775:             $domain=$env{'request.role.domain'}; 
1.60      matthew  3776:         }
                   3777:     }
1.63      www      3778:     return $domain;
                   3779: }
                   3780: ###############################################
1.517     raeburn  3781: 
1.518     albertel 3782: sub devalidate_domconfig_cache {
                   3783:     my ($udom)=@_;
                   3784:     &Apache::lonnet::devalidate_cache_new('domainconfig',$udom);
                   3785: }
                   3786: 
                   3787: # ---------------------- Get domain configuration for a domain
                   3788: sub get_domainconf {
                   3789:     my ($udom) = @_;
                   3790:     my $cachetime=1800;
                   3791:     my ($result,$cached)=&Apache::lonnet::is_cached_new('domainconfig',$udom);
                   3792:     if (defined($cached)) { return %{$result}; }
                   3793: 
                   3794:     my %domconfig = &Apache::lonnet::get_dom('configuration',
                   3795: 					     ['login','rolecolors'],$udom);
1.632     raeburn  3796:     my (%designhash,%legacy);
1.518     albertel 3797:     if (keys(%domconfig) > 0) {
                   3798:         if (ref($domconfig{'login'}) eq 'HASH') {
1.632     raeburn  3799:             if (keys(%{$domconfig{'login'}})) {
                   3800:                 foreach my $key (keys(%{$domconfig{'login'}})) {
                   3801:                     $designhash{$udom.'.login.'.$key}=$domconfig{'login'}{$key};
                   3802:                 }
                   3803:             } else {
                   3804:                 $legacy{'login'} = 1;
1.518     albertel 3805:             }
1.632     raeburn  3806:         } else {
                   3807:             $legacy{'login'} = 1;
1.518     albertel 3808:         }
                   3809:         if (ref($domconfig{'rolecolors'}) eq 'HASH') {
1.632     raeburn  3810:             if (keys(%{$domconfig{'rolecolors'}})) {
                   3811:                 foreach my $role (keys(%{$domconfig{'rolecolors'}})) {
                   3812:                     if (ref($domconfig{'rolecolors'}{$role}) eq 'HASH') {
                   3813:                         foreach my $item (keys(%{$domconfig{'rolecolors'}{$role}})) {
                   3814:                             $designhash{$udom.'.'.$role.'.'.$item}=$domconfig{'rolecolors'}{$role}{$item};
                   3815:                         }
1.518     albertel 3816:                     }
                   3817:                 }
1.632     raeburn  3818:             } else {
                   3819:                 $legacy{'rolecolors'} = 1;
1.518     albertel 3820:             }
1.632     raeburn  3821:         } else {
                   3822:             $legacy{'rolecolors'} = 1;
1.518     albertel 3823:         }
1.632     raeburn  3824:         if (keys(%legacy) > 0) {
                   3825:             my %legacyhash = &get_legacy_domconf($udom);
                   3826:             foreach my $item (keys(%legacyhash)) {
                   3827:                 if ($item =~ /^\Q$udom\E\.login/) {
                   3828:                     if ($legacy{'login'}) { 
                   3829:                         $designhash{$item} = $legacyhash{$item};
                   3830:                     }
                   3831:                 } else {
                   3832:                     if ($legacy{'rolecolors'}) {
                   3833:                         $designhash{$item} = $legacyhash{$item};
                   3834:                     }
1.518     albertel 3835:                 }
                   3836:             }
                   3837:         }
1.632     raeburn  3838:     } else {
                   3839:         %designhash = &get_legacy_domconf($udom); 
1.518     albertel 3840:     }
                   3841:     &Apache::lonnet::do_cache_new('domainconfig',$udom,\%designhash,
                   3842: 				  $cachetime);
                   3843:     return %designhash;
                   3844: }
                   3845: 
1.632     raeburn  3846: sub get_legacy_domconf {
                   3847:     my ($udom) = @_;
                   3848:     my %legacyhash;
                   3849:     my $designdir=$Apache::lonnet::perlvar{'lonTabDir'}.'/lonDomColors';
                   3850:     my $designfile =  $designdir.'/'.$udom.'.tab';
                   3851:     if (-e $designfile) {
                   3852:         if ( open (my $fh,"<$designfile") ) {
                   3853:             while (my $line = <$fh>) {
                   3854:                 next if ($line =~ /^\#/);
                   3855:                 chomp($line);
                   3856:                 my ($key,$val)=(split(/\=/,$line));
                   3857:                 if ($val) { $legacyhash{$udom.'.'.$key}=$val; }
                   3858:             }
                   3859:             close($fh);
                   3860:         }
                   3861:     }
                   3862:     if (-e '/home/httpd/html/adm/lonDomLogos/'.$udom.'.gif') {
                   3863:         $legacyhash{$udom.'.login.domlogo'} = "/adm/lonDomLogos/$udom.gif";
                   3864:     }
                   3865:     return %legacyhash;
                   3866: }
                   3867: 
1.63      www      3868: =pod
                   3869: 
1.112     bowersj2 3870: =item * &domainlogo()
1.63      www      3871: 
                   3872: Inputs: $domain (usually will be undef)
                   3873: 
                   3874: Returns: A link to a domain logo, if the domain logo exists.
                   3875: If the domain logo does not exist, a description of the domain.
                   3876: 
                   3877: =cut
1.112     bowersj2 3878: 
1.63      www      3879: ###############################################
                   3880: sub domainlogo {
1.517     raeburn  3881:     my $domain = &determinedomain(shift);
1.518     albertel 3882:     my %designhash = &get_domainconf($domain);    
1.517     raeburn  3883:     # See if there is a logo
                   3884:     if ($designhash{$domain.'.login.domlogo'} ne '') {
1.519     raeburn  3885:         my $imgsrc = $designhash{$domain.'.login.domlogo'};
1.538     albertel 3886:         if ($imgsrc =~ m{^/(adm|res)/}) {
                   3887: 	    if ($imgsrc =~ m{^/res/}) {
                   3888: 		my $local_name = &Apache::lonnet::filelocation('',$imgsrc);
                   3889: 		&Apache::lonnet::repcopy($local_name);
                   3890: 	    }
                   3891: 	   $imgsrc = &lonhttpdurl($imgsrc);
1.519     raeburn  3892:         } 
                   3893:         return '<img src="'.$imgsrc.'" alt="'.$domain.'" />';
1.514     albertel 3894:     } elsif (defined(&Apache::lonnet::domain($domain,'description'))) {
                   3895:         return &Apache::lonnet::domain($domain,'description');
1.59      www      3896:     } else {
1.60      matthew  3897:         return '';
1.59      www      3898:     }
                   3899: }
1.63      www      3900: ##############################################
                   3901: 
                   3902: =pod
                   3903: 
1.112     bowersj2 3904: =item * &designparm()
1.63      www      3905: 
                   3906: Inputs: $which parameter; $domain (usually will be undef)
                   3907: 
                   3908: Returns: value of designparamter $which
                   3909: 
                   3910: =cut
1.112     bowersj2 3911: 
1.397     albertel 3912: 
1.400     albertel 3913: ##############################################
1.397     albertel 3914: sub designparm {
                   3915:     my ($which,$domain)=@_;
1.258     albertel 3916:     if ($env{'browser.blackwhite'} eq 'on') {
1.635     raeburn  3917: 	if ($which=~/\.(font|alink|vlink|link|textcol)$/) {
1.110     www      3918: 	    return '#000000';
                   3919: 	}
1.635     raeburn  3920: 	if ($which=~/\.(pgbg|sidebg|bgcol)$/) {
1.110     www      3921: 	    return '#FFFFFF';
                   3922: 	}
                   3923: 	if ($which=~/\.tabbg$/) {
                   3924: 	    return '#CCCCCC';
                   3925: 	}
                   3926:     }
1.397     albertel 3927:     if (exists($env{'environment.color.'.$which})) {
1.258     albertel 3928: 	return $env{'environment.color.'.$which};
1.96      www      3929:     }
1.63      www      3930:     $domain=&determinedomain($domain);
1.518     albertel 3931:     my %domdesign = &get_domainconf($domain);
1.520     raeburn  3932:     my $output;
1.517     raeburn  3933:     if ($domdesign{$domain.'.'.$which} ne '') {
1.520     raeburn  3934: 	$output = $domdesign{$domain.'.'.$which};
1.63      www      3935:     } else {
1.520     raeburn  3936:         $output = $defaultdesign{$which};
                   3937:     }
                   3938:     if (($which =~ /^(student|coordinator|author|admin)\.img$/) ||
1.635     raeburn  3939:         ($which =~ /login\.(img|logo|domlogo|login)/)) {
1.538     albertel 3940:         if ($output =~ m{^/(adm|res)/}) {
                   3941: 	    if ($output =~ m{^/res/}) {
                   3942: 		my $local_name = &Apache::lonnet::filelocation('',$output);
                   3943: 		&Apache::lonnet::repcopy($local_name);
                   3944: 	    }
1.520     raeburn  3945:             $output = &lonhttpdurl($output);
                   3946:         }
1.63      www      3947:     }
1.520     raeburn  3948:     return $output;
1.63      www      3949: }
1.59      www      3950: 
1.60      matthew  3951: ###############################################
                   3952: ###############################################
                   3953: 
                   3954: =pod
                   3955: 
1.112     bowersj2 3956: =back
                   3957: 
1.549     albertel 3958: =head1 HTML Helpers
1.112     bowersj2 3959: 
                   3960: =over 4
                   3961: 
                   3962: =item * &bodytag()
1.60      matthew  3963: 
                   3964: Returns a uniform header for LON-CAPA web pages.
                   3965: 
                   3966: Inputs: 
                   3967: 
1.112     bowersj2 3968: =over 4
                   3969: 
                   3970: =item * $title, A title to be displayed on the page.
                   3971: 
                   3972: =item * $function, the current role (can be undef).
                   3973: 
                   3974: =item * $addentries, extra parameters for the <body> tag.
                   3975: 
                   3976: =item * $bodyonly, if defined, only return the <body> tag.
                   3977: 
                   3978: =item * $domain, if defined, force a given domain.
                   3979: 
                   3980: =item * $forcereg, if page should register as content page (relevant for 
1.86      www      3981:             text interface only)
1.60      matthew  3982: 
1.326     albertel 3983: =item * $customtitle, alternate text to use instead of $title
                   3984:                       in the title box that appears, this text
                   3985:                       is not auto translated like the $title is
1.309     albertel 3986: 
                   3987: =item * $notopbar, if true, keep the 'what is this' info but remove the
                   3988:                    navigational links
1.317     albertel 3989: 
1.338     albertel 3990: =item * $bgcolor, used to override the bgcolor on a webpage to a specific value
                   3991: 
                   3992: =item * $notitle, if true keep the nav controls, but remove the title bar
                   3993: 
1.361     albertel 3994: =item * $no_inline_link, if true and in remote mode, don't show the 
                   3995:          'Switch To Inline Menu' link
                   3996: 
1.460     albertel 3997: =item * $args, optional argument valid values are
                   3998:             no_auto_mt_title -> prevents &mt()ing the title arg
1.562     albertel 3999:             inherit_jsmath -> when creating popup window in a page,
                   4000:                               should it have jsmath forced on by the
                   4001:                               current page
1.460     albertel 4002: 
1.112     bowersj2 4003: =back
                   4004: 
1.60      matthew  4005: Returns: A uniform header for LON-CAPA web pages.  
                   4006: If $bodyonly is nonzero, a string containing a <body> tag will be returned.
                   4007: If $bodyonly is undef or zero, an html string containing a <body> tag and 
                   4008: other decorations will be returned.
                   4009: 
                   4010: =cut
                   4011: 
1.54      www      4012: sub bodytag {
1.309     albertel 4013:     my ($title,$function,$addentries,$bodyonly,$domain,$forcereg,$customtitle,
1.460     albertel 4014: 	$notopbar,$bgcolor,$notitle,$no_inline_link,$args)=@_;
1.339     albertel 4015: 
1.460     albertel 4016:     if (!$args->{'no_auto_mt_title'}) { $title = &mt($title); }
1.339     albertel 4017: 
1.183     matthew  4018:     $function = &get_users_function() if (!$function);
1.339     albertel 4019:     my $img =    &designparm($function.'.img',$domain);
                   4020:     my $font =   &designparm($function.'.font',$domain);
                   4021:     my $pgbg   = $bgcolor || &designparm($function.'.pgbg',$domain);
                   4022: 
                   4023:     my %design = ( 'style'   => 'margin-top: 0px',
1.535     albertel 4024: 		   'bgcolor' => $pgbg,
1.339     albertel 4025: 		   'text'    => $font,
                   4026:                    'alink'   => &designparm($function.'.alink',$domain),
                   4027: 		   'vlink'   => &designparm($function.'.vlink',$domain),
                   4028: 		   'link'    => &designparm($function.'.link',$domain),);
1.438     albertel 4029:     @design{keys(%$addentries)} = @$addentries{keys(%$addentries)}; 
1.339     albertel 4030: 
1.63      www      4031:  # role and realm
1.378     raeburn  4032:     my ($role,$realm) = split(/\./,$env{'request.role'},2);
                   4033:     if ($role  eq 'ca') {
1.479     albertel 4034:         my ($rdom,$rname) = ($realm =~ m{^/($match_domain)/($match_username)$});
1.500     albertel 4035:         $realm = &plainname($rname,$rdom);
1.378     raeburn  4036:     } 
1.55      www      4037: # realm
1.258     albertel 4038:     if ($env{'request.course.id'}) {
1.378     raeburn  4039:         if ($env{'request.role'} !~ /^cr/) {
                   4040:             $role = &Apache::lonnet::plaintext($role,&course_type());
                   4041:         }
1.359     albertel 4042: 	$realm = $env{'course.'.$env{'request.course.id'}.'.description'};
1.378     raeburn  4043:     } else {
                   4044:         $role = &Apache::lonnet::plaintext($role);
1.54      www      4045:     }
1.433     albertel 4046: 
1.359     albertel 4047:     if (!$realm) { $realm='&nbsp;'; }
1.55      www      4048: # Set messages
1.60      matthew  4049:     my $messages=&domainlogo($domain);
1.330     albertel 4050: 
1.438     albertel 4051:     my $extra_body_attr = &make_attr_string($forcereg,\%design);
1.329     albertel 4052: 
1.101     www      4053: # construct main body tag
1.359     albertel 4054:     my $bodytag = "<body $extra_body_attr>".
1.562     albertel 4055: 	&Apache::lontexconvert::init_math_support($args->{'inherit_jsmath'});
1.252     albertel 4056: 
1.530     albertel 4057:     if ($bodyonly) {
1.60      matthew  4058:         return $bodytag;
1.258     albertel 4059:     } elsif ($env{'browser.interface'} eq 'textual') {
1.95      www      4060: # Accessibility
1.224     raeburn  4061:           
1.337     albertel 4062: 	$bodytag.=&Apache::lonmenu::menubuttons($forcereg,$forcereg);
1.338     albertel 4063: 	if (!$notitle) {
1.337     albertel 4064: 	    $bodytag.='<h1>LON-CAPA: '.$title.'</h1>';
                   4065: 	}
                   4066: 	return $bodytag;
1.359     albertel 4067:     }
                   4068: 
1.410     albertel 4069:     my $name = &plainname($env{'user.name'},$env{'user.domain'});
1.433     albertel 4070:     if ($env{'user.name'} eq 'public' && $env{'user.domain'} eq 'public') {
                   4071: 	undef($role);
1.434     albertel 4072:     } else {
                   4073: 	$name = &aboutmewrapper($name,$env{'user.name'},$env{'user.domain'});
1.433     albertel 4074:     }
1.359     albertel 4075:     
                   4076:     my $roleinfo=(<<ENDROLE);
                   4077: <td class="LC_title_bar_who">
                   4078: <div class="LC_title_bar_name">
1.410     albertel 4079:     $name
1.361     albertel 4080:     &nbsp;
1.359     albertel 4081: </div>
                   4082: <div class="LC_title_bar_role">
1.361     albertel 4083: $role&nbsp;
1.359     albertel 4084: </div>
                   4085: <div class="LC_title_bar_realm">
1.361     albertel 4086: $realm&nbsp;
1.359     albertel 4087: </div>
1.206     albertel 4088: </td>
                   4089: ENDROLE
1.235     raeburn  4090: 
1.359     albertel 4091:     my $titleinfo = '<span class="LC_title_bar_title">'.$title.'</span>';
                   4092:     if ($customtitle) {
                   4093:         $titleinfo = $customtitle;
                   4094:     }
                   4095:     #
                   4096:     # Extra info if you are the DC
                   4097:     my $dc_info = '';
                   4098:     if ($env{'user.adv'} && exists($env{'user.role.dc./'.
                   4099:                         $env{'course.'.$env{'request.course.id'}.
                   4100:                                  '.domain'}.'/'})) {
                   4101:         my $cid = $env{'request.course.id'};
                   4102:         $dc_info.= $cid.' '.$env{'course.'.$cid.'.internal.coursecode'};
1.380     www      4103:         $dc_info =~ s/\s+$//;
1.359     albertel 4104:         $dc_info = '('.$dc_info.')';
                   4105:     }
                   4106: 
1.644     www      4107:     if (($env{'environment.remote'} eq 'off') || ($args->{'suppress_header_logos'})) {
1.359     albertel 4108:         # No Remote
1.258     albertel 4109: 	if ($env{'request.state'} eq 'construct') {
1.359     albertel 4110: 	    $forcereg=1;
                   4111: 	}
                   4112: 
                   4113: 	if (!$customtitle && $env{'request.state'} eq 'construct') {
                   4114: 	    # this is for resources; directories have customtitle, and crumbs
                   4115:             # and select recent are created in lonpubdir.pm  
1.229     albertel 4116: 	    my ($uname,$thisdisfn)=
1.258     albertel 4117: 		($env{'request.filename'} =~ m|^/home/([^/]+)/public_html/(.*)|);
1.229     albertel 4118: 	    my $formaction='/priv/'.$uname.'/'.$thisdisfn;
                   4119: 	    $formaction=~s/\/+/\//g;
                   4120: 
1.359     albertel 4121: 	    my $parentpath = '';
                   4122: 	    my $lastitem = '';
                   4123: 	    if ($thisdisfn =~ m-(.+/)([^/]*)$-) {
                   4124: 		$parentpath = $1;
                   4125: 		$lastitem = $2;
                   4126: 	    } else {
                   4127: 		$lastitem = $thisdisfn;
                   4128: 	    }
                   4129: 	    $titleinfo = 
1.640     bisitz   4130: 		&Apache::loncommon::help_open_menu('','',3,'Authoring')
                   4131: 		.'<b>'.&mt('Construction Space').'</b>:&nbsp;'
                   4132: 		.'<form name="dirs" method="post" action="'.$formaction
1.359     albertel 4133: 		.'" target="_top"><tt><b>'
                   4134: 		.&Apache::lonhtmlcommon::crumbs($uname.'/'.$parentpath,'_top','/priv','','+1',1)."<font size=\"+1\">$lastitem</font></b></tt><br />"
                   4135: 		.&Apache::lonhtmlcommon::select_recent('construct','recent','this.form.action=this.form.recent.value;this.form.submit()')
                   4136: 		.'</form>'
                   4137: 		.&Apache::lonmenu::constspaceform();
1.235     raeburn  4138:         }
1.359     albertel 4139: 
1.337     albertel 4140:         my $titletable;
1.338     albertel 4141: 	if (!$notitle) {
1.337     albertel 4142: 	    $titletable =
1.359     albertel 4143: 		'<table id="LC_title_bar">'.
                   4144:                          "<tr><td> $titleinfo $dc_info</td>".$roleinfo.
                   4145: 			 '</tr></table>';
1.337     albertel 4146: 	}
1.359     albertel 4147: 	if ($notopbar) {
                   4148: 	    $bodytag .= $titletable;
                   4149: 	} else {
                   4150: 	    if ($env{'request.state'} eq 'construct') {
1.337     albertel 4151:                 $bodytag .= &Apache::lonmenu::menubuttons($forcereg,$forcereg,
                   4152: 							  $titletable);
1.272     raeburn  4153:             } else {
1.336     albertel 4154:                 $bodytag .= &Apache::lonmenu::menubuttons($forcereg,$forcereg).
1.359     albertel 4155: 		    $titletable;
1.272     raeburn  4156:             }
1.235     raeburn  4157:         }
                   4158:         return $bodytag;
1.94      www      4159:     }
1.95      www      4160: 
1.93      www      4161: #
1.95      www      4162: # Top frame rendering, Remote is up
1.93      www      4163: #
1.359     albertel 4164: 
1.517     raeburn  4165:     my $imgsrc = $img;
                   4166:     if ($img =~ /^\/adm/) {
1.575     albertel 4167:         $imgsrc = &lonhttpdurl($img);
1.517     raeburn  4168:     }
                   4169:     my $upperleft='<img src="'.$imgsrc.'" alt="'.$function.'" />';
1.359     albertel 4170: 
1.305     www      4171:     # Explicit link to get inline menu
1.361     albertel 4172:     my $menu= ($no_inline_link?''
                   4173: 	       :'<br /><a href="/adm/remote?action=collapse">'.&mt('Switch to Inline Menu Mode').'</a>');
1.245     matthew  4174:     #
1.338     albertel 4175:     if ($notitle) {
1.337     albertel 4176: 	return $bodytag;
                   4177:     }
1.94      www      4178:     return(<<ENDBODY);
1.60      matthew  4179: $bodytag
1.359     albertel 4180: <table id="LC_title_bar" class="LC_with_remote">
1.368     albertel 4181: <tr><td class="LC_title_bar_role_logo">$upperleft</td>
1.359     albertel 4182:     <td class="LC_title_bar_domain_logo">$messages&nbsp;</td>
1.54      www      4183: </tr>
1.359     albertel 4184: <tr><td>$titleinfo $dc_info $menu</td>
                   4185: $roleinfo
1.368     albertel 4186: </tr>
1.356     albertel 4187: </table>
1.54      www      4188: ENDBODY
1.182     matthew  4189: }
                   4190: 
1.330     albertel 4191: sub make_attr_string {
                   4192:     my ($register,$attr_ref) = @_;
                   4193: 
                   4194:     if ($attr_ref && !ref($attr_ref)) {
                   4195: 	die("addentries Must be a hash ref ".
                   4196: 	    join(':',caller(1))." ".
                   4197: 	    join(':',caller(0))." ");
                   4198:     }
                   4199: 
                   4200:     if ($register) {
1.339     albertel 4201: 	my ($on_load,$on_unload);
                   4202: 	foreach my $key (keys(%{$attr_ref})) {
                   4203: 	    if      (lc($key) eq 'onload') {
                   4204: 		$on_load.=$attr_ref->{$key}.';';
                   4205: 		delete($attr_ref->{$key});
                   4206: 
                   4207: 	    } elsif (lc($key) eq 'onunload') {
                   4208: 		$on_unload.=$attr_ref->{$key}.';';
                   4209: 		delete($attr_ref->{$key});
                   4210: 	    }
                   4211: 	}
                   4212: 	$attr_ref->{'onload'}  =
                   4213: 	    &Apache::lonmenu::loadevents().  $on_load;
                   4214: 	$attr_ref->{'onunload'}=
                   4215: 	    &Apache::lonmenu::unloadevents().$on_unload;
                   4216:     }
                   4217: 
                   4218: # Accessibility font enhance
                   4219:     if ($env{'browser.fontenhance'} eq 'on') {
                   4220: 	my $style;
                   4221: 	foreach my $key (keys(%{$attr_ref})) {
                   4222: 	    if (lc($key) eq 'style') {
                   4223: 		$style.=$attr_ref->{$key}.';';
                   4224: 		delete($attr_ref->{$key});
                   4225: 	    }
                   4226: 	}
                   4227: 	$attr_ref->{'style'}=$style.'; font-size: x-large;';
1.330     albertel 4228:     }
1.339     albertel 4229: 
                   4230:     if ($env{'browser.blackwhite'} eq 'on') {
                   4231: 	delete($attr_ref->{'font'});
                   4232: 	delete($attr_ref->{'link'});
                   4233: 	delete($attr_ref->{'alink'});
                   4234: 	delete($attr_ref->{'vlink'});
                   4235: 	delete($attr_ref->{'bgcolor'});
                   4236: 	delete($attr_ref->{'background'});
                   4237:     }
                   4238: 
1.330     albertel 4239:     my $attr_string;
                   4240:     foreach my $attr (keys(%$attr_ref)) {
                   4241: 	$attr_string .= " $attr=\"".$attr_ref->{$attr}.'" ';
                   4242:     }
                   4243:     return $attr_string;
                   4244: }
                   4245: 
                   4246: 
1.182     matthew  4247: ###############################################
1.251     albertel 4248: ###############################################
                   4249: 
                   4250: =pod
                   4251: 
                   4252: =item * &endbodytag()
                   4253: 
                   4254: Returns a uniform footer for LON-CAPA web pages.
                   4255: 
1.635     raeburn  4256: Inputs: 1 - optional reference to an args hash
                   4257: If in the hash, key for noredirectlink has a value which evaluates to true,
                   4258: a 'Continue' link is not displayed if the page contains an
                   4259: internal redirect in the <head></head> section,
                   4260: i.e., $env{'internal.head.redirect'} exists   
1.251     albertel 4261: 
                   4262: =cut
                   4263: 
                   4264: sub endbodytag {
1.635     raeburn  4265:     my ($args) = @_;
1.251     albertel 4266:     my $endbodytag='</body>';
1.269     albertel 4267:     $endbodytag=&Apache::lontexconvert::jsMath_process()."\n".$endbodytag;
1.315     albertel 4268:     if ( exists( $env{'internal.head.redirect'} ) ) {
1.635     raeburn  4269:         if (!(ref($args) eq 'HASH' && $args->{'noredirectlink'})) {
                   4270: 	    $endbodytag=
                   4271: 	        "<br /><a href=\"$env{'internal.head.redirect'}\">".
                   4272: 	        &mt('Continue').'</a>'.
                   4273: 	        $endbodytag;
                   4274:         }
1.315     albertel 4275:     }
1.251     albertel 4276:     return $endbodytag;
                   4277: }
                   4278: 
1.352     albertel 4279: =pod
                   4280: 
                   4281: =item * &standard_css()
                   4282: 
                   4283: Returns a style sheet
                   4284: 
                   4285: Inputs: (all optional)
                   4286:             domain         -> force to color decorate a page for a specific
                   4287:                                domain
                   4288:             function       -> force usage of a specific rolish color scheme
                   4289:             bgcolor        -> override the default page bgcolor
                   4290: 
                   4291: =cut
                   4292: 
1.343     albertel 4293: sub standard_css {
1.345     albertel 4294:     my ($function,$domain,$bgcolor) = @_;
1.352     albertel 4295:     $function  = &get_users_function() if (!$function);
                   4296:     my $img    = &designparm($function.'.img',   $domain);
                   4297:     my $tabbg  = &designparm($function.'.tabbg', $domain);
                   4298:     my $font   = &designparm($function.'.font',  $domain);
1.345     albertel 4299:     my $sidebg = &designparm($function.'.sidebg',$domain);
1.382     albertel 4300:     my $pgbg_or_bgcolor =
                   4301: 	         $bgcolor ||
1.352     albertel 4302: 	         &designparm($function.'.pgbg',  $domain);
1.382     albertel 4303:     my $pgbg   = &designparm($function.'.pgbg',  $domain);
1.352     albertel 4304:     my $alink  = &designparm($function.'.alink', $domain);
                   4305:     my $vlink  = &designparm($function.'.vlink', $domain);
                   4306:     my $link   = &designparm($function.'.link',  $domain);
                   4307: 
1.602     albertel 4308:     my $sans                 = 'Verdana,Arial,Helvetica,sans-serif';
1.395     albertel 4309:     my $mono                 = 'monospace';
1.352     albertel 4310:     my $data_table_head      = $tabbg;
                   4311:     my $data_table_light     = '#EEEEEE';
1.470     banghart 4312:     my $data_table_dark      = '#DDDDDD';
                   4313:     my $data_table_darker    = '#CCCCCC';
1.349     albertel 4314:     my $data_table_highlight = '#FFFF00';
1.352     albertel 4315:     my $mail_new             = '#FFBB77';
                   4316:     my $mail_new_hover       = '#DD9955';
                   4317:     my $mail_read            = '#BBBB77';
                   4318:     my $mail_read_hover      = '#999944';
                   4319:     my $mail_replied         = '#AAAA88';
                   4320:     my $mail_replied_hover   = '#888855';
                   4321:     my $mail_other           = '#99BBBB';
                   4322:     my $mail_other_hover     = '#669999';
1.391     albertel 4323:     my $table_header         = '#DDDDDD';
1.489     raeburn  4324:     my $feedback_link_bg     = '#BBBBBB';
1.392     albertel 4325: 
1.608     albertel 4326:     my $border = ($env{'browser.type'} eq 'explorer' ||
                   4327: 		  $env{'browser.type'} eq 'safari'     ) ? '0px 2px 0px 2px'
                   4328: 	                                                 : '0px 3px 0px 4px';
1.448     albertel 4329: 
1.523     albertel 4330: 
1.343     albertel 4331:     return <<END;
1.345     albertel 4332: h1, h2, h3, th { font-family: $sans }
1.343     albertel 4333: a:focus { color: red; background: yellow } 
1.510     albertel 4334: table.thinborder,
1.523     albertel 4335: 
1.510     albertel 4336: table.thinborder tr th {
                   4337:   border-style: solid;
                   4338:   border-width: 1px;
                   4339:   background: $tabbg;
                   4340: }
1.523     albertel 4341: table.thinborder tr td {
1.510     albertel 4342:   border-style: solid;
                   4343:   border-width: 1px
                   4344: }
1.426     albertel 4345: 
1.343     albertel 4346: form, .inline { display: inline; }
                   4347: .center { text-align: center; }
1.593     albertel 4348: .LC_filename {font-family: $mono; white-space:pre;}
1.350     albertel 4349: .LC_error {
                   4350:   color: red;
                   4351:   font-size: larger;
                   4352: }
1.457     albertel 4353: .LC_warning,
                   4354: .LC_diff_removed {
1.394     albertel 4355:   color: red;
                   4356: }
1.532     albertel 4357: 
                   4358: .LC_info,
1.457     albertel 4359: .LC_success,
                   4360: .LC_diff_added {
1.350     albertel 4361:   color: green;
                   4362: }
1.543     albertel 4363: .LC_unknown {
                   4364:   color: yellow;
                   4365: }
                   4366: 
1.440     albertel 4367: .LC_icon {
                   4368:   border: 0px;
                   4369: }
1.539     albertel 4370: .LC_indexer_icon {
                   4371:   border: 0px;
                   4372:   height: 22px;
                   4373: }
1.543     albertel 4374: .LC_docs_spacer {
                   4375:   width: 25px;
                   4376:   height: 1px;
                   4377:   border: 0px;
                   4378: }
1.346     albertel 4379: 
1.532     albertel 4380: .LC_internal_info {
                   4381:   color: #999;
                   4382: }
                   4383: 
1.458     albertel 4384: table.LC_pastsubmission {
                   4385:   border: 1px solid black;
                   4386:   margin: 2px;
                   4387: }
                   4388: 
1.606     albertel 4389: table#LC_top_nav, table#LC_menubuttons,table#LC_nav_location {
1.345     albertel 4390:   width: 100%;
                   4391:   background: $pgbg;
1.392     albertel 4392:   border: 2px;
1.402     albertel 4393:   border-collapse: separate;
1.403     albertel 4394:   padding: 0px;
1.345     albertel 4395: }
1.392     albertel 4396: 
1.606     albertel 4397: table#LC_title_bar, table.LC_breadcrumbs, 
1.393     albertel 4398: table#LC_title_bar.LC_with_remote {
1.359     albertel 4399:   width: 100%;
1.392     albertel 4400:   border-color: $pgbg;
                   4401:   border-style: solid;
                   4402:   border-width: $border;
                   4403: 
1.379     albertel 4404:   background: $pgbg;
                   4405:   font-family: $sans;
1.392     albertel 4406:   border-collapse: collapse;
1.403     albertel 4407:   padding: 0px;
1.359     albertel 4408: }
1.392     albertel 4409: 
1.409     albertel 4410: table.LC_docs_path {
                   4411:   width: 100%;
                   4412:   border: 0;
                   4413:   background: $pgbg;
                   4414:   font-family: $sans;
                   4415:   border-collapse: collapse;
                   4416:   padding: 0px;
                   4417: }
                   4418: 
1.359     albertel 4419: table#LC_title_bar td {
                   4420:   background: $tabbg;
                   4421: }
                   4422: table#LC_title_bar td.LC_title_bar_who {
                   4423:   background: $tabbg;
                   4424:   color: $font;
1.427     albertel 4425:   font: small $sans;
1.359     albertel 4426:   text-align: right;
                   4427: }
1.469     banghart 4428: span.LC_metadata {
                   4429:     font-family: $sans;
                   4430: }
1.359     albertel 4431: span.LC_title_bar_title {
1.416     albertel 4432:   font: bold x-large $sans;
1.359     albertel 4433: }
                   4434: table#LC_title_bar td.LC_title_bar_domain_logo {
                   4435:   background: $sidebg;
                   4436:   text-align: right;
1.368     albertel 4437:   padding: 0px;
                   4438: }
                   4439: table#LC_title_bar td.LC_title_bar_role_logo {
                   4440:   background: $sidebg;
                   4441:   padding: 0px;
1.359     albertel 4442: }
                   4443: 
1.346     albertel 4444: table#LC_menubuttons_mainmenu {
1.526     www      4445:   width: 100%;
1.346     albertel 4446:   border: 0px;
                   4447:   border-spacing: 1px;
1.372     albertel 4448:   padding: 0px 1px;
1.346     albertel 4449:   margin: 0px;
                   4450:   border-collapse: separate;
                   4451: }
                   4452: table#LC_menubuttons img, table#LC_menubuttons_mainmenu img {
                   4453:   border: 0px;
                   4454: }
1.345     albertel 4455: table#LC_top_nav td {
                   4456:   background: $tabbg;
1.392     albertel 4457:   border: 0px;
1.407     albertel 4458:   font-size: small;
1.345     albertel 4459: }
                   4460: table#LC_top_nav td a, div#LC_top_nav a {
                   4461:   color: $font;
                   4462:   font-family: $sans;
                   4463: }
1.364     albertel 4464: table#LC_top_nav td.LC_top_nav_logo {
                   4465:   background: $tabbg;
1.432     albertel 4466:   text-align: left;
1.408     albertel 4467:   white-space: nowrap;
1.432     albertel 4468:   width: 31px;
1.408     albertel 4469: }
                   4470: table#LC_top_nav td.LC_top_nav_logo img {
1.432     albertel 4471:   border: 0px;
1.408     albertel 4472:   vertical-align: bottom;
1.364     albertel 4473: }
1.432     albertel 4474: table#LC_top_nav td.LC_top_nav_exit,
                   4475: table#LC_top_nav td.LC_top_nav_help {
                   4476:   width: 2.0em;
                   4477: }
1.442     albertel 4478: table#LC_top_nav td.LC_top_nav_login {
                   4479:   width: 4.0em;
                   4480:   text-align: center;
                   4481: }
1.409     albertel 4482: table.LC_breadcrumbs td, table.LC_docs_path td  {
1.357     albertel 4483:   background: $tabbg;
                   4484:   color: $font;
                   4485:   font-family: $sans;
1.358     albertel 4486:   font-size: smaller;
1.357     albertel 4487: }
1.411     albertel 4488: table.LC_breadcrumbs td.LC_breadcrumbs_component,
1.409     albertel 4489: table.LC_docs_path td.LC_docs_path_component {
1.357     albertel 4490:   background: $tabbg;
                   4491:   color: $font;
                   4492:   font-family: $sans;
                   4493:   font-size: larger;
                   4494:   text-align: right;
                   4495: }
1.383     albertel 4496: td.LC_table_cell_checkbox {
                   4497:   text-align: center;
                   4498: }
                   4499: 
1.522     albertel 4500: table#LC_mainmenu td.LC_mainmenu_column {
                   4501:     vertical-align: top;
                   4502: }
                   4503: 
1.346     albertel 4504: .LC_menubuttons_inline_text {
                   4505:   color: $font;
                   4506:   font-family: $sans;
                   4507:   font-size: smaller;
                   4508: }
                   4509: 
1.526     www      4510: .LC_menubuttons_link {
                   4511:   text-decoration: none;
                   4512: }
                   4513: 
1.522     albertel 4514: .LC_menubuttons_category {
1.521     www      4515:   color: $font;
1.526     www      4516:   background: $pgbg;
1.521     www      4517:   font-family: $sans;
                   4518:   font-size: larger;
                   4519:   font-weight: bold;
                   4520: }
                   4521: 
1.346     albertel 4522: td.LC_menubuttons_text {
1.526     www      4523:   width: 90%;
1.346     albertel 4524:   color: $font;
                   4525:   font-family: $sans;
                   4526: }
1.526     www      4527: 
1.346     albertel 4528: td.LC_menubuttons_img {
                   4529: }
1.526     www      4530: 
1.346     albertel 4531: .LC_current_location {
                   4532:   font-family: $sans;
                   4533:   background: $tabbg;
                   4534: }
                   4535: .LC_new_mail {
                   4536:   font-family: $sans;
1.634     www      4537:   background: $tabbg;
1.346     albertel 4538:   font-weight: bold;
                   4539: }
1.347     albertel 4540: 
1.526     www      4541: .LC_rolesmenu_is {
                   4542:   font-family: $sans;
                   4543: }
                   4544: 
                   4545: .LC_rolesmenu_selected {
                   4546:   font-family: $sans;
                   4547: }
                   4548: 
                   4549: .LC_rolesmenu_future {
                   4550:   font-family: $sans;
                   4551: }
                   4552: 
                   4553: 
                   4554: .LC_rolesmenu_will {
                   4555:   font-family: $sans;
                   4556: }
                   4557: 
                   4558: .LC_rolesmenu_will_not {
                   4559:   font-family: $sans;
                   4560: }
                   4561: 
                   4562: .LC_rolesmenu_expired {
                   4563:   font-family: $sans;
                   4564: }
                   4565: 
                   4566: .LC_rolesinfo {
                   4567:   font-family: $sans;
                   4568: }
                   4569: 
1.527     www      4570: .LC_dropadd_labeltext {
                   4571:   font-family: $sans;
                   4572:   text-align: right;
                   4573: }
                   4574: 
                   4575: .LC_preferences_labeltext {
                   4576:   font-family: $sans;
                   4577:   text-align: right;
                   4578: }
                   4579: 
1.440     albertel 4580: table.LC_aboutme_port {
                   4581:   border: 0px;
                   4582:   border-collapse: collapse;
                   4583:   border-spacing: 0px;
                   4584: }
1.349     albertel 4585: table.LC_data_table, table.LC_mail_list {
1.347     albertel 4586:   border: 1px solid #000000;
1.402     albertel 4587:   border-collapse: separate;
1.426     albertel 4588:   border-spacing: 1px;
1.610     albertel 4589:   background: $pgbg;
1.347     albertel 4590: }
1.422     albertel 4591: .LC_data_table_dense {
                   4592:   font-size: small;
                   4593: }
1.507     raeburn  4594: table.LC_nested_outer {
                   4595:   border: 1px solid #000000;
1.589     raeburn  4596:   border-collapse: collapse;
1.507     raeburn  4597:   border-spacing: 0px;
                   4598:   width: 100%;
                   4599: }
                   4600: table.LC_nested {
                   4601:   border: 0px;
1.589     raeburn  4602:   border-collapse: collapse;
1.507     raeburn  4603:   border-spacing: 0px;
                   4604:   width: 100%;
                   4605: }
1.523     albertel 4606: table.LC_data_table tr th, table.LC_calendar tr th, table.LC_mail_list tr th,
                   4607: table.LC_prior_tries tr th {
1.349     albertel 4608:   font-weight: bold;
                   4609:   background-color: $data_table_head;
1.421     albertel 4610:   font-size: smaller;
1.347     albertel 4611: }
1.610     albertel 4612: table.LC_data_table tr.LC_odd_row > td, 
1.440     albertel 4613: table.LC_aboutme_port tr td {
1.349     albertel 4614:   background-color: $data_table_light;
1.425     albertel 4615:   padding: 2px;
1.347     albertel 4616: }
1.610     albertel 4617: table.LC_data_table tr.LC_even_row > td,
1.440     albertel 4618: table.LC_aboutme_port tr.LC_even_row td {
1.349     albertel 4619:   background-color: $data_table_dark;
1.347     albertel 4620: }
1.425     albertel 4621: table.LC_data_table tr.LC_data_table_highlight td {
                   4622:   background-color: $data_table_darker;
                   4623: }
1.639     raeburn  4624: table.LC_data_table tr td.LC_leftcol_header {
                   4625:   background-color: $data_table_head;
                   4626:   font-weight: bold;
                   4627: }
1.451     albertel 4628: table.LC_data_table tr.LC_empty_row td,
1.507     raeburn  4629: table.LC_nested tr.LC_empty_row td {
1.347     albertel 4630:   background-color: #FFFFFF;
1.421     albertel 4631:   font-weight: bold;
                   4632:   font-style: italic;
                   4633:   text-align: center;
                   4634:   padding: 8px;
1.347     albertel 4635: }
1.507     raeburn  4636: table.LC_nested tr.LC_empty_row td {
1.465     albertel 4637:   padding: 4ex
                   4638: }
1.507     raeburn  4639: table.LC_nested_outer tr th {
                   4640:   font-weight: bold;
                   4641:   background-color: $data_table_head;
                   4642:   font-size: smaller;
                   4643:   border-bottom: 1px solid #000000;
                   4644: }
                   4645: table.LC_nested_outer tr td.LC_subheader {
                   4646:   background-color: $data_table_head;
                   4647:   font-weight: bold;
                   4648:   font-size: small;
                   4649:   border-bottom: 1px solid #000000;
                   4650:   text-align: right;
1.451     albertel 4651: }
1.507     raeburn  4652: table.LC_nested tr.LC_info_row td {
1.451     albertel 4653:   background-color: #CCC;
                   4654:   font-weight: bold;
                   4655:   font-size: small;
1.507     raeburn  4656:   text-align: center;
                   4657: }
1.589     raeburn  4658: table.LC_nested tr.LC_info_row td.LC_left_item,
                   4659: table.LC_nested_outer tr th.LC_left_item {
1.507     raeburn  4660:   text-align: left;
1.451     albertel 4661: }
1.507     raeburn  4662: table.LC_nested td {
1.451     albertel 4663:   background-color: #FFF;
                   4664:   font-size: small;
1.507     raeburn  4665: }
                   4666: table.LC_nested_outer tr th.LC_right_item,
                   4667: table.LC_nested tr.LC_info_row td.LC_right_item,
                   4668: table.LC_nested tr.LC_odd_row td.LC_right_item,
                   4669: table.LC_nested tr td.LC_right_item {
1.451     albertel 4670:   text-align: right;
                   4671: }
                   4672: 
1.507     raeburn  4673: table.LC_nested tr.LC_odd_row td {
1.451     albertel 4674:   background-color: #EEE;
                   4675: }
                   4676: 
1.473     raeburn  4677: table.LC_createuser {
                   4678: }
                   4679: 
                   4680: table.LC_createuser tr.LC_section_row td {
                   4681:   font-size: smaller;
                   4682: }
                   4683: 
                   4684: table.LC_createuser tr.LC_info_row td  {
                   4685:   background-color: #CCC;
                   4686:   font-weight: bold;
                   4687:   text-align: center;
                   4688: }
                   4689: 
1.349     albertel 4690: table.LC_calendar {
                   4691:   border: 1px solid #000000;
                   4692:   border-collapse: collapse;
                   4693: }
                   4694: table.LC_calendar_pickdate {
                   4695:   font-size: xx-small;
                   4696: }
                   4697: table.LC_calendar tr td {
                   4698:   border: 1px solid #000000;
                   4699:   vertical-align: top;
                   4700: }
                   4701: table.LC_calendar tr td.LC_calendar_day_empty {
                   4702:   background-color: $data_table_dark;
                   4703: }
                   4704: table.LC_calendar tr td.LC_calendar_day_current {
                   4705:   background-color: $data_table_highlight;
                   4706: }
                   4707: 
                   4708: table.LC_mail_list tr.LC_mail_new {
                   4709:   background-color: $mail_new;
                   4710: }
                   4711: table.LC_mail_list tr.LC_mail_new:hover {
                   4712:   background-color: $mail_new_hover;
                   4713: }
                   4714: table.LC_mail_list tr.LC_mail_read {
                   4715:   background-color: $mail_read;
                   4716: }
                   4717: table.LC_mail_list tr.LC_mail_read:hover {
                   4718:   background-color: $mail_read_hover;
                   4719: }
                   4720: table.LC_mail_list tr.LC_mail_replied {
                   4721:   background-color: $mail_replied;
                   4722: }
                   4723: table.LC_mail_list tr.LC_mail_replied:hover {
                   4724:   background-color: $mail_replied_hover;
                   4725: }
                   4726: table.LC_mail_list tr.LC_mail_other {
                   4727:   background-color: $mail_other;
                   4728: }
                   4729: table.LC_mail_list tr.LC_mail_other:hover {
                   4730:   background-color: $mail_other_hover;
                   4731: }
1.494     raeburn  4732: table.LC_mail_list tr.LC_mail_even {
                   4733: }
                   4734: table.LC_mail_list tr.LC_mail_odd {
                   4735: }
                   4736: 
1.385     albertel 4737: 
1.386     albertel 4738: table#LC_portfolio_actions {
                   4739:   width: auto;
                   4740:   background: $pgbg;
                   4741:   border: 0px;
                   4742:   border-spacing: 2px 2px;
                   4743:   padding: 0px;
                   4744:   margin: 0px;
                   4745:   border-collapse: separate;
                   4746: }
                   4747: table#LC_portfolio_actions td.LC_label {
                   4748:   background: $tabbg;
                   4749:   text-align: right;
                   4750: }
                   4751: table#LC_portfolio_actions td.LC_value {
                   4752:   background: $tabbg;
                   4753: }
1.385     albertel 4754: 
1.391     albertel 4755: table#LC_cstr_controls {
                   4756:   width: 100%;
                   4757:   border-collapse: collapse;
                   4758: }
                   4759: table#LC_cstr_controls tr td {
                   4760:   border: 4px solid $pgbg;
                   4761:   padding: 4px;
                   4762:   text-align: center;
                   4763:   background: $tabbg;
                   4764: }
                   4765: table#LC_cstr_controls tr th {
                   4766:   border: 4px solid $pgbg;
                   4767:   background: $table_header;
                   4768:   text-align: center;
                   4769:   font-family: $sans;
                   4770:   font-size: smaller;
                   4771: }
                   4772: 
1.389     albertel 4773: table#LC_browser {
                   4774:  
                   4775: }
                   4776: table#LC_browser tr th {
1.391     albertel 4777:   background: $table_header;
1.389     albertel 4778: }
1.390     albertel 4779: table#LC_browser tr td {
                   4780:   padding: 2px;
                   4781: }
1.389     albertel 4782: table#LC_browser tr.LC_browser_file,
                   4783: table#LC_browser tr.LC_browser_file_published {
                   4784:   background: #CCFF88;
                   4785: }
                   4786: table#LC_browser tr.LC_browser_file_locked,
                   4787: table#LC_browser tr.LC_browser_file_unpublished {
                   4788:   background: #FFAA99;
1.387     albertel 4789: }
1.389     albertel 4790: table#LC_browser tr.LC_browser_file_obsolete {
                   4791:   background: #AAAAAA;
1.387     albertel 4792: }
1.455     albertel 4793: table#LC_browser tr.LC_browser_file_modified,
                   4794: table#LC_browser tr.LC_browser_file_metamodified {
1.389     albertel 4795:   background: #FFFF77;
1.387     albertel 4796: }
1.389     albertel 4797: table#LC_browser tr.LC_browser_folder {
                   4798:   background: #CCCCFF;
1.387     albertel 4799: }
1.388     albertel 4800: span.LC_current_location {
                   4801:   font-size: x-large;
                   4802:   background: $pgbg;
                   4803: }
1.387     albertel 4804: 
1.395     albertel 4805: span.LC_parm_menu_item {
                   4806:   font-size: larger;
                   4807:   font-family: $sans;
                   4808: }
                   4809: span.LC_parm_scope_all {
                   4810:   color: red;
                   4811: }
                   4812: span.LC_parm_scope_folder {
                   4813:   color: green;
                   4814: }
                   4815: span.LC_parm_scope_resource {
                   4816:   color: orange;
                   4817: }
                   4818: span.LC_parm_part {
                   4819:   color: blue;
                   4820: }
                   4821: span.LC_parm_folder, span.LC_parm_symb {
                   4822:   font-size: x-small;
                   4823:   font-family: $mono;
                   4824:   color: #AAAAAA;
                   4825: }
                   4826: 
1.396     albertel 4827: td.LC_parm_overview_level_menu, td.LC_parm_overview_map_menu,
                   4828: td.LC_parm_overview_parm_selectors, td.LC_parm_overview_parm_restrictions {
                   4829:   border: 1px solid black;
                   4830:   border-collapse: collapse;
                   4831: }
                   4832: table.LC_parm_overview_restrictions td {
                   4833:   border-width: 1px 4px 1px 4px;
                   4834:   border-style: solid;
                   4835:   border-color: $pgbg;
                   4836:   text-align: center;
                   4837: }
                   4838: table.LC_parm_overview_restrictions th {
                   4839:   background: $tabbg;
                   4840:   border-width: 1px 4px 1px 4px;
                   4841:   border-style: solid;
                   4842:   border-color: $pgbg;
                   4843: }
1.398     albertel 4844: table#LC_helpmenu {
                   4845:   border: 0px;
                   4846:   height: 55px;
                   4847:   border-spacing: 0px;
                   4848: }
                   4849: 
                   4850: table#LC_helpmenu fieldset legend {
                   4851:   font-size: larger;
                   4852:   font-weight: bold;
                   4853: }
1.397     albertel 4854: table#LC_helpmenu_links {
                   4855:   width: 100%;
                   4856:   border: 1px solid black;
                   4857:   background: $pgbg;
                   4858:   padding: 0px;
                   4859:   border-spacing: 1px;
                   4860: }
                   4861: table#LC_helpmenu_links tr td {
                   4862:   padding: 1px;
                   4863:   background: $tabbg;
1.399     albertel 4864:   text-align: center;
                   4865:   font-weight: bold;
1.397     albertel 4866: }
1.396     albertel 4867: 
1.397     albertel 4868: table#LC_helpmenu_links a:link, table#LC_helpmenu_links a:visited,
                   4869: table#LC_helpmenu_links a:active {
                   4870:   text-decoration: none;
                   4871:   color: $font;
                   4872: }
                   4873: table#LC_helpmenu_links a:hover {
                   4874:   text-decoration: underline;
                   4875:   color: $vlink;
                   4876: }
1.396     albertel 4877: 
1.417     albertel 4878: .LC_chrt_popup_exists {
                   4879:   border: 1px solid #339933;
                   4880:   margin: -1px;
                   4881: }
                   4882: .LC_chrt_popup_up {
                   4883:   border: 1px solid yellow;
                   4884:   margin: -1px;
                   4885: }
                   4886: .LC_chrt_popup {
                   4887:   border: 1px solid #8888FF;
                   4888:   background: #CCCCFF;
                   4889: }
1.421     albertel 4890: table.LC_pick_box {
                   4891:   border-collapse: separate;
                   4892:   background: white;
                   4893:   border: 1px solid black;
                   4894:   border-spacing: 1px;
                   4895: }
                   4896: table.LC_pick_box td.LC_pick_box_title {
                   4897:   background: $tabbg;
                   4898:   font-weight: bold;
                   4899:   text-align: right;
                   4900:   width: 184px;
                   4901:   padding: 8px;
                   4902: }
1.645     raeburn  4903: table.LC_pick_box td.LC_selfenroll_pick_box_title {
                   4904:   background: $tabbg;
                   4905:   font-weight: bold;
                   4906:   text-align: right;
                   4907:   width: 350px;
                   4908:   padding: 8px;
                   4909: }
                   4910: 
1.579     raeburn  4911: table.LC_pick_box td.LC_pick_box_value {
                   4912:   text-align: left;
                   4913:   padding: 8px;
                   4914: }
                   4915: table.LC_pick_box td.LC_pick_box_select {
                   4916:   text-align: left;
                   4917:   padding: 8px;
                   4918: }
1.424     albertel 4919: table.LC_pick_box td.LC_pick_box_separator {
1.421     albertel 4920:   padding: 0px;
                   4921:   height: 1px;
                   4922:   background: black;
                   4923: }
                   4924: table.LC_pick_box td.LC_pick_box_submit {
                   4925:   text-align: right;
                   4926: }
1.579     raeburn  4927: table.LC_pick_box td.LC_evenrow_value {
                   4928:   text-align: left;
                   4929:   padding: 8px;
                   4930:   background-color: $data_table_light;
                   4931: }
                   4932: table.LC_pick_box td.LC_oddrow_value {
                   4933:   text-align: left;
                   4934:   padding: 8px;
                   4935:   background-color: $data_table_light;
                   4936: }
                   4937: table.LC_helpform_receipt {
                   4938:   width: 620px;
                   4939:   border-collapse: separate;
                   4940:   background: white;
                   4941:   border: 1px solid black;
                   4942:   border-spacing: 1px;
                   4943: }
                   4944: table.LC_helpform_receipt td.LC_pick_box_title {
                   4945:   background: $tabbg;
                   4946:   font-weight: bold;
                   4947:   text-align: right;
                   4948:   width: 184px;
                   4949:   padding: 8px;
                   4950: }
                   4951: table.LC_helpform_receipt td.LC_evenrow_value {
                   4952:   text-align: left;
                   4953:   padding: 8px;
                   4954:   background-color: $data_table_light;
                   4955: }
                   4956: table.LC_helpform_receipt td.LC_oddrow_value {
                   4957:   text-align: left;
                   4958:   padding: 8px;
                   4959:   background-color: $data_table_light;
                   4960: }
                   4961: table.LC_helpform_receipt td.LC_pick_box_separator {
                   4962:   padding: 0px;
                   4963:   height: 1px;
                   4964:   background: black;
                   4965: }
                   4966: span.LC_helpform_receipt_cat {
                   4967:   font-weight: bold;
                   4968: }
1.424     albertel 4969: table.LC_group_priv_box {
                   4970:   background: white;
                   4971:   border: 1px solid black;
                   4972:   border-spacing: 1px;
                   4973: }
                   4974: table.LC_group_priv_box td.LC_pick_box_title {
                   4975:   background: $tabbg;
                   4976:   font-weight: bold;
                   4977:   text-align: right;
                   4978:   width: 184px;
                   4979: }
                   4980: table.LC_group_priv_box td.LC_groups_fixed {
                   4981:   background: $data_table_light;
                   4982:   text-align: center;
                   4983: }
                   4984: table.LC_group_priv_box td.LC_groups_optional {
                   4985:   background: $data_table_dark;
                   4986:   text-align: center;
                   4987: }
                   4988: table.LC_group_priv_box td.LC_groups_functionality {
                   4989:   background: $data_table_darker;
                   4990:   text-align: center;
                   4991:   font-weight: bold;
                   4992: }
                   4993: table.LC_group_priv td {
                   4994:   text-align: left;
                   4995:   padding: 0px;
                   4996: }
                   4997: 
1.421     albertel 4998: table.LC_notify_front_page {
                   4999:   background: white;
                   5000:   border: 1px solid black;
                   5001:   padding: 8px;
                   5002: }
                   5003: table.LC_notify_front_page td {
                   5004:   padding: 8px;
                   5005: }
1.424     albertel 5006: .LC_navbuttons {
                   5007:   margin: 2ex 0ex 2ex 0ex;
                   5008: }
1.423     albertel 5009: .LC_topic_bar {
                   5010:   font-family: $sans;
                   5011:   font-weight: bold;
                   5012:   width: 100%;
                   5013:   background: $tabbg;
                   5014:   vertical-align: middle;
                   5015:   margin: 2ex 0ex 2ex 0ex;
                   5016: }
                   5017: .LC_topic_bar span {
                   5018:   vertical-align: middle;
                   5019: }
                   5020: .LC_topic_bar img {
                   5021:   vertical-align: bottom;
                   5022: }
                   5023: table.LC_course_group_status {
                   5024:   margin: 20px;
                   5025: }
                   5026: table.LC_status_selector td {
                   5027:   vertical-align: top;
                   5028:   text-align: center;
1.424     albertel 5029:   padding: 4px;
                   5030: }
                   5031: table.LC_descriptive_input td.LC_description {
                   5032:   vertical-align: top;
                   5033:   text-align: right;
                   5034:   font-weight: bold;
1.423     albertel 5035: }
1.599     albertel 5036: div.LC_feedback_link {
1.616     albertel 5037:   clear: both;
1.599     albertel 5038:   background: white;
                   5039:   width: 100%;  
1.489     raeburn  5040: }
                   5041: span.LC_feedback_link {
1.599     albertel 5042:   background: $feedback_link_bg;
                   5043:   font-size: larger;
                   5044: }
                   5045: span.LC_message_link {
                   5046:   background: $feedback_link_bg;
                   5047:   font-size: larger;
                   5048:   position: absolute;
                   5049:   right: 1em;
1.489     raeburn  5050: }
1.421     albertel 5051: 
1.515     albertel 5052: table.LC_prior_tries {
1.524     albertel 5053:   border: 1px solid #000000;
                   5054:   border-collapse: separate;
                   5055:   border-spacing: 1px;
1.515     albertel 5056: }
1.523     albertel 5057: 
1.515     albertel 5058: table.LC_prior_tries td {
1.524     albertel 5059:   padding: 2px;
1.515     albertel 5060: }
1.523     albertel 5061: 
                   5062: .LC_answer_correct {
                   5063:   background: #AAFFAA;
                   5064:   color: black;
                   5065: }
                   5066: .LC_answer_charged_try {
                   5067:   background: #FFAAAA ! important;
                   5068:   color: black;
                   5069: }
                   5070: .LC_answer_not_charged_try, 
                   5071: .LC_answer_no_grade,
                   5072: .LC_answer_late {
                   5073:   background: #FFFFAA;
                   5074:   color: black;
                   5075: }
                   5076: .LC_answer_previous {
                   5077:   background: #AAAAFF;
                   5078:   color: black;
                   5079: }
                   5080: .LC_answer_no_message {
                   5081:   background: #FFFFFF;
                   5082:   color: black;
                   5083: }
                   5084: .LC_answer_unknown {
                   5085:   background: orange;
                   5086:   color: black;
                   5087: }
                   5088: 
                   5089: 
1.529     albertel 5090: span.LC_prior_numerical,
                   5091: span.LC_prior_string,
                   5092: span.LC_prior_custom,
                   5093: span.LC_prior_reaction,
                   5094: span.LC_prior_math {
1.523     albertel 5095:   font-family: monospace;
                   5096:   white-space: pre;
                   5097: }
                   5098: 
1.525     albertel 5099: span.LC_prior_string {
                   5100:   font-family: monospace;
                   5101:   white-space: pre;
                   5102: }
                   5103: 
1.523     albertel 5104: table.LC_prior_option {
                   5105:   width: 100%;
                   5106:   border-collapse: collapse;
                   5107: }
1.528     albertel 5108: table.LC_prior_rank, table.LC_prior_match {
                   5109:   border-collapse: collapse;
                   5110: }
                   5111: table.LC_prior_option tr td,
                   5112: table.LC_prior_rank tr td,
                   5113: table.LC_prior_match tr td {
1.524     albertel 5114:   border: 1px solid #000000;
1.515     albertel 5115: }
                   5116: 
1.519     raeburn  5117: span.LC_nobreak {
1.544     albertel 5118:   white-space: nowrap;
1.519     raeburn  5119: }
                   5120: 
1.576     raeburn  5121: span.LC_cusr_emph {
                   5122:   font-style: italic;
                   5123: }
                   5124: 
1.633     raeburn  5125: span.LC_cusr_subheading {
                   5126:   font-weight: normal;
                   5127:   font-size: 85%;
                   5128: }
                   5129: 
1.545     albertel 5130: table.LC_docs_documents {
                   5131:   background: #BBBBBB;
1.547     albertel 5132:   border-width: 0px;
1.545     albertel 5133:   border-collapse: collapse;
                   5134: }
                   5135: 
                   5136: table.LC_docs_documents td.LC_docs_document {
                   5137:   border: 2px solid black;
                   5138:   padding: 4px;
                   5139: }
                   5140: 
                   5141: .LC_docs_course_commands div {
                   5142:   float: left;
                   5143:   border: 4px solid #AAAAAA;
                   5144:   padding: 4px;
                   5145:   background: #DDDDCC;
                   5146: }
                   5147: 
                   5148: .LC_docs_entry_move {
                   5149:   border: 0px;
                   5150:   border-collapse: collapse;
1.544     albertel 5151: }
                   5152: 
1.545     albertel 5153: .LC_docs_entry_move td {
                   5154:   border: 2px solid #BBBBBB;
                   5155:   background: #DDDDDD;
                   5156: }
                   5157: 
                   5158: .LC_docs_editor td.LC_docs_entry_commands {
                   5159:   background: #DDDDDD;
                   5160:   font-size: x-small;
                   5161: }
1.544     albertel 5162: .LC_docs_copy {
1.545     albertel 5163:   color: #000099;
1.544     albertel 5164: }
                   5165: .LC_docs_cut {
1.545     albertel 5166:   color: #550044;
1.544     albertel 5167: }
                   5168: .LC_docs_rename {
1.545     albertel 5169:   color: #009900;
1.544     albertel 5170: }
                   5171: .LC_docs_remove {
1.545     albertel 5172:   color: #990000;
                   5173: }
                   5174: 
1.547     albertel 5175: .LC_docs_reinit_warn,
                   5176: .LC_docs_ext_edit {
                   5177:   font-size: x-small;
                   5178: }
                   5179: 
1.545     albertel 5180: .LC_docs_editor td.LC_docs_entry_title,
                   5181: .LC_docs_editor td.LC_docs_entry_icon {
                   5182:   background: #FFFFBB;
                   5183: }
                   5184: .LC_docs_editor td.LC_docs_entry_parameter {
                   5185:   background: #BBBBFF;
                   5186:   font-size: x-small;
                   5187:   white-space: nowrap;
                   5188: }
                   5189: 
                   5190: table.LC_docs_adddocs td,
                   5191: table.LC_docs_adddocs th {
                   5192:   border: 1px solid #BBBBBB;
                   5193:   padding: 4px;
                   5194:   background: #DDDDDD;
1.543     albertel 5195: }
                   5196: 
1.584     albertel 5197: table.LC_sty_begin {
                   5198:   background: #BBFFBB;
                   5199: }
                   5200: table.LC_sty_end {
                   5201:   background: #FFBBBB;
                   5202: }
                   5203: 
1.589     raeburn  5204: table.LC_double_column {
                   5205:   border-width: 0px;
                   5206:   border-collapse: collapse;
                   5207:   width: 100%;
                   5208:   padding: 2px;
                   5209: }
                   5210: 
                   5211: table.LC_double_column tr td.LC_left_col {
1.590     raeburn  5212:   top: 2px;
1.589     raeburn  5213:   left: 2px;
                   5214:   width: 47%;
                   5215:   vertical-align: top;
                   5216: }
                   5217: 
                   5218: table.LC_double_column tr td.LC_right_col {
                   5219:   top: 2px;
                   5220:   right: 2px; 
                   5221:   width: 47%;
                   5222:   vertical-align: top;
                   5223: }
                   5224: 
1.594     raeburn  5225: span.LC_role_level {
                   5226:   font-weight: bold;
                   5227: }
                   5228: 
1.591     raeburn  5229: div.LC_left_float {
                   5230:   float: left;
                   5231:   padding-right: 5%;
1.597     albertel 5232:   padding-bottom: 4px;
1.591     raeburn  5233: }
                   5234: 
                   5235: div.LC_clear_float_header {
1.597     albertel 5236:   padding-bottom: 2px;
1.591     raeburn  5237: }
                   5238: 
                   5239: div.LC_clear_float_footer {
1.597     albertel 5240:   padding-top: 10px;
1.591     raeburn  5241:   clear: both;
                   5242: }
                   5243: 
1.597     albertel 5244: 
1.601     albertel 5245: div.LC_grade_select_mode {
1.604     albertel 5246:   font-family: $sans;
1.601     albertel 5247: }
                   5248: div.LC_grade_select_mode div div {
                   5249:   margin: 5px;
                   5250: }
                   5251: div.LC_grade_select_mode_selector {
                   5252:   margin: 5px;
                   5253:   float: left;
                   5254: }
                   5255: div.LC_grade_select_mode_selector_header {
                   5256:   font: bold medium $sans;
                   5257: }
                   5258: div.LC_grade_select_mode_type {
                   5259:   clear: left;
                   5260: }
                   5261: 
1.597     albertel 5262: div.LC_grade_show_user {
                   5263:   margin-top: 20px;
                   5264:   border: 1px solid black;
                   5265: }
                   5266: div.LC_grade_user_name {
                   5267:   background: #DDDDEE;
                   5268:   border-bottom: 1px solid black;
                   5269:   font: bold large $sans;
                   5270: }
                   5271: div.LC_grade_show_user_odd_row div.LC_grade_user_name {
                   5272:   background: #DDEEDD;
                   5273: }
                   5274: 
                   5275: div.LC_grade_show_problem,
                   5276: div.LC_grade_submissions,
                   5277: div.LC_grade_message_center,
                   5278: div.LC_grade_info_links,
                   5279: div.LC_grade_assign {
                   5280:   margin: 5px;
                   5281:   width: 99%;
                   5282:   background: #FFFFFF;
                   5283: }
                   5284: div.LC_grade_show_problem_header,
                   5285: div.LC_grade_submissions_header,
                   5286: div.LC_grade_message_center_header,
                   5287: div.LC_grade_assign_header {
                   5288:   font: bold large $sans;
                   5289: }
                   5290: div.LC_grade_show_problem_problem,
                   5291: div.LC_grade_submissions_body,
                   5292: div.LC_grade_message_center_body,
                   5293: div.LC_grade_assign_body {
                   5294:   border: 1px solid black;
                   5295:   width: 99%;
                   5296:   background: #FFFFFF;
                   5297: }
1.598     albertel 5298: span.LC_grade_check_note {
                   5299:   font: normal medium $sans;
                   5300:   display: inline;
                   5301:   position: absolute;
                   5302:   right: 1em;
                   5303: }
1.597     albertel 5304: 
1.613     albertel 5305: table.LC_scantron_action {
                   5306:   width: 100%;
                   5307: }
                   5308: table.LC_scantron_action tr th {
                   5309:   font: normal bold $sans;
                   5310: }
1.600     albertel 5311: 
1.614     albertel 5312: div.LC_edit_problem_header, 
                   5313: div.LC_edit_problem_footer {
1.600     albertel 5314:   font: normal medium $sans;
1.602     albertel 5315:   margin: 2px;
1.600     albertel 5316: }
                   5317: div.LC_edit_problem_header,
1.602     albertel 5318: div.LC_edit_problem_header div,
1.614     albertel 5319: div.LC_edit_problem_footer,
                   5320: div.LC_edit_problem_footer div,
1.602     albertel 5321: div.LC_edit_problem_editxml_header,
                   5322: div.LC_edit_problem_editxml_header div {
1.600     albertel 5323:   margin-top: 5px;
                   5324: }
1.602     albertel 5325: div.LC_edit_problem_header_edit_row {
                   5326:   background: $tabbg;
                   5327:   padding: 3px;
                   5328:   margin-bottom: 5px;
                   5329: }
1.600     albertel 5330: div.LC_edit_problem_header_title {
1.602     albertel 5331:   font: larger bold $sans;
                   5332:   background: $tabbg;
                   5333:   padding: 3px;
                   5334: }
                   5335: table.LC_edit_problem_header_title {
                   5336:   font: larger bold $sans;
                   5337:   width: 100%;
                   5338:   border-color: $pgbg;
                   5339:   border-style: solid;
                   5340:   border-width: $border;
                   5341: 
1.600     albertel 5342:   background: $tabbg;
1.602     albertel 5343:   border-collapse: collapse;
                   5344:   padding: 0px
                   5345: }
                   5346: 
                   5347: div.LC_edit_problem_discards {
                   5348:   float: left;
                   5349:   padding-bottom: 5px;
                   5350: }
                   5351: div.LC_edit_problem_saves {
                   5352:   float: right;
                   5353:   padding-bottom: 5px;
1.600     albertel 5354: }
                   5355: hr.LC_edit_problem_divide {
1.602     albertel 5356:   clear: both;
1.600     albertel 5357:   color: $tabbg;
                   5358:   background-color: $tabbg;
                   5359:   height: 3px;
                   5360:   border: 0px;
                   5361: }
1.343     albertel 5362: END
                   5363: }
                   5364: 
1.306     albertel 5365: =pod
                   5366: 
                   5367: =item * &headtag()
                   5368: 
                   5369: Returns a uniform footer for LON-CAPA web pages.
                   5370: 
1.307     albertel 5371: Inputs: $title - optional title for the head
                   5372:         $head_extra - optional extra HTML to put inside the <head>
1.315     albertel 5373:         $args - optional arguments
1.319     albertel 5374:             force_register - if is true call registerurl so the remote is 
                   5375:                              informed
1.415     albertel 5376:             redirect       -> array ref of
                   5377:                                    1- seconds before redirect occurs
                   5378:                                    2- url to redirect to
                   5379:                                    3- whether the side effect should occur
1.315     albertel 5380:                            (side effect of setting 
                   5381:                                $env{'internal.head.redirect'} to the url 
                   5382:                                redirected too)
1.352     albertel 5383:             domain         -> force to color decorate a page for a specific
                   5384:                                domain
                   5385:             function       -> force usage of a specific rolish color scheme
                   5386:             bgcolor        -> override the default page bgcolor
1.460     albertel 5387:             no_auto_mt_title
                   5388:                            -> prevent &mt()ing the title arg
1.464     albertel 5389: 
1.306     albertel 5390: =cut
                   5391: 
                   5392: sub headtag {
1.313     albertel 5393:     my ($title,$head_extra,$args) = @_;
1.306     albertel 5394:     
1.363     albertel 5395:     my $function = $args->{'function'} || &get_users_function();
                   5396:     my $domain   = $args->{'domain'}   || &determinedomain();
                   5397:     my $bgcolor  = $args->{'bgcolor'}  || &designparm($function.'.pgbg',$domain);
1.418     albertel 5398:     my $url = join(':',$env{'user.name'},$env{'user.domain'},
1.458     albertel 5399: 		   $Apache::lonnet::perlvar{'lonVersion'},
1.531     albertel 5400: 		   #time(),
1.418     albertel 5401: 		   $env{'environment.color.timestamp'},
1.363     albertel 5402: 		   $function,$domain,$bgcolor);
                   5403: 
1.369     www      5404:     $url = '/adm/css/'.&escape($url).'.css';
1.363     albertel 5405: 
1.308     albertel 5406:     my $result =
                   5407: 	'<head>'.
1.461     albertel 5408: 	&font_settings();
1.319     albertel 5409: 
1.461     albertel 5410:     if (!$args->{'frameset'}) {
                   5411: 	$result .= &Apache::lonhtmlcommon::htmlareaheaders();
                   5412:     }
1.319     albertel 5413:     if ($args->{'force_register'}) {
                   5414: 	$result .= &Apache::lonmenu::registerurl(1);
                   5415:     }
1.436     albertel 5416:     if (!$args->{'no_nav_bar'} 
                   5417: 	&& !$args->{'only_body'}
                   5418: 	&& !$args->{'frameset'}) {
                   5419: 	$result .= &help_menu_js();
                   5420:     }
1.319     albertel 5421: 
1.314     albertel 5422:     if (ref($args->{'redirect'})) {
1.414     albertel 5423: 	my ($time,$url,$inhibit_continue) = @{$args->{'redirect'}};
1.315     albertel 5424: 	$url = &Apache::lonenc::check_encrypt($url);
1.414     albertel 5425: 	if (!$inhibit_continue) {
                   5426: 	    $env{'internal.head.redirect'} = $url;
                   5427: 	}
1.313     albertel 5428: 	$result.=<<ADDMETA
                   5429: <meta http-equiv="pragma" content="no-cache" />
1.344     albertel 5430: <meta http-equiv="Refresh" content="$time; url=$url" />
1.313     albertel 5431: ADDMETA
                   5432:     }
1.306     albertel 5433:     if (!defined($title)) {
                   5434: 	$title = 'The LearningOnline Network with CAPA';
                   5435:     }
1.460     albertel 5436:     if (!$args->{'no_auto_mt_title'}) { $title = &mt($title); }
                   5437:     $result .= '<title> LON-CAPA '.$title.'</title>'
1.414     albertel 5438: 	.'<link rel="stylesheet" type="text/css" href="'.$url.'" />'
                   5439: 	.$head_extra;
1.306     albertel 5440:     return $result;
                   5441: }
                   5442: 
                   5443: =pod
                   5444: 
1.340     albertel 5445: =item * &font_settings()
                   5446: 
                   5447: Returns neccessary <meta> to set the proper encoding
                   5448: 
                   5449: Inputs: none
                   5450: 
                   5451: =cut
                   5452: 
                   5453: sub font_settings {
                   5454:     my $headerstring='';
1.647     www      5455:     if (!$env{'browser.mathml'} && $env{'browser.unicode'}) {
1.340     albertel 5456: 	$headerstring.=
                   5457: 	    '<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />';
                   5458:     }
                   5459:     return $headerstring;
                   5460: }
                   5461: 
1.341     albertel 5462: =pod
                   5463: 
                   5464: =item * &xml_begin()
                   5465: 
                   5466: Returns the needed doctype and <html>
                   5467: 
                   5468: Inputs: none
                   5469: 
                   5470: =cut
                   5471: 
                   5472: sub xml_begin {
                   5473:     my $output='';
                   5474: 
1.592     albertel 5475:     if ($env{'internal.start_page'}==1) {
                   5476: 	&Apache::lonhtmlcommon::init_htmlareafields();
                   5477:     }
1.342     albertel 5478: 
1.341     albertel 5479:     if ($env{'browser.mathml'}) {
                   5480: 	$output='<?xml version="1.0"?>'
                   5481:             #.'<?xml-stylesheet type="text/css" href="/adm/MathML/mathml.css"?>'."\n"
                   5482: #            .'<!DOCTYPE html SYSTEM "/adm/MathML/mathml.dtd" '
                   5483:             
                   5484: #	    .'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [<!ENTITY mathns "http://www.w3.org/1998/Math/MathML">] >'
                   5485: 	    .'<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN" "http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd">'
                   5486:             .'<html xmlns:math="http://www.w3.org/1998/Math/MathML" ' 
                   5487: 	    .'xmlns="http://www.w3.org/1999/xhtml">';
                   5488:     } else {
                   5489: 	$output='<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html>';
                   5490:     }
                   5491:     return $output;
                   5492: }
1.340     albertel 5493: 
                   5494: =pod
                   5495: 
1.306     albertel 5496: =item * &endheadtag()
                   5497: 
                   5498: Returns a uniform </head> for LON-CAPA web pages.
                   5499: 
                   5500: Inputs: none
                   5501: 
                   5502: =cut
                   5503: 
                   5504: sub endheadtag {
                   5505:     return '</head>';
                   5506: }
                   5507: 
                   5508: =pod
                   5509: 
                   5510: =item * &head()
                   5511: 
                   5512: Returns a uniform complete <head>..</head> section for LON-CAPA web pages.
                   5513: 
1.648     raeburn  5514: Inputs:
                   5515: 
                   5516: =over 4
                   5517: 
                   5518: $title - optional title for the page
                   5519: 
                   5520: $head_extra - optional extra HTML to put inside the <head>
                   5521: 
                   5522: =back
1.405     albertel 5523: 
1.306     albertel 5524: =cut
                   5525: 
                   5526: sub head {
1.325     albertel 5527:     my ($title,$head_extra,$args) = @_;
                   5528:     return &headtag($title,$head_extra,$args).&endheadtag();
1.306     albertel 5529: }
                   5530: 
                   5531: =pod
                   5532: 
                   5533: =item * &start_page()
                   5534: 
                   5535: Returns a complete <html> .. <body> section for LON-CAPA web pages.
                   5536: 
1.648     raeburn  5537: Inputs:
                   5538: 
                   5539: =over 4
                   5540: 
                   5541: $title - optional title for the page
                   5542: 
                   5543: $head_extra - optional extra HTML to incude inside the <head>
                   5544: 
                   5545: $args - additional optional args supported are:
                   5546: 
                   5547: =over 8
                   5548: 
                   5549:              only_body      -> is true will set &bodytag() onlybodytag
1.317     albertel 5550:                                     arg on
1.648     raeburn  5551:              no_nav_bar     -> is true will set &bodytag() notopbar arg on
                   5552:              add_entries    -> additional attributes to add to the  <body>
                   5553:              domain         -> force to color decorate a page for a 
1.317     albertel 5554:                                     specific domain
1.648     raeburn  5555:              function       -> force usage of a specific rolish color
1.317     albertel 5556:                                     scheme
1.648     raeburn  5557:              redirect       -> see &headtag()
                   5558:              bgcolor        -> override the default page bg color
                   5559:              js_ready       -> return a string ready for being used in 
1.317     albertel 5560:                                     a javascript writeln
1.648     raeburn  5561:              html_encode    -> return a string ready for being used in 
1.320     albertel 5562:                                     a html attribute
1.648     raeburn  5563:              force_register -> if is true will turn on the &bodytag()
1.317     albertel 5564:                                     $forcereg arg
1.648     raeburn  5565:              body_title     -> alternate text to use instead of $title
1.326     albertel 5566:                                     in the title box that appears, this text
                   5567:                                     is not auto translated like the $title is
1.648     raeburn  5568:              frameset       -> if true will start with a <frameset>
1.330     albertel 5569:                                     rather than <body>
1.648     raeburn  5570:              no_title       -> if true the title bar won't be shown
                   5571:              skip_phases    -> hash ref of 
1.338     albertel 5572:                                     head -> skip the <html><head> generation
                   5573:                                     body -> skip all <body> generation
1.648     raeburn  5574:              no_inline_link -> if true and in remote mode, don't show the 
1.361     albertel 5575:                                     'Switch To Inline Menu' link
1.648     raeburn  5576:              no_auto_mt_title -> prevent &mt()ing the title arg
                   5577:              inherit_jsmath -> when creating popup window in a page,
                   5578:                                     should it have jsmath forced on by the
                   5579:                                     current page
1.361     albertel 5580: 
1.648     raeburn  5581: =back
1.460     albertel 5582: 
1.648     raeburn  5583: =back
1.562     albertel 5584: 
1.306     albertel 5585: =cut
                   5586: 
                   5587: sub start_page {
1.309     albertel 5588:     my ($title,$head_extra,$args) = @_;
1.318     albertel 5589:     #&Apache::lonnet::logthis("start_page ".join(':',caller(0)));
1.313     albertel 5590:     my %head_args;
1.352     albertel 5591:     foreach my $arg ('redirect','force_register','domain','function',
1.460     albertel 5592: 		     'bgcolor','frameset','no_nav_bar','only_body',
                   5593: 		     'no_auto_mt_title') {
1.319     albertel 5594: 	if (defined($args->{$arg})) {
1.324     raeburn  5595: 	    $head_args{$arg} = $args->{$arg};
1.319     albertel 5596: 	}
1.313     albertel 5597:     }
1.319     albertel 5598: 
1.315     albertel 5599:     $env{'internal.start_page'}++;
1.338     albertel 5600:     my $result;
                   5601:     if (! exists($args->{'skip_phases'}{'head'}) ) {
                   5602: 	$result.=
1.341     albertel 5603: 	    &xml_begin().
1.338     albertel 5604: 	    &headtag($title,$head_extra,\%head_args).&endheadtag();
                   5605:     }
                   5606:     
                   5607:     if (! exists($args->{'skip_phases'}{'body'}) ) {
                   5608: 	if ($args->{'frameset'}) {
                   5609: 	    my $attr_string = &make_attr_string($args->{'force_register'},
                   5610: 						$args->{'add_entries'});
                   5611: 	    $result .= "\n<frameset $attr_string>\n";
                   5612: 	} else {
                   5613: 	    $result .=
                   5614: 		&bodytag($title, 
                   5615: 			 $args->{'function'},       $args->{'add_entries'},
                   5616: 			 $args->{'only_body'},      $args->{'domain'},
                   5617: 			 $args->{'force_register'}, $args->{'body_title'},
                   5618: 			 $args->{'no_nav_bar'},     $args->{'bgcolor'},
1.460     albertel 5619: 			 $args->{'no_title'},       $args->{'no_inline_link'},
                   5620: 			 $args);
1.338     albertel 5621: 	}
1.330     albertel 5622:     }
1.338     albertel 5623: 
1.315     albertel 5624:     if ($args->{'js_ready'}) {
1.317     albertel 5625: 	$result = &js_ready($result);
1.315     albertel 5626:     }
1.320     albertel 5627:     if ($args->{'html_encode'}) {
                   5628: 	$result = &html_encode($result);
                   5629:     }
1.315     albertel 5630:     return $result;
1.306     albertel 5631: }
                   5632: 
1.330     albertel 5633: 
1.306     albertel 5634: =pod
                   5635: 
                   5636: =item * &head()
                   5637: 
                   5638: Returns a complete </body></html> section for LON-CAPA web pages.
                   5639: 
1.315     albertel 5640: Inputs:         $args - additional optional args supported are:
                   5641:                  js_ready     -> return a string ready for being used in 
                   5642:                                  a javascript writeln
1.320     albertel 5643:                  html_encode  -> return a string ready for being used in 
                   5644:                                  a html attribute
1.330     albertel 5645:                  frameset     -> if true will start with a <frameset>
                   5646:                                  rather than <body>
1.493     albertel 5647:                  dicsussion   -> if true will get discussion from
                   5648:                                   lonxml::xmlend
                   5649:                                  (you can pass the target and parser arguments
                   5650:                                   through optional 'target' and 'parser' args
                   5651:                                   to this routine)
1.306     albertel 5652: 
                   5653: =cut
                   5654: 
                   5655: sub end_page {
1.315     albertel 5656:     my ($args) = @_;
                   5657:     $env{'internal.end_page'}++;
1.330     albertel 5658:     my $result;
1.335     albertel 5659:     if ($args->{'discussion'}) {
                   5660: 	my ($target,$parser);
                   5661: 	if (ref($args->{'discussion'})) {
                   5662: 	    ($target,$parser) =($args->{'discussion'}{'target'},
                   5663: 				$args->{'discussion'}{'parser'});
                   5664: 	}
                   5665: 	$result .= &Apache::lonxml::xmlend($target,$parser);
                   5666:     }
                   5667: 
1.330     albertel 5668:     if ($args->{'frameset'}) {
                   5669: 	$result .= '</frameset>';
                   5670:     } else {
1.635     raeburn  5671: 	$result .= &endbodytag($args);
1.330     albertel 5672:     }
                   5673:     $result .= "\n</html>";
                   5674: 
1.315     albertel 5675:     if ($args->{'js_ready'}) {
1.317     albertel 5676: 	$result = &js_ready($result);
1.315     albertel 5677:     }
1.335     albertel 5678: 
1.320     albertel 5679:     if ($args->{'html_encode'}) {
                   5680: 	$result = &html_encode($result);
                   5681:     }
1.335     albertel 5682: 
1.315     albertel 5683:     return $result;
                   5684: }
                   5685: 
1.320     albertel 5686: sub html_encode {
                   5687:     my ($result) = @_;
                   5688: 
1.322     albertel 5689:     $result = &HTML::Entities::encode($result,'<>&"');
1.320     albertel 5690:     
                   5691:     return $result;
                   5692: }
1.317     albertel 5693: sub js_ready {
                   5694:     my ($result) = @_;
                   5695: 
1.323     albertel 5696:     $result =~ s/[\n\r]/ /xmsg;
                   5697:     $result =~ s/\\/\\\\/xmsg;
                   5698:     $result =~ s/'/\\'/xmsg;
1.372     albertel 5699:     $result =~ s{</}{<\\/}xmsg;
1.317     albertel 5700:     
                   5701:     return $result;
                   5702: }
                   5703: 
1.315     albertel 5704: sub validate_page {
                   5705:     if (  exists($env{'internal.start_page'})
1.316     albertel 5706: 	  &&     $env{'internal.start_page'} > 1) {
                   5707: 	&Apache::lonnet::logthis('start_page called multiple times '.
1.318     albertel 5708: 				 $env{'internal.start_page'}.' '.
1.316     albertel 5709: 				 $ENV{'request.filename'});
1.315     albertel 5710:     }
                   5711:     if (  exists($env{'internal.end_page'})
1.316     albertel 5712: 	  &&     $env{'internal.end_page'} > 1) {
                   5713: 	&Apache::lonnet::logthis('end_page called multiple times '.
1.318     albertel 5714: 				 $env{'internal.end_page'}.' '.
1.316     albertel 5715: 				 $env{'request.filename'});
1.315     albertel 5716:     }
                   5717:     if (     exists($env{'internal.start_page'})
                   5718: 	&& ! exists($env{'internal.end_page'})) {
1.316     albertel 5719: 	&Apache::lonnet::logthis('start_page called without end_page '.
                   5720: 				 $env{'request.filename'});
1.315     albertel 5721:     }
                   5722:     if (   ! exists($env{'internal.start_page'})
                   5723: 	&&   exists($env{'internal.end_page'})) {
1.316     albertel 5724: 	&Apache::lonnet::logthis('end_page called without start_page'.
                   5725: 				 $env{'request.filename'});
1.315     albertel 5726:     }
1.306     albertel 5727: }
1.315     albertel 5728: 
1.318     albertel 5729: sub simple_error_page {
                   5730:     my ($r,$title,$msg) = @_;
                   5731:     my $page =
                   5732: 	&Apache::loncommon::start_page($title).
                   5733: 	&mt($msg).
                   5734: 	&Apache::loncommon::end_page();
                   5735:     if (ref($r)) {
                   5736: 	$r->print($page);
1.327     albertel 5737: 	return;
1.318     albertel 5738:     }
                   5739:     return $page;
                   5740: }
1.347     albertel 5741: 
                   5742: {
1.610     albertel 5743:     my @row_count;
1.347     albertel 5744:     sub start_data_table {
1.422     albertel 5745: 	my ($add_class) = @_;
                   5746: 	my $css_class = (join(' ','LC_data_table',$add_class));
1.610     albertel 5747: 	unshift(@row_count,0);
1.422     albertel 5748: 	return '<table class="'.$css_class.'">'."\n";
1.347     albertel 5749:     }
                   5750: 
                   5751:     sub end_data_table {
1.610     albertel 5752: 	shift(@row_count);
1.389     albertel 5753: 	return '</table>'."\n";;
1.347     albertel 5754:     }
                   5755: 
                   5756:     sub start_data_table_row {
1.422     albertel 5757: 	my ($add_class) = @_;
1.610     albertel 5758: 	$row_count[0]++;
                   5759: 	my $css_class = ($row_count[0] % 2)?'LC_odd_row':'LC_even_row';
1.428     albertel 5760: 	$css_class = (join(' ',$css_class,$add_class));
1.422     albertel 5761: 	return  '<tr class="'.$css_class.'">'."\n";;
1.347     albertel 5762:     }
1.471     banghart 5763:     
                   5764:     sub continue_data_table_row {
                   5765: 	my ($add_class) = @_;
1.610     albertel 5766: 	my $css_class = ($row_count[0] % 2)?'LC_odd_row':'LC_even_row';
1.471     banghart 5767: 	$css_class = (join(' ',$css_class,$add_class));
                   5768: 	return  '<tr class="'.$css_class.'">'."\n";;
                   5769:     }
1.347     albertel 5770: 
                   5771:     sub end_data_table_row {
1.389     albertel 5772: 	return '</tr>'."\n";;
1.347     albertel 5773:     }
1.367     www      5774: 
1.421     albertel 5775:     sub start_data_table_empty_row {
1.610     albertel 5776: 	$row_count[0]++;
1.421     albertel 5777: 	return  '<tr class="LC_empty_row" >'."\n";;
                   5778:     }
                   5779: 
                   5780:     sub end_data_table_empty_row {
                   5781: 	return '</tr>'."\n";;
                   5782:     }
                   5783: 
1.367     www      5784:     sub start_data_table_header_row {
1.389     albertel 5785: 	return  '<tr class="LC_header_row">'."\n";;
1.367     www      5786:     }
                   5787: 
                   5788:     sub end_data_table_header_row {
1.389     albertel 5789: 	return '</tr>'."\n";;
1.367     www      5790:     }
1.347     albertel 5791: }
                   5792: 
1.548     albertel 5793: =pod
                   5794: 
                   5795: =item * &inhibit_menu_check($arg)
                   5796: 
                   5797: Checks for a inhibitmenu state and generates output to preserve it
                   5798: 
                   5799: Inputs:         $arg - can be any of
                   5800:                      - undef - in which case the return value is a string 
                   5801:                                to add  into arguments list of a uri
                   5802:                      - 'input' - in which case the return value is a HTML
                   5803:                                  <form> <input> field of type hidden to
                   5804:                                  preserve the value
                   5805:                      - a url - in which case the return value is the url with
                   5806:                                the neccesary cgi args added to preserve the
                   5807:                                inhibitmenu state
                   5808:                      - a ref to a url - no return value, but the string is
                   5809:                                         updated to include the neccessary cgi
                   5810:                                         args to preserve the inhibitmenu state
                   5811: 
                   5812: =cut
                   5813: 
                   5814: sub inhibit_menu_check {
                   5815:     my ($arg) = @_;
                   5816:     &get_unprocessed_cgi($ENV{'QUERY_STRING'}, ['inhibitmenu']);
                   5817:     if ($arg eq 'input') {
                   5818: 	if ($env{'form.inhibitmenu'}) {
                   5819: 	    return '<input type="hidden" name="inhibitmenu" value="'.$env{'form.inhibitmenu'}.'" />';
                   5820: 	} else {
                   5821: 	    return
                   5822: 	}
                   5823:     }
                   5824:     if ($env{'form.inhibitmenu'}) {
                   5825: 	if (ref($arg)) {
                   5826: 	    $$arg .= '?inhibitmenu='.$env{'form.inhibitmenu'};
                   5827: 	} elsif ($arg eq '') {
                   5828: 	    $arg .= 'inhibitmenu='.$env{'form.inhibitmenu'};
                   5829: 	} else {
                   5830: 	    $arg .= '?inhibitmenu='.$env{'form.inhibitmenu'};
                   5831: 	}
                   5832:     }
                   5833:     if (!ref($arg)) {
                   5834: 	return $arg;
                   5835:     }
                   5836: }
                   5837: 
1.251     albertel 5838: ###############################################
1.182     matthew  5839: 
                   5840: =pod
                   5841: 
1.549     albertel 5842: =back
                   5843: 
                   5844: =head1 User Information Routines
                   5845: 
                   5846: =over 4
                   5847: 
1.405     albertel 5848: =item * &get_users_function()
1.182     matthew  5849: 
                   5850: Used by &bodytag to determine the current users primary role.
                   5851: Returns either 'student','coordinator','admin', or 'author'.
                   5852: 
                   5853: =cut
                   5854: 
                   5855: ###############################################
                   5856: sub get_users_function {
                   5857:     my $function = 'student';
1.258     albertel 5858:     if ($env{'request.role'}=~/^(cc|in|ta|ep)/) {
1.182     matthew  5859:         $function='coordinator';
                   5860:     }
1.258     albertel 5861:     if ($env{'request.role'}=~/^(su|dc|ad|li)/) {
1.182     matthew  5862:         $function='admin';
                   5863:     }
1.258     albertel 5864:     if (($env{'request.role'}=~/^(au|ca)/) ||
1.182     matthew  5865:         ($ENV{'REQUEST_URI'}=~/^(\/priv|\~)/)) {
                   5866:         $function='author';
                   5867:     }
                   5868:     return $function;
1.54      www      5869: }
1.99      www      5870: 
                   5871: ###############################################
                   5872: 
1.233     raeburn  5873: =pod
                   5874: 
1.542     raeburn  5875: =item * &check_user_status()
1.274     raeburn  5876: 
                   5877: Determines current status of supplied role for a
                   5878: specific user. Roles can be active, previous or future.
                   5879: 
                   5880: Inputs: 
                   5881: user's domain, user's username, course's domain,
1.375     raeburn  5882: course's number, optional section ID.
1.274     raeburn  5883: 
                   5884: Outputs:
                   5885: role status: active, previous or future. 
                   5886: 
                   5887: =cut
                   5888: 
                   5889: sub check_user_status {
1.412     raeburn  5890:     my ($udom,$uname,$cdom,$crs,$role,$sec) = @_;
1.274     raeburn  5891:     my %userinfo = &Apache::lonnet::dump('roles',$udom,$uname);
                   5892:     my @uroles = keys %userinfo;
                   5893:     my $srchstr;
                   5894:     my $active_chk = 'none';
1.412     raeburn  5895:     my $now = time;
1.274     raeburn  5896:     if (@uroles > 0) {
1.412     raeburn  5897:         if (($role eq 'cc') || ($sec eq '') || (!defined($sec))) {
1.274     raeburn  5898:             $srchstr = '/'.$cdom.'/'.$crs.'_'.$role;
                   5899:         } else {
1.412     raeburn  5900:             $srchstr = '/'.$cdom.'/'.$crs.'/'.$sec.'_'.$role;
                   5901:         }
                   5902:         if (grep/^\Q$srchstr\E$/,@uroles) {
1.274     raeburn  5903:             my $role_end = 0;
                   5904:             my $role_start = 0;
                   5905:             $active_chk = 'active';
1.412     raeburn  5906:             if ($userinfo{$srchstr} =~ m/^\Q$role\E_(\d+)/) {
                   5907:                 $role_end = $1;
                   5908:                 if ($userinfo{$srchstr} =~ m/^\Q$role\E_\Q$role_end\E_(\d+)$/) {
                   5909:                     $role_start = $1;
1.274     raeburn  5910:                 }
                   5911:             }
                   5912:             if ($role_start > 0) {
1.412     raeburn  5913:                 if ($now < $role_start) {
1.274     raeburn  5914:                     $active_chk = 'future';
                   5915:                 }
                   5916:             }
                   5917:             if ($role_end > 0) {
1.412     raeburn  5918:                 if ($now > $role_end) {
1.274     raeburn  5919:                     $active_chk = 'previous';
                   5920:                 }
                   5921:             }
                   5922:         }
                   5923:     }
                   5924:     return $active_chk;
                   5925: }
                   5926: 
                   5927: ###############################################
                   5928: 
                   5929: =pod
                   5930: 
1.405     albertel 5931: =item * &get_sections()
1.233     raeburn  5932: 
                   5933: Determines all the sections for a course including
                   5934: sections with students and sections containing other roles.
1.419     raeburn  5935: Incoming parameters: 
                   5936: 
                   5937: 1. domain
                   5938: 2. course number 
                   5939: 3. reference to array containing roles for which sections should 
                   5940: be gathered (optional).
                   5941: 4. reference to array containing status types for which sections 
                   5942: should be gathered (optional).
                   5943: 
                   5944: If the third argument is undefined, sections are gathered for any role. 
                   5945: If the fourth argument is undefined, sections are gathered for any status.
                   5946: Permissible values are 'active' or 'future' or 'previous'.
1.233     raeburn  5947:  
1.374     raeburn  5948: Returns section hash (keys are section IDs, values are
                   5949: number of users in each section), subject to the
1.419     raeburn  5950: optional roles filter, optional status filter 
1.233     raeburn  5951: 
                   5952: =cut
                   5953: 
                   5954: ###############################################
                   5955: sub get_sections {
1.419     raeburn  5956:     my ($cdom,$cnum,$possible_roles,$possible_status) = @_;
1.366     albertel 5957:     if (!defined($cdom) || !defined($cnum)) {
                   5958:         my $cid =  $env{'request.course.id'};
                   5959: 
                   5960: 	return if (!defined($cid));
                   5961: 
                   5962:         $cdom = $env{'course.'.$cid.'.domain'};
                   5963:         $cnum = $env{'course.'.$cid.'.num'};
                   5964:     }
                   5965: 
                   5966:     my %sectioncount;
1.419     raeburn  5967:     my $now = time;
1.240     albertel 5968: 
1.366     albertel 5969:     if (!defined($possible_roles) || (grep(/^st$/,@$possible_roles))) {
1.276     albertel 5970: 	my ($classlist) = &Apache::loncoursedata::get_classlist($cdom,$cnum);
1.240     albertel 5971: 	my $sec_index = &Apache::loncoursedata::CL_SECTION();
                   5972: 	my $status_index = &Apache::loncoursedata::CL_STATUS();
1.419     raeburn  5973:         my $start_index = &Apache::loncoursedata::CL_START();
                   5974:         my $end_index = &Apache::loncoursedata::CL_END();
                   5975:         my $status;
1.366     albertel 5976: 	while (my ($student,$data) = each(%$classlist)) {
1.419     raeburn  5977: 	    my ($section,$stu_status,$start,$end) = ($data->[$sec_index],
                   5978: 				                     $data->[$status_index],
                   5979:                                                      $data->[$start_index],
                   5980:                                                      $data->[$end_index]);
                   5981:             if ($stu_status eq 'Active') {
                   5982:                 $status = 'active';
                   5983:             } elsif ($end < $now) {
                   5984:                 $status = 'previous';
                   5985:             } elsif ($start > $now) {
                   5986:                 $status = 'future';
                   5987:             } 
                   5988: 	    if ($section ne '-1' && $section !~ /^\s*$/) {
                   5989:                 if ((!defined($possible_status)) || (($status ne '') && 
                   5990:                     (grep/^\Q$status\E$/,@{$possible_status}))) { 
                   5991: 		    $sectioncount{$section}++;
                   5992:                 }
1.240     albertel 5993: 	    }
                   5994: 	}
                   5995:     }
                   5996:     my %courseroles = &Apache::lonnet::dump('nohist_userroles',$cdom,$cnum);
                   5997:     foreach my $user (sort(keys(%courseroles))) {
                   5998: 	if ($user !~ /^(\w{2})/) { next; }
                   5999: 	my ($role) = ($user =~ /^(\w{2})/);
                   6000: 	if ($possible_roles && !(grep(/^$role$/,@$possible_roles))) { next; }
1.419     raeburn  6001: 	my ($section,$status);
1.240     albertel 6002: 	if ($role eq 'cr' &&
                   6003: 	    $user =~ m-^$role/[^/]*/[^/]*/[^/]*:[^:]*:[^:]*:(\w+)-) {
                   6004: 	    $section=$1;
                   6005: 	}
                   6006: 	if ($user =~ /^$role:[^:]*:[^:]*:(\w+)/) { $section=$1; }
                   6007: 	if (!defined($section) || $section eq '-1') { next; }
1.419     raeburn  6008:         my ($end,$start) = ($courseroles{$user} =~ /^([^:]*):([^:]*)$/);
                   6009:         if ($end == -1 && $start == -1) {
                   6010:             next; #deleted role
                   6011:         }
                   6012:         if (!defined($possible_status)) { 
                   6013:             $sectioncount{$section}++;
                   6014:         } else {
                   6015:             if ((!$end || $end >= $now) && (!$start || $start <= $now)) {
                   6016:                 $status = 'active';
                   6017:             } elsif ($end < $now) {
                   6018:                 $status = 'future';
                   6019:             } elsif ($start > $now) {
                   6020:                 $status = 'previous';
                   6021:             }
                   6022:             if (($status ne '') && (grep/^\Q$status\E$/,@{$possible_status})) {
                   6023:                 $sectioncount{$section}++;
                   6024:             }
                   6025:         }
1.233     raeburn  6026:     }
1.366     albertel 6027:     return %sectioncount;
1.233     raeburn  6028: }
                   6029: 
1.274     raeburn  6030: ###############################################
1.294     raeburn  6031: 
                   6032: =pod
1.405     albertel 6033: 
                   6034: =item * &get_course_users()
                   6035: 
1.275     raeburn  6036: Retrieves usernames:domains for users in the specified course
                   6037: with specific role(s), and access status. 
                   6038: 
                   6039: Incoming parameters:
1.277     albertel 6040: 1. course domain
                   6041: 2. course number
                   6042: 3. access status: users must have - either active, 
1.275     raeburn  6043: previous, future, or all.
1.277     albertel 6044: 4. reference to array of permissible roles
1.288     raeburn  6045: 5. reference to array of section restrictions (optional)
                   6046: 6. reference to results object (hash of hashes).
                   6047: 7. reference to optional userdata hash
1.609     raeburn  6048: 8. reference to optional statushash
1.630     raeburn  6049: 9. flag if privileged users (except those set to unhide in
                   6050:    course settings) should be excluded    
1.609     raeburn  6051: Keys of top level results hash are roles.
1.275     raeburn  6052: Keys of inner hashes are username:domain, with 
                   6053: values set to access type.
1.288     raeburn  6054: Optional userdata hash returns an array with arguments in the 
                   6055: same order as loncoursedata::get_classlist() for student data.
                   6056: 
1.609     raeburn  6057: Optional statushash returns
                   6058: 
1.288     raeburn  6059: Entries for end, start, section and status are blank because
                   6060: of the possibility of multiple values for non-student roles.
                   6061: 
1.275     raeburn  6062: =cut
1.405     albertel 6063: 
1.275     raeburn  6064: ###############################################
1.405     albertel 6065: 
1.275     raeburn  6066: sub get_course_users {
1.630     raeburn  6067:     my ($cdom,$cnum,$types,$roles,$sections,$users,$userdata,$statushash,$hidepriv) = @_;
1.288     raeburn  6068:     my %idx = ();
1.419     raeburn  6069:     my %seclists;
1.288     raeburn  6070: 
                   6071:     $idx{udom} = &Apache::loncoursedata::CL_SDOM();
                   6072:     $idx{uname} =  &Apache::loncoursedata::CL_SNAME();
                   6073:     $idx{end} = &Apache::loncoursedata::CL_END();
                   6074:     $idx{start} = &Apache::loncoursedata::CL_START();
                   6075:     $idx{id} = &Apache::loncoursedata::CL_ID();
                   6076:     $idx{section} = &Apache::loncoursedata::CL_SECTION();
                   6077:     $idx{fullname} = &Apache::loncoursedata::CL_FULLNAME();
                   6078:     $idx{status} = &Apache::loncoursedata::CL_STATUS();
                   6079: 
1.290     albertel 6080:     if (grep(/^st$/,@{$roles})) {
1.276     albertel 6081:         my ($classlist,$keylist)=&Apache::loncoursedata::get_classlist($cdom,$cnum);
1.278     raeburn  6082:         my $now = time;
1.277     albertel 6083:         foreach my $student (keys(%{$classlist})) {
1.288     raeburn  6084:             my $match = 0;
1.412     raeburn  6085:             my $secmatch = 0;
1.419     raeburn  6086:             my $section = $$classlist{$student}[$idx{section}];
1.609     raeburn  6087:             my $status = $$classlist{$student}[$idx{status}];
1.419     raeburn  6088:             if ($section eq '') {
                   6089:                 $section = 'none';
                   6090:             }
1.291     albertel 6091:             if ((ref($sections) eq 'ARRAY') && (@{$sections} > 0)) {
1.420     albertel 6092:                 if (grep(/^all$/,@{$sections})) {
1.412     raeburn  6093:                     $secmatch = 1;
                   6094:                 } elsif ($$classlist{$student}[$idx{section}] eq '') {
1.420     albertel 6095:                     if (grep(/^none$/,@{$sections})) {
1.412     raeburn  6096:                         $secmatch = 1;
                   6097:                     }
                   6098:                 } else {  
1.419     raeburn  6099: 		    if (grep(/^\Q$section\E$/,@{$sections})) {
1.412     raeburn  6100: 		        $secmatch = 1;
                   6101:                     }
1.290     albertel 6102: 		}
1.412     raeburn  6103:                 if (!$secmatch) {
                   6104:                     next;
                   6105:                 }
1.419     raeburn  6106:             }
1.275     raeburn  6107:             if (defined($$types{'active'})) {
1.288     raeburn  6108:                 if ($$classlist{$student}[$idx{status}] eq 'Active') {
1.275     raeburn  6109:                     push(@{$$users{st}{$student}},'active');
1.288     raeburn  6110:                     $match = 1;
1.275     raeburn  6111:                 }
                   6112:             }
                   6113:             if (defined($$types{'previous'})) {
1.609     raeburn  6114:                 if ($$classlist{$student}[$idx{status}] eq 'Expired') {
1.275     raeburn  6115:                     push(@{$$users{st}{$student}},'previous');
1.288     raeburn  6116:                     $match = 1;
1.275     raeburn  6117:                 }
                   6118:             }
                   6119:             if (defined($$types{'future'})) {
1.609     raeburn  6120:                 if ($$classlist{$student}[$idx{status}] eq 'Future') {
1.275     raeburn  6121:                     push(@{$$users{st}{$student}},'future');
1.288     raeburn  6122:                     $match = 1;
1.275     raeburn  6123:                 }
                   6124:             }
1.609     raeburn  6125:             if ($match) {
                   6126:                 push(@{$seclists{$student}},$section);
                   6127:                 if (ref($userdata) eq 'HASH') {
                   6128:                     $$userdata{$student} = $$classlist{$student};
                   6129:                 }
                   6130:                 if (ref($statushash) eq 'HASH') {
                   6131:                     $statushash->{$student}{'st'}{$section} = $status;
                   6132:                 }
1.288     raeburn  6133:             }
1.275     raeburn  6134:         }
                   6135:     }
1.412     raeburn  6136:     if ((@{$roles} > 1) || ((@{$roles} == 1) && ($$roles[0] ne "st"))) {
1.439     raeburn  6137:         my %coursepersonnel = &Apache::lonnet::dump('nohist_userroles',$cdom,$cnum);
                   6138:         my $now = time;
1.609     raeburn  6139:         my %displaystatus = ( previous => 'Expired',
                   6140:                               active   => 'Active',
                   6141:                               future   => 'Future',
                   6142:                             );
1.630     raeburn  6143:         my %nothide;
                   6144:         if ($hidepriv) {
                   6145:             my %coursehash=&Apache::lonnet::coursedescription($cdom.'_'.$cnum);
                   6146:             foreach my $user (split(/\s*\,\s*/,$coursehash{'nothideprivileged'})) {
                   6147:                 if ($user !~ /:/) {
                   6148:                     $nothide{join(':',split(/[\@]/,$user))}=1;
                   6149:                 } else {
                   6150:                     $nothide{$user} = 1;
                   6151:                 }
                   6152:             }
                   6153:         }
1.439     raeburn  6154:         foreach my $person (sort(keys(%coursepersonnel))) {
1.288     raeburn  6155:             my $match = 0;
1.412     raeburn  6156:             my $secmatch = 0;
1.439     raeburn  6157:             my $status;
1.412     raeburn  6158:             my ($role,$user,$usec) = ($person =~ /^([^:]*):([^:]+:[^:]+):([^:]*)/);
1.275     raeburn  6159:             $user =~ s/:$//;
1.439     raeburn  6160:             my ($end,$start) = split(/:/,$coursepersonnel{$person});
                   6161:             if ($end == -1 || $start == -1) {
                   6162:                 next;
                   6163:             }
                   6164:             if (($role) && ((grep(/^\Q$role\E$/,@{$roles})) ||
                   6165:                 (grep(/^cr$/,@{$roles}) && $role =~ /^cr\//))) {
1.412     raeburn  6166:                 my ($uname,$udom) = split(/:/,$user);
                   6167:                 if ((ref($sections) eq 'ARRAY') && (@{$sections} > 0)) {
1.420     albertel 6168:                     if (grep(/^all$/,@{$sections})) {
1.412     raeburn  6169:                         $secmatch = 1;
                   6170:                     } elsif ($usec eq '') {
1.420     albertel 6171:                         if (grep(/^none$/,@{$sections})) {
1.412     raeburn  6172:                             $secmatch = 1;
                   6173:                         }
                   6174:                     } else {
                   6175:                         if (grep(/^\Q$usec\E$/,@{$sections})) {
                   6176:                             $secmatch = 1;
                   6177:                         }
                   6178:                     }
                   6179:                     if (!$secmatch) {
                   6180:                         next;
                   6181:                     }
1.288     raeburn  6182:                 }
1.419     raeburn  6183:                 if ($usec eq '') {
                   6184:                     $usec = 'none';
                   6185:                 }
1.275     raeburn  6186:                 if ($uname ne '' && $udom ne '') {
1.630     raeburn  6187:                     if ($hidepriv) {
                   6188:                         if ((&Apache::lonnet::privileged($uname,$udom)) &&
                   6189:                             (!$nothide{$uname.':'.$udom})) {
                   6190:                             next;
                   6191:                         }
                   6192:                     }
1.503     raeburn  6193:                     if ($end > 0 && $end < $now) {
1.439     raeburn  6194:                         $status = 'previous';
                   6195:                     } elsif ($start > $now) {
                   6196:                         $status = 'future';
                   6197:                     } else {
                   6198:                         $status = 'active';
                   6199:                     }
1.277     albertel 6200:                     foreach my $type (keys(%{$types})) { 
1.275     raeburn  6201:                         if ($status eq $type) {
1.420     albertel 6202:                             if (!grep(/^\Q$type\E$/,@{$$users{$role}{$user}})) {
1.419     raeburn  6203:                                 push(@{$$users{$role}{$user}},$type);
                   6204:                             }
1.288     raeburn  6205:                             $match = 1;
                   6206:                         }
                   6207:                     }
1.419     raeburn  6208:                     if (($match) && (ref($userdata) eq 'HASH')) {
                   6209:                         if (!exists($$userdata{$uname.':'.$udom})) {
                   6210: 			    &get_user_info($udom,$uname,\%idx,$userdata);
                   6211:                         }
1.420     albertel 6212:                         if (!grep(/^\Q$usec\E$/,@{$seclists{$uname.':'.$udom}})) {
1.419     raeburn  6213:                             push(@{$seclists{$uname.':'.$udom}},$usec);
                   6214:                         }
1.609     raeburn  6215:                         if (ref($statushash) eq 'HASH') {
                   6216:                             $statushash->{$uname.':'.$udom}{$role}{$usec} = $displaystatus{$status};
                   6217:                         }
1.275     raeburn  6218:                     }
                   6219:                 }
                   6220:             }
                   6221:         }
1.290     albertel 6222:         if (grep(/^ow$/,@{$roles})) {
1.279     raeburn  6223:             if ((defined($cdom)) && (defined($cnum))) {
                   6224:                 my %csettings = &Apache::lonnet::get('environment',['internal.courseowner'],$cdom,$cnum);
                   6225:                 if ( defined($csettings{'internal.courseowner'}) ) {
                   6226:                     my $owner = $csettings{'internal.courseowner'};
1.609     raeburn  6227:                     next if ($owner eq '');
                   6228:                     my ($ownername,$ownerdom);
                   6229:                     if ($owner =~ /^([^:]+):([^:]+)$/) {
                   6230:                         $ownername = $1;
                   6231:                         $ownerdom = $2;
                   6232:                     } else {
                   6233:                         $ownername = $owner;
                   6234:                         $ownerdom = $cdom;
                   6235:                         $owner = $ownername.':'.$ownerdom;
1.439     raeburn  6236:                     }
                   6237:                     @{$$users{'ow'}{$owner}} = 'any';
1.290     albertel 6238:                     if (defined($userdata) && 
1.609     raeburn  6239: 			!exists($$userdata{$owner})) {
                   6240: 			&get_user_info($ownerdom,$ownername,\%idx,$userdata);
                   6241:                         if (!grep(/^none$/,@{$seclists{$owner}})) {
                   6242:                             push(@{$seclists{$owner}},'none');
                   6243:                         }
                   6244:                         if (ref($statushash) eq 'HASH') {
                   6245:                             $statushash->{$owner}{'ow'}{'none'} = 'Any';
1.419     raeburn  6246:                         }
1.290     albertel 6247: 		    }
1.279     raeburn  6248:                 }
                   6249:             }
                   6250:         }
1.419     raeburn  6251:         foreach my $user (keys(%seclists)) {
                   6252:             @{$seclists{$user}} = (sort {$a <=> $b} @{$seclists{$user}});
                   6253:             $$userdata{$user}[$idx{section}] = join(',',@{$seclists{$user}});
                   6254:         }
1.275     raeburn  6255:     }
                   6256:     return;
                   6257: }
                   6258: 
1.288     raeburn  6259: sub get_user_info {
                   6260:     my ($udom,$uname,$idx,$userdata) = @_;
1.289     albertel 6261:     $$userdata{$uname.':'.$udom}[$$idx{fullname}] = 
                   6262: 	&plainname($uname,$udom,'lastname');
1.291     albertel 6263:     $$userdata{$uname.':'.$udom}[$$idx{uname}] = $uname;
1.297     raeburn  6264:     $$userdata{$uname.':'.$udom}[$$idx{udom}] = $udom;
1.609     raeburn  6265:     my %idhash =  &Apache::lonnet::idrget($udom,($uname));
                   6266:     $$userdata{$uname.':'.$udom}[$$idx{id}] = $idhash{$uname}; 
1.288     raeburn  6267:     return;
                   6268: }
1.275     raeburn  6269: 
1.472     raeburn  6270: ###############################################
                   6271: 
                   6272: =pod
                   6273: 
                   6274: =item * &get_user_quota()
                   6275: 
                   6276: Retrieves quota assigned for storage of portfolio files for a user  
                   6277: 
                   6278: Incoming parameters:
                   6279: 1. user's username
                   6280: 2. user's domain
                   6281: 
                   6282: Returns:
1.536     raeburn  6283: 1. Disk quota (in Mb) assigned to student.
                   6284: 2. (Optional) Type of setting: custom or default
                   6285:    (individually assigned or default for user's 
                   6286:    institutional status).
                   6287: 3. (Optional) - User's institutional status (e.g., faculty, staff
                   6288:    or student - types as defined in localenroll::inst_usertypes 
                   6289:    for user's domain, which determines default quota for user.
                   6290: 4. (Optional) - Default quota which would apply to the user.
1.472     raeburn  6291: 
                   6292: If a value has been stored in the user's environment, 
1.536     raeburn  6293: it will return that, otherwise it returns the maximal default
                   6294: defined for the user's instituional status(es) in the domain.
1.472     raeburn  6295: 
                   6296: =cut
                   6297: 
                   6298: ###############################################
                   6299: 
                   6300: 
                   6301: sub get_user_quota {
                   6302:     my ($uname,$udom) = @_;
1.536     raeburn  6303:     my ($quota,$quotatype,$settingstatus,$defquota);
1.472     raeburn  6304:     if (!defined($udom)) {
                   6305:         $udom = $env{'user.domain'};
                   6306:     }
                   6307:     if (!defined($uname)) {
                   6308:         $uname = $env{'user.name'};
                   6309:     }
                   6310:     if (($udom eq '' || $uname eq '') ||
                   6311:         ($udom eq 'public') && ($uname eq 'public')) {
                   6312:         $quota = 0;
1.536     raeburn  6313:         $quotatype = 'default';
                   6314:         $defquota = 0; 
1.472     raeburn  6315:     } else {
1.536     raeburn  6316:         my $inststatus;
1.472     raeburn  6317:         if ($udom eq $env{'user.domain'} && $uname eq $env{'user.name'}) {
                   6318:             $quota = $env{'environment.portfolioquota'};
1.536     raeburn  6319:             $inststatus = $env{'environment.inststatus'};
1.472     raeburn  6320:         } else {
1.536     raeburn  6321:             my %userenv = 
                   6322:                 &Apache::lonnet::get('environment',['portfolioquota',
                   6323:                                      'inststatus'],$udom,$uname);
1.472     raeburn  6324:             my ($tmp) = keys(%userenv);
                   6325:             if ($tmp !~ /^(con_lost|error|no_such_host)/i) {
                   6326:                 $quota = $userenv{'portfolioquota'};
1.536     raeburn  6327:                 $inststatus = $userenv{'inststatus'};
1.472     raeburn  6328:             } else {
                   6329:                 undef(%userenv);
                   6330:             }
                   6331:         }
1.536     raeburn  6332:         ($defquota,$settingstatus) = &default_quota($udom,$inststatus);
1.472     raeburn  6333:         if ($quota eq '') {
1.536     raeburn  6334:             $quota = $defquota;
                   6335:             $quotatype = 'default';
                   6336:         } else {
                   6337:             $quotatype = 'custom';
1.472     raeburn  6338:         }
                   6339:     }
1.536     raeburn  6340:     if (wantarray) {
                   6341:         return ($quota,$quotatype,$settingstatus,$defquota);
                   6342:     } else {
                   6343:         return $quota;
                   6344:     }
1.472     raeburn  6345: }
                   6346: 
                   6347: ###############################################
                   6348: 
                   6349: =pod
                   6350: 
                   6351: =item * &default_quota()
                   6352: 
1.536     raeburn  6353: Retrieves default quota assigned for storage of user portfolio files,
                   6354: given an (optional) user's institutional status.
1.472     raeburn  6355: 
                   6356: Incoming parameters:
                   6357: 1. domain
1.536     raeburn  6358: 2. (Optional) institutional status(es).  This is a : separated list of 
                   6359:    status types (e.g., faculty, staff, student etc.)
                   6360:    which apply to the user for whom the default is being retrieved.
                   6361:    If the institutional status string in undefined, the domain
                   6362:    default quota will be returned. 
1.472     raeburn  6363: 
                   6364: Returns:
                   6365: 1. Default disk quota (in Mb) for user portfolios in the domain.
1.536     raeburn  6366: 2. (Optional) institutional type which determined the value of the
                   6367:    default quota.
1.472     raeburn  6368: 
                   6369: If a value has been stored in the domain's configuration db,
                   6370: it will return that, otherwise it returns 20 (for backwards 
                   6371: compatibility with domains which have not set up a configuration
                   6372: db file; the original statically defined portfolio quota was 20 Mb). 
                   6373: 
1.536     raeburn  6374: If the user's status includes multiple types (e.g., staff and student),
                   6375: the largest default quota which applies to the user determines the
                   6376: default quota returned.
                   6377: 
1.472     raeburn  6378: =cut
                   6379: 
                   6380: ###############################################
                   6381: 
                   6382: 
                   6383: sub default_quota {
1.536     raeburn  6384:     my ($udom,$inststatus) = @_;
                   6385:     my ($defquota,$settingstatus);
                   6386:     my %quotahash = &Apache::lonnet::get_dom('configuration',
1.622     raeburn  6387:                                             ['quotas'],$udom);
                   6388:     if (ref($quotahash{'quotas'}) eq 'HASH') {
1.536     raeburn  6389:         if ($inststatus ne '') {
                   6390:             my @statuses = split(/:/,$inststatus);
                   6391:             foreach my $item (@statuses) {
1.622     raeburn  6392:                 if ($quotahash{'quotas'}{$item} ne '') {
1.536     raeburn  6393:                     if ($defquota eq '') {
1.622     raeburn  6394:                         $defquota = $quotahash{'quotas'}{$item};
1.536     raeburn  6395:                         $settingstatus = $item;
1.622     raeburn  6396:                     } elsif ($quotahash{'quotas'}{$item} > $defquota) {
                   6397:                         $defquota = $quotahash{'quotas'}{$item};
1.536     raeburn  6398:                         $settingstatus = $item;
                   6399:                     }
                   6400:                 }
                   6401:             }
                   6402:         }
                   6403:         if ($defquota eq '') {
1.622     raeburn  6404:             $defquota = $quotahash{'quotas'}{'default'};
1.536     raeburn  6405:             $settingstatus = 'default';
                   6406:         }
                   6407:     } else {
                   6408:         $settingstatus = 'default';
                   6409:         $defquota = 20;
                   6410:     }
                   6411:     if (wantarray) {
                   6412:         return ($defquota,$settingstatus);
1.472     raeburn  6413:     } else {
1.536     raeburn  6414:         return $defquota;
1.472     raeburn  6415:     }
                   6416: }
                   6417: 
1.384     raeburn  6418: sub get_secgrprole_info {
                   6419:     my ($cdom,$cnum,$needroles,$type)  = @_;
                   6420:     my %sections_count = &get_sections($cdom,$cnum);
                   6421:     my @sections =  (sort {$a <=> $b} keys(%sections_count));
                   6422:     my %curr_groups = &Apache::longroup::coursegroups($cdom,$cnum);
                   6423:     my @groups = sort(keys(%curr_groups));
                   6424:     my $allroles = [];
                   6425:     my $rolehash;
                   6426:     my $accesshash = {
                   6427:                      active => 'Currently has access',
                   6428:                      future => 'Will have future access',
                   6429:                      previous => 'Previously had access',
                   6430:                   };
                   6431:     if ($needroles) {
                   6432:         $rolehash = {'all' => 'all'};
1.385     albertel 6433:         my %user_roles = &Apache::lonnet::dump('nohist_userroles',$cdom,$cnum);
                   6434: 	if (&Apache::lonnet::error(%user_roles)) {
                   6435: 	    undef(%user_roles);
                   6436: 	}
                   6437:         foreach my $item (keys(%user_roles)) {
1.384     raeburn  6438:             my ($role)=split(/\:/,$item,2);
                   6439:             if ($role eq 'cr') { next; }
                   6440:             if ($role =~ /^cr/) {
                   6441:                 $$rolehash{$role} = (split('/',$role))[3];
                   6442:             } else {
                   6443:                 $$rolehash{$role} = &Apache::lonnet::plaintext($role,$type);
                   6444:             }
                   6445:         }
                   6446:         foreach my $key (sort(keys(%{$rolehash}))) {
                   6447:             push(@{$allroles},$key);
                   6448:         }
                   6449:         push (@{$allroles},'st');
                   6450:         $$rolehash{'st'} = &Apache::lonnet::plaintext('st',$type);
                   6451:     }
                   6452:     return (\@sections,\@groups,$allroles,$rolehash,$accesshash);
                   6453: }
                   6454: 
1.555     raeburn  6455: sub user_picker {
1.627     raeburn  6456:     my ($dom,$srch,$forcenewuser,$caller,$cancreate,$usertype) = @_;
1.555     raeburn  6457:     my $currdom = $dom;
                   6458:     my %curr_selected = (
                   6459:                         srchin => 'dom',
1.580     raeburn  6460:                         srchby => 'lastname',
1.555     raeburn  6461:                       );
                   6462:     my $srchterm;
1.625     raeburn  6463:     if ((ref($srch) eq 'HASH') && ($env{'form.origform'} ne 'crtusername')) {
1.555     raeburn  6464:         if ($srch->{'srchby'} ne '') {
                   6465:             $curr_selected{'srchby'} = $srch->{'srchby'};
                   6466:         }
                   6467:         if ($srch->{'srchin'} ne '') {
                   6468:             $curr_selected{'srchin'} = $srch->{'srchin'};
                   6469:         }
                   6470:         if ($srch->{'srchtype'} ne '') {
                   6471:             $curr_selected{'srchtype'} = $srch->{'srchtype'};
                   6472:         }
                   6473:         if ($srch->{'srchdomain'} ne '') {
                   6474:             $currdom = $srch->{'srchdomain'};
                   6475:         }
                   6476:         $srchterm = $srch->{'srchterm'};
                   6477:     }
                   6478:     my %lt=&Apache::lonlocal::texthash(
1.573     raeburn  6479:                     'usr'       => 'Search criteria',
1.563     raeburn  6480:                     'doma'      => 'Domain/institution to search',
1.558     albertel 6481:                     'uname'     => 'username',
                   6482:                     'lastname'  => 'last name',
1.555     raeburn  6483:                     'lastfirst' => 'last name, first name',
1.558     albertel 6484:                     'crs'       => 'in this course',
1.576     raeburn  6485:                     'dom'       => 'in selected LON-CAPA domain', 
1.558     albertel 6486:                     'alc'       => 'all LON-CAPA',
1.573     raeburn  6487:                     'instd'     => 'in institutional directory for selected domain',
1.558     albertel 6488:                     'exact'     => 'is',
                   6489:                     'contains'  => 'contains',
1.569     raeburn  6490:                     'begins'    => 'begins with',
1.571     raeburn  6491:                     'youm'      => "You must include some text to search for.",
                   6492:                     'thte'      => "The text you are searching for must contain at least two characters when using a 'begins' type search.",
                   6493:                     'thet'      => "The text you are searching for must contain at least three characters when using a 'contains' type search.",
                   6494:                     'yomc'      => "You must choose a domain when using an institutional directory search.",
                   6495:                     'ymcd'      => "You must choose a domain when using a domain search.",
                   6496:                     'whus'      => "When using searching by last,first you must include a comma as separator between last name and first name.",
                   6497:                     'whse'      => "When searching by last,first you must include at least one character in the first name.",
                   6498:                      'thfo'     => "The following need to be corrected before the search can be run:",
1.555     raeburn  6499:                                        );
1.563     raeburn  6500:     my $domform = &select_dom_form($currdom,'srchdomain',1,1);
                   6501:     my $srchinsel = ' <select name="srchin">';
1.555     raeburn  6502: 
                   6503:     my @srchins = ('crs','dom','alc','instd');
                   6504: 
                   6505:     foreach my $option (@srchins) {
                   6506:         # FIXME 'alc' option unavailable until 
                   6507:         #       loncreateuser::print_user_query_page()
                   6508:         #       has been completed.
                   6509:         next if ($option eq 'alc');
                   6510:         next if ($option eq 'crs' && !$env{'request.course.id'});
1.563     raeburn  6511:         if ($curr_selected{'srchin'} eq $option) {
                   6512:             $srchinsel .= ' 
                   6513:    <option value="'.$option.'" selected="selected">'.$lt{$option}.'</option>';
                   6514:         } else {
                   6515:             $srchinsel .= '
                   6516:    <option value="'.$option.'">'.$lt{$option}.'</option>';
                   6517:         }
1.555     raeburn  6518:     }
1.563     raeburn  6519:     $srchinsel .= "\n  </select>\n";
1.555     raeburn  6520: 
                   6521:     my $srchbysel =  ' <select name="srchby">';
1.580     raeburn  6522:     foreach my $option ('lastname','lastfirst','uname') {
1.555     raeburn  6523:         if ($curr_selected{'srchby'} eq $option) {
                   6524:             $srchbysel .= '
                   6525:    <option value="'.$option.'" selected="selected">'.$lt{$option}.'</option>';
                   6526:         } else {
                   6527:             $srchbysel .= '
                   6528:    <option value="'.$option.'">'.$lt{$option}.'</option>';
                   6529:          }
                   6530:     }
                   6531:     $srchbysel .= "\n  </select>\n";
                   6532: 
                   6533:     my $srchtypesel = ' <select name="srchtype">';
1.580     raeburn  6534:     foreach my $option ('begins','contains','exact') {
1.555     raeburn  6535:         if ($curr_selected{'srchtype'} eq $option) {
                   6536:             $srchtypesel .= '
                   6537:    <option value="'.$option.'" selected="selected">'.$lt{$option}.'</option>';
                   6538:         } else {
                   6539:             $srchtypesel .= '
                   6540:    <option value="'.$option.'">'.$lt{$option}.'</option>';
                   6541:         }
                   6542:     }
                   6543:     $srchtypesel .= "\n  </select>\n";
                   6544: 
1.558     albertel 6545:     my ($newuserscript,$new_user_create);
1.556     raeburn  6546: 
                   6547:     if ($forcenewuser) {
1.576     raeburn  6548:         if (ref($srch) eq 'HASH') {
                   6549:             if ($srch->{'srchby'} eq 'uname' && $srch->{'srchtype'} eq 'exact' && $srch->{'srchin'} eq 'dom' && $srch->{'srchdomain'} eq $env{'request.role.domain'}) {
1.627     raeburn  6550:                 if ($cancreate) {
                   6551:                     $new_user_create = '<p> <input type="submit" name="forcenew" value="'.&HTML::Entities::encode(&mt('Make new user "[_1]"',$srchterm),'<>&"').'" onclick="javascript:setSearch(\'1\','.$caller.');" /> </p>';
                   6552:                 } else {
                   6553:                     my $helplink = ' href="javascript:helpMenu('."'display'".')"';
                   6554:                     my %usertypetext = (
                   6555:                         official   => 'institutional',
                   6556:                         unofficial => 'non-institutional',
                   6557:                     );
                   6558:                     $new_user_create = '<br /><span class="LC_warning">'.&mt("You are not authorized to create new $usertypetext{$usertype} users in this domain.").' '.&mt('Contact the <a[_1]>helpdesk</a> for assistance.',$helplink).'</span><br /><br />';
                   6559:                 }
1.576     raeburn  6560:             }
                   6561:         }
                   6562: 
1.556     raeburn  6563:         $newuserscript = <<"ENDSCRIPT";
                   6564: 
1.570     raeburn  6565: function setSearch(createnew,callingForm) {
1.556     raeburn  6566:     if (createnew == 1) {
1.570     raeburn  6567:         for (var i=0; i<callingForm.srchby.length; i++) {
                   6568:             if (callingForm.srchby.options[i].value == 'uname') {
                   6569:                 callingForm.srchby.selectedIndex = i;
1.556     raeburn  6570:             }
                   6571:         }
1.570     raeburn  6572:         for (var i=0; i<callingForm.srchin.length; i++) {
                   6573:             if ( callingForm.srchin.options[i].value == 'dom') {
                   6574: 		callingForm.srchin.selectedIndex = i;
1.556     raeburn  6575:             }
                   6576:         }
1.570     raeburn  6577:         for (var i=0; i<callingForm.srchtype.length; i++) {
                   6578:             if (callingForm.srchtype.options[i].value == 'exact') {
                   6579:                 callingForm.srchtype.selectedIndex = i;
1.556     raeburn  6580:             }
                   6581:         }
1.570     raeburn  6582:         for (var i=0; i<callingForm.srchdomain.length; i++) {
                   6583:             if (callingForm.srchdomain.options[i].value == '$env{'request.role.domain'}') {
                   6584:                 callingForm.srchdomain.selectedIndex = i;
1.556     raeburn  6585:             }
                   6586:         }
                   6587:     }
                   6588: }
                   6589: ENDSCRIPT
1.558     albertel 6590: 
1.556     raeburn  6591:     }
                   6592: 
1.555     raeburn  6593:     my $output = <<"END_BLOCK";
1.556     raeburn  6594: <script type="text/javascript">
1.570     raeburn  6595: function validateEntry(callingForm) {
1.558     albertel 6596: 
1.556     raeburn  6597:     var checkok = 1;
1.558     albertel 6598:     var srchin;
1.570     raeburn  6599:     for (var i=0; i<callingForm.srchin.length; i++) {
                   6600: 	if ( callingForm.srchin[i].checked ) {
                   6601: 	    srchin = callingForm.srchin[i].value;
1.558     albertel 6602: 	}
                   6603:     }
                   6604: 
1.570     raeburn  6605:     var srchtype = callingForm.srchtype.options[callingForm.srchtype.selectedIndex].value;
                   6606:     var srchby = callingForm.srchby.options[callingForm.srchby.selectedIndex].value;
                   6607:     var srchdomain = callingForm.srchdomain.options[callingForm.srchdomain.selectedIndex].value;
                   6608:     var srchterm =  callingForm.srchterm.value;
                   6609:     var srchin = callingForm.srchin.options[callingForm.srchin.selectedIndex].value;
1.556     raeburn  6610:     var msg = "";
                   6611: 
                   6612:     if (srchterm == "") {
                   6613:         checkok = 0;
1.571     raeburn  6614:         msg += "$lt{'youm'}\\n";
1.556     raeburn  6615:     }
                   6616: 
1.569     raeburn  6617:     if (srchtype== 'begins') {
                   6618:         if (srchterm.length < 2) {
                   6619:             checkok = 0;
1.571     raeburn  6620:             msg += "$lt{'thte'}\\n";
1.569     raeburn  6621:         }
                   6622:     }
                   6623: 
1.556     raeburn  6624:     if (srchtype== 'contains') {
                   6625:         if (srchterm.length < 3) {
                   6626:             checkok = 0;
1.571     raeburn  6627:             msg += "$lt{'thet'}\\n";
1.556     raeburn  6628:         }
                   6629:     }
                   6630:     if (srchin == 'instd') {
                   6631:         if (srchdomain == '') {
                   6632:             checkok = 0;
1.571     raeburn  6633:             msg += "$lt{'yomc'}\\n";
1.556     raeburn  6634:         }
                   6635:     }
                   6636:     if (srchin == 'dom') {
                   6637:         if (srchdomain == '') {
                   6638:             checkok = 0;
1.571     raeburn  6639:             msg += "$lt{'ymcd'}\\n";
1.556     raeburn  6640:         }
                   6641:     }
                   6642:     if (srchby == 'lastfirst') {
                   6643:         if (srchterm.indexOf(",") == -1) {
                   6644:             checkok = 0;
1.571     raeburn  6645:             msg += "$lt{'whus'}\\n";
1.556     raeburn  6646:         }
                   6647:         if (srchterm.indexOf(",") == srchterm.length -1) {
                   6648:             checkok = 0;
1.571     raeburn  6649:             msg += "$lt{'whse'}\\n";
1.556     raeburn  6650:         }
                   6651:     }
                   6652:     if (checkok == 0) {
1.571     raeburn  6653:         alert("$lt{'thfo'}\\n"+msg);
1.556     raeburn  6654:         return;
                   6655:     }
                   6656:     if (checkok == 1) {
1.570     raeburn  6657:         callingForm.submit();
1.556     raeburn  6658:     }
                   6659: }
                   6660: 
                   6661: $newuserscript
                   6662: 
                   6663: </script>
1.558     albertel 6664: 
                   6665: $new_user_create
                   6666: 
1.555     raeburn  6667: <table>
1.558     albertel 6668:  <tr>
1.573     raeburn  6669:   <td>$lt{'doma'}:</td>
                   6670:   <td>$domform</td>
                   6671:   </td>
                   6672:  </tr>
                   6673:  <tr>
                   6674:   <td>$lt{'usr'}:</td>
1.563     raeburn  6675:   <td>$srchbysel
                   6676:       $srchtypesel 
                   6677:       <input type="text" size="15" name="srchterm" value="$srchterm" />
1.564     albertel 6678:       $srchinsel 
1.563     raeburn  6679:   </td>
                   6680:  </tr>
1.555     raeburn  6681: </table>
                   6682: <br />
                   6683: END_BLOCK
1.558     albertel 6684: 
1.555     raeburn  6685:     return $output;
                   6686: }
                   6687: 
1.612     raeburn  6688: sub user_rule_check {
1.615     raeburn  6689:     my ($usershash,$checks,$alerts,$rulematch,$inst_results,$curr_rules,$got_rules) = @_;
1.612     raeburn  6690:     my $response;
                   6691:     if (ref($usershash) eq 'HASH') {
                   6692:         foreach my $user (keys(%{$usershash})) {
                   6693:             my ($uname,$udom) = split(/:/,$user);
                   6694:             next if ($udom eq '' || $uname eq '');
1.615     raeburn  6695:             my ($id,$newuser);
1.612     raeburn  6696:             if (ref($usershash->{$user}) eq 'HASH') {
1.615     raeburn  6697:                 $newuser = $usershash->{$user}->{'newuser'};
1.612     raeburn  6698:                 $id = $usershash->{$user}->{'id'};
                   6699:             }
                   6700:             my $inst_response;
                   6701:             if (ref($checks) eq 'HASH') {
                   6702:                 if (defined($checks->{'username'})) {
1.615     raeburn  6703:                     ($inst_response,%{$inst_results->{$user}}) = 
1.612     raeburn  6704:                         &Apache::lonnet::get_instuser($udom,$uname);
                   6705:                 } elsif (defined($checks->{'id'})) {
1.615     raeburn  6706:                     ($inst_response,%{$inst_results->{$user}}) =
1.612     raeburn  6707:                         &Apache::lonnet::get_instuser($udom,undef,$id);
                   6708:                 }
1.615     raeburn  6709:             } else {
                   6710:                 ($inst_response,%{$inst_results->{$user}}) =
                   6711:                     &Apache::lonnet::get_instuser($udom,$uname);
                   6712:                 return;
1.612     raeburn  6713:             }
1.615     raeburn  6714:             if (!$got_rules->{$udom}) {
1.612     raeburn  6715:                 my %domconfig = &Apache::lonnet::get_dom('configuration',
                   6716:                                                   ['usercreation'],$udom);
                   6717:                 if (ref($domconfig{'usercreation'}) eq 'HASH') {
1.615     raeburn  6718:                     foreach my $item ('username','id') {
1.612     raeburn  6719:                         if (ref($domconfig{'usercreation'}{$item.'_rule'}) eq 'ARRAY') {
                   6720:                             $$curr_rules{$udom}{$item} = 
                   6721:                                 $domconfig{'usercreation'}{$item.'_rule'};
1.585     raeburn  6722:                         }
                   6723:                     }
                   6724:                 }
1.615     raeburn  6725:                 $got_rules->{$udom} = 1;  
1.585     raeburn  6726:             }
1.612     raeburn  6727:             foreach my $item (keys(%{$checks})) {
                   6728:                 if (ref($$curr_rules{$udom}) eq 'HASH') {
                   6729:                     if (ref($$curr_rules{$udom}{$item}) eq 'ARRAY') {
                   6730:                         if (@{$$curr_rules{$udom}{$item}} > 0) {
                   6731:                             my %rule_check = &Apache::lonnet::inst_rulecheck($udom,$uname,$id,$item,$$curr_rules{$udom}{$item});
                   6732:                             foreach my $rule (@{$$curr_rules{$udom}{$item}}) {
                   6733:                                 if ($rule_check{$rule}) {
                   6734:                                     $$rulematch{$user}{$item} = $rule;
                   6735:                                     if ($inst_response eq 'ok') {
1.615     raeburn  6736:                                         if (ref($inst_results) eq 'HASH') {
                   6737:                                             if (ref($inst_results->{$user}) eq 'HASH') {
                   6738:                                                 if (keys(%{$inst_results->{$user}}) == 0) {
                   6739:                                                     $$alerts{$item}{$udom}{$uname} = 1;
                   6740:                                                 }
1.612     raeburn  6741:                                             }
                   6742:                                         }
1.615     raeburn  6743:                                     }
                   6744:                                     last;
1.585     raeburn  6745:                                 }
                   6746:                             }
                   6747:                         }
                   6748:                     }
                   6749:                 }
                   6750:             }
                   6751:         }
                   6752:     }
1.612     raeburn  6753:     return;
                   6754: }
                   6755: 
                   6756: sub user_rule_formats {
                   6757:     my ($domain,$domdesc,$curr_rules,$check) = @_;
                   6758:     my %text = ( 
                   6759:                  'username' => 'Usernames',
                   6760:                  'id'       => 'IDs',
                   6761:                );
                   6762:     my $output;
                   6763:     my ($rules,$ruleorder) = &Apache::lonnet::inst_userrules($domain,$check);
                   6764:     if ((ref($rules) eq 'HASH') && (ref($ruleorder) eq 'ARRAY')) {
                   6765:         if (@{$ruleorder} > 0) {
                   6766:             $output = '<br />'.&mt("$text{$check} with the following format(s) may <span class=\"LC_cusr_emph\">only</span> be used for verified users at [_1]:",$domdesc).' <ul>';
                   6767:             foreach my $rule (@{$ruleorder}) {
                   6768:                 if (ref($curr_rules) eq 'ARRAY') {
                   6769:                     if (grep(/^\Q$rule\E$/,@{$curr_rules})) {
                   6770:                         if (ref($rules->{$rule}) eq 'HASH') {
                   6771:                             $output .= '<li>'.$rules->{$rule}{'name'}.': '.
                   6772:                                         $rules->{$rule}{'desc'}.'</li>';
                   6773:                         }
                   6774:                     }
                   6775:                 }
                   6776:             }
                   6777:             $output .= '</ul>';
                   6778:         }
                   6779:     }
                   6780:     return $output;
                   6781: }
                   6782: 
                   6783: sub instrule_disallow_msg {
1.615     raeburn  6784:     my ($checkitem,$domdesc,$count,$mode) = @_;
1.612     raeburn  6785:     my $response;
                   6786:     my %text = (
                   6787:                   item   => 'username',
                   6788:                   items  => 'usernames',
                   6789:                   match  => 'matches',
                   6790:                   do     => 'does',
                   6791:                   action => 'a username',
                   6792:                   one    => 'one',
                   6793:                );
                   6794:     if ($count > 1) {
                   6795:         $text{'item'} = 'usernames';
                   6796:         $text{'match'} ='match';
                   6797:         $text{'do'} = 'do';
                   6798:         $text{'action'} = 'usernames',
                   6799:         $text{'one'} = 'ones';
                   6800:     }
                   6801:     if ($checkitem eq 'id') {
                   6802:         $text{'items'} = 'IDs';
                   6803:         $text{'item'} = 'ID';
                   6804:         $text{'action'} = 'an ID';
1.615     raeburn  6805:         if ($count > 1) {
                   6806:             $text{'item'} = 'IDs';
                   6807:             $text{'action'} = 'IDs';
                   6808:         }
1.612     raeburn  6809:     }
                   6810:     $response = &mt("The $text{'item'} you chose $text{'match'} the format of $text{'items'} defined for <span class=\"LC_cusr_emph\">[_1]</span>, but the $text{'item'} $text{'do'} not exist in the institutional directory.",$domdesc).'<br />';
1.615     raeburn  6811:     if ($mode eq 'upload') {
                   6812:         if ($checkitem eq 'username') {
                   6813:             $response .= &mt("You will need to modify your upload file so it will include $text{'action'} with a different format --  $text{'one'} that will not conflict with 'official' institutional $text{'items'}.");
                   6814:         } elsif ($checkitem eq 'id') {
                   6815:             $response .= &mt("Either upload a file which includes $text{'action'} with a different format --  $text{'one'} that will not conflict with 'official' institutional $text{'items'}, or when associating fields with data columns, omit an association for the ID/Student Number field.");
                   6816:         }
                   6817:     } else {
                   6818:         if ($checkitem eq 'username') {
                   6819:             $response .= &mt("You must choose $text{'action'} with a different format --  $text{'one'} that will not conflict with 'official' institutional $text{'items'}.");
                   6820:         } elsif ($checkitem eq 'id') {
                   6821:             $response .= &mt("You must either choose $text{'action'} with a different format --  $text{'one'} that will not conflict with 'official' institutional $text{'items'}, or leave the ID field blank.");
                   6822:         }
1.612     raeburn  6823:     }
                   6824:     return $response;
1.585     raeburn  6825: }
                   6826: 
1.624     raeburn  6827: sub personal_data_fieldtitles {
                   6828:     my %fieldtitles = &Apache::lonlocal::texthash (
                   6829:                         id => 'Student/Employee ID',
                   6830:                         permanentemail => 'E-mail address',
                   6831:                         lastname => 'Last Name',
                   6832:                         firstname => 'First Name',
                   6833:                         middlename => 'Middle Name',
                   6834:                         generation => 'Generation',
                   6835:                         gen => 'Generation',
                   6836:                    );
                   6837:     return %fieldtitles;
                   6838: }
                   6839: 
1.642     raeburn  6840: sub sorted_inst_types {
                   6841:     my ($dom) = @_;
                   6842:     my ($usertypes,$order) = &Apache::lonnet::retrieve_inst_usertypes($dom);
                   6843:     my $othertitle = &mt('All users');
                   6844:     if ($env{'request.course.id'}) {
                   6845:         $othertitle  = 'any';
                   6846:     }
                   6847:     my @types;
                   6848:     if (ref($order) eq 'ARRAY') {
                   6849:         @types = @{$order};
                   6850:     }
                   6851:     if (@types == 0) {
                   6852:         if (ref($usertypes) eq 'HASH') {
                   6853:             @types = sort(keys(%{$usertypes}));
                   6854:         }
                   6855:     }
                   6856:     if (keys(%{$usertypes}) > 0) {
                   6857:         $othertitle = &mt('Other users');
                   6858:         if ($env{'request.course.id'}) {
                   6859:             $othertitle = 'other';
                   6860:         }
                   6861:     }
                   6862:     return ($othertitle,$usertypes,\@types);
                   6863: }
                   6864: 
1.645     raeburn  6865: sub get_institutional_codes {
                   6866:     my ($settings,$allcourses,$LC_code) = @_;
                   6867: # Get complete list of course sections to update
                   6868:     my @currsections = ();
                   6869:     my @currxlists = ();
                   6870:     my $coursecode = $$settings{'internal.coursecode'};
                   6871: 
                   6872:     if ($$settings{'internal.sectionnums'} ne '') {
                   6873:         @currsections = split(/,/,$$settings{'internal.sectionnums'});
                   6874:     }
                   6875: 
                   6876:     if ($$settings{'internal.crosslistings'} ne '') {
                   6877:         @currxlists = split(/,/,$$settings{'internal.crosslistings'});
                   6878:     }
                   6879: 
                   6880:     if (@currxlists > 0) {
                   6881:         foreach (@currxlists) {
                   6882:             if (m/^([^:]+):(\w*)$/) {
                   6883:                 unless (grep/^$1$/,@{$allcourses}) {
                   6884:                     push @{$allcourses},$1;
                   6885:                     $$LC_code{$1} = $2;
                   6886:                 }
                   6887:             }
                   6888:         }
                   6889:     }
                   6890:  
                   6891:     if (@currsections > 0) {
                   6892:         foreach (@currsections) {
                   6893:             if (m/^(\w+):(\w*)$/) {
                   6894:                 my $sec = $coursecode.$1;
                   6895:                 my $lc_sec = $2;
                   6896:                 unless (grep/^$sec$/,@{$allcourses}) {
                   6897:                     push @{$allcourses},$sec;
                   6898:                     $$LC_code{$sec} = $lc_sec;
                   6899:                 }
                   6900:             }
                   6901:         }
                   6902:     }
                   6903:     return;
                   6904: }
                   6905: 
1.112     bowersj2 6906: =pod
                   6907: 
1.549     albertel 6908: =back
                   6909: 
                   6910: =head1 HTTP Helpers
                   6911: 
                   6912: =over 4
                   6913: 
1.648     raeburn  6914: =item * &get_unprocessed_cgi($query,$possible_names)
1.112     bowersj2 6915: 
1.258     albertel 6916: Modify the %env hash to contain unprocessed CGI form parameters held in
1.112     bowersj2 6917: $query.  The parameters listed in $possible_names (an array reference),
1.258     albertel 6918: will be set in $env{'form.name'} if they do not already exist.
1.112     bowersj2 6919: 
                   6920: Typically called with $ENV{'QUERY_STRING'} as the first parameter.  
                   6921: $possible_names is an ref to an array of form element names.  As an example:
                   6922: get_unprocessed_cgi($ENV{'QUERY_STRING'},['uname','udom']);
1.258     albertel 6923: will result in $env{'form.uname'} and $env{'form.udom'} being set.
1.112     bowersj2 6924: 
                   6925: =cut
1.1       albertel 6926: 
1.6       albertel 6927: sub get_unprocessed_cgi {
1.25      albertel 6928:   my ($query,$possible_names)= @_;
1.26      matthew  6929:   # $Apache::lonxml::debug=1;
1.356     albertel 6930:   foreach my $pair (split(/&/,$query)) {
                   6931:     my ($name, $value) = split(/=/,$pair);
1.369     www      6932:     $name = &unescape($name);
1.25      albertel 6933:     if (!defined($possible_names) || (grep {$_ eq $name} @$possible_names)) {
                   6934:       $value =~ tr/+/ /;
                   6935:       $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
1.258     albertel 6936:       unless (defined($env{'form.'.$name})) { &add_to_env('form.'.$name,$value) };
1.25      albertel 6937:     }
1.16      harris41 6938:   }
1.6       albertel 6939: }
                   6940: 
1.112     bowersj2 6941: =pod
                   6942: 
1.648     raeburn  6943: =item * &cacheheader() 
1.112     bowersj2 6944: 
                   6945: returns cache-controlling header code
                   6946: 
                   6947: =cut
                   6948: 
1.7       albertel 6949: sub cacheheader {
1.258     albertel 6950:     unless ($env{'request.method'} eq 'GET') { return ''; }
1.216     albertel 6951:     my $date=strftime("%a, %d %b %Y %H:%M:%S GMT",gmtime);
                   6952:     my $output .='<meta HTTP-EQUIV="Expires" CONTENT="'.$date.'" />
1.7       albertel 6953:                 <meta HTTP-EQUIV="Cache-control" CONTENT="no-cache" />
                   6954:                 <meta HTTP-EQUIV="Pragma" CONTENT="no-cache" />';
1.216     albertel 6955:     return $output;
1.7       albertel 6956: }
                   6957: 
1.112     bowersj2 6958: =pod
                   6959: 
1.648     raeburn  6960: =item * &no_cache($r) 
1.112     bowersj2 6961: 
                   6962: specifies header code to not have cache
                   6963: 
                   6964: =cut
                   6965: 
1.9       albertel 6966: sub no_cache {
1.216     albertel 6967:     my ($r) = @_;
                   6968:     if ($ENV{'REQUEST_METHOD'} ne 'GET' &&
1.258     albertel 6969: 	$env{'request.method'} ne 'GET') { return ''; }
1.216     albertel 6970:     my $date=strftime("%a, %d %b %Y %H:%M:%S GMT",gmtime(time));
                   6971:     $r->no_cache(1);
                   6972:     $r->header_out("Expires" => $date);
                   6973:     $r->header_out("Pragma" => "no-cache");
1.123     www      6974: }
                   6975: 
                   6976: sub content_type {
1.181     albertel 6977:     my ($r,$type,$charset) = @_;
1.299     foxr     6978:     if ($r) {
                   6979: 	#  Note that printout.pl calls this with undef for $r.
                   6980: 	&no_cache($r);
                   6981:     }
1.258     albertel 6982:     if ($env{'browser.mathml'} && $type eq 'text/html') { $type='text/xml'; }
1.181     albertel 6983:     unless ($charset) {
                   6984: 	$charset=&Apache::lonlocal::current_encoding;
                   6985:     }
                   6986:     if ($charset) { $type.='; charset='.$charset; }
                   6987:     if ($r) {
                   6988: 	$r->content_type($type);
                   6989:     } else {
                   6990: 	print("Content-type: $type\n\n");
                   6991:     }
1.9       albertel 6992: }
1.25      albertel 6993: 
1.112     bowersj2 6994: =pod
                   6995: 
1.648     raeburn  6996: =item * &add_to_env($name,$value) 
1.112     bowersj2 6997: 
1.258     albertel 6998: adds $name to the %env hash with value
1.112     bowersj2 6999: $value, if $name already exists, the entry is converted to an array
                   7000: reference and $value is added to the array.
                   7001: 
                   7002: =cut
                   7003: 
1.25      albertel 7004: sub add_to_env {
                   7005:   my ($name,$value)=@_;
1.258     albertel 7006:   if (defined($env{$name})) {
                   7007:     if (ref($env{$name})) {
1.25      albertel 7008:       #already have multiple values
1.258     albertel 7009:       push(@{ $env{$name} },$value);
1.25      albertel 7010:     } else {
                   7011:       #first time seeing multiple values, convert hash entry to an arrayref
1.258     albertel 7012:       my $first=$env{$name};
                   7013:       undef($env{$name});
                   7014:       push(@{ $env{$name} },$first,$value);
1.25      albertel 7015:     }
                   7016:   } else {
1.258     albertel 7017:     $env{$name}=$value;
1.25      albertel 7018:   }
1.31      albertel 7019: }
1.149     albertel 7020: 
                   7021: =pod
                   7022: 
1.648     raeburn  7023: =item * &get_env_multiple($name) 
1.149     albertel 7024: 
1.258     albertel 7025: gets $name from the %env hash, it seemlessly handles the cases where multiple
1.149     albertel 7026: values may be defined and end up as an array ref.
                   7027: 
                   7028: returns an array of values
                   7029: 
                   7030: =cut
                   7031: 
                   7032: sub get_env_multiple {
                   7033:     my ($name) = @_;
                   7034:     my @values;
1.258     albertel 7035:     if (defined($env{$name})) {
1.149     albertel 7036:         # exists is it an array
1.258     albertel 7037:         if (ref($env{$name})) {
                   7038:             @values=@{ $env{$name} };
1.149     albertel 7039:         } else {
1.258     albertel 7040:             $values[0]=$env{$name};
1.149     albertel 7041:         }
                   7042:     }
                   7043:     return(@values);
                   7044: }
                   7045: 
1.31      albertel 7046: 
1.41      ng       7047: =pod
1.45      matthew  7048: 
1.464     albertel 7049: =back
1.41      ng       7050: 
1.112     bowersj2 7051: =head1 CSV Upload/Handling functions
1.38      albertel 7052: 
1.41      ng       7053: =over 4
                   7054: 
1.648     raeburn  7055: =item * &upfile_store($r)
1.41      ng       7056: 
                   7057: Store uploaded file, $r should be the HTTP Request object,
1.258     albertel 7058: needs $env{'form.upfile'}
1.41      ng       7059: returns $datatoken to be put into hidden field
                   7060: 
                   7061: =cut
1.31      albertel 7062: 
                   7063: sub upfile_store {
                   7064:     my $r=shift;
1.258     albertel 7065:     $env{'form.upfile'}=~s/\r/\n/gs;
                   7066:     $env{'form.upfile'}=~s/\f/\n/gs;
                   7067:     $env{'form.upfile'}=~s/\n+/\n/gs;
                   7068:     $env{'form.upfile'}=~s/\n+$//gs;
1.31      albertel 7069: 
1.258     albertel 7070:     my $datatoken=$env{'user.name'}.'_'.$env{'user.domain'}.
                   7071: 	'_enroll_'.$env{'request.course.id'}.'_'.time.'_'.$$;
1.31      albertel 7072:     {
1.158     raeburn  7073:         my $datafile = $r->dir_config('lonDaemons').
                   7074:                            '/tmp/'.$datatoken.'.tmp';
                   7075:         if ( open(my $fh,">$datafile") ) {
1.258     albertel 7076:             print $fh $env{'form.upfile'};
1.158     raeburn  7077:             close($fh);
                   7078:         }
1.31      albertel 7079:     }
                   7080:     return $datatoken;
                   7081: }
                   7082: 
1.56      matthew  7083: =pod
                   7084: 
1.648     raeburn  7085: =item * &load_tmp_file($r)
1.41      ng       7086: 
                   7087: Load uploaded file from tmp, $r should be the HTTP Request object,
1.258     albertel 7088: needs $env{'form.datatoken'},
                   7089: sets $env{'form.upfile'} to the contents of the file
1.41      ng       7090: 
                   7091: =cut
1.31      albertel 7092: 
                   7093: sub load_tmp_file {
                   7094:     my $r=shift;
                   7095:     my @studentdata=();
                   7096:     {
1.158     raeburn  7097:         my $studentfile = $r->dir_config('lonDaemons').
1.258     albertel 7098:                               '/tmp/'.$env{'form.datatoken'}.'.tmp';
1.158     raeburn  7099:         if ( open(my $fh,"<$studentfile") ) {
                   7100:             @studentdata=<$fh>;
                   7101:             close($fh);
                   7102:         }
1.31      albertel 7103:     }
1.258     albertel 7104:     $env{'form.upfile'}=join('',@studentdata);
1.31      albertel 7105: }
                   7106: 
1.56      matthew  7107: =pod
                   7108: 
1.648     raeburn  7109: =item * &upfile_record_sep()
1.41      ng       7110: 
                   7111: Separate uploaded file into records
                   7112: returns array of records,
1.258     albertel 7113: needs $env{'form.upfile'} and $env{'form.upfiletype'}
1.41      ng       7114: 
                   7115: =cut
1.31      albertel 7116: 
                   7117: sub upfile_record_sep {
1.258     albertel 7118:     if ($env{'form.upfiletype'} eq 'xml') {
1.31      albertel 7119:     } else {
1.248     albertel 7120: 	my @records;
1.258     albertel 7121: 	foreach my $line (split(/\n/,$env{'form.upfile'})) {
1.248     albertel 7122: 	    if ($line=~/^\s*$/) { next; }
                   7123: 	    push(@records,$line);
                   7124: 	}
                   7125: 	return @records;
1.31      albertel 7126:     }
                   7127: }
                   7128: 
1.56      matthew  7129: =pod
                   7130: 
1.648     raeburn  7131: =item * &record_sep($record)
1.41      ng       7132: 
1.258     albertel 7133: Separate a record into fields $record should be an item from the upfile_record_sep(), needs $env{'form.upfiletype'}
1.41      ng       7134: 
                   7135: =cut
                   7136: 
1.263     www      7137: sub takeleft {
                   7138:     my $index=shift;
                   7139:     return substr('0000'.$index,-4,4);
                   7140: }
                   7141: 
1.31      albertel 7142: sub record_sep {
                   7143:     my $record=shift;
                   7144:     my %components=();
1.258     albertel 7145:     if ($env{'form.upfiletype'} eq 'xml') {
                   7146:     } elsif ($env{'form.upfiletype'} eq 'space') {
1.31      albertel 7147:         my $i=0;
1.356     albertel 7148:         foreach my $field (split(/\s+/,$record)) {
1.31      albertel 7149:             $field=~s/^(\"|\')//;
                   7150:             $field=~s/(\"|\')$//;
1.263     www      7151:             $components{&takeleft($i)}=$field;
1.31      albertel 7152:             $i++;
                   7153:         }
1.258     albertel 7154:     } elsif ($env{'form.upfiletype'} eq 'tab') {
1.31      albertel 7155:         my $i=0;
1.356     albertel 7156:         foreach my $field (split(/\t/,$record)) {
1.31      albertel 7157:             $field=~s/^(\"|\')//;
                   7158:             $field=~s/(\"|\')$//;
1.263     www      7159:             $components{&takeleft($i)}=$field;
1.31      albertel 7160:             $i++;
                   7161:         }
                   7162:     } else {
1.561     www      7163:         my $separator=',';
1.480     banghart 7164:         if ($env{'form.upfiletype'} eq 'semisv') {
1.561     www      7165:             $separator=';';
1.480     banghart 7166:         }
1.31      albertel 7167:         my $i=0;
1.561     www      7168: # the character we are looking for to indicate the end of a quote or a record 
                   7169:         my $looking_for=$separator;
                   7170: # do not add the characters to the fields
                   7171:         my $ignore=0;
                   7172: # we just encountered a separator (or the beginning of the record)
                   7173:         my $just_found_separator=1;
                   7174: # store the field we are working on here
                   7175:         my $field='';
                   7176: # work our way through all characters in record
                   7177:         foreach my $character ($record=~/(.)/g) {
                   7178:             if ($character eq $looking_for) {
                   7179:                if ($character ne $separator) {
                   7180: # Found the end of a quote, again looking for separator
                   7181:                   $looking_for=$separator;
                   7182:                   $ignore=1;
                   7183:                } else {
                   7184: # Found a separator, store away what we got
                   7185:                   $components{&takeleft($i)}=$field;
                   7186: 	          $i++;
                   7187:                   $just_found_separator=1;
                   7188:                   $ignore=0;
                   7189:                   $field='';
                   7190:                }
                   7191:                next;
                   7192:             }
                   7193: # single or double quotation marks after a separator indicate beginning of a quote
                   7194: # we are now looking for the end of the quote and need to ignore separators
                   7195:             if ((($character eq '"') || ($character eq "'")) && ($just_found_separator))  {
                   7196:                $looking_for=$character;
                   7197:                next;
                   7198:             }
                   7199: # ignore would be true after we reached the end of a quote
                   7200:             if ($ignore) { next; }
                   7201:             if (($just_found_separator) && ($character=~/\s/)) { next; }
                   7202:             $field.=$character;
                   7203:             $just_found_separator=0; 
1.31      albertel 7204:         }
1.561     www      7205: # catch the very last entry, since we never encountered the separator
                   7206:         $components{&takeleft($i)}=$field;
1.31      albertel 7207:     }
                   7208:     return %components;
                   7209: }
                   7210: 
1.144     matthew  7211: ######################################################
                   7212: ######################################################
                   7213: 
1.56      matthew  7214: =pod
                   7215: 
1.648     raeburn  7216: =item * &upfile_select_html()
1.41      ng       7217: 
1.144     matthew  7218: Return HTML code to select a file from the users machine and specify 
                   7219: the file type.
1.41      ng       7220: 
                   7221: =cut
                   7222: 
1.144     matthew  7223: ######################################################
                   7224: ######################################################
1.31      albertel 7225: sub upfile_select_html {
1.144     matthew  7226:     my %Types = (
                   7227:                  csv   => &mt('CSV (comma separated values, spreadsheet)'),
1.480     banghart 7228:                  semisv => &mt('Semicolon separated values'),
1.144     matthew  7229:                  space => &mt('Space separated'),
                   7230:                  tab   => &mt('Tabulator separated'),
                   7231: #                 xml   => &mt('HTML/XML'),
                   7232:                  );
                   7233:     my $Str = '<input type="file" name="upfile" size="50" />'.
                   7234:         '<br />Type: <select name="upfiletype">';
                   7235:     foreach my $type (sort(keys(%Types))) {
                   7236:         $Str .= '<option value="'.$type.'" >'.$Types{$type}."</option>\n";
                   7237:     }
                   7238:     $Str .= "</select>\n";
                   7239:     return $Str;
1.31      albertel 7240: }
                   7241: 
1.301     albertel 7242: sub get_samples {
                   7243:     my ($records,$toget) = @_;
                   7244:     my @samples=({});
                   7245:     my $got=0;
                   7246:     foreach my $rec (@$records) {
                   7247: 	my %temp = &record_sep($rec);
                   7248: 	if (! grep(/\S/, values(%temp))) { next; }
                   7249: 	if (%temp) {
                   7250: 	    $samples[$got]=\%temp;
                   7251: 	    $got++;
                   7252: 	    if ($got == $toget) { last; }
                   7253: 	}
                   7254:     }
                   7255:     return \@samples;
                   7256: }
                   7257: 
1.144     matthew  7258: ######################################################
                   7259: ######################################################
                   7260: 
1.56      matthew  7261: =pod
                   7262: 
1.648     raeburn  7263: =item * &csv_print_samples($r,$records)
1.41      ng       7264: 
                   7265: Prints a table of sample values from each column uploaded $r is an
                   7266: Apache Request ref, $records is an arrayref from
                   7267: &Apache::loncommon::upfile_record_sep
                   7268: 
                   7269: =cut
                   7270: 
1.144     matthew  7271: ######################################################
                   7272: ######################################################
1.31      albertel 7273: sub csv_print_samples {
                   7274:     my ($r,$records) = @_;
1.301     albertel 7275:     my $samples = &get_samples($records,3);
                   7276: 
1.594     raeburn  7277:     $r->print(&mt('Samples').'<br />'.&start_data_table().
                   7278:               &start_data_table_header_row());
1.356     albertel 7279:     foreach my $sample (sort({$a <=> $b} keys(%{ $samples->[0] }))) { 
                   7280:         $r->print('<th>'.&mt('Column&nbsp;[_1]',($sample+1)).'</th>'); }
1.594     raeburn  7281:     $r->print(&end_data_table_header_row());
1.301     albertel 7282:     foreach my $hash (@$samples) {
1.594     raeburn  7283: 	$r->print(&start_data_table_row());
1.356     albertel 7284: 	foreach my $sample (sort({$a <=> $b} keys(%{ $samples->[0] }))) {
1.31      albertel 7285: 	    $r->print('<td>');
1.356     albertel 7286: 	    if (defined($$hash{$sample})) { $r->print($$hash{$sample}); }
1.31      albertel 7287: 	    $r->print('</td>');
                   7288: 	}
1.594     raeburn  7289: 	$r->print(&end_data_table_row());
1.31      albertel 7290:     }
1.594     raeburn  7291:     $r->print(&end_data_table().'<br />'."\n");
1.31      albertel 7292: }
                   7293: 
1.144     matthew  7294: ######################################################
                   7295: ######################################################
                   7296: 
1.56      matthew  7297: =pod
                   7298: 
1.648     raeburn  7299: =item * &csv_print_select_table($r,$records,$d)
1.41      ng       7300: 
                   7301: Prints a table to create associations between values and table columns.
1.144     matthew  7302: 
1.41      ng       7303: $r is an Apache Request ref,
                   7304: $records is an arrayref from &Apache::loncommon::upfile_record_sep,
1.174     matthew  7305: $d is an array of 2 element arrays (internal name, displayed name,defaultcol)
1.41      ng       7306: 
                   7307: =cut
                   7308: 
1.144     matthew  7309: ######################################################
                   7310: ######################################################
1.31      albertel 7311: sub csv_print_select_table {
                   7312:     my ($r,$records,$d) = @_;
1.301     albertel 7313:     my $i=0;
                   7314:     my $samples = &get_samples($records,1);
1.144     matthew  7315:     $r->print(&mt('Associate columns with student attributes.')."\n".
1.594     raeburn  7316: 	      &start_data_table().&start_data_table_header_row().
1.144     matthew  7317:               '<th>'.&mt('Attribute').'</th>'.
1.594     raeburn  7318:               '<th>'.&mt('Column').'</th>'.
                   7319:               &end_data_table_header_row()."\n");
1.356     albertel 7320:     foreach my $array_ref (@$d) {
                   7321: 	my ($value,$display,$defaultcol)=@{ $array_ref };
1.594     raeburn  7322: 	$r->print(&start_data_table_row().'<tr><td>'.$display.'</td>');
1.31      albertel 7323: 
                   7324: 	$r->print('<td><select name=f'.$i.
1.32      matthew  7325: 		  ' onchange="javascript:flip(this.form,'.$i.');">');
1.31      albertel 7326: 	$r->print('<option value="none"></option>');
1.356     albertel 7327: 	foreach my $sample (sort({$a <=> $b} keys(%{ $samples->[0] }))) {
                   7328: 	    $r->print('<option value="'.$sample.'"'.
                   7329:                       ($sample eq $defaultcol ? ' selected="selected" ' : '').
                   7330:                       '>Column '.($sample+1).'</option>');
1.31      albertel 7331: 	}
1.594     raeburn  7332: 	$r->print('</select></td>'.&end_data_table_row()."\n");
1.31      albertel 7333: 	$i++;
                   7334:     }
1.594     raeburn  7335:     $r->print(&end_data_table());
1.31      albertel 7336:     $i--;
                   7337:     return $i;
                   7338: }
1.56      matthew  7339: 
1.144     matthew  7340: ######################################################
                   7341: ######################################################
                   7342: 
1.56      matthew  7343: =pod
1.31      albertel 7344: 
1.648     raeburn  7345: =item * &csv_samples_select_table($r,$records,$d)
1.41      ng       7346: 
                   7347: Prints a table of sample values from the upload and can make associate samples to internal names.
                   7348: 
                   7349: $r is an Apache Request ref,
                   7350: $records is an arrayref from &Apache::loncommon::upfile_record_sep,
                   7351: $d is an array of 2 element arrays (internal name, displayed name)
                   7352: 
                   7353: =cut
                   7354: 
1.144     matthew  7355: ######################################################
                   7356: ######################################################
1.31      albertel 7357: sub csv_samples_select_table {
                   7358:     my ($r,$records,$d) = @_;
                   7359:     my $i=0;
1.144     matthew  7360:     #
1.301     albertel 7361:     my $samples = &get_samples($records,3);
1.594     raeburn  7362:     $r->print(&start_data_table().
                   7363:               &start_data_table_header_row().'<th>'.
                   7364:               &mt('Field').'</th><th>'.&mt('Samples').'</th>'.
                   7365:               &end_data_table_header_row());
1.301     albertel 7366: 
                   7367:     foreach my $key (sort(keys(%{ $samples->[0] }))) {
1.594     raeburn  7368: 	$r->print(&start_data_table_row().'<td><select name="f'.$i.'"'.
1.32      matthew  7369: 		  ' onchange="javascript:flip(this.form,'.$i.');">');
1.301     albertel 7370: 	foreach my $option (@$d) {
                   7371: 	    my ($value,$display,$defaultcol)=@{ $option };
1.174     matthew  7372: 	    $r->print('<option value="'.$value.'"'.
1.253     albertel 7373:                       ($i eq $defaultcol ? ' selected="selected" ':'').'>'.
1.174     matthew  7374:                       $display.'</option>');
1.31      albertel 7375: 	}
                   7376: 	$r->print('</select></td><td>');
1.301     albertel 7377: 	foreach my $line (0..2) {
                   7378: 	    if (defined($samples->[$line]{$key})) { 
                   7379: 		$r->print($samples->[$line]{$key}."<br />\n"); 
                   7380: 	    }
                   7381: 	}
1.594     raeburn  7382: 	$r->print('</td>'.&end_data_table_row());
1.31      albertel 7383: 	$i++;
                   7384:     }
1.594     raeburn  7385:     $r->print(&end_data_table());
1.31      albertel 7386:     $i--;
                   7387:     return($i);
1.115     matthew  7388: }
                   7389: 
1.144     matthew  7390: ######################################################
                   7391: ######################################################
                   7392: 
1.115     matthew  7393: =pod
                   7394: 
1.648     raeburn  7395: =item * &clean_excel_name($name)
1.115     matthew  7396: 
                   7397: Returns a replacement for $name which does not contain any illegal characters.
                   7398: 
                   7399: =cut
                   7400: 
1.144     matthew  7401: ######################################################
                   7402: ######################################################
1.115     matthew  7403: sub clean_excel_name {
                   7404:     my ($name) = @_;
                   7405:     $name =~ s/[:\*\?\/\\]//g;
                   7406:     if (length($name) > 31) {
                   7407:         $name = substr($name,0,31);
                   7408:     }
                   7409:     return $name;
1.25      albertel 7410: }
1.84      albertel 7411: 
1.85      albertel 7412: =pod
                   7413: 
1.648     raeburn  7414: =item * &check_if_partid_hidden($id,$symb,$udom,$uname)
1.85      albertel 7415: 
                   7416: Returns either 1 or undef
                   7417: 
                   7418: 1 if the part is to be hidden, undef if it is to be shown
                   7419: 
                   7420: Arguments are:
                   7421: 
                   7422: $id the id of the part to be checked
                   7423: $symb, optional the symb of the resource to check
                   7424: $udom, optional the domain of the user to check for
                   7425: $uname, optional the username of the user to check for
                   7426: 
                   7427: =cut
1.84      albertel 7428: 
                   7429: sub check_if_partid_hidden {
                   7430:     my ($id,$symb,$udom,$uname) = @_;
1.133     albertel 7431:     my $hiddenparts=&Apache::lonnet::EXT('resource.0.hiddenparts',
1.84      albertel 7432: 					 $symb,$udom,$uname);
1.141     albertel 7433:     my $truth=1;
                   7434:     #if the string starts with !, then the list is the list to show not hide
                   7435:     if ($hiddenparts=~s/^\s*!//) { $truth=undef; }
1.84      albertel 7436:     my @hiddenlist=split(/,/,$hiddenparts);
                   7437:     foreach my $checkid (@hiddenlist) {
1.141     albertel 7438: 	if ($checkid =~ /^\s*\Q$id\E\s*$/) { return $truth; }
1.84      albertel 7439:     }
1.141     albertel 7440:     return !$truth;
1.84      albertel 7441: }
1.127     matthew  7442: 
1.138     matthew  7443: 
                   7444: ############################################################
                   7445: ############################################################
                   7446: 
                   7447: =pod
                   7448: 
1.157     matthew  7449: =back 
                   7450: 
1.138     matthew  7451: =head1 cgi-bin script and graphing routines
                   7452: 
1.157     matthew  7453: =over 4
                   7454: 
1.648     raeburn  7455: =item * &get_cgi_id()
1.138     matthew  7456: 
                   7457: Inputs: none
                   7458: 
                   7459: Returns an id which can be used to pass environment variables
                   7460: to various cgi-bin scripts.  These environment variables will
                   7461: be removed from the users environment after a given time by
                   7462: the routine &Apache::lonnet::transfer_profile_to_env.
                   7463: 
                   7464: =cut
                   7465: 
                   7466: ############################################################
                   7467: ############################################################
1.152     albertel 7468: my $uniq=0;
1.136     matthew  7469: sub get_cgi_id {
1.154     albertel 7470:     $uniq=($uniq+1)%100000;
1.280     albertel 7471:     return (time.'_'.$$.'_'.$uniq);
1.136     matthew  7472: }
                   7473: 
1.127     matthew  7474: ############################################################
                   7475: ############################################################
                   7476: 
                   7477: =pod
                   7478: 
1.648     raeburn  7479: =item * &DrawBarGraph()
1.127     matthew  7480: 
1.138     matthew  7481: Facilitates the plotting of data in a (stacked) bar graph.
                   7482: Puts plot definition data into the users environment in order for 
                   7483: graph.png to plot it.  Returns an <img> tag for the plot.
                   7484: The bars on the plot are labeled '1','2',...,'n'.
                   7485: 
                   7486: Inputs:
                   7487: 
                   7488: =over 4
                   7489: 
                   7490: =item $Title: string, the title of the plot
                   7491: 
                   7492: =item $xlabel: string, text describing the X-axis of the plot
                   7493: 
                   7494: =item $ylabel: string, text describing the Y-axis of the plot
                   7495: 
                   7496: =item $Max: scalar, the maximum Y value to use in the plot
                   7497: If $Max is < any data point, the graph will not be rendered.
                   7498: 
1.140     matthew  7499: =item $colors: array ref holding the colors to be used for the data sets when
1.138     matthew  7500: they are plotted.  If undefined, default values will be used.
                   7501: 
1.178     matthew  7502: =item $labels: array ref holding the labels to use on the x-axis for the bars.
                   7503: 
1.138     matthew  7504: =item @Values: An array of array references.  Each array reference holds data
                   7505: to be plotted in a stacked bar chart.
                   7506: 
1.239     matthew  7507: =item If the final element of @Values is a hash reference the key/value
                   7508: pairs will be added to the graph definition.
                   7509: 
1.138     matthew  7510: =back
                   7511: 
                   7512: Returns:
                   7513: 
                   7514: An <img> tag which references graph.png and the appropriate identifying
                   7515: information for the plot.
                   7516: 
1.127     matthew  7517: =cut
                   7518: 
                   7519: ############################################################
                   7520: ############################################################
1.134     matthew  7521: sub DrawBarGraph {
1.178     matthew  7522:     my ($Title,$xlabel,$ylabel,$Max,$colors,$labels,@Values)=@_;
1.134     matthew  7523:     #
                   7524:     if (! defined($colors)) {
                   7525:         $colors = ['#33ff00', 
                   7526:                   '#0033cc', '#990000', '#aaaa66', '#663399', '#ff9933',
                   7527:                   '#66ccff', '#ff9999', '#cccc33', '#660000', '#33cc66',
                   7528:                   ]; 
                   7529:     }
1.228     matthew  7530:     my $extra_settings = {};
                   7531:     if (ref($Values[-1]) eq 'HASH') {
                   7532:         $extra_settings = pop(@Values);
                   7533:     }
1.127     matthew  7534:     #
1.136     matthew  7535:     my $identifier = &get_cgi_id();
                   7536:     my $id = 'cgi.'.$identifier;        
1.129     matthew  7537:     if (! @Values || ref($Values[0]) ne 'ARRAY') {
1.127     matthew  7538:         return '';
                   7539:     }
1.225     matthew  7540:     #
                   7541:     my @Labels;
                   7542:     if (defined($labels)) {
                   7543:         @Labels = @$labels;
                   7544:     } else {
                   7545:         for (my $i=0;$i<@{$Values[0]};$i++) {
                   7546:             push (@Labels,$i+1);
                   7547:         }
                   7548:     }
                   7549:     #
1.129     matthew  7550:     my $NumBars = scalar(@{$Values[0]});
1.225     matthew  7551:     if ($NumBars < scalar(@Labels)) { $NumBars = scalar(@Labels); }
1.129     matthew  7552:     my %ValuesHash;
                   7553:     my $NumSets=1;
                   7554:     foreach my $array (@Values) {
                   7555:         next if (! ref($array));
1.136     matthew  7556:         $ValuesHash{$id.'.data.'.$NumSets++} = 
1.132     matthew  7557:             join(',',@$array);
1.129     matthew  7558:     }
1.127     matthew  7559:     #
1.136     matthew  7560:     my ($height,$width,$xskip,$bar_width) = (200,120,1,15);
1.225     matthew  7561:     if ($NumBars < 3) {
                   7562:         $width = 120+$NumBars*32;
1.220     matthew  7563:         $xskip = 1;
1.225     matthew  7564:         $bar_width = 30;
                   7565:     } elsif ($NumBars < 5) {
                   7566:         $width = 120+$NumBars*20;
                   7567:         $xskip = 1;
                   7568:         $bar_width = 20;
1.220     matthew  7569:     } elsif ($NumBars < 10) {
1.136     matthew  7570:         $width = 120+$NumBars*15;
                   7571:         $xskip = 1;
                   7572:         $bar_width = 15;
                   7573:     } elsif ($NumBars <= 25) {
                   7574:         $width = 120+$NumBars*11;
                   7575:         $xskip = 5;
                   7576:         $bar_width = 8;
                   7577:     } elsif ($NumBars <= 50) {
                   7578:         $width = 120+$NumBars*8;
                   7579:         $xskip = 5;
                   7580:         $bar_width = 4;
                   7581:     } else {
                   7582:         $width = 120+$NumBars*8;
                   7583:         $xskip = 5;
                   7584:         $bar_width = 4;
                   7585:     }
                   7586:     #
1.137     matthew  7587:     $Max = 1 if ($Max < 1);
                   7588:     if ( int($Max) < $Max ) {
                   7589:         $Max++;
                   7590:         $Max = int($Max);
                   7591:     }
1.127     matthew  7592:     $Title  = '' if (! defined($Title));
                   7593:     $xlabel = '' if (! defined($xlabel));
                   7594:     $ylabel = '' if (! defined($ylabel));
1.369     www      7595:     $ValuesHash{$id.'.title'}    = &escape($Title);
                   7596:     $ValuesHash{$id.'.xlabel'}   = &escape($xlabel);
                   7597:     $ValuesHash{$id.'.ylabel'}   = &escape($ylabel);
1.137     matthew  7598:     $ValuesHash{$id.'.y_max_value'} = $Max;
1.136     matthew  7599:     $ValuesHash{$id.'.NumBars'}  = $NumBars;
                   7600:     $ValuesHash{$id.'.NumSets'}  = $NumSets;
                   7601:     $ValuesHash{$id.'.PlotType'} = 'bar';
                   7602:     $ValuesHash{$id.'.Colors'}   = join(',',@{$colors});
                   7603:     $ValuesHash{$id.'.height'}   = $height;
                   7604:     $ValuesHash{$id.'.width'}    = $width;
                   7605:     $ValuesHash{$id.'.xskip'}    = $xskip;
                   7606:     $ValuesHash{$id.'.bar_width'} = $bar_width;
                   7607:     $ValuesHash{$id.'.labels'} = join(',',@Labels);
1.127     matthew  7608:     #
1.228     matthew  7609:     # Deal with other parameters
                   7610:     while (my ($key,$value) = each(%$extra_settings)) {
                   7611:         $ValuesHash{$id.'.'.$key} = $value;
                   7612:     }
                   7613:     #
1.646     raeburn  7614:     &Apache::lonnet::appenv(\%ValuesHash);
1.137     matthew  7615:     return '<img src="/cgi-bin/graph.png?'.$identifier.'" border="1" />';
                   7616: }
                   7617: 
                   7618: ############################################################
                   7619: ############################################################
                   7620: 
                   7621: =pod
                   7622: 
1.648     raeburn  7623: =item * &DrawXYGraph()
1.137     matthew  7624: 
1.138     matthew  7625: Facilitates the plotting of data in an XY graph.
                   7626: Puts plot definition data into the users environment in order for 
                   7627: graph.png to plot it.  Returns an <img> tag for the plot.
                   7628: 
                   7629: Inputs:
                   7630: 
                   7631: =over 4
                   7632: 
                   7633: =item $Title: string, the title of the plot
                   7634: 
                   7635: =item $xlabel: string, text describing the X-axis of the plot
                   7636: 
                   7637: =item $ylabel: string, text describing the Y-axis of the plot
                   7638: 
                   7639: =item $Max: scalar, the maximum Y value to use in the plot
                   7640: If $Max is < any data point, the graph will not be rendered.
                   7641: 
                   7642: =item $colors: Array ref containing the hex color codes for the data to be 
                   7643: plotted in.  If undefined, default values will be used.
                   7644: 
                   7645: =item $Xlabels: Array ref containing the labels to be used for the X-axis.
                   7646: 
                   7647: =item $Ydata: Array ref containing Array refs.  
1.185     www      7648: Each of the contained arrays will be plotted as a separate curve.
1.138     matthew  7649: 
                   7650: =item %Values: hash indicating or overriding any default values which are 
                   7651: passed to graph.png.  
                   7652: Possible values are: width, xskip, x_ticks, x_tick_offset, among others.
                   7653: 
                   7654: =back
                   7655: 
                   7656: Returns:
                   7657: 
                   7658: An <img> tag which references graph.png and the appropriate identifying
                   7659: information for the plot.
                   7660: 
1.137     matthew  7661: =cut
                   7662: 
                   7663: ############################################################
                   7664: ############################################################
                   7665: sub DrawXYGraph {
                   7666:     my ($Title,$xlabel,$ylabel,$Max,$colors,$Xlabels,$Ydata,%Values)=@_;
                   7667:     #
                   7668:     # Create the identifier for the graph
                   7669:     my $identifier = &get_cgi_id();
                   7670:     my $id = 'cgi.'.$identifier;
                   7671:     #
                   7672:     $Title  = '' if (! defined($Title));
                   7673:     $xlabel = '' if (! defined($xlabel));
                   7674:     $ylabel = '' if (! defined($ylabel));
                   7675:     my %ValuesHash = 
                   7676:         (
1.369     www      7677:          $id.'.title'  => &escape($Title),
                   7678:          $id.'.xlabel' => &escape($xlabel),
                   7679:          $id.'.ylabel' => &escape($ylabel),
1.137     matthew  7680:          $id.'.y_max_value'=> $Max,
                   7681:          $id.'.labels'     => join(',',@$Xlabels),
                   7682:          $id.'.PlotType'   => 'XY',
                   7683:          );
                   7684:     #
                   7685:     if (defined($colors) && ref($colors) eq 'ARRAY') {
                   7686:         $ValuesHash{$id.'.Colors'}   = join(',',@{$colors});
                   7687:     }
                   7688:     #
                   7689:     if (! ref($Ydata) || ref($Ydata) ne 'ARRAY') {
                   7690:         return '';
                   7691:     }
                   7692:     my $NumSets=1;
1.138     matthew  7693:     foreach my $array (@{$Ydata}){
1.137     matthew  7694:         next if (! ref($array));
                   7695:         $ValuesHash{$id.'.data.'.$NumSets++} = join(',',@$array);
                   7696:     }
1.138     matthew  7697:     $ValuesHash{$id.'.NumSets'} = $NumSets-1;
1.137     matthew  7698:     #
                   7699:     # Deal with other parameters
                   7700:     while (my ($key,$value) = each(%Values)) {
                   7701:         $ValuesHash{$id.'.'.$key} = $value;
1.127     matthew  7702:     }
                   7703:     #
1.646     raeburn  7704:     &Apache::lonnet::appenv(\%ValuesHash);
1.136     matthew  7705:     return '<img src="/cgi-bin/graph.png?'.$identifier.'" border="1" />';
                   7706: }
                   7707: 
                   7708: ############################################################
                   7709: ############################################################
                   7710: 
                   7711: =pod
                   7712: 
1.648     raeburn  7713: =item * &DrawXYYGraph()
1.138     matthew  7714: 
                   7715: Facilitates the plotting of data in an XY graph with two Y axes.
                   7716: Puts plot definition data into the users environment in order for 
                   7717: graph.png to plot it.  Returns an <img> tag for the plot.
                   7718: 
                   7719: Inputs:
                   7720: 
                   7721: =over 4
                   7722: 
                   7723: =item $Title: string, the title of the plot
                   7724: 
                   7725: =item $xlabel: string, text describing the X-axis of the plot
                   7726: 
                   7727: =item $ylabel: string, text describing the Y-axis of the plot
                   7728: 
                   7729: =item $colors: Array ref containing the hex color codes for the data to be 
                   7730: plotted in.  If undefined, default values will be used.
                   7731: 
                   7732: =item $Xlabels: Array ref containing the labels to be used for the X-axis.
                   7733: 
                   7734: =item $Ydata1: The first data set
                   7735: 
                   7736: =item $Min1: The minimum value of the left Y-axis
                   7737: 
                   7738: =item $Max1: The maximum value of the left Y-axis
                   7739: 
                   7740: =item $Ydata2: The second data set
                   7741: 
                   7742: =item $Min2: The minimum value of the right Y-axis
                   7743: 
                   7744: =item $Max2: The maximum value of the left Y-axis
                   7745: 
                   7746: =item %Values: hash indicating or overriding any default values which are 
                   7747: passed to graph.png.  
                   7748: Possible values are: width, xskip, x_ticks, x_tick_offset, among others.
                   7749: 
                   7750: =back
                   7751: 
                   7752: Returns:
                   7753: 
                   7754: An <img> tag which references graph.png and the appropriate identifying
                   7755: information for the plot.
1.136     matthew  7756: 
                   7757: =cut
                   7758: 
                   7759: ############################################################
                   7760: ############################################################
1.137     matthew  7761: sub DrawXYYGraph {
                   7762:     my ($Title,$xlabel,$ylabel,$colors,$Xlabels,$Ydata1,$Min1,$Max1,
                   7763:                                         $Ydata2,$Min2,$Max2,%Values)=@_;
1.136     matthew  7764:     #
                   7765:     # Create the identifier for the graph
                   7766:     my $identifier = &get_cgi_id();
                   7767:     my $id = 'cgi.'.$identifier;
                   7768:     #
                   7769:     $Title  = '' if (! defined($Title));
                   7770:     $xlabel = '' if (! defined($xlabel));
                   7771:     $ylabel = '' if (! defined($ylabel));
                   7772:     my %ValuesHash = 
                   7773:         (
1.369     www      7774:          $id.'.title'  => &escape($Title),
                   7775:          $id.'.xlabel' => &escape($xlabel),
                   7776:          $id.'.ylabel' => &escape($ylabel),
1.136     matthew  7777:          $id.'.labels' => join(',',@$Xlabels),
                   7778:          $id.'.PlotType' => 'XY',
                   7779:          $id.'.NumSets' => 2,
1.137     matthew  7780:          $id.'.two_axes' => 1,
                   7781:          $id.'.y1_max_value' => $Max1,
                   7782:          $id.'.y1_min_value' => $Min1,
                   7783:          $id.'.y2_max_value' => $Max2,
                   7784:          $id.'.y2_min_value' => $Min2,
1.136     matthew  7785:          );
                   7786:     #
1.137     matthew  7787:     if (defined($colors) && ref($colors) eq 'ARRAY') {
                   7788:         $ValuesHash{$id.'.Colors'}   = join(',',@{$colors});
                   7789:     }
                   7790:     #
                   7791:     if (! ref($Ydata1) || ref($Ydata1) ne 'ARRAY' ||
                   7792:         ! ref($Ydata2) || ref($Ydata2) ne 'ARRAY'){
1.136     matthew  7793:         return '';
                   7794:     }
                   7795:     my $NumSets=1;
1.137     matthew  7796:     foreach my $array ($Ydata1,$Ydata2){
1.136     matthew  7797:         next if (! ref($array));
                   7798:         $ValuesHash{$id.'.data.'.$NumSets++} = join(',',@$array);
1.137     matthew  7799:     }
                   7800:     #
                   7801:     # Deal with other parameters
                   7802:     while (my ($key,$value) = each(%Values)) {
                   7803:         $ValuesHash{$id.'.'.$key} = $value;
1.136     matthew  7804:     }
                   7805:     #
1.646     raeburn  7806:     &Apache::lonnet::appenv(\%ValuesHash);
1.130     albertel 7807:     return '<img src="/cgi-bin/graph.png?'.$identifier.'" border="1" />';
1.139     matthew  7808: }
                   7809: 
                   7810: ############################################################
                   7811: ############################################################
                   7812: 
                   7813: =pod
                   7814: 
1.157     matthew  7815: =back 
                   7816: 
1.139     matthew  7817: =head1 Statistics helper routines?  
                   7818: 
                   7819: Bad place for them but what the hell.
                   7820: 
1.157     matthew  7821: =over 4
                   7822: 
1.648     raeburn  7823: =item * &chartlink()
1.139     matthew  7824: 
                   7825: Returns a link to the chart for a specific student.  
                   7826: 
                   7827: Inputs:
                   7828: 
                   7829: =over 4
                   7830: 
                   7831: =item $linktext: The text of the link
                   7832: 
                   7833: =item $sname: The students username
                   7834: 
                   7835: =item $sdomain: The students domain
                   7836: 
                   7837: =back
                   7838: 
1.157     matthew  7839: =back
                   7840: 
1.139     matthew  7841: =cut
                   7842: 
                   7843: ############################################################
                   7844: ############################################################
                   7845: sub chartlink {
                   7846:     my ($linktext, $sname, $sdomain) = @_;
                   7847:     my $link = '<a href="/adm/statistics?reportSelected=student_assessment'.
1.369     www      7848:         '&amp;SelectedStudent='.&escape($sname.':'.$sdomain).
1.219     albertel 7849:         '&amp;chartoutputmode='.HTML::Entities::encode('html, with all links').
1.139     matthew  7850:        '">'.$linktext.'</a>';
1.153     matthew  7851: }
                   7852: 
                   7853: #######################################################
                   7854: #######################################################
                   7855: 
                   7856: =pod
                   7857: 
                   7858: =head1 Course Environment Routines
1.157     matthew  7859: 
                   7860: =over 4
1.153     matthew  7861: 
1.648     raeburn  7862: =item * &restore_course_settings()
1.153     matthew  7863: 
1.648     raeburn  7864: =item * &store_course_settings()
1.153     matthew  7865: 
                   7866: Restores/Store indicated form parameters from the course environment.
                   7867: Will not overwrite existing values of the form parameters.
                   7868: 
                   7869: Inputs: 
                   7870: a scalar describing the data (e.g. 'chart', 'problem_analysis')
                   7871: 
                   7872: a hash ref describing the data to be stored.  For example:
                   7873:    
                   7874: %Save_Parameters = ('Status' => 'scalar',
                   7875:     'chartoutputmode' => 'scalar',
                   7876:     'chartoutputdata' => 'scalar',
                   7877:     'Section' => 'array',
1.373     raeburn  7878:     'Group' => 'array',
1.153     matthew  7879:     'StudentData' => 'array',
                   7880:     'Maps' => 'array');
                   7881: 
                   7882: Returns: both routines return nothing
                   7883: 
1.631     raeburn  7884: =back
                   7885: 
1.153     matthew  7886: =cut
                   7887: 
                   7888: #######################################################
                   7889: #######################################################
                   7890: sub store_course_settings {
1.496     albertel 7891:     return &store_settings($env{'request.course.id'},@_);
                   7892: }
                   7893: 
                   7894: sub store_settings {
1.153     matthew  7895:     # save to the environment
                   7896:     # appenv the same items, just to be safe
1.300     albertel 7897:     my $udom  = $env{'user.domain'};
                   7898:     my $uname = $env{'user.name'};
1.496     albertel 7899:     my ($context,$prefix,$Settings) = @_;
1.153     matthew  7900:     my %SaveHash;
                   7901:     my %AppHash;
                   7902:     while (my ($setting,$type) = each(%$Settings)) {
1.496     albertel 7903:         my $basename = join('.','internal',$context,$prefix,$setting);
1.300     albertel 7904:         my $envname = 'environment.'.$basename;
1.258     albertel 7905:         if (exists($env{'form.'.$setting})) {
1.153     matthew  7906:             # Save this value away
                   7907:             if ($type eq 'scalar' &&
1.258     albertel 7908:                 (! exists($env{$envname}) || 
                   7909:                  $env{$envname} ne $env{'form.'.$setting})) {
                   7910:                 $SaveHash{$basename} = $env{'form.'.$setting};
                   7911:                 $AppHash{$envname}   = $env{'form.'.$setting};
1.153     matthew  7912:             } elsif ($type eq 'array') {
                   7913:                 my $stored_form;
1.258     albertel 7914:                 if (ref($env{'form.'.$setting})) {
1.153     matthew  7915:                     $stored_form = join(',',
                   7916:                                         map {
1.369     www      7917:                                             &escape($_);
1.258     albertel 7918:                                         } sort(@{$env{'form.'.$setting}}));
1.153     matthew  7919:                 } else {
                   7920:                     $stored_form = 
1.369     www      7921:                         &escape($env{'form.'.$setting});
1.153     matthew  7922:                 }
                   7923:                 # Determine if the array contents are the same.
1.258     albertel 7924:                 if ($stored_form ne $env{$envname}) {
1.153     matthew  7925:                     $SaveHash{$basename} = $stored_form;
                   7926:                     $AppHash{$envname}   = $stored_form;
                   7927:                 }
                   7928:             }
                   7929:         }
                   7930:     }
                   7931:     my $put_result = &Apache::lonnet::put('environment',\%SaveHash,
1.300     albertel 7932:                                           $udom,$uname);
1.153     matthew  7933:     if ($put_result !~ /^(ok|delayed)/) {
                   7934:         &Apache::lonnet::logthis('unable to save form parameters, '.
                   7935:                                  'got error:'.$put_result);
                   7936:     }
                   7937:     # Make sure these settings stick around in this session, too
1.646     raeburn  7938:     &Apache::lonnet::appenv(\%AppHash);
1.153     matthew  7939:     return;
                   7940: }
                   7941: 
                   7942: sub restore_course_settings {
1.499     albertel 7943:     return &restore_settings($env{'request.course.id'},@_);
1.496     albertel 7944: }
                   7945: 
                   7946: sub restore_settings {
                   7947:     my ($context,$prefix,$Settings) = @_;
1.153     matthew  7948:     while (my ($setting,$type) = each(%$Settings)) {
1.258     albertel 7949:         next if (exists($env{'form.'.$setting}));
1.496     albertel 7950:         my $envname = 'environment.internal.'.$context.'.'.$prefix.
1.153     matthew  7951:             '.'.$setting;
1.258     albertel 7952:         if (exists($env{$envname})) {
1.153     matthew  7953:             if ($type eq 'scalar') {
1.258     albertel 7954:                 $env{'form.'.$setting} = $env{$envname};
1.153     matthew  7955:             } elsif ($type eq 'array') {
1.258     albertel 7956:                 $env{'form.'.$setting} = [ 
1.153     matthew  7957:                                            map { 
1.369     www      7958:                                                &unescape($_); 
1.258     albertel 7959:                                            } split(',',$env{$envname})
1.153     matthew  7960:                                            ];
                   7961:             }
                   7962:         }
                   7963:     }
1.127     matthew  7964: }
                   7965: 
1.618     raeburn  7966: #######################################################
                   7967: #######################################################
                   7968: 
                   7969: =pod
                   7970: 
                   7971: =head1 Domain E-mail Routines  
                   7972: 
                   7973: =over 4
                   7974: 
1.648     raeburn  7975: =item * &build_recipient_list()
1.618     raeburn  7976: 
                   7977: Build recipient lists for three types of e-mail:
                   7978: (a) Error Reports, (b) Package Updates, (c) Help requests, generated by
1.619     raeburn  7979: lonerrorhandler.pm, CHECKRPMS and lonsupportreq.pm respectively.
1.618     raeburn  7980: 
                   7981: Inputs:
1.619     raeburn  7982: defmail (scalar - email address of default recipient), 
1.618     raeburn  7983: mailing type (scalar - errormail, packagesmail, or helpdeskmail), 
1.619     raeburn  7984: defdom (domain for which to retrieve configuration settings),
                   7985: origmail (scalar - email address of recipient from loncapa.conf, 
                   7986: i.e., predates configuration by DC via domainprefs.pm 
1.618     raeburn  7987: 
1.655     raeburn  7988: Returns: comma separated list of addresses to which to send e-mail.
                   7989: 
                   7990: =back
1.618     raeburn  7991: 
                   7992: =cut
                   7993: 
                   7994: ############################################################
                   7995: ############################################################
                   7996: sub build_recipient_list {
1.619     raeburn  7997:     my ($defmail,$mailing,$defdom,$origmail) = @_;
1.618     raeburn  7998:     my @recipients;
                   7999:     my $otheremails;
                   8000:     my %domconfig =
                   8001:          &Apache::lonnet::get_dom('configuration',['contacts'],$defdom);
                   8002:     if (ref($domconfig{'contacts'}) eq 'HASH') {
                   8003:         if (ref($domconfig{'contacts'}{$mailing}) eq 'HASH') {
                   8004:             my @contacts = ('adminemail','supportemail');
                   8005:             foreach my $item (@contacts) {
                   8006:                 if ($domconfig{'contacts'}{$mailing}{$item}) {
1.619     raeburn  8007:                     my $addr = $domconfig{'contacts'}{$item}; 
                   8008:                     if (!grep(/^\Q$addr\E$/,@recipients)) {
                   8009:                         push(@recipients,$addr);
                   8010:                     }
1.618     raeburn  8011:                 }
                   8012:                 $otheremails = $domconfig{'contacts'}{$mailing}{'others'};
                   8013:             }
                   8014:         }
1.619     raeburn  8015:     } elsif ($origmail ne '') {
                   8016:         push(@recipients,$origmail);
1.618     raeburn  8017:     }
                   8018:     if ($defmail ne '') {
                   8019:         push(@recipients,$defmail);
                   8020:     }
                   8021:     if ($otheremails) {
1.619     raeburn  8022:         my @others;
                   8023:         if ($otheremails =~ /,/) {
                   8024:             @others = split(/,/,$otheremails);
1.618     raeburn  8025:         } else {
1.619     raeburn  8026:             push(@others,$otheremails);
                   8027:         }
                   8028:         foreach my $addr (@others) {
                   8029:             if (!grep(/^\Q$addr\E$/,@recipients)) {
                   8030:                 push(@recipients,$addr);
                   8031:             }
1.618     raeburn  8032:         }
                   8033:     }
1.619     raeburn  8034:     my $recipientlist = join(',',@recipients); 
1.618     raeburn  8035:     return $recipientlist;
                   8036: }
                   8037: 
1.127     matthew  8038: ############################################################
                   8039: ############################################################
1.154     albertel 8040: 
1.655     raeburn  8041: =pod
                   8042: 
                   8043: =head1 Course Catalog Routines
                   8044: 
                   8045: =over 4
                   8046: 
                   8047: =item * &gather_categories()
                   8048: 
                   8049: Converts category definitions - keys of categories hash stored in  
                   8050: coursecategories in configuration.db on the primary library server in a 
                   8051: domain - to an array.  Also generates javascript and idx hash used to 
                   8052: generate Domain Coordinator interface for editing Course Categories.
                   8053: 
                   8054: Inputs:
                   8055: categories (reference to hash of category definitions).
                   8056: cats (reference to array of arrays/hashes which encapsulates hierarchy of
                   8057:       categories and subcategories).
                   8058: idx (reference to hash of counters used in Domain Coordinator interface for 
                   8059:       editing Course Categories).
                   8060: jsarray (reference to array of categories used to create Javascript arrays for
                   8061:          Domain Coordinator interface for editing Course Categories).
                   8062: 
                   8063: Returns: nothing
                   8064: 
                   8065: Side effects: populates cats, idx and jsarray. 
                   8066: 
                   8067: =cut
                   8068: 
                   8069: sub gather_categories {
                   8070:     my ($categories,$cats,$idx,$jsarray) = @_;
                   8071:     my %counters;
                   8072:     my $num = 0;
                   8073:     foreach my $item (keys(%{$categories})) {
                   8074:         my ($cat,$container,$depth) = map { &unescape($_); } split(/:/,$item);
                   8075:         if ($container eq '' && $depth == 0) {
                   8076:             $cats->[$depth][$categories->{$item}] = $cat;
                   8077:         } else {
                   8078:             $cats->[$depth]{$container}[$categories->{$item}] = $cat;
                   8079:         }
                   8080:         my ($escitem,$tail) = split(/:/,$item,2);
                   8081:         if ($counters{$tail} eq '') {
                   8082:             $counters{$tail} = $num;
                   8083:             $num ++;
                   8084:         }
                   8085:         if (ref($idx) eq 'HASH') {
                   8086:             $idx->{$item} = $counters{$tail};
                   8087:         }
                   8088:         if (ref($jsarray) eq 'ARRAY') {
                   8089:             push(@{$jsarray->[$counters{$tail}]},$item);
                   8090:         }
                   8091:     }
                   8092:     return;
                   8093: }
                   8094: 
                   8095: =pod
                   8096: 
                   8097: =item * &extract_categories()
                   8098: 
                   8099: Used to generate breadcrumb trails for course categories.
                   8100: 
                   8101: Inputs:
                   8102: categories (reference to hash of category definitions).
                   8103: cats (reference to array of arrays/hashes which encapsulates hierarchy of
                   8104:       categories and subcategories).
                   8105: trails (reference to array of breacrumb trails for each category).
                   8106: allitems (reference to hash - key is category key 
                   8107:          (format: escaped(name):escaped(parent category):depth in hierarchy).
                   8108: idx (reference to hash of counters used in Domain Coordinator interface for
                   8109:       editing Course Categories).
                   8110: jsarray (reference to array of categories used to create Javascript arrays for
                   8111:          Domain Coordinator interface for editing Course Categories).
                   8112: 
                   8113: Returns: nothing
                   8114: 
                   8115: Side effects: populates trails and allitems hash references.
                   8116: 
                   8117: =cut
                   8118: 
                   8119: sub extract_categories {
                   8120:     my ($categories,$cats,$trails,$allitems,$idx,$jsarray) = @_;
                   8121:     if (ref($categories) eq 'HASH') {
                   8122:         &gather_categories($categories,$cats,$idx,$jsarray);
                   8123:         if (ref($cats->[0]) eq 'ARRAY') {
                   8124:             for (my $i=0; $i<@{$cats->[0]}; $i++) {
                   8125:                 my $name = $cats->[0][$i];
                   8126:                 my $item = &escape($name).'::0';
                   8127:                 my $trailstr;
                   8128:                 if ($name eq 'instcode') {
                   8129:                     $trailstr = &mt('Official courses (with institutional codes)');
                   8130:                 } else {
                   8131:                     $trailstr = $name;
                   8132:                 }
                   8133:                 if ($allitems->{$item} eq '') {
                   8134:                     push(@{$trails},$trailstr);
                   8135:                     $allitems->{$item} = scalar(@{$trails})-1;
                   8136:                 }
                   8137:                 my @parents = ($name);
                   8138:                 if (ref($cats->[1]{$name}) eq 'ARRAY') {
                   8139:                     for (my $j=0; $j<@{$cats->[1]{$name}}; $j++) {
                   8140:                         my $category = $cats->[1]{$name}[$j];
                   8141:                         &recurse_categories($cats,2,$category,$trails,$allitems,\@parents);
                   8142:                     }
                   8143:                 }
                   8144:             }
                   8145:         }
                   8146:     }
                   8147:     return;
                   8148: }
                   8149: 
                   8150: =pod
                   8151: 
                   8152: =item *&recurse_categories()
                   8153: 
                   8154: Recursively used to generate breadcrumb trails for course categories.
                   8155: 
                   8156: Inputs:
                   8157: cats (reference to array of arrays/hashes which encapsulates hierarchy of
                   8158:       categories and subcategories).
                   8159: depth (current depth in hierarchy of categories and sub-categories - 0 indexed).
                   8160: category (current course category, for which breadcrumb trail is being generated).   
                   8161: trails (reference to array of breacrumb trails for each category).
                   8162: allitems (reference to hash - key is category key
                   8163:          (format: escaped(name):escaped(parent category):depth in hierarchy).
                   8164: parents (array containing containers directories for current category, 
                   8165:          back to top level). 
                   8166: 
                   8167: Returns: nothing
                   8168: 
                   8169: Side effects: populates trails and allitems hash references
                   8170: 
                   8171: =back
                   8172: 
                   8173: =cut
                   8174: 
                   8175: sub recurse_categories {
                   8176:     my ($cats,$depth,$category,$trails,$allitems,$parents) = @_;
                   8177:     my $shallower = $depth - 1;
                   8178:     if (ref($cats->[$depth]{$category}) eq 'ARRAY') {
                   8179:         for (my $k=0; $k<@{$cats->[$depth]{$category}}; $k++) {
                   8180:             my $name = $cats->[$depth]{$category}[$k];
                   8181:             my $item = &escape($category).':'.&escape($parents->[-1]).':'.$shallower;
                   8182:             my $trailstr = join(' -&gt; ',(@{$parents},$category));
                   8183:             if ($allitems->{$item} eq '') {
                   8184:                 push(@{$trails},$trailstr);
                   8185:                 $allitems->{$item} = scalar(@{$trails})-1;
                   8186:             }
                   8187:             my $deeper = $depth+1;
                   8188:             push(@{$parents},$category);
                   8189:             &recurse_categories($cats,$deeper,$name,$trails,$allitems,$parents);
                   8190:             pop(@{$parents});
                   8191:         }
                   8192:     } else {
                   8193:         my $item = &escape($category).':'.&escape($parents->[-1]).':'.$shallower;
                   8194:         my $trailstr = join(' -&gt; ',(@{$parents},$category));
                   8195:         if ($allitems->{$item} eq '') {
                   8196:             push(@{$trails},$trailstr);
                   8197:             $allitems->{$item} = scalar(@{$trails})-1;
                   8198:         }
                   8199:     }
                   8200:     return;
                   8201: }
                   8202: 
                   8203: ############################################################
                   8204: ############################################################
                   8205: 
                   8206: 
1.443     albertel 8207: sub commit_customrole {
                   8208:     my ($udom,$uname,$url,$three,$four,$five,$start,$end) = @_;
1.630     raeburn  8209:     my $output = &mt('Assigning custom role').' "'.$five.'" by '.$four.':'.$three.' in '.$url.
1.443     albertel 8210:                          ($start?', '.&mt('starting').' '.localtime($start):'').
                   8211:                          ($end?', ending '.localtime($end):'').': <b>'.
                   8212:               &Apache::lonnet::assigncustomrole(
                   8213:                  $udom,$uname,$url,$three,$four,$five,$end,$start).
                   8214:                  '</b><br />';
                   8215:     return $output;
                   8216: }
                   8217: 
                   8218: sub commit_standardrole {
1.541     raeburn  8219:     my ($udom,$uname,$url,$three,$start,$end,$one,$two,$sec,$context) = @_;
                   8220:     my ($output,$logmsg,$linefeed);
                   8221:     if ($context eq 'auto') {
                   8222:         $linefeed = "\n";
                   8223:     } else {
                   8224:         $linefeed = "<br />\n";
                   8225:     }  
1.443     albertel 8226:     if ($three eq 'st') {
1.541     raeburn  8227:         my $result = &commit_studentrole(\$logmsg,$udom,$uname,$url,$three,$start,$end,
                   8228:                                          $one,$two,$sec,$context);
                   8229:         if (($result =~ /^error/) || ($result eq 'not_in_class') || 
1.626     raeburn  8230:             ($result eq 'unknown_course') || ($result eq 'refused')) {
                   8231:             $output = $logmsg.' '.&mt('Error: ').$result."\n"; 
1.443     albertel 8232:         } else {
1.541     raeburn  8233:             $output = $logmsg.$linefeed.&mt('Assigning').' '.$three.' in '.$url.
1.443     albertel 8234:                ($start?', '.&mt('starting').' '.localtime($start):'').
1.541     raeburn  8235:                ($end?', '.&mt('ending').' '.localtime($end):'').': ';
                   8236:             if ($context eq 'auto') {
                   8237:                 $output .= $result.$linefeed.&mt('Add to classlist').': ok';
                   8238:             } else {
                   8239:                $output .= '<b>'.$result.'</b>'.$linefeed.
                   8240:                &mt('Add to classlist').': <b>ok</b>';
                   8241:             }
                   8242:             $output .= $linefeed;
1.443     albertel 8243:         }
                   8244:     } else {
                   8245:         $output = &mt('Assigning').' '.$three.' in '.$url.
                   8246:                ($start?', '.&mt('starting').' '.localtime($start):'').
1.541     raeburn  8247:                ($end?', '.&mt('ending').' '.localtime($end):'').': ';
1.652     raeburn  8248:         my $result = &Apache::lonnet::assignrole($udom,$uname,$url,$three,$end,$start,'','',$context);
1.541     raeburn  8249:         if ($context eq 'auto') {
                   8250:             $output .= $result.$linefeed;
                   8251:         } else {
                   8252:             $output .= '<b>'.$result.'</b>'.$linefeed;
                   8253:         }
1.443     albertel 8254:     }
                   8255:     return $output;
                   8256: }
                   8257: 
                   8258: sub commit_studentrole {
1.541     raeburn  8259:     my ($logmsg,$udom,$uname,$url,$three,$start,$end,$one,$two,$sec,$context) = @_;
1.626     raeburn  8260:     my ($result,$linefeed,$oldsecurl,$newsecurl);
1.541     raeburn  8261:     if ($context eq 'auto') {
                   8262:         $linefeed = "\n";
                   8263:     } else {
                   8264:         $linefeed = '<br />'."\n";
                   8265:     }
1.443     albertel 8266:     if (defined($one) && defined($two)) {
                   8267:         my $cid=$one.'_'.$two;
                   8268:         my $oldsec=&Apache::lonnet::getsection($udom,$uname,$cid);
                   8269:         my $secchange = 0;
                   8270:         my $expire_role_result;
                   8271:         my $modify_section_result;
1.628     raeburn  8272:         if ($oldsec ne '-1') { 
                   8273:             if ($oldsec ne $sec) {
1.443     albertel 8274:                 $secchange = 1;
1.628     raeburn  8275:                 my $now = time;
1.443     albertel 8276:                 my $uurl='/'.$cid;
                   8277:                 $uurl=~s/\_/\//g;
                   8278:                 if ($oldsec) {
                   8279:                     $uurl.='/'.$oldsec;
                   8280:                 }
1.626     raeburn  8281:                 $oldsecurl = $uurl;
1.628     raeburn  8282:                 $expire_role_result = 
1.652     raeburn  8283:                     &Apache::lonnet::assignrole($udom,$uname,$uurl,'st',$now,'','',$context);
1.628     raeburn  8284:                 if ($env{'request.course.sec'} ne '') { 
                   8285:                     if ($expire_role_result eq 'refused') {
                   8286:                         my @roles = ('st');
                   8287:                         my @statuses = ('previous');
                   8288:                         my @roledoms = ($one);
                   8289:                         my $withsec = 1;
                   8290:                         my %roleshash = 
                   8291:                             &Apache::lonnet::get_my_roles($uname,$udom,'userroles',
                   8292:                                               \@statuses,\@roles,\@roledoms,$withsec);
                   8293:                         if (defined ($roleshash{$two.':'.$one.':st:'.$oldsec})) {
                   8294:                             my ($oldstart,$oldend) = 
                   8295:                                 split(':',$roleshash{$two.':'.$one.':st:'.$oldsec});
                   8296:                             if ($oldend > 0 && $oldend <= $now) {
                   8297:                                 $expire_role_result = 'ok';
                   8298:                             }
                   8299:                         }
                   8300:                     }
                   8301:                 }
1.443     albertel 8302:                 $result = $expire_role_result;
                   8303:             }
                   8304:         }
                   8305:         if (($expire_role_result eq 'ok') || ($secchange == 0)) {
1.652     raeburn  8306:             $modify_section_result = &Apache::lonnet::modify_student_enrollment($udom,$uname,undef,undef,undef,undef,undef,$sec,$end,$start,'','',$cid,'',$context);
1.443     albertel 8307:             if ($modify_section_result =~ /^ok/) {
                   8308:                 if ($secchange == 1) {
1.628     raeburn  8309:                     if ($sec eq '') {
                   8310:                         $$logmsg .= &mt('Section for [_1] switched from (possibly expired) old section: [_2] to student role without a section.',$uname,$oldsec).$linefeed;
                   8311:                     } else {
                   8312:                         $$logmsg .= &mt('Section for [_1] switched from (possibly expired) old section: [_2] to new section: [_3].',$uname,$oldsec,$sec).$linefeed;
                   8313:                     }
1.443     albertel 8314:                 } elsif ($oldsec eq '-1') {
1.628     raeburn  8315:                     if ($sec eq '') {
                   8316:                         $$logmsg .= &mt('New student role without a section for [_1] in course [_2].',$uname,$cid).$linefeed;
                   8317:                     } else {
                   8318:                         $$logmsg .= &mt('New student role for [_1] in section [_2] in course [_3].',$uname,$sec,$cid).$linefeed;
                   8319:                     }
1.443     albertel 8320:                 } else {
1.628     raeburn  8321:                     if ($sec eq '') {
                   8322:                         $$logmsg .= &mt('Student [_1] assigned to course [_2] without a section.',$uname,$cid).$linefeed;
                   8323:                     } else {
                   8324:                         $$logmsg .= &mt('Student [_1] assigned to section [_2] in course [_3].',$uname,$sec,$cid).$linefeed;
                   8325:                     }
1.443     albertel 8326:                 }
                   8327:             } else {
1.628     raeburn  8328:                 if ($secchange) {       
                   8329:                     $$logmsg .= &mt('Error when attempting section change for [_1] from old section "[_2]" to new section: "[_3]" in course [_4] -error:',$uname,$oldsec,$sec,$cid).' '.$modify_section_result.$linefeed;
                   8330:                 } else {
                   8331:                     $$logmsg .= &mt('Error when attempting to modify role for [_1] for section: "[_2]" in course [_3] -error:',$uname,$sec,$cid).' '.$modify_section_result.$linefeed;
                   8332:                 }
1.443     albertel 8333:             }
                   8334:             $result = $modify_section_result;
                   8335:         } elsif ($secchange == 1) {
1.628     raeburn  8336:             if ($oldsec eq '') {
                   8337:                 $$logmsg .= &mt('Error when attempting to expire existing role without a section for [_1] in course [_3] -error: ',$uname,$cid).' '.$expire_role_result.$linefeed;
                   8338:             } else {
                   8339:                 $$logmsg .= &mt('Error when attempting to expire existing role for [_1] in section [_2] in course [_3] -error: ',$uname,$oldsec,$cid).' '.$expire_role_result.$linefeed;
                   8340:             }
1.626     raeburn  8341:             if ($expire_role_result eq 'refused') {
                   8342:                 my $newsecurl = '/'.$cid;
                   8343:                 $newsecurl =~ s/\_/\//g;
                   8344:                 if ($sec ne '') {
                   8345:                     $newsecurl.='/'.$sec;
                   8346:                 }
                   8347:                 if (&Apache::lonnet::allowed('cst',$newsecurl) && !(&Apache::lonnet::allowed('cst',$oldsecurl))) {
                   8348:                     if ($sec eq '') {
                   8349:                         $$logmsg .= &mt('Although your current role has privileges to add students to section "[_1]", you do not have privileges to modify existing enrollments unaffiliated with any section.',$sec).$linefeed;
                   8350:                     } else {
                   8351:                         $$logmsg .= &mt('Although your current role has privileges to add students to section "[_1]", you do not have privileges to modify existing enrollments in other sections.',$sec).$linefeed;
                   8352:                     }
                   8353:                 }
                   8354:             }
1.443     albertel 8355:         }
                   8356:     } else {
1.626     raeburn  8357:         $$logmsg .= &mt('Incomplete course id defined.').$linefeed.&mt('Addition of user [_1] from domain [_2] to course [_3], section [_4] not completed.',$uname,$udom,$one.'_'.$two,$sec).$linefeed;
1.443     albertel 8358:         $result = "error: incomplete course id\n";
                   8359:     }
                   8360:     return $result;
                   8361: }
                   8362: 
                   8363: ############################################################
                   8364: ############################################################
                   8365: 
1.566     albertel 8366: sub check_clone {
1.578     raeburn  8367:     my ($args,$linefeed) = @_;
1.566     albertel 8368:     my $cloneid='/'.$args->{'clonedomain'}.'/'.$args->{'clonecourse'};
                   8369:     my ($clonecrsudom,$clonecrsunum)= &LONCAPA::split_courseid($cloneid);
                   8370:     my $clonehome=&Apache::lonnet::homeserver($clonecrsunum,$clonecrsudom);
                   8371:     my $clonemsg;
                   8372:     my $can_clone = 0;
                   8373: 
                   8374:     if ($clonehome eq 'no_host') {
1.578     raeburn  8375:         $clonemsg = &mt('No new course created.').$linefeed.&mt('A new course could not be cloned from the specified original - [_1] - because it is a non-existent course.',$args->{'clonecourse'}.':'.$args->{'clonedomain'});     
1.566     albertel 8376:     } else {
                   8377: 	my %clonedesc = &Apache::lonnet::coursedescription($cloneid,{'one_time' => 1});
1.568     albertel 8378: 	if ($env{'request.role.domain'} eq $args->{'clonedomain'}) {
1.566     albertel 8379: 	    $can_clone = 1;
                   8380: 	} else {
                   8381: 	    my %clonehash = &Apache::lonnet::get('environment',['cloners'],
                   8382: 						 $args->{'clonedomain'},$args->{'clonecourse'});
                   8383: 	    my @cloners = split(/,/,$clonehash{'cloners'});
1.578     raeburn  8384:             if (grep(/^\*$/,@cloners)) {
                   8385:                 $can_clone = 1;
                   8386:             } elsif (grep(/^\*\:\Q$args->{'ccdomain'}\E$/,@cloners)) {
                   8387:                 $can_clone = 1;
                   8388:             } else {
                   8389: 	        my %roleshash =
                   8390: 		    &Apache::lonnet::get_my_roles($args->{'ccuname'},
                   8391: 					 $args->{'ccdomain'},
                   8392:                                          'userroles',['active'],['cc'],
                   8393: 					 [$args->{'clonedomain'}]);
                   8394: 	        if (($roleshash{$args->{'clonecourse'}.':'.$args->{'clonedomain'}.':cc'}) || (grep(/^\Q$args->{'ccuname'}\E:\Q$args->{'ccdomain'}\E$/,@cloners))) {
                   8395: 		    $can_clone = 1;
                   8396: 	        } else {
                   8397:                     $clonemsg = &mt('No new course created.').$linefeed.&mt('The new course could not be cloned from the existing course because the new course owner ([_1]) does not have cloning rights in the existing course ([_2]).',$args->{'ccuname'}.':'.$args->{'ccdomain'},$clonedesc{'description'});
                   8398: 	        }
1.566     albertel 8399: 	    }
1.578     raeburn  8400:         }
1.566     albertel 8401:     }
                   8402:     return ($can_clone, $clonemsg, $cloneid, $clonehome);
                   8403: }
                   8404: 
1.444     albertel 8405: sub construct_course {
1.541     raeburn  8406:     my ($args,$logmsg,$courseid,$crsudom,$crsunum,$udom,$uname,$context) = @_;
1.444     albertel 8407:     my $outcome;
1.541     raeburn  8408:     my $linefeed =  '<br />'."\n";
                   8409:     if ($context eq 'auto') {
                   8410:         $linefeed = "\n";
                   8411:     }
1.566     albertel 8412: 
                   8413: #
                   8414: # Are we cloning?
                   8415: #
                   8416:     my ($can_clone, $clonemsg, $cloneid, $clonehome);
                   8417:     if (($args->{'clonecourse'}) && ($args->{'clonedomain'})) {
1.578     raeburn  8418: 	($can_clone, $clonemsg, $cloneid, $clonehome) = &check_clone($args,$linefeed);
1.566     albertel 8419: 	if ($context ne 'auto') {
1.578     raeburn  8420:             if ($clonemsg ne '') {
                   8421: 	        $clonemsg = '<span class="LC_error">'.$clonemsg.'</span>';
                   8422:             }
1.566     albertel 8423: 	}
                   8424: 	$outcome .= $clonemsg.$linefeed;
                   8425: 
                   8426:         if (!$can_clone) {
                   8427: 	    return (0,$outcome);
                   8428: 	}
                   8429:     }
                   8430: 
1.444     albertel 8431: #
                   8432: # Open course
                   8433: #
                   8434:     my $crstype = lc($args->{'crstype'});
                   8435:     my %cenv=();
                   8436:     $$courseid=&Apache::lonnet::createcourse($args->{'course_domain'},
                   8437:                                              $args->{'cdescr'},
                   8438:                                              $args->{'curl'},
                   8439:                                              $args->{'course_home'},
                   8440:                                              $args->{'nonstandard'},
                   8441:                                              $args->{'crscode'},
                   8442:                                              $args->{'ccuname'}.':'.
                   8443:                                              $args->{'ccdomain'},
                   8444:                                              $args->{'crstype'});
                   8445: 
                   8446:     # Note: The testing routines depend on this being output; see 
                   8447:     # Utils::Course. This needs to at least be output as a comment
                   8448:     # if anyone ever decides to not show this, and Utils::Course::new
                   8449:     # will need to be suitably modified.
1.541     raeburn  8450:     $outcome .= &mt('New LON-CAPA [_1] ID: [_2]',$crstype,$$courseid).$linefeed;
1.444     albertel 8451: #
                   8452: # Check if created correctly
                   8453: #
1.479     albertel 8454:     ($$crsudom,$$crsunum)= &LONCAPA::split_courseid($$courseid);
1.444     albertel 8455:     my $crsuhome=&Apache::lonnet::homeserver($$crsunum,$$crsudom);
1.541     raeburn  8456:     $outcome .= &mt('Created on').': '.$crsuhome.$linefeed;
1.566     albertel 8457: 
1.444     albertel 8458: #
1.566     albertel 8459: # Do the cloning
                   8460: #   
                   8461:     if ($can_clone && $cloneid) {
                   8462: 	$clonemsg = &mt('Cloning [_1] from [_2]',$crstype,$clonehome);
                   8463: 	if ($context ne 'auto') {
                   8464: 	    $clonemsg = '<span class="LC_success">'.$clonemsg.'</span>';
                   8465: 	}
                   8466: 	$outcome .= $clonemsg.$linefeed;
                   8467: 	my %oldcenv=&Apache::lonnet::dump('environment',$$crsudom,$$crsunum);
1.444     albertel 8468: # Copy all files
1.637     www      8469: 	&Apache::lonclonecourse::copycoursefiles($cloneid,$$courseid,$args->{'datemode'},$args->{'dateshift'});
1.444     albertel 8470: # Restore URL
1.566     albertel 8471: 	$cenv{'url'}=$oldcenv{'url'};
1.444     albertel 8472: # Restore title
1.566     albertel 8473: 	$cenv{'description'}=$oldcenv{'description'};
1.444     albertel 8474: # Mark as cloned
1.566     albertel 8475: 	$cenv{'clonedfrom'}=$cloneid;
1.638     www      8476: # Need to clone grading mode
                   8477:         my %newenv=&Apache::lonnet::get('environment',['grading'],$$crsudom,$$crsunum);
                   8478:         $cenv{'grading'}=$newenv{'grading'};
                   8479: # Do not clone these environment entries
                   8480:         &Apache::lonnet::del('environment',
                   8481:                   ['default_enrollment_start_date',
                   8482:                    'default_enrollment_end_date',
                   8483:                    'question.email',
                   8484:                    'policy.email',
                   8485:                    'comment.email',
                   8486:                    'pch.users.denied',
                   8487:                    'plc.users.denied'],
                   8488:                    $$crsudom,$$crsunum);
1.444     albertel 8489:     }
1.566     albertel 8490: 
1.444     albertel 8491: #
                   8492: # Set environment (will override cloned, if existing)
                   8493: #
                   8494:     my @sections = ();
                   8495:     my @xlists = ();
                   8496:     if ($args->{'crstype'}) {
                   8497:         $cenv{'type'}=$args->{'crstype'};
                   8498:     }
                   8499:     if ($args->{'crsid'}) {
                   8500:         $cenv{'courseid'}=$args->{'crsid'};
                   8501:     }
                   8502:     if ($args->{'crscode'}) {
                   8503:         $cenv{'internal.coursecode'}=$args->{'crscode'};
                   8504:     }
                   8505:     if ($args->{'crsquota'} ne '') {
                   8506:         $cenv{'internal.coursequota'}=$args->{'crsquota'};
                   8507:     } else {
                   8508:         $cenv{'internal.coursequota'}=$args->{'crsquota'} = 20;
                   8509:     }
                   8510:     if ($args->{'ccuname'}) {
                   8511:         $cenv{'internal.courseowner'} = $args->{'ccuname'}.
                   8512:                                         ':'.$args->{'ccdomain'};
                   8513:     } else {
                   8514:         $cenv{'internal.courseowner'} = $args->{'curruser'};
                   8515:     }
                   8516:     my @badclasses = (); # Used to accumulate sections/crosslistings that did not pass classlist access check for course owner.
                   8517:     if ($args->{'crssections'}) {
                   8518:         $cenv{'internal.sectionnums'} = '';
                   8519:         if ($args->{'crssections'} =~ m/,/) {
                   8520:             @sections = split/,/,$args->{'crssections'};
                   8521:         } else {
                   8522:             $sections[0] = $args->{'crssections'};
                   8523:         }
                   8524:         if (@sections > 0) {
                   8525:             foreach my $item (@sections) {
                   8526:                 my ($sec,$gp) = split/:/,$item;
                   8527:                 my $class = $args->{'crscode'}.$sec;
                   8528:                 my $addcheck = &Apache::lonnet::auto_new_course($$crsunum,$$crsudom,$class,$cenv{'internal.courseowner'});
                   8529:                 $cenv{'internal.sectionnums'} .= $item.',';
                   8530:                 unless ($addcheck eq 'ok') {
                   8531:                     push @badclasses, $class;
                   8532:                 }
                   8533:             }
                   8534:             $cenv{'internal.sectionnums'} =~ s/,$//;
                   8535:         }
                   8536:     }
                   8537: # do not hide course coordinator from staff listing, 
                   8538: # even if privileged
                   8539:     $cenv{'nothideprivileged'}=$args->{'ccuname'}.':'.$args->{'ccdomain'};
                   8540: # add crosslistings
                   8541:     if ($args->{'crsxlist'}) {
                   8542:         $cenv{'internal.crosslistings'}='';
                   8543:         if ($args->{'crsxlist'} =~ m/,/) {
                   8544:             @xlists = split/,/,$args->{'crsxlist'};
                   8545:         } else {
                   8546:             $xlists[0] = $args->{'crsxlist'};
                   8547:         }
                   8548:         if (@xlists > 0) {
                   8549:             foreach my $item (@xlists) {
                   8550:                 my ($xl,$gp) = split/:/,$item;
                   8551:                 my $addcheck =  &Apache::lonnet::auto_new_course($$crsunum,$$crsudom,$xl,$cenv{'internal.courseowner'});
                   8552:                 $cenv{'internal.crosslistings'} .= $item.',';
                   8553:                 unless ($addcheck eq 'ok') {
                   8554:                     push @badclasses, $xl;
                   8555:                 }
                   8556:             }
                   8557:             $cenv{'internal.crosslistings'} =~ s/,$//;
                   8558:         }
                   8559:     }
                   8560:     if ($args->{'autoadds'}) {
                   8561:         $cenv{'internal.autoadds'}=$args->{'autoadds'};
                   8562:     }
                   8563:     if ($args->{'autodrops'}) {
                   8564:         $cenv{'internal.autodrops'}=$args->{'autodrops'};
                   8565:     }
                   8566: # check for notification of enrollment changes
                   8567:     my @notified = ();
                   8568:     if ($args->{'notify_owner'}) {
                   8569:         if ($args->{'ccuname'} ne '') {
                   8570:             push(@notified,$args->{'ccuname'}.':'.$args->{'ccdomain'});
                   8571:         }
                   8572:     }
                   8573:     if ($args->{'notify_dc'}) {
                   8574:         if ($uname ne '') { 
1.630     raeburn  8575:             push(@notified,$uname.':'.$udom);
1.444     albertel 8576:         }
                   8577:     }
                   8578:     if (@notified > 0) {
                   8579:         my $notifylist;
                   8580:         if (@notified > 1) {
                   8581:             $notifylist = join(',',@notified);
                   8582:         } else {
                   8583:             $notifylist = $notified[0];
                   8584:         }
                   8585:         $cenv{'internal.notifylist'} = $notifylist;
                   8586:     }
                   8587:     if (@badclasses > 0) {
                   8588:         my %lt=&Apache::lonlocal::texthash(
                   8589:                 'tclb' => 'The courses listed below were included as sections or crosslistings affiliated with your new LON-CAPA course.  However, if automated course roster updates are enabled for this class, these particular sections/crosslistings will not contribute towards enrollment, because the user identified as the course owner for this LON-CAPA course',
                   8590:                 'dnhr' => 'does not have rights to access enrollment in these classes',
                   8591:                 'adby' => 'as determined by the policies of your institution on access to official classlists'
                   8592:         );
1.541     raeburn  8593:         my $badclass_msg = $cenv{'internal.courseowner'}.') - '.$lt{'dnhr'}.
                   8594:                            ' ('.$lt{'adby'}.')';
                   8595:         if ($context eq 'auto') {
                   8596:             $outcome .= $badclass_msg.$linefeed;
1.566     albertel 8597:             $outcome .= '<div class="LC_warning">'.$badclass_msg.$linefeed.'<ul>'."\n";
1.541     raeburn  8598:             foreach my $item (@badclasses) {
                   8599:                 if ($context eq 'auto') {
                   8600:                     $outcome .= " - $item\n";
                   8601:                 } else {
                   8602:                     $outcome .= "<li>$item</li>\n";
                   8603:                 }
                   8604:             }
                   8605:             if ($context eq 'auto') {
                   8606:                 $outcome .= $linefeed;
                   8607:             } else {
1.566     albertel 8608:                 $outcome .= "</ul><br /><br /></div>\n";
1.541     raeburn  8609:             }
                   8610:         } 
1.444     albertel 8611:     }
                   8612:     if ($args->{'no_end_date'}) {
                   8613:         $args->{'endaccess'} = 0;
                   8614:     }
                   8615:     $cenv{'internal.autostart'}=$args->{'enrollstart'};
                   8616:     $cenv{'internal.autoend'}=$args->{'enrollend'};
                   8617:     $cenv{'default_enrollment_start_date'}=$args->{'startaccess'};
                   8618:     $cenv{'default_enrollment_end_date'}=$args->{'endaccess'};
                   8619:     if ($args->{'showphotos'}) {
                   8620:       $cenv{'internal.showphotos'}=$args->{'showphotos'};
                   8621:     }
                   8622:     $cenv{'internal.authtype'} = $args->{'authtype'};
                   8623:     $cenv{'internal.autharg'} = $args->{'autharg'}; 
                   8624:     if ( ($cenv{'internal.authtype'} =~ /^krb/) && ($cenv{'internal.autoadds'} == 1)) {
                   8625:         if (! defined($cenv{'internal.autharg'}) || $cenv{'internal.autharg'}  eq '') {
1.541     raeburn  8626:             my $krb_msg = &mt('As you did not include the default Kerberos domain to be used for authentication in this class, the institutional data used by the automated enrollment process must include the Kerberos domain for each new student'); 
                   8627:             if ($context eq 'auto') {
                   8628:                 $outcome .= $krb_msg;
                   8629:             } else {
1.566     albertel 8630:                 $outcome .= '<span class="LC_error">'.$krb_msg.'</span>';
1.541     raeburn  8631:             }
                   8632:             $outcome .= $linefeed;
1.444     albertel 8633:         }
                   8634:     }
                   8635:     if (($args->{'ccdomain'}) && ($args->{'ccuname'})) {
                   8636:        if ($args->{'setpolicy'}) {
                   8637:            $cenv{'policy.email'}=$args->{'ccuname'}.':'.$args->{'ccdomain'};
                   8638:        }
                   8639:        if ($args->{'setcontent'}) {
                   8640:            $cenv{'question.email'}=$args->{'ccuname'}.':'.$args->{'ccdomain'};
                   8641:        }
                   8642:     }
                   8643:     if ($args->{'reshome'}) {
                   8644: 	$cenv{'reshome'}=$args->{'reshome'}.'/';
                   8645: 	$cenv{'reshome'}=~s/\/+$/\//;
                   8646:     }
                   8647: #
                   8648: # course has keyed access
                   8649: #
                   8650:     if ($args->{'setkeys'}) {
                   8651:        $cenv{'keyaccess'}='yes';
                   8652:     }
                   8653: # if specified, key authority is not course, but user
                   8654: # only active if keyaccess is yes
                   8655:     if ($args->{'keyauth'}) {
1.487     albertel 8656: 	my ($user,$domain) = split(':',$args->{'keyauth'});
                   8657: 	$user = &LONCAPA::clean_username($user);
                   8658: 	$domain = &LONCAPA::clean_username($domain);
1.488     foxr     8659: 	if ($user ne '' && $domain ne '') {
1.487     albertel 8660: 	    $cenv{'keyauth'}=$user.':'.$domain;
1.444     albertel 8661: 	}
                   8662:     }
                   8663: 
                   8664:     if ($args->{'disresdis'}) {
                   8665:         $cenv{'pch.roles.denied'}='st';
                   8666:     }
                   8667:     if ($args->{'disablechat'}) {
                   8668:         $cenv{'plc.roles.denied'}='st';
                   8669:     }
                   8670: 
                   8671:     # Record we've not yet viewed the Course Initialization Helper for this 
                   8672:     # course
                   8673:     $cenv{'course.helper.not.run'} = 1;
                   8674:     #
                   8675:     # Use new Randomseed
                   8676:     #
                   8677:     $cenv{'rndseed'}=&Apache::lonnet::latest_rnd_algorithm_id();;
                   8678:     $cenv{'receiptalg'}=&Apache::lonnet::latest_receipt_algorithm_id();;
                   8679:     #
                   8680:     # The encryption code and receipt prefix for this course
                   8681:     #
                   8682:     $cenv{'internal.encseed'}=$Apache::lonnet::perlvar{'lonReceipt'}.$$.time.int(rand(9999));
                   8683:     $cenv{'internal.encpref'}=100+int(9*rand(99));
                   8684:     #
                   8685:     # By default, use standard grading
                   8686:     if (!defined($cenv{'grading'})) { $cenv{'grading'} = 'standard'; }
                   8687: 
1.541     raeburn  8688:     $outcome .= $linefeed.&mt('Setting environment').': '.                 
                   8689:           &Apache::lonnet::put('environment',\%cenv,$$crsudom,$$crsunum).$linefeed;
1.444     albertel 8690: #
                   8691: # Open all assignments
                   8692: #
                   8693:     if ($args->{'openall'}) {
                   8694:        my $storeunder=$$crsudom.'_'.$$crsunum.'.0.opendate';
                   8695:        my %storecontent = ($storeunder         => time,
                   8696:                            $storeunder.'.type' => 'date_start');
                   8697:        
                   8698:        $outcome .= &mt('Opening all assignments').': '.&Apache::lonnet::cput
1.541     raeburn  8699:                  ('resourcedata',\%storecontent,$$crsudom,$$crsunum).$linefeed;
1.444     albertel 8700:    }
                   8701: #
                   8702: # Set first page
                   8703: #
                   8704:     unless (($args->{'nonstandard'}) || ($args->{'firstres'} eq 'blank')
                   8705: 	    || ($cloneid)) {
1.445     albertel 8706: 	use LONCAPA::map;
1.444     albertel 8707: 	$outcome .= &mt('Setting first resource').': ';
1.445     albertel 8708: 
                   8709: 	my $map = '/uploaded/'.$$crsudom.'/'.$$crsunum.'/default.sequence';
                   8710:         my ($errtext,$fatal)=&LONCAPA::map::mapread($map);
                   8711: 
1.444     albertel 8712:         $outcome .= ($fatal?$errtext:'read ok').' - ';
                   8713:         my $title; my $url;
                   8714:         if ($args->{'firstres'} eq 'syl') {
                   8715: 	    $title='Syllabus';
                   8716:             $url='/public/'.$$crsudom.'/'.$$crsunum.'/syllabus';
                   8717:         } else {
                   8718:             $title='Navigate Contents';
                   8719:             $url='/adm/navmaps';
                   8720:         }
1.445     albertel 8721: 
                   8722:         $LONCAPA::map::resources[1]=$title.':'.$url.':false:start:res';
                   8723: 	(my $outtext,$errtext) = &LONCAPA::map::storemap($map,1);
                   8724: 
                   8725: 	if ($errtext) { $fatal=2; }
1.541     raeburn  8726:         $outcome .= ($fatal?$errtext:'write ok').$linefeed;
1.444     albertel 8727:     }
1.566     albertel 8728: 
                   8729:     return (1,$outcome);
1.444     albertel 8730: }
                   8731: 
                   8732: ############################################################
                   8733: ############################################################
                   8734: 
1.378     raeburn  8735: sub course_type {
                   8736:     my ($cid) = @_;
                   8737:     if (!defined($cid)) {
                   8738:         $cid = $env{'request.course.id'};
                   8739:     }
1.404     albertel 8740:     if (defined($env{'course.'.$cid.'.type'})) {
                   8741:         return $env{'course.'.$cid.'.type'};
1.378     raeburn  8742:     } else {
                   8743:         return 'Course';
1.377     raeburn  8744:     }
                   8745: }
1.156     albertel 8746: 
1.406     raeburn  8747: sub group_term {
                   8748:     my $crstype = &course_type();
                   8749:     my %names = (
                   8750:                   'Course' => 'group',
                   8751:                   'Group' => 'team',
                   8752:                 );
                   8753:     return $names{$crstype};
                   8754: }
                   8755: 
1.156     albertel 8756: sub icon {
                   8757:     my ($file)=@_;
1.505     albertel 8758:     my $curfext = lc((split(/\./,$file))[-1]);
1.168     albertel 8759:     my $iconname=$Apache::lonnet::perlvar{'lonIconsURL'}.'/unknown.gif';
1.156     albertel 8760:     my $embstyle = &Apache::loncommon::fileembstyle($curfext);
1.168     albertel 8761:     if (!(!defined($embstyle) || $embstyle eq 'unk' || $embstyle eq 'hdn')) {
                   8762: 	if (-e  $Apache::lonnet::perlvar{'lonDocRoot'}.'/'.
                   8763: 	          $Apache::lonnet::perlvar{'lonIconsURL'}.'/'.
                   8764: 	            $curfext.".gif") {
                   8765: 	    $iconname=$Apache::lonnet::perlvar{'lonIconsURL'}.'/'.
                   8766: 		$curfext.".gif";
                   8767: 	}
                   8768:     }
1.249     albertel 8769:     return &lonhttpdurl($iconname);
1.154     albertel 8770: } 
1.84      albertel 8771: 
1.575     albertel 8772: sub lonhttpd_port {
1.215     albertel 8773:     my $lonhttpd_port=$Apache::lonnet::perlvar{'lonhttpdPort'};
                   8774:     if (!defined($lonhttpd_port)) { $lonhttpd_port='8080'; }
1.574     albertel 8775:     # IE doesn't like a secure page getting images from a non-secure
                   8776:     # port (when logging we haven't parsed the browser type so default
                   8777:     # back to secure
                   8778:     if ((!exists($env{'browser.type'}) || $env{'browser.type'} eq 'explorer')
                   8779: 	&& $ENV{'SERVER_PORT'} == 443) {
1.575     albertel 8780: 	return 443;
                   8781:     }
                   8782:     return $lonhttpd_port;
                   8783: 
                   8784: }
                   8785: 
                   8786: sub lonhttpdurl {
                   8787:     my ($url)=@_;
                   8788: 
                   8789:     my $lonhttpd_port = &lonhttpd_port();
                   8790:     if ($lonhttpd_port == 443) {
1.574     albertel 8791: 	return 'https://'.$ENV{'SERVER_NAME'}.$url;
                   8792:     }
1.215     albertel 8793:     return 'http://'.$ENV{'SERVER_NAME'}.':'.$lonhttpd_port.$url;
                   8794: }
                   8795: 
1.213     albertel 8796: sub connection_aborted {
                   8797:     my ($r)=@_;
                   8798:     $r->print(" ");$r->rflush();
                   8799:     my $c = $r->connection;
                   8800:     return $c->aborted();
                   8801: }
                   8802: 
1.221     foxr     8803: #    Escapes strings that may have embedded 's that will be put into
1.222     foxr     8804: #    strings as 'strings'.
                   8805: sub escape_single {
1.221     foxr     8806:     my ($input) = @_;
1.223     albertel 8807:     $input =~ s/\\/\\\\/g;	# Escape the \'s..(must be first)>
1.221     foxr     8808:     $input =~ s/\'/\\\'/g;	# Esacpe the 's....
                   8809:     return $input;
                   8810: }
1.223     albertel 8811: 
1.222     foxr     8812: #  Same as escape_single, but escape's "'s  This 
                   8813: #  can be used for  "strings"
                   8814: sub escape_double {
                   8815:     my ($input) = @_;
                   8816:     $input =~ s/\\/\\\\/g;	# Escape the /'s..(must be first)>
                   8817:     $input =~ s/\"/\\\"/g;	# Esacpe the "s....
                   8818:     return $input;
                   8819: }
1.223     albertel 8820:  
1.222     foxr     8821: #   Escapes the last element of a full URL.
                   8822: sub escape_url {
                   8823:     my ($url)   = @_;
1.238     raeburn  8824:     my @urlslices = split(/\//, $url,-1);
1.369     www      8825:     my $lastitem = &escape(pop(@urlslices));
1.223     albertel 8826:     return join('/',@urlslices).'/'.$lastitem;
1.222     foxr     8827: }
1.462     albertel 8828: 
                   8829: # -------------------------------------------------------- Initliaze user login
                   8830: sub init_user_environment {
1.463     albertel 8831:     my ($r, $username, $domain, $authhost, $form, $args) = @_;
1.462     albertel 8832:     my $lonids=$Apache::lonnet::perlvar{'lonIDsDir'};
                   8833: 
                   8834:     my $public=($username eq 'public' && $domain eq 'public');
                   8835: 
                   8836: # See if old ID present, if so, remove
                   8837: 
                   8838:     my ($filename,$cookie,$userroles);
                   8839:     my $now=time;
                   8840: 
                   8841:     if ($public) {
                   8842: 	my $max_public=100;
                   8843: 	my $oldest;
                   8844: 	my $oldest_time=0;
                   8845: 	for(my $next=1;$next<=$max_public;$next++) {
                   8846: 	    if (-e $lonids."/publicuser_$next.id") {
                   8847: 		my $mtime=(stat($lonids."/publicuser_$next.id"))[9];
                   8848: 		if ($mtime<$oldest_time || !$oldest_time) {
                   8849: 		    $oldest_time=$mtime;
                   8850: 		    $oldest=$next;
                   8851: 		}
                   8852: 	    } else {
                   8853: 		$cookie="publicuser_$next";
                   8854: 		last;
                   8855: 	    }
                   8856: 	}
                   8857: 	if (!$cookie) { $cookie="publicuser_$oldest"; }
                   8858:     } else {
1.463     albertel 8859: 	# if this isn't a robot, kill any existing non-robot sessions
                   8860: 	if (!$args->{'robot'}) {
                   8861: 	    opendir(DIR,$lonids);
                   8862: 	    while ($filename=readdir(DIR)) {
                   8863: 		if ($filename=~/^$username\_\d+\_$domain\_$authhost\.id$/) {
                   8864: 		    unlink($lonids.'/'.$filename);
                   8865: 		}
1.462     albertel 8866: 	    }
1.463     albertel 8867: 	    closedir(DIR);
1.462     albertel 8868: 	}
                   8869: # Give them a new cookie
1.463     albertel 8870: 	my $id = ($args->{'robot'} ? 'robot'.$args->{'robot'}
                   8871: 		                   : $now);
                   8872: 	$cookie="$username\_$id\_$domain\_$authhost";
1.462     albertel 8873:     
                   8874: # Initialize roles
                   8875: 
                   8876: 	$userroles=&Apache::lonnet::rolesinit($domain,$username,$authhost);
                   8877:     }
                   8878: # ------------------------------------ Check browser type and MathML capability
                   8879: 
                   8880:     my ($httpbrowser,$clientbrowser,$clientversion,$clientmathml,
                   8881:         $clientunicode,$clientos) = &decode_user_agent($r);
                   8882: 
                   8883: # -------------------------------------- Any accessibility options to remember?
                   8884:     if (($form->{'interface'}) && ($form->{'remember'} eq 'true')) {
                   8885: 	foreach my $option ('imagesuppress','appletsuppress',
                   8886: 			    'embedsuppress','fontenhance','blackwhite') {
                   8887: 	    if ($form->{$option} eq 'true') {
                   8888: 		&Apache::lonnet::put('environment',{$option => 'on'},
                   8889: 				     $domain,$username);
                   8890: 	    } else {
                   8891: 		&Apache::lonnet::del('environment',[$option],
                   8892: 				     $domain,$username);
                   8893: 	    }
                   8894: 	}
                   8895:     }
                   8896: # ------------------------------------------------------------- Get environment
                   8897: 
                   8898:     my %userenv = &Apache::lonnet::dump('environment',$domain,$username);
                   8899:     my ($tmp) = keys(%userenv);
                   8900:     if ($tmp !~ /^(con_lost|error|no_such_host)/i) {
                   8901: 	# default remote control to off
                   8902: 	if ($userenv{'remote'} ne 'on') { $userenv{'remote'} = 'off'; }
                   8903:     } else {
                   8904: 	undef(%userenv);
                   8905:     }
                   8906:     if (($userenv{'interface'}) && (!$form->{'interface'})) {
                   8907: 	$form->{'interface'}=$userenv{'interface'};
                   8908:     }
                   8909:     $env{'environment.remote'}=$userenv{'remote'};
                   8910:     if ($userenv{'texengine'} eq 'ttm') { $clientmathml=1; }
                   8911: 
                   8912: # --------------- Do not trust query string to be put directly into environment
                   8913:     foreach my $option ('imagesuppress','appletsuppress',
                   8914: 			'embedsuppress','fontenhance','blackwhite',
                   8915: 			'interface','localpath','localres') {
                   8916: 	$form->{$option}=~s/[\n\r\=]//gs;
                   8917:     }
                   8918: # --------------------------------------------------------- Write first profile
                   8919: 
                   8920:     {
                   8921: 	my %initial_env = 
                   8922: 	    ("user.name"          => $username,
                   8923: 	     "user.domain"        => $domain,
                   8924: 	     "user.home"          => $authhost,
                   8925: 	     "browser.type"       => $clientbrowser,
                   8926: 	     "browser.version"    => $clientversion,
                   8927: 	     "browser.mathml"     => $clientmathml,
                   8928: 	     "browser.unicode"    => $clientunicode,
                   8929: 	     "browser.os"         => $clientos,
                   8930: 	     "server.domain"      => $Apache::lonnet::perlvar{'lonDefDomain'},
                   8931: 	     "request.course.fn"  => '',
                   8932: 	     "request.course.uri" => '',
                   8933: 	     "request.course.sec" => '',
                   8934: 	     "request.role"       => 'cm',
                   8935: 	     "request.role.adv"   => $env{'user.adv'},
                   8936: 	     "request.host"       => $ENV{'REMOTE_ADDR'},);
                   8937: 
                   8938:         if ($form->{'localpath'}) {
                   8939: 	    $initial_env{"browser.localpath"}  = $form->{'localpath'};
                   8940: 	    $initial_env{"browser.localres"}   = $form->{'localres'};
                   8941:         }
                   8942: 	
                   8943: 	if ($public) {
                   8944: 	    $initial_env{"environment.remote"} = "off";
                   8945: 	}
                   8946: 	if ($form->{'interface'}) {
                   8947: 	    $form->{'interface'}=~s/\W//gs;
                   8948: 	    $initial_env{"browser.interface"} = $form->{'interface'};
                   8949: 	    $env{'browser.interface'}=$form->{'interface'};
                   8950: 	    foreach my $option ('imagesuppress','appletsuppress',
                   8951: 				'embedsuppress','fontenhance','blackwhite') {
                   8952: 		if (($form->{$option} eq 'true') ||
                   8953: 		    ($userenv{$option} eq 'on')) {
                   8954: 		    $initial_env{"browser.$option"} = "on";
                   8955: 		}
                   8956: 	    }
                   8957: 	}
                   8958: 
                   8959: 	$env{'user.environment'} = "$lonids/$cookie.id";
                   8960: 	
                   8961: 	if (tie(my %disk_env,'GDBM_File',"$lonids/$cookie.id",
                   8962: 		 &GDBM_WRCREAT(),0640)) {
                   8963: 	    &_add_to_env(\%disk_env,\%initial_env);
                   8964: 	    &_add_to_env(\%disk_env,\%userenv,'environment.');
                   8965: 	    &_add_to_env(\%disk_env,$userroles);
1.463     albertel 8966: 	    if (ref($args->{'extra_env'})) {
                   8967: 		&_add_to_env(\%disk_env,$args->{'extra_env'});
                   8968: 	    }
1.462     albertel 8969: 	    untie(%disk_env);
                   8970: 	} else {
                   8971: 	    &Apache::lonnet::logthis("<font color=\"blue\">WARNING: ".
                   8972: 			   'Could not create environment storage in lonauth: '.$!.'</font>');
                   8973: 	    return 'error: '.$!;
                   8974: 	}
                   8975:     }
                   8976:     $env{'request.role'}='cm';
                   8977:     $env{'request.role.adv'}=$env{'user.adv'};
                   8978:     $env{'browser.type'}=$clientbrowser;
                   8979: 
                   8980:     return $cookie;
                   8981: 
                   8982: }
                   8983: 
                   8984: sub _add_to_env {
                   8985:     my ($idf,$env_data,$prefix) = @_;
                   8986:     while (my ($key,$value) = each(%$env_data)) {
                   8987: 	$idf->{$prefix.$key} = $value;
                   8988: 	$env{$prefix.$key}   = $value;
                   8989:     }
                   8990: }
                   8991: 
                   8992: 
1.41      ng       8993: =pod
                   8994: 
                   8995: =back
                   8996: 
1.112     bowersj2 8997: =cut
1.41      ng       8998: 
1.112     bowersj2 8999: 1;
                   9000: __END__;
1.41      ng       9001: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>