Annotation of loncom/interface/lonstatistics.pm, revision 1.144

1.1       albertel    1: # The LearningOnline Network with CAPA
                      2: #
1.144   ! jms         3: # $Id: lonstatistics.pm,v 1.143 2008/11/10 13:20:14 jms Exp $
1.1       albertel    4: #
                      5: # Copyright Michigan State University Board of Trustees
                      6: #
                      7: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      8: #
                      9: # LON-CAPA is free software; you can redistribute it and/or modify
                     10: # it under the terms of the GNU General Public License as published by
                     11: # the Free Software Foundation; either version 2 of the License, or
                     12: # (at your option) any later version.
                     13: #
                     14: # LON-CAPA is distributed in the hope that it will be useful,
                     15: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     16: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     17: # GNU General Public License for more details.
                     18: #
                     19: # You should have received a copy of the GNU General Public License
                     20: # along with LON-CAPA; if not, write to the Free Software
                     21: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     22: #
                     23: # /home/httpd/html/adm/gpl.txt
                     24: #
                     25: # http://www.lon-capa.org/
                     26: #
                     27: # (Navigate problems for statistical reports
1.14      minaeibi   28: #
1.1       albertel   29: ###
                     30: 
1.59      matthew    31: 
                     32: 
1.55      minaeibi   33: package Apache::lonstatistics;
1.1       albertel   34: 
1.30      stredwic   35: use strict;
1.1       albertel   36: use Apache::Constants qw(:common :http);
1.61      matthew    37: use vars qw(
                     38:     @FullClasslist 
                     39:     @Students
1.130     raeburn    40:     @Sections
                     41:     @Groups 
1.61      matthew    42:     %StudentData
                     43:     @StudentDataOrder
                     44:     @SelectedStudentData
1.94      matthew    45:     $enrollment_status);
1.61      matthew    46: 
1.123     albertel   47: use Apache::lonnet;
1.1       albertel   48: use Apache::lonhomework;
1.12      minaeibi   49: use Apache::loncommon;
1.29      stredwic   50: use Apache::loncoursedata;
                     51: use Apache::lonhtmlcommon;
1.97      matthew    52: use Apache::lonmysql;
                     53: use Apache::lonlocal;
1.135     raeburn    54: use Apache::longroup;
1.97      matthew    55: use Time::HiRes;
                     56: #
                     57: # Statistics Packages
1.61      matthew    58: use Apache::lonproblemanalysis();
1.89      matthew    59: use Apache::lonsubmissiontimeanalysis();
1.94      matthew    60: use Apache::loncorrectproblemplot();
1.61      matthew    61: use Apache::lonproblemstatistics();
                     62: use Apache::lonstudentassessment();
1.49      stredwic   63: use Apache::lonpercentage;
1.97      matthew    64: use Apache::lonstudentsubmissions();
1.104     matthew    65: use Apache::lonsurveyreports();
1.128     albertel   66: use Apache::longradinganalysis();
1.136     www        67: use LONCAPA;
1.60      matthew    68: 
                     69: #
                     70: # Classlist variables
                     71: #
1.59      matthew    72: my $curr_student;
                     73: my $prev_student;
                     74: my $next_student;
                     75: 
1.61      matthew    76: 
1.59      matthew    77: sub clear_classlist_variables {
                     78:     undef(@FullClasslist);
                     79:     undef(@Students);
                     80:     undef(@Sections);
1.130     raeburn    81:     undef(@Groups);
1.61      matthew    82:     undef(%StudentData);
                     83:     undef(@SelectedStudentData);
1.59      matthew    84:     undef($curr_student);
                     85:     undef($prev_student);
                     86:     undef($next_student);
                     87: }
                     88: 
