version 1.127, 2005/12/13 16:32:22
|
version 1.164, 2017/12/18 23:51:14
|
Line 28
|
Line 28
|
# |
# |
### |
### |
|
|
=pod |
|
|
|
=head1 NAME |
|
|
|
lonstatistics |
|
|
|
=head1 SYNOPSIS |
|
|
|
Main handler for statistics and chart. |
|
|
|
=over 4 |
|
|
|
=cut |
|
|
|
package Apache::lonstatistics; |
package Apache::lonstatistics; |
|
|
Line 49 use Apache::Constants qw(:common :http);
|
Line 37 use Apache::Constants qw(:common :http);
|
use vars qw( |
use vars qw( |
@FullClasslist |
@FullClasslist |
@Students |
@Students |
@Sections |
@Sections |
|
@Groups |
%StudentData |
%StudentData |
@StudentDataOrder |
@StudentDataOrder |
@SelectedStudentData |
@SelectedStudentData |
Line 62 use Apache::loncoursedata;
|
Line 51 use Apache::loncoursedata;
|
use Apache::lonhtmlcommon; |
use Apache::lonhtmlcommon; |
use Apache::lonmysql; |
use Apache::lonmysql; |
use Apache::lonlocal; |
use Apache::lonlocal; |
|
use Apache::longroup; |
use Time::HiRes; |
use Time::HiRes; |
# |
# |
# Statistics Packages |
# Statistics Packages |
Line 73 use Apache::lonstudentassessment();
|
Line 63 use Apache::lonstudentassessment();
|
use Apache::lonpercentage; |
use Apache::lonpercentage; |
use Apache::lonstudentsubmissions(); |
use Apache::lonstudentsubmissions(); |
use Apache::lonsurveyreports(); |
use Apache::lonsurveyreports(); |
|
use Apache::longradinganalysis(); |
|
use Apache::lonquickgrades(); |
|
use LONCAPA; |
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item Package Variables |
|
|
|
=item @FullClasslist The full classlist |
|
|
|
=item @Students The students we are concerned with for this invocation |
|
|
|
=item @Sections The sections available in this class |
|
|
|
=item $curr_student The student currently being examined |
|
|
|
=item $prev_student The student previous in the classlist |
|
|
|
=item $next_student The student next in the classlist |
|
|
|
=over |
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
# |
# |
# Classlist variables |
# Classlist variables |
# |
# |
Line 106 my $curr_student;
|
Line 74 my $curr_student;
|
my $prev_student; |
my $prev_student; |
my $next_student; |
my $next_student; |
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item &clear_classlist_variables() |
|
|
|
undef the following package variables: |
|
|
|
=over |
|
|
|
=item @FullClasslist |
|
|
|
=item @Students |
|
|
|
=item @Sections |
|
|
|
=item %StudentData |
|
|
|
=item @StudentDataOrder |
|
|
|
=item @SelectedStudentData |
|
|
|
=item $curr_student |
|
|
|
=item $prev_student |
|
|
|
=item $next_student |
|
|
|
=back |
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
sub clear_classlist_variables { |
sub clear_classlist_variables { |
undef(@FullClasslist); |
undef(@FullClasslist); |
undef(@Students); |
undef(@Students); |
undef(@Sections); |
undef(@Sections); |
|
undef(@Groups); |
undef(%StudentData); |
undef(%StudentData); |
undef(@SelectedStudentData); |
undef(@SelectedStudentData); |
undef($curr_student); |
undef($curr_student); |
Line 152 sub clear_classlist_variables {
|
Line 87 sub clear_classlist_variables {
|
undef($next_student); |
undef($next_student); |
} |
} |
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item &PrepareClasslist() |
|
|
|
Build up the classlist information. The classlist information is kept in |
|
the following package variables: |
|
|
|
=over |
|
|
|
=item @FullClasslist |
|
|
|
=item @Students |
|
|
|
=item @Sections |
|
|
|
=item %StudentData |
|
|
|
=item @SelectedStudentData |
|
|
|
=item $curr_student |
|
|
|
=item $prev_student |
|
|
|
=item $next_student |
|
|
|
=back |
|
|
|
$curr_student, $prev_student, and $next_student may not be defined, depending |
|
upon the calling context. |
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
sub PrepareClasslist { |
sub PrepareClasslist { |
my %Sections; |
my %Sections; |
&clear_classlist_variables(); |
&clear_classlist_variables(); |
Line 200 sub PrepareClasslist {
|
Line 99 sub PrepareClasslist {
|
my ($classlist,$field_names) = &Apache::loncoursedata::get_classlist($cdom, |
my ($classlist,$field_names) = &Apache::loncoursedata::get_classlist($cdom, |
$cnum); |
$cnum); |
my @selected_sections = &get_selected_sections(); |
my @selected_sections = &get_selected_sections(); |
|
my @selected_groups = &get_selected_groups(); |
# |
# |
# Deal with instructors with restricted section access |
# Deal with instructors with restricted section access |
if ($env{'request.course.sec'} !~ /^\s*$/) { |
if ($env{'request.course.sec'} !~ /^\s*$/) { |
Line 207 sub PrepareClasslist {
|
Line 107 sub PrepareClasslist {
|
} |
} |
# |
# |
# Set up %StudentData |
# Set up %StudentData |
@StudentDataOrder = qw/fullname username domain id section status comments/; |
@StudentDataOrder = qw/fullname username domain id section status groups comments/; |
foreach my $field (@StudentDataOrder) { |
foreach my $field (@StudentDataOrder) { |
$StudentData{$field}->{'title'} = &mt($field); |
$StudentData{$field}->{'title'} = &mt($field); |
$StudentData{$field}->{'base_width'} = length(&mt($field)); |
$StudentData{$field}->{'base_width'} = length(&mt($field)); |
Line 219 sub PrepareClasslist {
|
Line 119 sub PrepareClasslist {
|
$enrollment_status = 'Active'; |
$enrollment_status = 'Active'; |
$enrollment_status = $env{'form.Status'} if (exists($env{'form.Status'})); |
$enrollment_status = $env{'form.Status'} if (exists($env{'form.Status'})); |
# |
# |
|
# Get groupmembership |
|
my ($classgroups,$studentgroups); |
|
my %curr_groups = &Apache::longroup::coursegroups($cdom,$cnum); |
|
if (%curr_groups) { |
|
($classgroups,$studentgroups) = |
|
&Apache::loncoursedata::get_group_memberships($classlist, |
|
$field_names, |
|
$cdom,$cnum); |
|
} |
|
my $now = time; |
|
|
# Process the classlist |
# Process the classlist |
while (my ($student,$student_data) = each (%$classlist)) { |
while (my ($student,$student_data) = each (%$classlist)) { |
my $studenthash = (); |
my $studenthash = (); |
Line 233 sub PrepareClasslist {
|
Line 144 sub PrepareClasslist {
|
$StudentData{$field}->{'width'} = $length; |
$StudentData{$field}->{'width'} = $length; |
} |
} |
} |
} |
|
my @studentsgroups = &Apache::loncoursedata::get_students_groups |
|
($student,$enrollment_status, |
|
$classgroups); |
|
if (@studentsgroups) { |
|
$studenthash->{'groups'} = join(', ',@studentsgroups); |
|
$studenthash->{'groupref'} = \@studentsgroups; |
|
} else { |
|
$studenthash->{'groups'} = 'none'; |
|
$studenthash->{'groupref'} = []; |
|
} |
push (@FullClasslist,$studenthash); |
push (@FullClasslist,$studenthash); |
# |
# |
# Build up a list of sections |
# Build up a list of sections |
Line 250 sub PrepareClasslist {
|
Line 171 sub PrepareClasslist {
|
(($studenthash->{'status'} eq $enrollment_status) || |
(($studenthash->{'status'} eq $enrollment_status) || |
($enrollment_status eq 'Any')) |
($enrollment_status eq 'Any')) |
){ |
){ |
push (@Students,$studenthash); |
my $groupcheck = 0; |
last; |
if (grep(/^all$/,@selected_groups)) { |
|
push(@Students,$studenthash); |
|
last; |
|
} elsif (grep(/^none$/,@selected_groups)) { |
|
if ($studenthash->{'groups'} eq 'none') { |
|
push(@Students,$studenthash); |
|
last; |
|
} |
|
} else { |
|
foreach my $group (@selected_groups) { |
|
if (grep(/^$group$/,@studentsgroups)) { |
|
push(@Students,$studenthash); |
|
$groupcheck = 1; |
|
last; |
|
} |
|
} |
|
if ($groupcheck) { |
|
last; |
|
} |
|
} |
} |
} |
} |
} |
} |
} |
Line 260 sub PrepareClasslist {
|
Line 200 sub PrepareClasslist {
|
if ($env{'request.course.sec'} !~ /^\s*$/) { |
if ($env{'request.course.sec'} !~ /^\s*$/) { |
@Sections = ($env{'request.course.sec'}); |
@Sections = ($env{'request.course.sec'}); |
} else { |
} else { |
@Sections = sort {$a cmp $b} keys(%Sections); |
@Sections = sort { |
|
if ($a == $a && $b == $b ) { return $a <=> $b; } |
|
return $a cmp $b; |
|
} keys(%Sections); |
|
|
unshift(@Sections,'all'); # Put 'all' at the front of the list |
unshift(@Sections,'all'); # Put 'all' at the front of the list |
} |
} |
|
# Sort the groups |
|
@Groups = sort {$a cmp $b} keys(%{$studentgroups}); |
|
unshift(@Groups,'all'); # Put 'all' at the front of the list |
|
|
# |
# |
# Sort the Students |
# Sort the Students |
my $sortby = 'fullname'; |
my $sortby = 'fullname'; |
Line 314 sub PrepareClasslist {
|
Line 262 sub PrepareClasslist {
|
return; |
return; |
} |
} |
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item get_selected_sections |
|
|
|
Returns an array of the selected sections |
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
sub get_selected_sections { |
sub get_selected_sections { |
my @selected_sections = |
my @selected_sections = |
&Apache::loncommon::get_env_multiple('form.Section'); |
&Apache::loncommon::get_env_multiple('form.Section'); |
Line 344 sub get_selected_sections {
|
Line 280 sub get_selected_sections {
|
return @selected_sections; |
return @selected_sections; |
} |
} |
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item §ion_and_enrollment_description |
sub get_selected_groups { |
|
my @selected_groups = |
Returns a string describing the currenly selected section(s) and |
&Apache::loncommon::get_env_multiple('form.Group'); |
enrollment status. |
@selected_groups = ('all') if (! @selected_groups); |
|
foreach my $grp (@selected_groups) { |
Inputs: mode = 'plaintext' or 'localized' (defaults to 'localized') |
if ($grp eq 'all') { |
'plaintext' is used for example in Excel spreadsheets. |
@selected_groups = ('all'); |
Returns: scalar description string. |
last; |
|
} |
|
} |
|
return @selected_groups; |
|
} |
|
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
sub section_and_enrollment_description { |
sub section_and_enrollment_description { |
my ($mode) = @_; |
my ($mode) = @_; |
if (! defined($mode)) { $mode = 'localized'; } |
if (! defined($mode)) { $mode = 'localized'; } |
my @sections = &Apache::lonstatistics::get_selected_sections(); |
my @sections = &Apache::lonstatistics::get_selected_sections(); |
|
my @groups = &Apache::lonstatistics::get_selected_groups(); |
my $description; |
my $description; |
if ($mode eq 'localized') { |
if ($mode eq 'localized') { |
$description = &mt('Unable to determine section and enrollment'); |
$description = &mt('Unable to determine section, groups and access status'); |
} elsif ($mode eq 'plaintext') { |
} elsif ($mode eq 'plaintext') { |
$description = 'Unable to determine section and enrollment'; |
$description = 'Unable to determine section, groups and access status'; |
} else { |
} else { |
$description = 'Bad parameter passed to lonstatistics::section_and_enrollment_description'; |
$description = 'Bad parameter passed to lonstatistics::section_and_enrollment_description'; |
&Apache::lonnet::logthis($description); |
&Apache::lonnet::logthis($description); |
} |
} |
if (scalar(@sections) == 1 && $sections[0] ne 'all') { |
$description = §ion_or_group_text($mode,'section',@sections). |
|
' '.§ion_or_group_text($mode,'group',@groups); |
|
if ($mode eq 'localized') { |
|
$description .= ' '.&mt($env{'form.Status'}.' access status.'); |
|
} elsif ($mode eq 'plaintext') { |
|
$description .= ' '.$env{'form.Status'}.' access status.'; |
|
} |
|
return $description; |
|
} |
|
|
|
|
|
|
|
|
|
sub section_or_group_text { |
|
my ($mode,$type,@items) = @_; |
|
my $text; |
|
my %phrases = (); |
|
%{$phrases{'section'}} = ( |
|
single => 'Section', |
|
all => 'All sections', |
|
plural => 'Sections', |
|
); |
|
%{$phrases{'group'}} = ( |
|
single => 'Group', |
|
all => 'All groups', |
|
plural => 'Groups', |
|
); |
|
if (scalar(@items) == 1 && $items[0] ne 'all') { |
if ($mode eq 'localized') { |
if ($mode eq 'localized') { |
$description = &mt('Section [_1]. [_2] enrollment status.', |
$text = &mt($phrases{$type}{single}.' [_1].',$items[0]); |
$sections[0],$env{'form.Status'}); |
|
} elsif ($mode eq 'plaintext') { |
} elsif ($mode eq 'plaintext') { |
$description = 'Section '.$sections[0].'. '. |
$text = $phrases{$type}{single}.' '.$items[0].'.'; |
$env{'form.Status'}.' enrollment status.'; |
|
} |
} |
} elsif (scalar(@sections) && $sections[0] eq 'all') { |
} elsif (scalar(@items) && $items[0] eq 'all') { |
if ($mode eq 'localized') { |
if ($mode eq 'localized') { |
$description = &mt('All sections. [_1] enrollment status.', |
$text = &mt($phrases{$type}{all}.'.'); |
$env{'form.Status'}); |
|
} elsif ($mode eq 'plaintext') { |
} elsif ($mode eq 'plaintext') { |
$description = 'All sections. '. |
$text = $phrases{$type}{all}.'.'; |
$env{'form.Status'}.' enrollment status.'; |
|
} |
} |
} elsif (scalar(@sections)) { |
} elsif (scalar(@items)) { |
my $lastsection = pop(@sections); |
my $lastitem = pop(@items); |
if ($mode eq 'localized') { |
if ($mode eq 'localized') { |
$description = &mt('Sections [_1] and [_2]. [_3] enrollment status.', |
$text = &mt($phrases{$type}{plural}.' [_1] and [_2].', |
join(', ',@sections),$lastsection, |
join(', ',@items),$lastitem); |
$env{'form.Status'}); |
|
} elsif ($mode eq 'plaintext') { |
} elsif ($mode eq 'plaintext') { |
$description = |
$text = $phrases{$type}{plural}.' '.join(', ',@items).' and '. |
'Sections '.join(', ',@sections).' and '.$lastsection.'. '. |
$lastitem.'.'; |
$env{'form.Status'}.' enrollment status.'; |
|
} |
} |
} |
} |
return $description; |
return $text; |
} |
} |
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item get_students |
|
|
|
Returns a list of the selected students |
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
sub get_students { |
sub get_students { |
if (! @Students) { |
if (! @Students) { |
&PrepareClasslist() |
&PrepareClasslist(); |
} |
} |
return @Students; |
return @Students; |
} |
} |
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item ¤t_student() |
|
|
|
Returns a pointer to a hash containing data about the currently |
|
selected student. |
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
sub current_student { |
sub current_student { |
return $curr_student; |
return $curr_student; |
} |
} |
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item &previous_student() |
|
|
|
Returns a pointer to a hash containing data about the student prior |
|
in the list of students. Or something. |
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
sub previous_student { |
sub previous_student { |
return $prev_student; |
return $prev_student; |
} |
} |
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item &next_student() |
|
|
|
Returns a pointer to a hash containing data about the next student |
|
to be viewed. |
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
sub next_student { |
sub next_student { |
return $next_student; |
return $next_student; |
} |
} |
|
|
############################################## |
|
############################################## |
|
|
|
=pod |
|
|
|
=item &StudentDataSelect($elementname,$status,$numvisible,$selected) |
|
|
|
Returns html for a selection box allowing the user to choose one (or more) |
|
of the fields of student data available (fullname, username, id, section, etc) |
|
|
|
=over 4 |
|
|
|
=item $elementname The name of the HTML form element |
|
|
|
=item $status 'multiple' or 'single' selection box |
|
|
|
=item $numvisible The number of options to be visible |
|
|
|
=back |
|
|
|
=cut |
|
|
|
############################################## |
|
############################################## |
|
sub StudentDataSelect { |
sub StudentDataSelect { |
my ($elementname,$status,$numvisible)=@_; |
my ($elementname,$status,$numvisible)=@_; |
if ($numvisible < 1) { |
if ($numvisible < 1) { |
Line 514 sub StudentDataSelect {
|
Line 401 sub StudentDataSelect {
|
my $Str = "\n"; |
my $Str = "\n"; |
$Str .= '<select name="'.$elementname.'" '; |
$Str .= '<select name="'.$elementname.'" '; |
if ($status ne 'single') { |
if ($status ne 'single') { |
$Str .= 'multiple="true" '; |
$Str .= 'multiple="multiple" '; |
} |
} |
$Str .= 'size="'.$numvisible.'" >'."\n"; |
$Str .= 'size="'.$numvisible.'" >'."\n"; |
# |
# |
# Deal with 'all' |
# Deal with 'all' |
$Str .= ' <option value="all" '; |
$Str .= ' <option value="all"'; |
foreach (@SelectedStudentData) { |
foreach (@SelectedStudentData) { |
if ($_ eq 'all') { |
if ($_ eq 'all') { |
$Str .= 'selected '; |
$Str .= ' selected="selected"'; |
last; |
last; |
} |
} |
} |
} |
$Str .= ">all</option>\n"; |
$Str .= '>'.&mt('all')."</option>\n"; |
# |
# |
# Loop through the student data fields |
# Loop through the student data fields |
foreach my $item (@StudentDataOrder) { |
foreach my $item (@StudentDataOrder) { |
$Str .= ' <option value="'.$item.'" '; |
$Str .= ' <option value="'.$item.'"'; |
foreach (@SelectedStudentData) { |
foreach (@SelectedStudentData) { |
if ($item eq $_ ) { |
if ($item eq $_ ) { |
$Str .= 'selected '; |
$Str .= ' selected="selected"'; |
last; |
last; |
} |
} |
} |
} |
$Str .= '>'.$item."</option>\n"; |
$Str .= '>'.&mt($item)."</option>\n"; |
} |
} |
$Str .= "</select>\n"; |
$Str .= "</select>\n"; |
return $Str; |
return $Str; |
} |
} |
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item &get_selected_maps($elementname) |
|
|
|
Input: Name of the <select> form element used to specify the maps. |
|
|
|
Returns: Array of symbs of selected maps or the description 'all'. |
|
If form.$elementname does not exist, 'all' is returned. |
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
sub get_selected_maps { |
sub get_selected_maps { |
my ($elementname) = @_; |
my ($elementname) = @_; |
my @selected_maps = |
my @selected_maps = |
Line 574 sub get_selected_maps {
|
Line 447 sub get_selected_maps {
|
} |
} |
|
|
|
|
####################################################### |
|
####################################################### |
|
|
|
=pod |
|
|
|
=item &selected_sequences_with_assessments |
|
|
|
Retrieve the sequences which were selected by the user to show. |
|
|
|
Input: $mode: scalar. Either 'selected' or 'all'. If not specified, |
|
'selected' is used. |
|
|
|
Returns: an array containing a navmap object and navmap resources, |
|
or an array containing a scalar with an error message. |
|
|
|
=cut |
|
|
|
####################################################### |
|
####################################################### |
|
sub selected_sequences_with_assessments { |
sub selected_sequences_with_assessments { |
my ($mode) = @_; |
my ($mode) = @_; |
$mode = 'selected' if (! defined($mode)); |
$mode = 'selected' if (! defined($mode)); |
Line 603 sub selected_sequences_with_assessments
|
Line 459 sub selected_sequences_with_assessments
|
# |
# |
my @sequences = $navmap->retrieveResources(undef, |
my @sequences = $navmap->retrieveResources(undef, |
sub { shift->is_map(); },1,0,1); |
sub { shift->is_map(); },1,0,1); |
|
my $toplevelseq = $navmap->getById('0.0'); |
|
if (!grep(/^\Q$toplevelseq\E$/,@sequences)) { |
|
unshift(@sequences,$toplevelseq); |
|
} |
|
|
my @sequences_with_assessments; |
my @sequences_with_assessments; |
for my $sequence ($navmap->getById('0.0'), @sequences) { |
foreach my $sequence (@sequences) { |
if ($navmap->hasResource($sequence,sub { shift->is_problem(); },0,1)){ |
if ($navmap->hasResource($sequence,sub { shift->is_gradable(); },0,1)){ |
push(@sequences_with_assessments,$sequence); |
push(@sequences_with_assessments,$sequence); |
} |
} |
} |
} |
Line 627 sub selected_sequences_with_assessments
|
Line 488 sub selected_sequences_with_assessments
|
return $navmap,@sequences_to_show; |
return $navmap,@sequences_to_show; |
} |
} |
|
|
############################################## |
|
############################################## |
|
|
|
=pod |
|
|
|
=item &map_select($elementname,$status,$numvisible,$restriction) |
|
|
|
Returns html for a selection box allowing the user to choose one (or more) |
|
of the sequences in the course. The values of the sequences are the symbs. |
|
If the top sequence is selected, the value 'top' will result. |
|
|
|
=over 4 |
|
|
|
=item $elementname The name of the HTML form element |
|
|
|
=item $status 'multiple' or 'single' selection box |
|
|
|
=item $numvisible The number of options to be visible |
|
|
|
=back |
|
|
|
=cut |
|
|
|
############################################## |
|
############################################## |
|
sub map_select { |
sub map_select { |
my ($elementname,$status,$numvisible)=@_; |
my ($elementname,$status,$numvisible)=@_; |
if ($numvisible < 1) { |
if ($numvisible < 1) { |
Line 665 sub map_select {
|
Line 502 sub map_select {
|
my $form = "\n"; |
my $form = "\n"; |
$form .= '<select name="'.$elementname.'" '; |
$form .= '<select name="'.$elementname.'" '; |
if ($status ne 'single') { |
if ($status ne 'single') { |
$form .= 'multiple="true" '; |
$form .= 'multiple="multiple" '; |
} |
} |
$form .= 'size="'.$numvisible.'" >'."\n"; |
$form .= 'size="'.$numvisible.'" >'."\n"; |
# |
# |
# Put in option for 'all' |
# Put in option for 'all' |
$form .= ' <option value="all" '; |
$form .= ' <option value="all"'; |
if ($selected_maps[0] eq 'all') { |
if ($selected_maps[0] eq 'all') { |
$form .= 'selected '; |
$form .= ' selected="selected"'; |
} |
} |
$form .= ">all</option>\n"; |
$form .= '>'.&mt('all').'</option>'."\n"; |
# |
# |
# Loop through the sequences |
# Loop through the sequences |
my @sequences = &selected_sequences_with_assessments('all'); |
my @sequences = &selected_sequences_with_assessments('all'); |
Line 685 sub map_select {
|
Line 522 sub map_select {
|
$navmap = shift(@sequences); |
$navmap = shift(@sequences); |
} |
} |
foreach my $seq (@sequences){ |
foreach my $seq (@sequences){ |
$form .= ' <option value="'.$seq->symb.'" '; |
$form .= ' <option value="'.$seq->symb.'"'; |
foreach (@selected_maps) { |
foreach (@selected_maps) { |
if ($seq->symb eq $_) { |
if ($seq->symb eq $_) { |
$form .= 'selected '; |
$form .= ' selected="selected"'; |
last; |
last; |
} |
} |
} |
} |
Line 698 sub map_select {
|
Line 535 sub map_select {
|
return $form; |
return $form; |
} |
} |
|
|
############################################## |
|
############################################## |
|
|
|
=pod |
|
|
|
=item &SectionSelect($elementname,$status,$numvisible) |
|
|
|
Returns html for a selection box allowing the user to choose one (or more) |
|
of the sections in the course. |
|
|
|
Uses the package variables @Sections |
|
=over 4 |
|
|
|
=item $elementname The name of the HTML form element |
|
|
|
=item $status 'multiple' or 'single' selection box |
|
|
|
=item $numvisible The number of options to be visible |
|
|
|
=back |
|
|
|
=cut |
|
|
|
############################################## |
|
############################################## |
|
sub SectionSelect { |
sub SectionSelect { |
my ($elementname,$status,$numvisible)=@_; |
my ($elementname,$status,$numvisible)=@_; |
if ($numvisible < 1) { |
if ($numvisible < 1) { |
Line 734 sub SectionSelect {
|
Line 547 sub SectionSelect {
|
&PrepareClasslist() |
&PrepareClasslist() |
} |
} |
# |
# |
|
# Make sure course's student table is up to date |
|
if (@Sections) { |
|
&Apache::loncoursedata::ensure_current_sections(); |
|
} |
|
# |
# Build the form element |
# Build the form element |
my $Str = "\n"; |
my $Str = "\n"; |
$Str .= '<select name="'.$elementname.'" '; |
$Str .= '<select name="'.$elementname.'" '; |
if ($status ne 'single') { |
if ($status ne 'single') { |
$Str .= 'multiple="true" '; |
$Str .= 'multiple="multiple" '; |
} |
} |
$Str .= 'size="'.$numvisible.'" >'."\n"; |
$Str .= 'size="'.$numvisible.'" >'."\n"; |
# |
# |
# Loop through the sequences |
# Loop through the sequences |
foreach my $s (@Sections) { |
foreach my $s (@Sections) { |
$Str .= ' <option value="'.$s.'" '; |
$Str .= ' <option value="'.$s.'"'; |
foreach (&get_selected_sections()) { |
foreach (&get_selected_sections()) { |
if ($s eq $_) { |
if ($s eq $_) { |
$Str .= 'selected '; |
$Str .= ' selected="selected"'; |
last; |
last; |
} |
} |
} |
} |
Line 757 sub SectionSelect {
|
Line 575 sub SectionSelect {
|
return $Str; |
return $Str; |
} |
} |
|
|
################################################## |
|
################################################## |
sub GroupSelect { |
|
my ($elementname,$status,$numvisible)=@_; |
|
if ($numvisible < 1) { |
|
return; |
|
} |
|
# |
|
# Make sure we have the data we need to continue |
|
if (! @Groups) { |
|
&PrepareClasslist(); |
|
} |
|
# |
|
# Make sure course's groupnames and studentgroups tables |
|
# are up to date. |
|
# |
|
if (@Groups) { |
|
&Apache::loncoursedata::ensure_current_groups(); |
|
&Apache::loncoursedata::ensure_current_students_groups(); |
|
} |
|
# |
|
# Build the form element |
|
my $Str = "\n"; |
|
$Str .= '<select name="'.$elementname.'" '; |
|
if ($status ne 'single') { |
|
$Str .= 'multiple="multiple" '; |
|
} |
|
$Str .= 'size="'.$numvisible.'" >'."\n"; |
|
# |
|
# Loop through the groups |
|
foreach my $s (@Groups) { |
|
$Str .= ' <option value="'.$s.'"'; |
|
foreach my $group (&get_selected_groups()) { |
|
if ($s eq $group) { |
|
$Str .= ' selected="selected"'; |
|
last; |
|
} |
|
} |
|
$Str .= '>'.$s."</option>\n"; |
|
} |
|
$Str .= "</select>\n"; |
|
} |
|
|
|
|
|
|
|
|
sub DisplayClasslist { |
sub DisplayClasslist { |
my ($r)=@_; |
my ($r)=@_; |
&Apache::lonhtmlcommon::add_breadcrumb |
&Apache::lonhtmlcommon::add_breadcrumb |
Line 766 sub DisplayClasslist {
|
Line 627 sub DisplayClasslist {
|
# |
# |
# Output some of the standard interface components |
# Output some of the standard interface components |
my $Str; |
my $Str; |
$Str .= &Apache::lonhtmlcommon::breadcrumbs(undef,'Select One Student'); |
$Str .= &Apache::lonhtmlcommon::breadcrumbs('Select One Student'); |
$Str .= '<p><table cellspacing="5">'."\n"; |
$Str .= '<table cellspacing="5">'."\n"; |
$Str .= '<tr>'; |
$Str .= '<tr>'; |
$Str .= '<th align="center"><b>'.&mt('Sections').'</b></th>'; |
$Str .= '<th align="center"><b>'.&mt('Sections').'</b></th>'; |
$Str .= '<th align="center"><b>'.&mt('Enrollment Status').'</b></th>'; |
$Str .= '<th align="center"><b>'.&mt('Groups').'</b></th>'; |
|
$Str .= '<th align="center"><b>'.&mt('Access Status').'</b></th>'; |
$Str .= '</tr>'.$/; |
$Str .= '</tr>'.$/; |
$Str .= '<tr>'; |
$Str .= '<tr>'; |
$Str .= '<td>'. |
$Str .= '<td>'. |
&Apache::lonstatistics::SectionSelect('Section','multiple',5). |
&Apache::lonstatistics::SectionSelect('Section','multiple',5). |
'</td>'; |
'</td>'; |
|
$Str .= '<td>'. |
|
&Apache::lonstatistics::GroupSelect('Group','multiple',5). |
|
'</td>'; |
$Str .= '<td>'. |
$Str .= '<td>'. |
&Apache::lonhtmlcommon::StatusOptions(undef,undef,5). |
&Apache::lonhtmlcommon::StatusOptions(undef,undef,5). |
'</td>'; |
'</td>'; |
|
|
$Str .= '</tr>'.$/; |
$Str .= '</tr>'.$/; |
$Str .= '</table></p>'; |
$Str .= '</table>'; |
$Str .= '<input type="submit" name="selectstudent" value="'. |
$Str .= '<input type="submit" name="selectstudent" value="'. |
&mt('Update Display').'" />'; |
&mt('Update Display').'" />'; |
$r->print($Str); |
$r->print($Str); |
$r->rflush(); |
$r->rflush(); |
# |
# |
my @Fields = ('fullname','username','domain','id','section','status'); |
my @Fields = ('fullname','username','domain','id','section','status','groups'); |
# |
# |
$Str = ''; |
$Str = ''; |
my @selected_sections = &get_selected_sections(); |
my @selected_sections = &get_selected_sections(); |
if (! @Students) { |
if (! @Students) { |
if ($selected_sections[0] eq 'all') { |
if ($selected_sections[0] eq 'all') { |
if (lc($env{'form.Status'}) eq 'any') { |
if (lc($env{'form.Status'}) eq 'active') { |
$Str .= '<h2>'. |
$Str .= '<p class="LC_info">'. |
&mt('There are no students in the course.'). |
|
'</h2>'; |
|
} elsif (lc($env{'form.Status'}) eq 'active') { |
|
$Str .= '<h2>'. |
|
&mt('There are no currently enrolled students in the course.'). |
&mt('There are no currently enrolled students in the course.'). |
'</h2>'; |
'</p>'; |
} elsif (lc($env{'form.Status'}) eq 'expired') { |
} elsif (lc($env{'form.Status'}) eq 'expired') { |
$Str .= '<h2>'. |
$Str .= '<p class="LC_info">'. |
&mt('There are no previously enrolled students in the course.'). |
&mt('There are no previously enrolled students in the course.'). |
'</h2>'; |
'</p>'; |
|
} elsif (lc($env{'form.Status'}) eq 'future') { |
|
$Str .= '<p class="LC_info">'. |
|
&mt('There are no students with future access in the course.'). |
|
'</p>'; |
|
} else { # 'any' and any others |
|
$Str .= '<p class="LC_info">'. |
|
&mt('There are no students in the course.'). |
|
'</p>'; |
} |
} |
} else { |
} else { |
my $sections; |
if (lc($env{'form.Status'}) eq 'active') { |
if (lc($env{'form.Status'}) eq 'any') { |
$Str .= '<p class="LC_info">'. |
$Str .= '<h2>'. |
|
&mt('There are no students in the selected sections.'). |
|
'</h2>'; |
|
} elsif (lc($env{'form.Status'}) eq 'active') { |
|
$Str .= '<h2>'. |
|
&mt('There are no currently enrolled students in the selected sections.'). |
&mt('There are no currently enrolled students in the selected sections.'). |
'</h2>'; |
'</p>'; |
} elsif (lc($env{'form.Status'}) eq 'expired') { |
} elsif (lc($env{'form.Status'}) eq 'expired') { |
$Str .= '<h2>'. |
$Str .= '<p class="LC_info">'. |
&mt('There are no previously enrolled students in the selected sections.'). |
&mt('There are no previously enrolled students in the selected sections.'). |
'</h2>'; |
'</p>'; |
|
} elsif (lc($env{'form.Status'}) eq 'future') { |
|
$Str .= '<p class="LC_info">'. |
|
&mt('There are no students with future access in the selected sections.'). |
|
'</p>'; |
|
} else { # 'any' and any others |
|
$Str .= '<p class="LC_info">'. |
|
&mt('There are no students in the selected sections.'). |
|
'</p>'; |
} |
} |
} |
} |
$Str.= '<a href="/adm/statistics?reportSelected=student_assessment">'. |
$Str.= '<p>' |
&mt('Click here to return to the chart').'</a>'; |
.'<a href="/adm/statistics?reportSelected=student_assessment">' |
|
.&mt('Return to the chart').'</a>' |
|
.'</p>'; |
$r->print($Str); |
$r->print($Str); |
$r->rflush(); |
$r->rflush(); |
return; |
return; |
} |
} |
|
|
# "Click" is asinine but it is probably not my place to change the world. |
$Str .= '<h2>'.&mt('Select One Student').'</h2>' |
$Str .= '<h2>Click on a students name or username to view their chart</h2>'; |
.'<p>'.&mt("Click on a student's name or username to view their chart.").'</p>' |
$Str .= '<table border="0"><tr><td bgcolor="#777777">'."\n"; |
.&Apache::loncommon::start_data_table() |
$Str .= '<table border="0" cellpadding="3"><tr bgcolor="#e6ffff">'."\n"; |
.&Apache::loncommon::start_data_table_header_row(); |
foreach my $field (@Fields) { |
foreach my $field (@Fields) { |
$Str .= '<th><a href="/adm/statistics?'. |
$Str .= '<th><a href="/adm/statistics?'. |
'reportSelected=student_assessment&'. |
'reportSelected=student_assessment&'. |
'selectstudent=1&'. |
'selectstudent=1&'. |
'sort='.$field.'">'.&mt($field). |
'sort='.$field.'">'.&mt($field). |
'</a></th>'; |
'</a></th>'; |
} |
} |
$Str .= '</tr>'."\n"; |
$Str .= &Apache::loncommon::end_data_table_header_row(); |
# |
# |
my $alternate = 0; |
|
foreach my $student (@Students) { # @Students is a package variable |
foreach my $student (@Students) { # @Students is a package variable |
my $sname = $student->{'username'}.':'.$student->{'domain'}; |
my $sname = $student->{'username'}.':'.$student->{'domain'}; |
if($alternate) { |
$Str .= &Apache::loncommon::start_data_table_row(); |
$Str .= '<tr bgcolor="#ffffe6">'; |
|
} else { |
|
$Str .= '<tr bgcolor="#ffffc6">'; |
|
} |
|
$alternate = ($alternate + 1) % 2; |
|
# |
# |
foreach my $field (@Fields) { |
foreach my $field (@Fields) { |
$Str .= '<td>'; |
$Str .= '<td>'; |
if ($field eq 'fullname' || $field eq 'username') { |
if ($field eq 'fullname' || $field eq 'username') { |
$Str .= '<a href="/adm/statistics?reportSelected='; |
$Str .= '<a href="/adm/statistics?reportSelected='; |
$Str .= &Apache::lonnet::escape('student_assessment'); |
$Str .= &escape('student_assessment'); |
$Str .= '&sort='.&Apache::lonnet::escape($env{'form.sort'}); |
$Str .= '&sort='.&escape($env{'form.sort'}); |
$Str .= '&SelectedStudent='; |
$Str .= '&SelectedStudent='; |
$Str .= &Apache::lonnet::escape($sname).'">'; |
$Str .= &escape($sname).'">'; |
$Str .= $student->{$field}.' '; |
$Str .= $student->{$field}; |
$Str .= '</a>'; |
$Str .= '</a>'; |
} elsif ($field eq 'status') { |
} elsif ($field eq 'status') { |
$Str .= &mt($student->{$field}); |
$Str .= &mt($student->{$field}); |
} else { |
} else { |
$Str .= $student->{$field}; |
if ($student->{$field} eq 'none') { |
|
$Str .= &mt('none') |
|
} else { |
|
$Str .= $student->{$field}; |
|
} |
} |
} |
$Str .= '</td>'; |
$Str .= '</td>'; |
} |
} |
$Str .= "</tr>\n"; |
$Str .= &Apache::loncommon::end_data_table_row(); |
} |
} |
$Str .= '</table></td></tr></table>'."\n"; |
$Str .= &Apache::loncommon::end_data_table(); |
# |
# |
$r->print($Str); |
$r->print($Str); |
$r->rflush(); |
$r->rflush(); |
Line 879 sub DisplayClasslist {
|
Line 751 sub DisplayClasslist {
|
return; |
return; |
} |
} |
|
|
############################################## |
|
############################################## |
|
sub CreateMainMenu { |
sub CreateMainMenu { |
# |
# |
# Define menu data |
# Define menu data |
my @reports = ({ internal_name => 'problem_statistics', |
my @reports = ( |
name => &mt('Overall Problem Statistics'), |
{categorytitle => 'Statistics and Analyses', |
short_description => |
items => [ |
&mt('Student performance statistics on all problems.'), |
{url => '/adm/statistics?reportSelected=problem_statistics', |
}, |
permission => 'F', |
{ internal_name => 'problem_analysis', |
icon => 'document-open.png', |
name => &mt('Detailed Problem Analysis'), |
linktext => ('Overall Problem Statistics'), |
short_description => |
linktitle => ('Student performance statistics on all problems.')}, |
&mt('Detailed statistics and graphs of student performance on problems.'), |
|
}, |
{url => '/adm/statistics?reportSelected=problem_analysis', |
{ internal_name => 'submissiontime_analysis', |
permission => 'F', |
name => &mt('Submission Time Plots'), |
icon => 'prob_ana.png', |
short_description => |
linktext => ('Detailed Problem Analysis'), |
&mt('Display and analysis of submission times on assessments.'), |
linktitle => ('Detailed statistics and graphs of student performance on problems.')}, |
}, |
]}, |
{ internal_name => 'student_submission_reports', |
{categorytitle => 'Plots', |
name => &mt('Student Submission Reports'), |
items => [ |
short_description => |
{url => '/adm/statistics?reportSelected=submissiontime_analysis', |
&mt('Prepare reports of student submissions.'), |
permission => 'F', |
}, |
icon => 'subtimpl.png', |
{ internal_name => 'survey_reports', |
linktext => ('Submission Time Plots'), |
name => &mt('Survey Reports'), |
linktitle => ('Display and analysis of submission times on assessments.')}, |
short_description => |
|
&mt('Prepare reports on survey results.'), |
{url => '/adm/statistics?reportSelected=correct_problems_plot', |
}, |
permission => 'F', |
{ internal_name => 'correct_problems_plot', |
icon => 'coprplot.png', |
name => &mt('Correct Problems Plot'), |
linktext => ('Correct Problems Plot'), |
short_description => |
linktitle => ('Display a histogram of student performance in the course.')}, |
&mt('Display a histogram of student performance in the course.'), |
]}, |
}, |
{categorytitle => 'Reports', |
# { internal_name => 'student_assessment', |
items => [ |
# name => &mt('Problem Status Chart'), |
{url => '/adm/statistics?reportSelected=student_submission_reports', |
# short_description => |
permission => 'F', |
# &mt('Brief view of each students performance in course.'), |
icon => 'edit-copy.png', |
# }, |
linktext => ('Student Submission Reports'), |
# 'percentage' => 'Correct-problems Plot', |
linktitle => ('Prepare reports of student submissions.')}, |
# 'activitylog' => 'Activity Log', |
|
); |
{url => '/adm/statistics?reportSelected=survey_reports', |
# |
permission => 'F', |
# Create the menu |
icon => 'survey_rep.png', |
my $Str; |
linktext => ('Survey Reports'), |
$Str .= '<h2>'.&mt('Please select a report to generate').'</h2>'; |
linktitle => ('Prepare reports on survey results.')}, |
foreach my $reportdata (@reports) { |
]}); |
$Str .=' <h3><a href="/adm/statistics?reportSelected='. |
|
$reportdata->{'internal_name'}.'" >'. |
return &Apache::lonhtmlcommon::generate_menu(@reports); |
$reportdata->{'name'}."</a></h3>\n"; |
|
$Str .= ' '.(' 'x8).$reportdata->{'short_description'}. |
|
"\n"; |
|
} |
|
$Str .="</dl>\n"; |
|
# |
|
return $Str; |
|
} |
} |
|
|
############################################## |
|
############################################## |
|
sub handler { |
sub handler { |
my $r=shift; |
my $r=shift; |
my $c = $r->connection(); |
my $c = $r->connection(); |
# |
# |
# Check for overloading |
|
my $loaderror=&Apache::lonnet::overloaderror($r); |
|
if ($loaderror) { return $loaderror; } |
|
$loaderror= |
|
&Apache::lonnet::overloaderror($r, |
|
$env{'course.'.$env{'request.course.id'}.'.home'}); |
|
if ($loaderror) { return $loaderror; } |
|
# |
|
# Check for access |
# Check for access |
if (! &Apache::lonnet::allowed('vgr',$env{'request.course.id'})) { |
if (! &Apache::lonnet::allowed('vgr',$env{'request.course.id'})) { |
$env{'user.error.msg'}= |
$env{'user.error.msg'}= |
Line 984 sub handler {
|
Line 842 sub handler {
|
td.essay { border: 1px solid gray; } |
td.essay { border: 1px solid gray; } |
</style> |
</style> |
ENDSTYLE |
ENDSTYLE |
my $html=&Apache::lonxml::xmlbegin(); |
|
$r->print($html.'<head><title>'. |
$r->print(&Apache::loncommon::start_page('Course Statistics and Charts', |
&mt('Course Statistics and Charts'). |
$style)); |
'</title>'.$style. |
|
"</head>\n". |
|
&Apache::loncommon::bodytag('Course Statistics and Charts')); |
|
$r->rflush(); |
$r->rflush(); |
# |
# |
# Either print out a menu for them or send them to a report |
# Either print out a menu for them or send them to a report |
Line 1001 ENDSTYLE
|
Line 856 ENDSTYLE
|
bug=>'Statistics and Charts'}); |
bug=>'Statistics and Charts'}); |
if (! exists($env{'form.reportSelected'}) || |
if (! exists($env{'form.reportSelected'}) || |
$env{'form.reportSelected'} eq '') { |
$env{'form.reportSelected'} eq '') { |
$r->print(&Apache::lonhtmlcommon::breadcrumbs |
$r->print(&Apache::lonhtmlcommon::breadcrumbs('Statistics Main Page')); |
(undef,&mt('Statistics Main Page')). |
&Apache::lonquickgrades::startGradeScreen($r,'statistics'); |
&CreateMainMenu()); |
$r->print(&CreateMainMenu()); |
} else { |
} else { |
# |
# |
if (! &Apache::lonmysql::verify_sql_connection()) { |
if (! &Apache::lonmysql::verify_sql_connection()) { |
my $serveradmin = $r->dir_config('lonAdmEMail'); |
my $serveradmin = $r->dir_config('lonAdmEMail'); |
$r->print('<h2><font color="Red">'. |
$r->print('<p class="LC_error">'. |
&mt('Unable to connect to database!'). |
&mt('Unable to connect to database!'). |
'</font></h2>'); |
'</p>'); |
$r->print('<p>'. |
$r->print('<p>' |
&mt('Please notify the server administrator '). |
.&mt('Please notify the server administrator [_1]', |
'<b>'.$serveradmin.'</b></p>'); |
,'<b>'.$serveradmin.'</b>') |
|
.'</p>'); |
$r->print('<p>'. |
$r->print('<p>'. |
&mt('Course Statistics and Charts cannot be '. |
&mt('Course Statistics and Charts cannot be '. |
'retrieved until the database is restarted. '. |
'retrieved until the database is restarted. '. |
'Your data is intact but cannot be displayed '. |
'Your data is intact but cannot be displayed '. |
'at this time.').'</p>'); |
'at this time.').'</p>'); |
$r->print('</body></html>'); |
$r->print(&Apache::loncommon::end_page()); |
return; |
return; |
} |
} |
# |
# |
# Clean out the caches |
# Clean out the caches |
if (exists($env{'form.ClearCache'})) { |
if (exists($env{'form.ClearCache'})) { |
&Apache::loncoursedata::delete_caches($env{'requres.course.id'}); |
&Apache::loncoursedata::delete_caches($env{'request.course.id'}); |
} |
} |
# |
# |
|
my $GoToPage = $env{'form.reportSelected'}; |
|
# |
# Begin form output |
# Begin form output |
$r->print('<form name="Statistics" '); |
$r->print('<form name="Statistics" '); |
|
if ($GoToPage eq 'student_submission_reports') { |
|
$r->print('onsubmit="return checkanon();" '); |
|
} |
$r->print('method="post" action="/adm/statistics">'); |
$r->print('method="post" action="/adm/statistics">'); |
$r->rflush(); |
$r->rflush(); |
# |
|
my $GoToPage = $env{'form.reportSelected'}; |
|
# |
|
$r->print('<input type="hidden" name="reportSelected" value="'. |
$r->print('<input type="hidden" name="reportSelected" value="'. |
$GoToPage.'">'); |
$GoToPage.'" />'); |
if($GoToPage eq 'activitylog') { |
if($GoToPage eq 'activitylog') { |
# &Apache::lonproblemstatistics::Activity(); |
# &Apache::lonproblemstatistics::Activity(); |
} elsif($GoToPage eq 'problem_statistics') { |
} elsif($GoToPage eq 'problem_statistics') { |
Line 1078 ENDSTYLE
|
Line 936 ENDSTYLE
|
({href=>'/adm/statistics?reportselected=student_assessment', |
({href=>'/adm/statistics?reportselected=student_assessment', |
text=>'Chart'}); |
text=>'Chart'}); |
&Apache::lonstudentassessment::BuildStudentAssessmentPage($r,$c); |
&Apache::lonstudentassessment::BuildStudentAssessmentPage($r,$c); |
} |
} elsif($GoToPage eq 'grading_analysis') { |
|
&Apache::lonhtmlcommon::add_breadcrumb |
|
({href=>'/adm/statistics?reportselected=grading_anaylsis', |
|
text=>'Grading Analysis'}); |
|
&Apache::longradinganalysis::build_grading_analysis_page($r,$c); |
|
} |
# |
# |
$r->print("</form>\n"); |
$r->print("</form>\n"); |
} |
} |
$r->print("</body>\n</html>\n"); |
&Apache::lonquickgrades::endGradeScreen($r); |
|
$r->print(&Apache::loncommon::end_page()); |
$r->rflush(); |
$r->rflush(); |
# |
# |
return OK; |
return OK; |
Line 1090 ENDSTYLE
|
Line 954 ENDSTYLE
|
|
|
1; |
1; |
|
|
####################################################### |
__END__ |
####################################################### |
|
|
|
=pod |
=pod |
|
|
|
=head1 NAME |
|
|
|
lonstatistics |
|
|
|
=head1 SYNOPSIS |
|
|
|
Main handler for statistics and chart. |
|
|
|
This is part of the LearningOnline Network with CAPA project |
|
described at http://www.lon-capa.org. |
|
|
|
|
|
=head1 PACKAGE VARIABLES |
|
|
|
=over |
|
|
|
=item @FullClasslist The full classlist |
|
|
|
=item @Students The students we are concerned with for this invocation |
|
|
|
=item @Sections The sections available in this class |
|
|
|
=item @Groups The groups available in the class |
|
|
|
=item $curr_student The student currently being examined |
|
|
|
=item $prev_student The student previous in the classlist |
|
|
|
=item $next_student The student next in the classlist |
|
|
=back |
=back |
|
|
=cut |
=head1 SUBROUTINES |
|
|
####################################################### |
=over |
####################################################### |
|
|
|
__END__ |
=item &clear_classlist_variables() |
|
|
|
undef the following package variables: |
|
|
|
=over 4 |
|
|
|
=item * @FullClasslist |
|
|
|
=item * @Students |
|
|
|
=item * @Sections |
|
|
|
=item * @Groups |
|
|
|
=item * %StudentData |
|
|
|
=item * @StudentDataOrder |
|
|
|
=item * @SelectedStudentData |
|
|
|
=item * $curr_student |
|
|
|
=item * $prev_student |
|
|
|
=item * $next_student |
|
|
|
=back |
|
|
|
=item &PrepareClasslist() |
|
|
|
Build up the classlist information. The classlist information is kept in |
|
the following package variables: |
|
|
|
=over 4 |
|
|
|
=item * @FullClasslist |
|
|
|
=item * @Students |
|
|
|
=item * @Sections |
|
|
|
=item * @Groups |
|
|
|
=item * %StudentData |
|
|
|
=item * @SelectedStudentData |
|
|
|
=item * $curr_student |
|
|
|
=item * $prev_student |
|
|
|
=item * $next_student |
|
|
|
=back |
|
|
|
$curr_student, $prev_student, and $next_student may not be defined, depending |
|
upon the calling context. |
|
|
|
=item get_selected_sections() |
|
|
|
Returns an array of the selected sections |
|
|
|
=item get_selected_groups() |
|
|
|
Returns an array of the selected groups |
|
|
|
=item §ion_and_enrollment_description() |
|
|
|
Returns a string describing the currently selected section(s), group(s) and |
|
access status. |
|
|
|
Inputs: mode = 'plaintext' or 'localized' (defaults to 'localized') |
|
'plaintext' is used for example in Excel spreadsheets. |
|
Returns: scalar description string. |
|
|
|
=item section_or_group_text() |
|
|
|
=item get_students() |
|
|
|
Returns a list of the selected students |
|
|
|
=item ¤t_student() |
|
|
|
Returns a pointer to a hash containing data about the currently |
|
selected student. |
|
|
|
=item &previous_student() |
|
|
|
Returns a pointer to a hash containing data about the student prior |
|
in the list of students. Or something. |
|
|
|
=item &next_student() |
|
|
|
Returns a pointer to a hash containing data about the next student |
|
to be viewed. |
|
|
|
=item &StudentDataSelect($elementname,$status,$numvisible,$selected) |
|
|
|
Returns html for a selection box allowing the user to choose one (or more) |
|
of the fields of student data available (fullname, username, id, section, etc) |
|
|
|
=over 4 |
|
|
|
=item * $elementname The name of the HTML form element |
|
|
|
=item * $status 'multiple' or 'single' selection box |
|
|
|
=item * $numvisible The number of options to be visible |
|
|
|
=back |
|
|
|
=item &get_selected_maps($elementname) |
|
|
|
Input: Name of the <select> form element used to specify the maps. |
|
|
|
Returns: Array of symbs of selected maps or the description 'all'. |
|
If form.$elementname does not exist, 'all' is returned. |
|
|
|
=item &selected_sequences_with_assessments() |
|
|
|
Retrieve the sequences which were selected by the user to show. |
|
|
|
Input: $mode: scalar. Either 'selected' or 'all'. If not specified, |
|
'selected' is used. |
|
|
|
Returns: an array containing a navmap object and navmap resources, |
|
or an array containing a scalar with an error message. |
|
|
|
=item &map_select($elementname,$status,$numvisible,$restriction) |
|
|
|
Returns html for a selection box allowing the user to choose one (or more) |
|
of the sequences in the course. The values of the sequences are the symbs. |
|
If the top sequence is selected, the value 'top' will result. |
|
|
|
=over 4 |
|
|
|
=item * $elementname The name of the HTML form element |
|
|
|
=item * $status 'multiple' or 'single' selection box |
|
|
|
=item * $numvisible The number of options to be visible |
|
|
|
=back |
|
|
|
=item &SectionSelect($elementname,$status,$numvisible) |
|
|
|
Returns html for a selection box allowing the user to choose one (or more) |
|
of the sections in the course. |
|
|
|
Uses the package variables @Sections |
|
|
|
=over 4 |
|
|
|
=item * $elementname The name of the HTML form element |
|
|
|
=item * $status 'multiple' or 'single' selection box |
|
|
|
=item * $numvisible The number of options to be visible |
|
|
|
=back |
|
|
|
=item &GroupSelect($elementname,$status,$numvisible) |
|
|
|
Returns html for a selection box allowing the user to choose one (or more) |
|
of the groups in the course. |
|
|
|
Uses the package variables @Groups |
|
|
|
=over 4 |
|
|
|
=item * $elementname The name of the HTML form element |
|
|
|
=item * $status 'multiple' or 'single' selection box |
|
|
|
=item * $numvisible The number of options to be visible |
|
|
|
=back |
|
|
|
=item CreateMainMenu() |
|
|
|
=back |
|
|
|
=cut |
|
|