1.130     raeburn    89: 
1.59      matthew    90: sub PrepareClasslist {
                     91:     my %Sections;
                     92:     &clear_classlist_variables();
                     93:     #
                     94:     # Retrieve the classlist
1.123     albertel   95:     my $cid  = $env{'request.course.id'};
                     96:     my $cdom = $env{'course.'.$cid.'.domain'};
                     97:     my $cnum = $env{'course.'.$cid.'.num'};
1.125     albertel   98:     my ($classlist,$field_names) = &Apache::loncoursedata::get_classlist($cdom,
                     99: 									$cnum);
1.119     matthew   100:     my @selected_sections = &get_selected_sections();
1.130     raeburn   101:     my @selected_groups = &get_selected_groups();
1.61      matthew   102:     #
1.69      matthew   103:     # Deal with instructors with restricted section access
1.123     albertel  104:     if ($env{'request.course.sec'} !~ /^\s*$/) {
                    105:         @selected_sections = ($env{'request.course.sec'});
1.69      matthew   106:     }
                    107:     #
1.61      matthew   108:     # Set up %StudentData
1.130     raeburn   109:     @StudentDataOrder = qw/fullname username domain id section status groups comments/;
1.61      matthew   110:     foreach my $field (@StudentDataOrder) {
1.108     matthew   111:         $StudentData{$field}->{'title'} = &mt($field);
                    112:         $StudentData{$field}->{'base_width'} = length(&mt($field));
1.61      matthew   113:         $StudentData{$field}->{'width'} = 
                    114:                                $StudentData{$field}->{'base_width'};
                    115:     }
1.59      matthew   116:     #
1.68      matthew   117:     # get the status requested
1.94      matthew   118:     $enrollment_status = 'Active';
1.123     albertel  119:     $enrollment_status = $env{'form.Status'} if (exists($env{'form.Status'}));
1.68      matthew   120:     #
1.130     raeburn   121:     # Get groupmembership
1.133     albertel  122:     my ($classgroups,$studentgroups);
1.135     raeburn   123:     my %curr_groups = &Apache::longroup::coursegroups($cdom,$cnum);
1.133     albertel  124:     if (%curr_groups) {
1.130     raeburn   125:         ($classgroups,$studentgroups) = 
1.133     albertel  126: 	    &Apache::loncoursedata::get_group_memberships($classlist,
1.134     raeburn   127:                                                           $field_names,
1.133     albertel  128: 							  $cdom,$cnum);
1.130     raeburn   129:     }
                    130:     my $now = time;
                    131: 
1.59      matthew   132:     # Process the classlist
                    133:     while (my ($student,$student_data) = each (%$classlist)) {
                    134:         my $studenthash = ();
                    135:         for (my $i=0; $i< scalar(@$field_names);$i++) {
1.61      matthew   136:             my $field = $field_names->[$i];
                    137:             # Store the data
                    138:             $studenthash->{$field}=$student_data->[$i];
                    139:             # Keep track of the width of the fields
                    140:             next if (! exists($StudentData{$field}));
1.63      matthew   141:             my $length = length($student_data->[$i]);
1.61      matthew   142:             if ($StudentData{$field}->{'width'} < $length) {
                    143:                 $StudentData{$field}->{'width'} = $length; 
                    144:             }
1.59      matthew   145:         }
1.130     raeburn   146:         my @studentsgroups = &Apache::loncoursedata::get_students_groups
                    147:                                                    ($student,$enrollment_status,
                    148:                                                     $classgroups);
                    149:         if (@studentsgroups) {
                    150:             $studenthash->{'groups'} = join(', ',@studentsgroups);
                    151:             $studenthash->{'groupref'} = \@studentsgroups;
                    152:         } else {
                    153:             $studenthash->{'groups'} = 'none';
                    154:             $studenthash->{'groupref'} = []; 
                    155:         }
1.59      matthew   156:         push (@FullClasslist,$studenthash);
                    157:         #
                    158:         # Build up a list of sections
                    159:         my $section = $studenthash->{'section'};
1.60      matthew   160:         if (! defined($section) || $section =~/^\s*$/ || $section == -1) {
                    161:             $studenthash->{'section'} = 'none';
                    162:             $section = $studenthash->{'section'};
                    163:         }
1.59      matthew   164:         $Sections{$section}++;
                    165:         #
                    166:         # Only put in the list those students we are interested in
1.119     matthew   167:         foreach my $sect (@selected_sections) {
1.68      matthew   168:             if ( (($sect eq 'all') || 
                    169:                   ($section eq $sect)) &&
1.94      matthew   170:                  (($studenthash->{'status'} eq $enrollment_status) || 
                    171:                   ($enrollment_status eq 'Any')) 
1.68      matthew   172:                  ){
1.130     raeburn   173:                 my $groupcheck = 0;
1.131     albertel  174:                 if (grep(/^all$/,@selected_groups)) {
                    175:                     push(@Students,$studenthash);
1.130     raeburn   176:                     last;
1.131     albertel  177:                 } elsif (grep(/^none$/,@selected_groups)) {
1.130     raeburn   178:                     if ($studenthash->{'groups'} eq 'none') {
1.131     albertel  179:                         push(@Students,$studenthash);
1.130     raeburn   180:                         last;
                    181:                     }     
                    182:                 } else {
                    183:                     foreach my $group (@selected_groups) {
1.131     albertel  184:                         if (grep(/^$group$/,@studentsgroups)) {
                    185:                             push(@Students,$studenthash);
1.130     raeburn   186:                             $groupcheck = 1;
                    187:                             last;
                    188:                         }
                    189:                     }
                    190:                     if ($groupcheck) {
                    191:                         last;
                    192:                     }
                    193:                 }
1.60      matthew   194:             }
1.59      matthew   195:         }
                    196:     }
                    197:     #
                    198:     # Put the consolidated section data in the right place
1.123     albertel  199:     if ($env{'request.course.sec'} !~ /^\s*$/) {
                    200:         @Sections = ($env{'request.course.sec'});
1.69      matthew   201:     } else {
1.138     albertel  202:         @Sections = sort {
                    203: 	    if ($a == $a && $b == $b ) { return $a <=> $b; }
                    204: 	    return $a cmp $b;
                    205: 	} keys(%Sections);
                    206: 
1.69      matthew   207:         unshift(@Sections,'all'); # Put 'all' at the front of the list
                    208:     }
1.130     raeburn   209:     # Sort the groups
                    210:     @Groups = sort {$a cmp $b} keys(%{$studentgroups});
                    211:     unshift(@Groups,'all'); # Put 'all' at the front of the list
                    212: 
1.59      matthew   213:     #
                    214:     # Sort the Students
                    215:     my $sortby = 'fullname';
1.123     albertel  216:     $sortby = $env{'form.sort'} if (exists($env{'form.sort'}));
1.127     albertel  217:     my @TmpStudents = sort { lc($a->{$sortby}) cmp lc($b->{$sortby}) ||
1.126     albertel  218:                              lc($a->{'fullname'}) cmp lc($b->{'fullname'}) ||
                    219: 			     lc($a->{'username'}) cmp lc($b->{'username'}) } @Students;
1.60      matthew   220:     @Students = @TmpStudents;
1.59      matthew   221:     # 
                    222:     # Now deal with that current student thing....
1.72      matthew   223:     $curr_student = undef;
1.123     albertel  224:     if (exists($env{'form.SelectedStudent'})) {
1.59      matthew   225:         my ($current_uname,$current_dom) = 
1.123     albertel  226:             split(':',$env{'form.SelectedStudent'});
1.59      matthew   227:         my $i;
                    228:         for ($i = 0; $i<=$#Students; $i++) {
                    229:             next if (($Students[$i]->{'username'} ne $current_uname) || 
                    230:                      ($Students[$i]->{'domain'}   ne $current_dom));
1.60      matthew   231:             $curr_student = $Students[$i];
1.59      matthew   232:             last; # If we get here, we have our student.
                    233:         }
1.72      matthew   234:         if (defined($curr_student)) {
                    235:             if ($i == 0) {
                    236:                 $prev_student = undef;
                    237:             } else {
                    238:                 $prev_student = $Students[$i-1];
                    239:             }
                    240:             if ($i == $#Students) {
                    241:                 $next_student = undef;
                    242:             } else {
                    243:                 $next_student = $Students[$i+1];
                    244:             }
1.59      matthew   245:         }
                    246:     }
1.61      matthew   247:     #
1.123     albertel  248:     if (exists($env{'form.StudentData'})) {
1.124     albertel  249: 	@SelectedStudentData = 
                    250: 	    &Apache::loncommon::get_env_multiple('form.StudentData');
1.61      matthew   251:     } else {
1.72      matthew   252:         @SelectedStudentData = ('username');
1.61      matthew   253:     }
                    254:     foreach (@SelectedStudentData) {
                    255:         if ($_ eq 'all') {
                    256:             @SelectedStudentData = ('all');
                    257:             last;
                    258:         }
                    259:     }
                    260:     #
                    261:     return;
                    262: }
                    263: 
1.119     matthew   264: 
                    265: sub get_selected_sections {
1.124     albertel  266:     my @selected_sections = 
                    267: 	&Apache::loncommon::get_env_multiple('form.Section');
1.119     matthew   268:     @selected_sections = ('all') if (! @selected_sections);
                    269:     foreach (@selected_sections) {
                    270:         if ($_ eq 'all') {
                    271:             @selected_sections = ('all');
                    272:         }
                    273:     }
                    274:     #
                    275:     # Deal with instructors with restricted section access
1.123     albertel  276:     if ($env{'request.course.sec'} !~ /^\s*$/) {
                    277:         @selected_sections = ($env{'request.course.sec'});
1.119     matthew   278:     }
                    279:     return @selected_sections;
                    280: }
                    281: 
1.144   ! jms       282: 
1.130     raeburn   283: sub get_selected_groups {
                    284:     my @selected_groups =
                    285:         &Apache::loncommon::get_env_multiple('form.Group');
                    286:     @selected_groups = ('all') if (! @selected_groups);
                    287:     foreach my $grp (@selected_groups) {
                    288:         if ($grp eq 'all') {
                    289:             @selected_groups = ('all');
                    290:             last;
                    291:         }
                    292:     }
                    293:     return @selected_groups;
                    294: }
                    295:                                                                                     
1.122     matthew   296: 
1.119     matthew   297: 
                    298: sub section_and_enrollment_description {
1.122     matthew   299:     my ($mode) = @_;
                    300:     if (! defined($mode)) { $mode = 'localized'; }
1.119     matthew   301:     my @sections = &Apache::lonstatistics::get_selected_sections();
1.130     raeburn   302:     my @groups = &Apache::lonstatistics::get_selected_groups();
1.122     matthew   303:     my $description;
                    304:     if ($mode eq 'localized') {
1.137     raeburn   305:         $description = &mt('Unable to determine section, groups and access status');
1.122     matthew   306:     } elsif ($mode eq 'plaintext') {
1.137     raeburn   307:         $description = 'Unable to determine section, groups and access status';
1.122     matthew   308:     } else {
                    309:         $description = 'Bad parameter passed to lonstatistics::section_and_enrollment_description';
                    310:         &Apache::lonnet::logthis($description);
                    311:     }
1.130     raeburn   312:     $description = &section_or_group_text($mode,'section',@sections).
1.131     albertel  313: 	' '.&section_or_group_text($mode,'group',@groups);
1.130     raeburn   314:     if ($mode eq 'localized') {
1.142     bisitz    315:         $description .= ' '.&mt($env{'form.Status'}.' access status.');
1.130     raeburn   316:     } elsif ($mode eq 'plaintext') {
1.137     raeburn   317:         $description .= ' '.$env{'form.Status'}.' access status.';
1.130     raeburn   318:     }
                    319:     return $description;
                    320: }
                    321: 
1.144   ! jms       322: 
        !           323: 
1.130     raeburn   324: 
                    325: sub section_or_group_text {
                    326:     my ($mode,$type,@items) = @_;
                    327:     my $text;
                    328:     my %phrases = ();
                    329:     %{$phrases{'section'}} = (
                    330:                               single => 'Section',
                    331:                               all => 'All sections',
                    332:                               plural => 'Sections',
                    333:                              );
                    334:     %{$phrases{'group'}} = (
                    335:                               single => 'Group',
                    336:                               all => 'All groups',
                    337:                               plural => 'Groups',
                    338:                              );
                    339:     if (scalar(@items) == 1 && $items[0] ne 'all') {
1.122     matthew   340:         if ($mode eq 'localized') {
1.142     bisitz    341:             $text = &mt($phrases{$type}{single}.' [_1].',$items[0]);
1.122     matthew   342:         } elsif ($mode eq 'plaintext') {
1.130     raeburn   343:             $text = $phrases{$type}{single}.' '.$items[0].'.';
                    344: 
1.122     matthew   345:         }
1.130     raeburn   346:     } elsif (scalar(@items) && $items[0] eq 'all') {
1.122     matthew   347:         if ($mode eq 'localized') {
1.142     bisitz    348:             $text = &mt($phrases{$type}{all}.'.');
1.122     matthew   349:         } elsif ($mode eq 'plaintext') {
1.130     raeburn   350:             $text = $phrases{$type}{all}.'.';
1.122     matthew   351:         }
1.130     raeburn   352:     } elsif (scalar(@items)) {
                    353:         my $lastitem = pop(@items);
1.122     matthew   354:         if ($mode eq 'localized') {
1.142     bisitz    355:             $text = &mt($phrases{$type}{plural}.' [_1] and [_2].',
1.130     raeburn   356:                         join(', ',@items),$lastitem);
1.122     matthew   357:         } elsif ($mode eq 'plaintext') {
1.130     raeburn   358:             $text = $phrases{$type}{plural}.' '.join(', ',@items).' and '.
                    359:                     $lastitem.'.';
1.122     matthew   360:         }
1.119     matthew   361:     }
1.130     raeburn   362:     return $text;
1.119     matthew   363: }
1.71      matthew   364: 
                    365: 
                    366: sub get_students {
                    367:     if (! @Students) {
                    368:         &PrepareClasslist()
                    369:     }
                    370:     return @Students;
                    371: }
                    372: 
1.61      matthew   373: 
                    374: 
                    375: sub current_student { 
1.72      matthew   376:     return $curr_student;
1.61      matthew   377: }
                    378: 
                    379: 
                    380: 
                    381: sub previous_student { 
1.72      matthew   382:     return $prev_student;
1.59      matthew   383: }
                    384: 
1.61      matthew   385: 
                    386: 
                    387: sub next_student { 
1.72      matthew   388:     return $next_student;
1.61      matthew   389: }
1.60      matthew   390: 
                    391: 
                    392: 
1.61      matthew   393: sub StudentDataSelect {
                    394:     my ($elementname,$status,$numvisible)=@_;
                    395:     if ($numvisible < 1) {
                    396:         return;
                    397:     }
                    398:     #
                    399:     # Build the form element
                    400:     my $Str = "\n";
                    401:     $Str .= '<select name="'.$elementname.'" ';
                    402:     if ($status ne 'single') {
                    403:         $Str .= 'multiple="true" ';
                    404:     }
                    405:     $Str .= 'size="'.$numvisible.'" >'."\n";
                    406:     #
                    407:     # Deal with 'all'
                    408:     $Str .= '    <option value="all" ';
                    409:     foreach (@SelectedStudentData) {
                    410:         if ($_ eq 'all') {
                    411:             $Str .= 'selected ';
                    412:             last;
                    413:         }
                    414:     }
                    415:     $Str .= ">all</option>\n";
                    416:     #
                    417:     # Loop through the student data fields
                    418:     foreach my $item (@StudentDataOrder) {
                    419:         $Str .= '    <option value="'.$item.'" ';
                    420:         foreach (@SelectedStudentData) {
                    421:             if ($item eq $_ ) {
                    422:                 $Str .= 'selected ';
                    423:                 last;
                    424:             }
                    425:         }
                    426:         $Str .= '>'.$item."</option>\n";
                    427:     }
                    428:     $Str .= "</select>\n";
                    429:     return $Str;
1.60      matthew   430: }
                    431: 
1.115     matthew   432: 
                    433: 
                    434: sub get_selected_maps {
                    435:     my ($elementname) = @_;
1.124     albertel  436:     my @selected_maps = 
                    437: 	&Apache::loncommon::get_env_multiple('form.'.$elementname);
                    438:     @selected_maps = ('all') if (! @selected_maps);
1.118     matthew   439:     foreach my $map (@selected_maps) {
                    440:         if ($map eq 'all') {
                    441:             @selected_maps = ('all');
                    442:             last;
                    443:         }
                    444:     }
1.115     matthew   445:     return @selected_maps;
                    446: }
                    447: 
                    448: 
                    449: 
                    450: 
1.116     matthew   451: sub selected_sequences_with_assessments {
1.115     matthew   452:     my ($mode) = @_;
                    453:     $mode = 'selected' if (! defined($mode));
                    454:     my $navmap = Apache::lonnavmaps::navmap->new();
                    455:     if (!defined($navmap)) {
                    456:         return ('Can not open Coursemap');
                    457:     }
                    458:     #
                    459:     my @sequences = $navmap->retrieveResources(undef,
                    460:                                                sub { shift->is_map(); },1,0,1);
1.139     raeburn   461:     my $toplevelseq = $navmap->getById('0.0');
                    462:     if (!grep(/^\Q$toplevelseq\E$/,@sequences)) {
                    463:         unshift(@sequences,$toplevelseq);
                    464:     }
                    465: 
1.115     matthew   466:     my @sequences_with_assessments;
1.139     raeburn   467:     foreach my $sequence (@sequences) {
1.120     matthew   468: 	if ($navmap->hasResource($sequence,sub { shift->is_problem(); },0,1)){
1.115     matthew   469:             push(@sequences_with_assessments,$sequence);
                    470:         }
                    471:     }
                    472:     #
                    473:     my @sequences_to_show;
                    474:     foreach my $sequence (@sequences_with_assessments) {
                    475:         if ($mode eq 'all') {
                    476:             push (@sequences_to_show,$sequence);
                    477:         } elsif ($mode eq 'selected') {
1.116     matthew   478:             foreach my $map_symb (&get_selected_maps('Maps')) {
1.115     matthew   479:                 if ($sequence->symb eq $map_symb || $map_symb eq 'all'){
                    480:                     push (@sequences_to_show,$sequence);
                    481:                     last; # Only put it in once
                    482:                 }
                    483:             }
                    484:         }
                    485: 
                    486:     }
                    487:     return $navmap,@sequences_to_show;
                    488: }
                    489: 
1.60      matthew   490: 
1.115     matthew   491: sub map_select {
                    492:     my ($elementname,$status,$numvisible)=@_;
1.60      matthew   493:     if ($numvisible < 1) {
                    494:         return;
                    495:     }
                    496:     #
                    497:     # Set up array of selected items
1.115     matthew   498:     my @selected_maps = &get_selected_maps($elementname);
1.60      matthew   499:     #
                    500:     # Build the form element
1.115     matthew   501:     my $form = "\n";
                    502:     $form .= '<select name="'.$elementname.'" ';
1.60      matthew   503:     if ($status ne 'single') {
1.115     matthew   504:         $form .= 'multiple="true" ';
1.60      matthew   505:     }
1.115     matthew   506:     $form .= 'size="'.$numvisible.'" >'."\n";
1.60      matthew   507:     #
1.61      matthew   508:     # Put in option for 'all'
1.115     matthew   509:     $form .= '    <option value="all" ';
1.118     matthew   510:     if ($selected_maps[0] eq 'all') {
                    511:         $form .= 'selected ';
1.61      matthew   512:     }
1.115     matthew   513:     $form .= ">all</option>\n";
1.61      matthew   514:     #
1.60      matthew   515:     # Loop through the sequences
1.117     matthew   516:     my @sequences = &selected_sequences_with_assessments('all');
1.115     matthew   517:     my $navmap;
                    518:     if (!ref($sequences[0])) {
                    519:         return $sequences[0];
                    520:     } else {
                    521:         $navmap = shift(@sequences);
                    522:     }
                    523:     foreach my $seq (@sequences){
                    524:         $form .= '    <option value="'.$seq->symb.'" ';
                    525:         foreach (@selected_maps) {
                    526:             if ($seq->symb eq $_) {
                    527:                 $form .= 'selected ';
1.60      matthew   528:                 last;
                    529:             }
                    530:         }
1.115     matthew   531:         $form .= '>'.$seq->compTitle."</option>\n";
1.60      matthew   532:     }
1.115     matthew   533:     $form .= "</select>\n";
                    534:     return $form;
1.60      matthew   535: }
                    536: 
                    537: 
                    538: sub SectionSelect {
                    539:     my ($elementname,$status,$numvisible)=@_;
                    540:     if ($numvisible < 1) {
                    541:         return;
                    542:     }
                    543:     #
1.71      matthew   544:     # Make sure we have the data we need to continue
                    545:     if (! @Sections) {
                    546:         &PrepareClasslist()
                    547:     }
                    548:     #
1.60      matthew   549:     # Build the form element
                    550:     my $Str = "\n";
                    551:     $Str .= '<select name="'.$elementname.'" ';
                    552:     if ($status ne 'single') {
                    553:         $Str .= 'multiple="true" ';
                    554:     }
                    555:     $Str .= 'size="'.$numvisible.'" >'."\n";
                    556:     #
                    557:     # Loop through the sequences
                    558:     foreach my $s (@Sections) {
                    559:         $Str .= '    <option value="'.$s.'" ';
1.119     matthew   560:         foreach (&get_selected_sections()) {
1.61      matthew   561:             if ($s eq $_) {
1.60      matthew   562:                 $Str .= 'selected ';
                    563:                 last;
                    564:             }
                    565:         }
                    566:         $Str .= '>'.$s."</option>\n";
                    567:     }
                    568:     $Str .= "</select>\n";
                    569:     return $Str;
1.80      matthew   570: }
                    571: 
1.144   ! jms       572: 
1.130     raeburn   573: sub GroupSelect {
                    574:     my ($elementname,$status,$numvisible)=@_;
                    575:     if ($numvisible < 1) {
                    576:         return;
                    577:     }
                    578:     #
                    579:     # Make sure we have the data we need to continue
                    580:     if (! @Groups) {
                    581:         &PrepareClasslist();
                    582:     }
                    583:     #
                    584:     # Build the form element
                    585:     my $Str = "\n";
                    586:     $Str .= '<select name="'.$elementname.'" ';
                    587:     if ($status ne 'single') {
                    588:         $Str .= 'multiple="true" ';
                    589:     }
                    590:     $Str .= 'size="'.$numvisible.'" >'."\n";
                    591:     #
                    592:     # Loop through the groups
                    593:     foreach my $s (@Groups) {
                    594:         $Str .= '    <option value="'.$s.'" ';
                    595:         foreach my $group (&get_selected_groups()) {
                    596:             if ($s eq $group) {
                    597:                 $Str .= 'selected ';
                    598:                 last;
                    599:             }
                    600:         }
                    601:         $Str .= '>'.$s."</option>\n";
                    602:     }
                    603:     $Str .= "</select>\n";
                    604: }
                    605: 
                    606: 
1.144   ! jms       607: 
        !           608: 
1.60      matthew   609: sub DisplayClasslist {
                    610:     my ($r)=@_;
1.107     matthew   611:     &Apache::lonhtmlcommon::add_breadcrumb
                    612:         ({text=>'Select One Student'});
1.60      matthew   613:     #
1.105     matthew   614:     # Output some of the standard interface components
                    615:     my $Str;
1.132     albertel  616:     $Str .= &Apache::lonhtmlcommon::breadcrumbs('Select One Student');
1.105     matthew   617:     $Str .= '<p><table cellspacing="5">'."\n";
                    618:     $Str .= '<tr>';
                    619:     $Str .= '<th align="center"><b>'.&mt('Sections').'</b></th>';
1.130     raeburn   620:     $Str .= '<th align="center"><b>'.&mt('Groups').'</b></th>';
1.137     raeburn   621:     $Str .= '<th align="center"><b>'.&mt('Access Status').'</b></th>';
1.105     matthew   622:     $Str .= '</tr>'.$/;
                    623:     $Str .= '<tr>';
                    624:     $Str .= '<td>'.
                    625:         &Apache::lonstatistics::SectionSelect('Section','multiple',5).
                    626:         '</td>';
1.130     raeburn   627:     $Str .=  '<td>'.
                    628:         &Apache::lonstatistics::GroupSelect('Group','multiple',5).
                    629:         '</td>';
1.105     matthew   630:     $Str .= '<td>'.
                    631:         &Apache::lonhtmlcommon::StatusOptions(undef,undef,5).
                    632:         '</td>';
                    633:     
                    634:     $Str .= '</tr>'.$/;
                    635:     $Str .= '</table></p>';
                    636:     $Str .= '<input type="submit" name="selectstudent" value="'.
                    637:         &mt('Update Display').'" />';
                    638:     $r->print($Str);
                    639:     $r->rflush();
                    640:     #
1.130     raeburn   641:     my @Fields = ('fullname','username','domain','id','section','status','groups');
1.60      matthew   642:     #
1.105     matthew   643:     $Str = '';
1.119     matthew   644:     my @selected_sections = &get_selected_sections();
1.78      matthew   645:     if (! @Students) {
1.119     matthew   646:         if ($selected_sections[0] eq 'all') { 
1.141     bisitz    647:             if (lc($env{'form.Status'}) eq 'active') {
                    648:                 $Str .= '<p class="LC_info">'.
1.106     matthew   649:                 &mt('There are no currently enrolled students in the course.').
1.141     bisitz    650:                     '</p>';
1.123     albertel  651:             } elsif (lc($env{'form.Status'}) eq 'expired') {
1.141     bisitz    652:                 $Str .= '<p class="LC_info">'.
1.106     matthew   653:                     &mt('There are no previously enrolled students in the course.').
1.141     bisitz    654:                         '</p>';
                    655:             } elsif (lc($env{'form.Status'}) eq 'future') {
                    656:                 $Str .= '<p class="LC_info">'.
                    657:                     &mt('There are no students with future access in the course.').
                    658:                         '</p>';
                    659:             } else { # 'any' and any others
                    660:                $Str .= '<p class="LC_info">'.
                    661:                     &mt('There are no students in the course.').
                    662:                     '</p>';
1.78      matthew   663:             }
                    664:         } else { 
1.141     bisitz    665:             if (lc($env{'form.Status'}) eq 'active') {
                    666:                 $Str .= '<p class="LC_info">'.
1.106     matthew   667:                     &mt('There are no currently enrolled students in the selected sections.').
1.141     bisitz    668:                     '</p>';
1.123     albertel  669:             } elsif (lc($env{'form.Status'}) eq 'expired') {
1.141     bisitz    670:                 $Str .= '<p class="LC_info">'.
1.106     matthew   671:                     &mt('There are no previously enrolled students in the selected sections.').
1.141     bisitz    672:                     '</p>';
                    673:             } elsif (lc($env{'form.Status'}) eq 'future') {
                    674:                 $Str .= '<p class="LC_info">'.
                    675:                     &mt('There are no students with future access in the selected sections.').
                    676:                         '</p>';
                    677:             } else { # 'any' and any others
                    678:                 $Str .= '<p class="LC_info">'.
                    679:                     &mt('There are no students in the selected sections.').
                    680:                     '</p>';
1.78      matthew   681:             }
                    682:         }
1.141     bisitz    683:         $Str.= '<p>'
                    684:               .'<a href="/adm/statistics?reportSelected=student_assessment">'
                    685:               .&mt('Return to the chart').'</a>'
                    686:               .'</p>';
1.78      matthew   687:         $r->print($Str);
                    688:         $r->rflush();
                    689:         return;
                    690:     }
                    691: 
1.141     bisitz    692:     $Str .= '<h2>'.&mt('Select One Student').'</h2>'
                    693:            .'<p>'.&mt("Click on a student's name or username to view their chart").'</p>'
                    694:            .&Apache::loncommon::start_data_table()
                    695:            .&Apache::loncommon::start_data_table_header_row();
1.60      matthew   696:     foreach my $field (@Fields) {
1.101     matthew   697:         $Str .= '<th><a href="/adm/statistics?'.
                    698:             'reportSelected=student_assessment&'.
                    699:             'selectstudent=1&'.
1.106     matthew   700:             'sort='.$field.'">'.&mt($field).
1.60      matthew   701:             '</a></th>';
                    702:     }
1.141     bisitz    703:     $Str .= &Apache::loncommon::end_data_table_header_row();
1.60      matthew   704:     #
1.65      matthew   705:     foreach my $student (@Students) { # @Students is a package variable
1.60      matthew   706:         my $sname = $student->{'username'}.':'.$student->{'domain'};
1.141     bisitz    707:         $Str .= &Apache::loncommon::start_data_table_row();
1.60      matthew   708:         #
                    709:         foreach my $field (@Fields) {
                    710:             $Str .= '<td>';
1.78      matthew   711:             if ($field eq 'fullname' || $field eq 'username') {
1.60      matthew   712:                 $Str .= '<a href="/adm/statistics?reportSelected=';
1.136     www       713:                 $Str .= &escape('student_assessment');
                    714:                 $Str .= '&sort='.&escape($env{'form.sort'});
1.72      matthew   715:                 $Str .= '&SelectedStudent=';
1.136     www       716:                 $Str .= &escape($sname).'">';
1.60      matthew   717:                 $Str .= $student->{$field}.'&nbsp';
                    718:                 $Str .= '</a>';
1.106     matthew   719:             } elsif ($field eq 'status') {
                    720:                 $Str .= &mt($student->{$field});
1.60      matthew   721:             } else {
                    722:                 $Str .= $student->{$field};
                    723:             }
                    724:             $Str .= '</td>';
                    725:         }
1.141     bisitz    726:         $Str .= &Apache::loncommon::end_data_table_row();
1.60      matthew   727:     }
1.141     bisitz    728:     $Str .= &Apache::loncommon::end_data_table();
1.60      matthew   729:     #
                    730:     $r->print($Str);
                    731:     $r->rflush();
                    732:     #
                    733:     return;
                    734: }
                    735: 
1.144   ! jms       736: 
        !           737: 
1.33      stredwic  738: sub CreateMainMenu {
1.65      matthew   739:     #
1.85      matthew   740:     # Define menu data
                    741:     my @reports = ({ internal_name => 'problem_statistics',
                    742:                      name => &mt('Overall Problem Statistics'),
                    743:                      short_description => 
                    744:     &mt('Student performance statistics on all problems.'),
                    745:                  },
                    746:                    { internal_name => 'problem_analysis',
                    747:                      name => &mt('Detailed Problem Analysis'),
                    748:                      short_description => 
                    749:     &mt('Detailed statistics and graphs of student performance on problems.'),
                    750:                  },
1.89      matthew   751:                    { internal_name => 'submissiontime_analysis',
1.94      matthew   752:                      name => &mt('Submission Time Plots'),
1.89      matthew   753:                      short_description => 
                    754:     &mt('Display and analysis of submission times on assessments.'),
                    755:                  },
1.97      matthew   756:                    { internal_name => 'student_submission_reports',
                    757:                      name => &mt('Student Submission Reports'),
                    758:                      short_description => 
1.111     matthew   759:     &mt('Prepare reports of student submissions.'),
1.97      matthew   760:                  },
1.104     matthew   761:                    { internal_name => 'survey_reports',
                    762:                      name => &mt('Survey Reports'),
                    763:                      short_description => 
                    764:     &mt('Prepare reports on survey results.'),
                    765:                  },
1.94      matthew   766:                    { internal_name => 'correct_problems_plot',
                    767:                      name => &mt('Correct Problems Plot'),
                    768:                      short_description => 
                    769:     &mt('Display a histogram of student performance in the course.'),
                    770:                  },
1.128     albertel  771: #                   { internal_name => 'grading_analysis',
                    772: #                     name => &mt('Detailed Grading Analysis'),
                    773: #                     short_description => 
                    774: #    &mt('Display statistics about who graded who.'),
                    775: #                 },
1.88      matthew   776: #                   { internal_name => 'student_assessment',
                    777: #                     name => &mt('Problem Status Chart'),
                    778: #                     short_description => 
                    779: #    &mt('Brief view of each students performance in course.'),
                    780: #                 },
1.85      matthew   781:                    # 'percentage'  => 'Correct-problems Plot',
                    782:                    # 'activitylog' => 'Activity Log',
                    783:                    );
1.65      matthew   784:     #
1.85      matthew   785:     # Create the menu
                    786:     my $Str;
1.98      matthew   787:     $Str .= '<h2>'.&mt('Please select a report to generate').'</h2>';
1.85      matthew   788:     foreach my $reportdata (@reports) {
1.87      matthew   789:         $Str .='    <h3><a href="/adm/statistics?reportSelected='.
1.85      matthew   790:             $reportdata->{'internal_name'}.'" >'.
1.87      matthew   791:             $reportdata->{'name'}."</a></h3>\n";
                    792:         $Str .= '    '.('&nbsp;'x8).$reportdata->{'short_description'}.
                    793:             "\n";
1.85      matthew   794:     }
                    795:     $Str .="</dl>\n";
1.65      matthew   796:     #
1.33      stredwic  797:     return $Str;
                    798: }
                    799: 
1.144   ! jms       800: 
        !           801: 
1.1       albertel  802: sub handler {
1.31      minaeibi  803:     my $r=shift;
1.65      matthew   804:     my $c = $r->connection();
                    805:     #
                    806:     # Check for overloading
1.51      www       807:     my $loaderror=&Apache::lonnet::overloaderror($r);
                    808:     if ($loaderror) { return $loaderror; }
                    809:     $loaderror=
                    810:        &Apache::lonnet::overloaderror($r,
1.123     albertel  811:          $env{'course.'.$env{'request.course.id'}.'.home'});
1.51      www       812:     if ($loaderror) { return $loaderror; }
1.65      matthew   813:     #
                    814:     # Check for access
1.123     albertel  815:     if (! &Apache::lonnet::allowed('vgr',$env{'request.course.id'})) {
                    816:         $env{'user.error.msg'}=
1.69      matthew   817:             $r->uri.":vgr:0:0:Cannot view grades for complete course";
                    818:         if (! &Apache::lonnet::allowed('vgr',
1.123     albertel  819:                       $env{'request.course.id'}.'/'.$env{'request.course.sec'})) {
                    820:             $env{'user.error.msg'}=
1.69      matthew   821:                 $r->uri.":vgr:0:0:Cannot view grades with given role";
                    822:             return HTTP_NOT_ACCEPTABLE;
                    823:         }
1.27      stredwic  824:     }
1.65      matthew   825:     #
                    826:     # Send the header
1.92      www       827:     &Apache::loncommon::no_cache($r);
                    828:     &Apache::loncommon::content_type($r,'text/html');
1.27      stredwic  829:     $r->send_http_header;
1.92      www       830:     if ($r->header_only) { return OK; }
1.65      matthew   831:     #
                    832:     # Extract form elements from query string
1.60      matthew   833:     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
1.65      matthew   834:                                             ['sort','reportSelected',
1.72      matthew   835:                                              'SelectedStudent']);
1.65      matthew   836:     #
                    837:     # Give the LON-CAPA page header
1.109     matthew   838:     my $style = <<ENDSTYLE;
                    839: <style type="text/css">
                    840:     ul.sub_studentans { list-style-type: none }
                    841:     ul.sub_correctans { list-style-type: none }
1.110     matthew   842:     tr.even           { background-color: \#CCCCCC }
                    843:     td.essay          { border: 1px solid gray; }
1.109     matthew   844: </style>
                    845: ENDSTYLE
1.129     albertel  846:       
                    847:     $r->print(&Apache::loncommon::start_page('Course Statistics and Charts',
                    848: 					     $style));
1.65      matthew   849:     $r->rflush();
1.85      matthew   850:     # 
                    851:     # Either print out a menu for them or send them to a report
1.98      matthew   852:     &Apache::lonhtmlcommon::clear_breadcrumbs();
                    853:     &Apache::lonhtmlcommon::add_breadcrumb({href=>'/adm/statistics',
1.100     matthew   854:                                             title=>'Statistics',
                    855:                                             text =>'Statistics',
1.98      matthew   856:                                             faq=>139,
                    857:                                             bug=>'Statistics and Charts'});
1.123     albertel  858:     if (! exists($env{'form.reportSelected'}) || 
                    859:         $env{'form.reportSelected'} eq '') {
1.132     albertel  860:         $r->print(&Apache::lonhtmlcommon::breadcrumbs('Statistics Main Page').
1.98      matthew   861:                   &CreateMainMenu());
1.85      matthew   862:     } else {
1.65      matthew   863:     #
1.85      matthew   864:         if (! &Apache::lonmysql::verify_sql_connection()) {
                    865:             my $serveradmin = $r->dir_config('lonAdmEMail');
1.140     bisitz    866:             $r->print('<h2 class="LC_error">'.
1.85      matthew   867:                       &mt('Unable to connect to database!').
1.140     bisitz    868:                       '</h2>');
                    869:             $r->print('<p>'
                    870:                      .&mt('Please notify the server administrator [_1]',
                    871:                          ,'<b>'.$serveradmin.'</b>')
                    872:                      .'</p>');
1.85      matthew   873:             $r->print('<p>'.
                    874:                       &mt('Course Statistics and Charts cannot be '.
                    875:                           'retrieved until the database is restarted.  '.
                    876:                           'Your data is intact but cannot be displayed '.
                    877:                           'at this time.').'</p>');
1.129     albertel  878:             $r->print(&Apache::loncommon::end_page());
1.85      matthew   879:             return;
                    880:         }
                    881:         #
                    882:         # Clean out the caches
1.123     albertel  883:         if (exists($env{'form.ClearCache'})) {
                    884:             &Apache::loncoursedata::delete_caches($env{'requres.course.id'});
1.85      matthew   885:         }
                    886:         #
                    887:         # Begin form output
                    888:         $r->print('<form name="Statistics" ');
                    889:         $r->print('method="post" action="/adm/statistics">');
                    890:         $r->rflush();
                    891:         #
1.123     albertel  892:         my $GoToPage = $env{'form.reportSelected'};
1.90      matthew   893:         #
1.85      matthew   894:         $r->print('<input type="hidden" name="reportSelected" value="'.
                    895:                   $GoToPage.'">');
                    896:         if($GoToPage eq 'activitylog') {
1.65      matthew   897: #        &Apache::lonproblemstatistics::Activity();
1.85      matthew   898:         } elsif($GoToPage eq 'problem_statistics') {
1.98      matthew   899:             &Apache::lonhtmlcommon::add_breadcrumb
                    900:                 ({href=>'/adm/statistics?reportselected=problem_statistics',
1.100     matthew   901:                   text=>'Overall Problem Statistics'});
1.85      matthew   902:             &Apache::lonproblemstatistics::BuildProblemStatisticsPage($r,$c);
                    903:         } elsif($GoToPage eq 'problem_analysis') {
1.98      matthew   904:             &Apache::lonhtmlcommon::add_breadcrumb
                    905:                 ({href=>'/adm/statistics?reportselected=problem_analysis',
1.100     matthew   906:                   text=>'Detailed Problem Analysis'});
1.85      matthew   907:             &Apache::lonproblemanalysis::BuildProblemAnalysisPage($r,$c);
1.89      matthew   908:         } elsif($GoToPage eq 'submissiontime_analysis') {
1.98      matthew   909:             &Apache::lonhtmlcommon::add_breadcrumb
                    910:                 ({href=>
                    911:                       '/adm/statistics?reportselected=submissiontime_analysis',
1.100     matthew   912:                       text=>'Submission Time Plots'});
1.89      matthew   913:             &Apache::lonsubmissiontimeanalysis::BuildSubmissionTimePage($r,$c);
1.97      matthew   914:         } elsif($GoToPage eq 'student_submission_reports') {
1.98      matthew   915:             &Apache::lonhtmlcommon::add_breadcrumb
                    916:                 ({href=>
                    917:                   '/adm/statistics?reportselected=student_submission_reports',
1.100     matthew   918:                   text=>'Student Submission Reports'});
1.97      matthew   919:             &Apache::lonstudentsubmissions::BuildStudentSubmissionsPage($r,$c);
1.104     matthew   920:         } elsif($GoToPage eq 'survey_reports') {
                    921:             &Apache::lonhtmlcommon::add_breadcrumb
                    922:                 ({href=>
                    923:                   '/adm/statistics?reportselected=survey_reports',
                    924:                   text=>'Survey Reports'});
                    925:             &Apache::lonsurveyreports::BuildSurveyReportsPage($r,$c);
1.94      matthew   926:         } elsif($GoToPage eq 'correct_problems_plot') {
1.98      matthew   927:             &Apache::lonhtmlcommon::add_breadcrumb
                    928:                 ({href=>'/adm/statistics?reportselected=correct_problems_plot',
1.100     matthew   929:                   text=>'Correct Problems Plot'});
1.94      matthew   930:             &Apache::loncorrectproblemplot::BuildCorrectProblemsPage($r,$c);
1.85      matthew   931:         } elsif($GoToPage eq 'student_assessment') {
1.98      matthew   932:             &Apache::lonhtmlcommon::clear_breadcrumbs();
                    933:             &Apache::lonhtmlcommon::add_breadcrumb
                    934:                 ({href=>'/adm/statistics?reportselected=student_assessment',
1.100     matthew   935:                   text=>'Chart'});
1.85      matthew   936:             &Apache::lonstudentassessment::BuildStudentAssessmentPage($r,$c);
1.128     albertel  937:         } elsif($GoToPage eq 'grading_analysis') {
                    938:             &Apache::lonhtmlcommon::add_breadcrumb
                    939:                 ({href=>'/adm/statistics?reportselected=grading_anaylsis',
                    940:                   text=>'Grading Analysis'});
                    941:             &Apache::longradinganalysis::build_grading_analysis_page($r,$c);
                    942: 	}
1.85      matthew   943:         #
                    944:         $r->print("</form>\n");
1.65      matthew   945:     }
1.129     albertel  946:     $r->print(&Apache::loncommon::end_page());
1.65      matthew   947:     $r->rflush();
                    948:     #
1.27      stredwic  949:     return OK;
1.1       albertel  950: }
1.65      matthew   951: 
1.1       albertel  952: 1;
1.59      matthew   953: 
1.144   ! jms       954: __END__
1.65      matthew   955: 
1.59      matthew   956: =pod
                    957: 
1.144   ! jms       958: =head1 NAME
        !           959: 
        !           960: lonstatistics
        !           961: 
        !           962: =head1 SYNOPSIS
        !           963: 
        !           964: Main handler for statistics and chart.
        !           965: 
        !           966: This is part of the LearningOnline Network with CAPA project
        !           967: described at http://www.lon-capa.org.
        !           968: 
        !           969: 
        !           970: =head1 PACKAGE VARIABLES
        !           971: 
        !           972: =over
        !           973: 
        !           974: =item @FullClasslist The full classlist
        !           975: 
        !           976: =item @Students The students we are concerned with for this invocation
        !           977: 
        !           978: =item @Sections The sections available in this class
        !           979: 
        !           980: =item @Groups The groups available in the class
        !           981: 
        !           982: =item $curr_student The student currently being examined
        !           983: 
        !           984: =item $prev_student The student previous in the classlist
        !           985: 
        !           986: =item $next_student The student next in the classlist
        !           987: 
        !           988: =back
        !           989: 
        !           990: =head1 SUBROUTINES
        !           991: 
        !           992: =over
        !           993: 
        !           994: =item &clear_classlist_variables()
        !           995: 
        !           996: undef the following package variables:
        !           997: 
        !           998: =over 4
        !           999: 
        !          1000: =item * @FullClasslist
        !          1001: 
        !          1002: =item * @Students
        !          1003: 
        !          1004: =item * @Sections
        !          1005: 
        !          1006: =item * @Groups
        !          1007: 
        !          1008: =item * %StudentData
        !          1009: 
        !          1010: =item * @StudentDataOrder
        !          1011: 
        !          1012: =item * @SelectedStudentData
        !          1013: 
        !          1014: =item * $curr_student
        !          1015: 
        !          1016: =item * $prev_student
        !          1017: 
        !          1018: =item * $next_student
        !          1019: 
        !          1020: =back
        !          1021: 
        !          1022: =item &PrepareClasslist()
        !          1023: 
        !          1024: Build up the classlist information.  The classlist information is kept in
        !          1025: the following package variables:
        !          1026: 
        !          1027: =over 4 
        !          1028: 
        !          1029: =item * @FullClasslist
        !          1030: 
        !          1031: =item * @Students
        !          1032: 
        !          1033: =item * @Sections
        !          1034: 
        !          1035: =item * @Groups 
        !          1036: 
        !          1037: =item * %StudentData
        !          1038: 
        !          1039: =item * @SelectedStudentData
        !          1040: 
        !          1041: =item * $curr_student
        !          1042: 
        !          1043: =item * $prev_student
        !          1044: 
        !          1045: =item * $next_student
        !          1046: 
        !          1047: =back
        !          1048: 
        !          1049: $curr_student, $prev_student, and $next_student may not be defined, depending
        !          1050: upon the calling context.
        !          1051: 
        !          1052: =item get_selected_sections()
        !          1053: 
        !          1054: Returns an array of the selected sections
        !          1055: 
        !          1056: =item get_selected_groups()
        !          1057:                                                                                     
        !          1058: Returns an array of the selected groups
        !          1059: 
        !          1060: =item &section_and_enrollment_description()
        !          1061: 
        !          1062: Returns a string describing the currently selected section(s), group(s) and 
        !          1063: access status.  
        !          1064: 
        !          1065: Inputs: mode = 'plaintext' or 'localized'  (defaults to 'localized')
        !          1066:     'plaintext' is used for example in Excel spreadsheets.
        !          1067: Returns: scalar description string.
        !          1068: 
        !          1069: =item section_or_group_text()
        !          1070: 
        !          1071: =item get_students()
        !          1072: 
        !          1073: Returns a list of the selected students
        !          1074: 
        !          1075: =item &current_student()
        !          1076: 
        !          1077: Returns a pointer to a hash containing data about the currently
        !          1078: selected student.
        !          1079: 
        !          1080: =item &previous_student()
        !          1081: 
        !          1082: Returns a pointer to a hash containing data about the student prior
        !          1083: in the list of students.  Or something. 
        !          1084: 
        !          1085: =item &next_student()
        !          1086: 
        !          1087: Returns a pointer to a hash containing data about the next student
        !          1088: to be viewed. 
        !          1089: 
        !          1090: =item &StudentDataSelect($elementname,$status,$numvisible,$selected)
        !          1091: 
        !          1092: Returns html for a selection box allowing the user to choose one (or more) 
        !          1093: of the fields of student data available (fullname, username, id, section, etc)
        !          1094: 
        !          1095: =over 4
        !          1096: 
        !          1097: =item * $elementname The name of the HTML form element
        !          1098: 
        !          1099: =item * $status 'multiple' or 'single' selection box
        !          1100: 
        !          1101: =item * $numvisible The number of options to be visible
        !          1102: 
        !          1103: =back
        !          1104: 
        !          1105: =item &get_selected_maps($elementname)
        !          1106: 
        !          1107: Input: Name of the <select> form element used to specify the maps.
        !          1108: 
        !          1109: Returns: Array of symbs of selected maps or the description 'all'.
        !          1110:    If form.$elementname does not exist, 'all' is returned.
        !          1111: 
        !          1112: =item &selected_sequences_with_assessments()
        !          1113: 
        !          1114: Retrieve the sequences which were selected by the user to show.  
        !          1115: 
        !          1116: Input: $mode: scalar.  Either 'selected' or 'all'.  If not specified,
        !          1117:     'selected' is used.
        !          1118: 
        !          1119: Returns: an array containing a navmap object and navmap resources, 
        !          1120:     or an array containing a scalar with an error message.
        !          1121: 
        !          1122: =item &map_select($elementname,$status,$numvisible,$restriction) 
        !          1123: 
        !          1124: Returns html for a selection box allowing the user to choose one (or more) 
        !          1125: of the sequences in the course.  The values of the sequences are the symbs.
        !          1126: If the top sequence is selected, the value 'top' will result.
        !          1127: 
        !          1128: =over 4
        !          1129: 
        !          1130: =item * $elementname The name of the HTML form element
        !          1131: 
        !          1132: =item * $status 'multiple' or 'single' selection box
        !          1133: 
        !          1134: =item * $numvisible The number of options to be visible
        !          1135: 
1.59      matthew  1136: =back
                   1137: 
1.144   ! jms      1138: =item &SectionSelect($elementname,$status,$numvisible) 
        !          1139: 
        !          1140: Returns html for a selection box allowing the user to choose one (or more) 
        !          1141: of the sections in the course.  
        !          1142: 
        !          1143: Uses the package variables @Sections
        !          1144: 
        !          1145: =over 4
        !          1146: 
        !          1147: =item * $elementname The name of the HTML form element
        !          1148: 
        !          1149: =item * $status 'multiple' or 'single' selection box
        !          1150: 
        !          1151: =item * $numvisible The number of options to be visible
        !          1152: 
        !          1153: =back
        !          1154: 
        !          1155: =item &GroupSelect($elementname,$status,$numvisible)
        !          1156:                                                                                     
        !          1157: Returns html for a selection box allowing the user to choose one (or more)
        !          1158: of the groups in the course.
        !          1159:                                                                                     
        !          1160: Uses the package variables @Groups
        !          1161: 
        !          1162: =over 4
        !          1163:                                                                                     
        !          1164: =item * $elementname The name of the HTML form element
        !          1165:                                                                                     
        !          1166: =item * $status 'multiple' or 'single' selection box
        !          1167:                                                                                     
        !          1168: =item * $numvisible The number of options to be visible
        !          1169:                                                                                     
        !          1170: =back
        !          1171: 
        !          1172: =item CreateMainMenu()
1.65      matthew  1173: 
1.144   ! jms      1174: =back
1.59      matthew  1175: 
1.144   ! jms      1176: =cut
1.31      minaeibi 1177: 

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