version 1.2, 2002/07/22 21:21:32
|
version 1.25, 2003/06/19 15:02:37
|
Line 25
|
Line 25
|
# |
# |
# http://www.lon-capa.org/ |
# http://www.lon-capa.org/ |
# |
# |
|
###################################################################### |
|
###################################################################### |
|
|
|
=pod |
|
|
|
=head1 NAME |
|
|
|
Apache::lonhtmlcommon - routines to do common html things |
|
|
|
=head1 SYNOPSIS |
|
|
|
Referenced by other mod_perl Apache modules. |
|
|
|
=head1 INTRODUCTION |
|
|
|
lonhtmlcommon is a collection of subroutines used to present information |
|
in a consistent html format, or provide other functionality related to |
|
html. |
|
|
|
=head2 General Subroutines |
|
|
|
=over 4 |
|
|
|
=cut |
|
|
|
###################################################################### |
|
###################################################################### |
|
|
package Apache::lonhtmlcommon; |
package Apache::lonhtmlcommon; |
|
|
|
use Time::Local; |
use strict; |
use strict; |
|
|
sub MapOptions { |
############################################## |
my ($data, $page)=@_; |
############################################## |
my $Str = ''; |
|
$Str .= '<select name="'; |
|
$Str .= (($page)?$page:'').'Map">'."\n"; |
|
|
|
my $selected = 0; |
=pod |
foreach my $sequence (split(':',$data->{'orderedSequences'})) { |
|
$Str .= '<option'; |
|
if($data->{$page.'Map'} eq $data->{$sequence.':title'}) { |
|
$Str .= ' selected'; |
|
$selected = 1; |
|
} |
|
$Str .= '>'.$data->{$sequence.':title'}.'</option>'."\n"; |
|
} |
|
$Str .= '<option'; |
|
if(!$selected) { |
|
$Str .= ' selected'; |
|
} |
|
$Str .= '>All Maps</option>'."\n"; |
|
|
|
$Str .= '</select>'."\n"; |
=item &date_setter |
|
|
return $Str; |
&date_setter returns html and javascript for a compact date-setting form. |
} |
To retrieve values from it, use &get_date_from_form(). |
|
|
sub StudentOptions { |
Inputs |
my ($cache, $students, $selectedName, $page)=@_; |
|
|
|
my $Str = ''; |
=over 4 |
$Str = '<select name="'.(($page)?$page:'').'Student">'."\n"; |
|
|
|
my $selected=0; |
=item $dname |
$Str .= '<option'; |
|
if($selectedName eq 'All Students') { |
The name to prepend to the form elements. |
$Str .= ' selected'; |
The form elements defined will be dname_year, dname_month, dname_day, |
$selected = 1; |
dname_hour, dname_min, and dname_sec. |
} |
|
$Str .= '>All Students</option>'."\n"; |
=item $currentvalue |
|
|
|
The current setting for this time parameter. A unix format time |
|
(time in seconds since the beginning of Jan 1st, 1970, GMT. |
|
An undefined value is taken to indicate the value is the current time. |
|
Also, to be explicit, a value of 'now' also indicates the current time. |
|
|
|
=back |
|
|
foreach (@$students) { |
Bugs |
$Str .= '<option'; |
|
if($selectedName eq $_) { |
The method used to restrict user input will fail in the year 2400. |
$Str .= ' selected'; |
|
$selected = 1; |
=cut |
|
|
|
############################################## |
|
############################################## |
|
sub date_setter { |
|
my ($formname,$dname,$currentvalue) = @_; |
|
if (! defined($currentvalue) || $currentvalue eq 'now') { |
|
$currentvalue = time; |
|
} |
|
# other potentially useful values: wkday,yrday,is_daylight_savings |
|
my ($sec,$min,$hour,$mday,$month,$year,undef,undef,undef) = |
|
localtime($currentvalue); |
|
$year += 1900; |
|
my $result = "\n<!-- $dname date setting form -->\n"; |
|
$result .= <<ENDJS; |
|
<script language="Javascript"> |
|
function $dname\_checkday() { |
|
var day = document.$formname.$dname\_day.value; |
|
var month = document.$formname.$dname\_month.value; |
|
var year = document.$formname.$dname\_year.value; |
|
var valid = true; |
|
if (day < 1) { |
|
document.$formname.$dname\_day.value = 1; |
|
} |
|
if (day > 31) { |
|
document.$formname.$dname\_day.value = 31; |
} |
} |
$Str .= '>'; |
if ((month == 1) || (month == 3) || (month == 5) || |
$Str .= $cache->{$_.':fullname'}; |
(month == 7) || (month == 8) || (month == 10) || |
$Str .= '</option>'."\n"; |
(month == 12)) { |
|
if (day > 31) { |
|
document.$formname.$dname\_day.value = 31; |
|
day = 31; |
|
} |
|
} else if (month == 2 ) { |
|
if ((year % 4 == 0) && (year % 100 != 0)) { |
|
if (day > 29) { |
|
document.$formname.$dname\_day.value = 29; |
|
} |
|
} else if (day > 29) { |
|
document.$formname.$dname\_day.value = 28; |
|
} |
|
} else if (day > 30) { |
|
document.$formname.$dname\_day.value = 30; |
|
} |
|
} |
|
</script> |
|
ENDJS |
|
$result .= " <select name=\"$dname\_month\" ". |
|
"onChange=\"javascript:$dname\_checkday()\" >\n"; |
|
my @Months = qw/January February March April May June |
|
July August September October November December/; |
|
# Pad @Months with a bogus value to make indexing easier |
|
unshift(@Months,'If you can read this an error occurred'); |
|
for(my $m = 1;$m <=$#Months;$m++) { |
|
$result .= " <option value=\"$m\" "; |
|
$result .= "selected " if ($m-1 == $month); |
|
$result .= "> $Months[$m] </option>\n"; |
} |
} |
|
$result .= " </select>\n"; |
|
$result .= " <input type=\"text\" name=\"$dname\_day\" ". |
|
"value=\"$mday\" size=\"3\" ". |
|
"onChange=\"javascript:$dname\_checkday()\" />\n"; |
|
$result .= " <input type=\"year\" name=\"$dname\_year\" ". |
|
"value=\"$year\" size=\"5\" ". |
|
"onChange=\"javascript:$dname\_checkday()\" />\n"; |
|
$result .= " "; |
|
$result .= " <select name=\"$dname\_hour\" >\n"; |
|
for (my $h = 0;$h<24;$h++) { |
|
$result .= " <option value=\"$h\" "; |
|
$result .= "selected " if ($hour == $h); |
|
$result .= "> "; |
|
if ($h == 0) { |
|
$result .= "12 am"; |
|
} elsif($h == 12) { |
|
$result .= "12 noon"; |
|
} elsif($h < 12) { |
|
$result .= "$h am"; |
|
} else { |
|
$result .= $h-12 ." pm"; |
|
} |
|
$result .= " </option>\n"; |
|
} |
|
$result .= " </select>\n"; |
|
$result .= " <input type=\"text\" name=\"$dname\_minute\" ". |
|
"value=\"$min\" size=\"3\" /> m\n"; |
|
$result .= " <input type=\"text\" name=\"$dname\_second\" ". |
|
"value=\"$sec\" size=\"3\" /> s\n"; |
|
$result .= "<!-- end $dname date setting form -->\n"; |
|
return $result; |
|
} |
|
|
|
############################################## |
|
############################################## |
|
|
|
=pod |
|
|
|
=item &get_date_from_form |
|
|
|
get_date_from_form retrieves the date specified in an &date_setter form. |
|
|
|
Inputs: |
|
|
|
=over 4 |
|
|
$Str .= '<option'; |
=item $dname |
if(!$selected) { |
|
$Str .= ' selected'; |
The name passed to &datesetter, which prefixes the form elements. |
|
|
|
=item $defaulttime |
|
|
|
The unix time to use as the default in case of poor inputs. |
|
|
|
=back |
|
|
|
Returns: Unix time represented in the form. |
|
|
|
=cut |
|
|
|
############################################## |
|
############################################## |
|
sub get_date_from_form { |
|
my ($dname) = @_; |
|
my ($sec,$min,$hour,$day,$month,$year); |
|
# |
|
if (defined($ENV{'form.'.$dname.'_second'})) { |
|
my $tmpsec = $ENV{'form.'.$dname.'_second'}; |
|
if (($tmpsec =~ /^\d+$/) && ($tmpsec >= 0) && ($tmpsec < 60)) { |
|
$sec = $tmpsec; |
|
} |
|
} |
|
if (defined($ENV{'form.'.$dname.'_minute'})) { |
|
my $tmpmin = $ENV{'form.'.$dname.'_minute'}; |
|
if (($tmpmin =~ /^\d+$/) && ($tmpmin >= 0) && ($tmpmin < 60)) { |
|
$min = $tmpmin; |
|
} |
|
} |
|
if (defined($ENV{'form.'.$dname.'_hour'})) { |
|
my $tmphour = $ENV{'form.'.$dname.'_hour'}; |
|
if (($tmphour =~ /^\d+$/) && ($tmphour > 0) && ($tmphour < 32)) { |
|
$hour = $tmphour; |
|
} |
|
} |
|
if (defined($ENV{'form.'.$dname.'_day'})) { |
|
my $tmpday = $ENV{'form.'.$dname.'_day'}; |
|
if (($tmpday =~ /^\d+$/) && ($tmpday > 0) && ($tmpday < 32)) { |
|
$day = $tmpday; |
|
} |
|
} |
|
if (defined($ENV{'form.'.$dname.'_month'})) { |
|
my $tmpmonth = $ENV{'form.'.$dname.'_month'}; |
|
if (($tmpmonth =~ /^\d+$/) && ($tmpmonth > 0) && ($tmpmonth < 13)) { |
|
$month = $tmpmonth - 1; |
|
} |
|
} |
|
if (defined($ENV{'form.'.$dname.'_year'})) { |
|
my $tmpyear = $ENV{'form.'.$dname.'_year'}; |
|
if (($tmpyear =~ /^\d+$/) && ($tmpyear > 1900)) { |
|
$year = $tmpyear - 1900; |
|
} |
} |
} |
$Str .= '>No Student Selected</option>'."\n"; |
if (($year<70) || ($year>137)) { return undef; } |
|
if (eval(&timelocal($sec,$min,$hour,$day,$month,$year))) { |
|
return &timelocal($sec,$min,$hour,$day,$month,$year); |
|
} else { |
|
return undef; |
|
} |
|
} |
|
|
$Str .= '</select>'."\n"; |
############################################## |
|
############################################## |
|
|
|
=pod |
|
|
|
=item &pjump_javascript_definition() |
|
|
|
Returns javascript defining the 'pjump' function, which opens up a |
|
parameter setting wizard. |
|
|
|
=cut |
|
|
|
############################################## |
|
############################################## |
|
sub pjump_javascript_definition { |
|
my $Str = <<END; |
|
function pjump(type,dis,value,marker,ret,call) { |
|
parmwin=window.open("/adm/rat/parameter.html?type="+escape(type) |
|
+"&value="+escape(value)+"&marker="+escape(marker) |
|
+"&return="+escape(ret) |
|
+"&call="+escape(call)+"&name="+escape(dis),"LONCAPAparms", |
|
"height=350,width=350,scrollbars=no,menubar=no"); |
|
} |
|
END |
return $Str; |
return $Str; |
} |
} |
|
|
|
############################################## |
|
############################################## |
|
|
|
=pod |
|
|
|
=item &javascript_nothing() |
|
|
|
Return an appropriate null for the users browser. This is used |
|
as the first arguement for window.open calls when you want a blank |
|
window that you can then write to. |
|
|
|
=cut |
|
|
|
############################################## |
|
############################################## |
|
sub javascript_nothing { |
|
# mozilla and other browsers work with "''", but IE on mac does not. |
|
my $nothing = "''"; |
|
my $user_browser; |
|
my $user_os; |
|
$user_browser = $ENV{'browser.type'} if (exists($ENV{'browser.type'})); |
|
$user_os = $ENV{'browser.os'} if (exists($ENV{'browser.os'})); |
|
if (! defined($user_browser) || ! defined($user_os)) { |
|
(undef,$user_browser,undef,undef,undef,$user_os) = |
|
&Apache::loncommon::decode_user_agent(); |
|
} |
|
if ($user_browser eq 'explorer' && $user_os =~ 'mac') { |
|
$nothing = "'javascript:void(0);'"; |
|
} |
|
return $nothing; |
|
} |
|
|
|
|
|
############################################## |
|
############################################## |
|
|
|
=pod |
|
|
|
=item &StatusOptions() |
|
|
|
Returns html for a selection box which allows the user to choose the |
|
enrollment status of students. The selection box name is 'Status'. |
|
|
|
Inputs: |
|
|
|
$status: the currently selected status. If undefined the value of |
|
$ENV{'form.Status'} is taken. If that is undefined, a value of 'Active' |
|
is used. |
|
|
|
$formname: The name of the form. If defined the onchange attribute of |
|
the selection box is set to document.$formname.submit(). |
|
|
|
$size: the size (number of lines) of the selection box. |
|
|
|
Returns: a perl string as described. |
|
|
|
=cut |
|
|
|
############################################## |
|
############################################## |
sub StatusOptions { |
sub StatusOptions { |
my ($status, $formName)=@_; |
my ($status, $formName,$size)=@_; |
|
$size = 1 if (!defined($size)); |
|
if (! defined($status)) { |
|
$status = 'Active'; |
|
$status = $ENV{'form.Status'} if (exists($ENV{'form.Status'})); |
|
} |
|
|
my $OpSel1 = ''; |
my $OpSel1 = ''; |
my $OpSel2 = ''; |
my $OpSel2 = ''; |
Line 108 sub StatusOptions {
|
Line 368 sub StatusOptions {
|
if(defined($formName) && $formName ne '') { |
if(defined($formName) && $formName ne '') { |
$Str .= ' onchange="document.'.$formName.'.submit()"'; |
$Str .= ' onchange="document.'.$formName.'.submit()"'; |
} |
} |
|
$Str .= ' size="'.$size.'" '; |
$Str .= '>'."\n"; |
$Str .= '>'."\n"; |
$Str .= '<option'.$OpSel1.'>Active</option>'."\n"; |
$Str .= '<option value="Active" '.$OpSel1.'>'. |
$Str .= '<option'.$OpSel2.'>Expired</option>'."\n"; |
'Currently Enrolled</option>'."\n"; |
$Str .= '<option'.$OpSel3.'>Any</option>'."\n"; |
$Str .= '<option value="Expired" '.$OpSel2.'>'. |
|
'Previously Enrolled</option>'."\n"; |
|
$Str .= '<option value="Any" '.$OpSel3.'>'. |
|
'Any Enrollment Status</option>'."\n"; |
$Str .= '</select>'."\n"; |
$Str .= '</select>'."\n"; |
} |
} |
|
|
sub Title { |
|
my ($pageName)=@_; |
|
|
|
my $Str = ''; |
######################################################## |
|
######################################################## |
|
|
$Str .= '<html><head><title>'.$pageName.'</title></head>'."\n"; |
=pod |
$Str .= '<body bgcolor="#FFFFFF">'."\n"; |
|
$Str .= '<script>window.focus(); window.width=500;window.height=500;'; |
=item &MultipleSectionSelect() |
$Str .= '</script>'."\n"; |
|
$Str .= '<table width="100%"><tr><td valign="top">'; |
Inputs: |
$Str .= '<h1> Course: '; |
|
$Str .= $ENV{'course.'.$ENV{'request.course.id'}.'.description'}; |
=over 4 |
$Str .= '</h1></td><td align="right">'."\n"; |
|
$Str .= '<img align="right" src=/adm/lonIcons/lonlogos.gif>'; |
=item $sections A references to an array containing the names of all the |
$Str .= '</td></tr></table>'."\n"; |
sections used in a class. |
# $Str .= '<h3>Current Time: '.localtime(time).'</h3><br><br><br>'."\n"; |
|
|
=item $selectedSections A reference to an array containing the names of the |
|
currently selected sections. |
|
|
|
=back |
|
|
|
Returns: a string containing HTML for a multiple select box for |
|
selecting sections of a course. |
|
|
|
The form element name is 'Section'. @$sections is sorted prior to output. |
|
|
|
=cut |
|
|
|
######################################################## |
|
######################################################## |
|
sub MultipleSectionSelect { |
|
my ($sections,$selectedSections)=@_; |
|
|
|
my $Str = ''; |
|
$Str .= '<select name="Section" multiple="true" size="4">'."\n"; |
|
|
|
foreach (sort @$sections) { |
|
$Str .= '<option'; |
|
foreach my $selected (@$selectedSections) { |
|
if($_ eq $selected) { |
|
$Str .= ' selected=""'; |
|
} |
|
} |
|
$Str .= '>'.$_.'</option>'."\n"; |
|
} |
|
$Str .= '</select>'."\n"; |
|
|
return $Str; |
return $Str; |
} |
} |
|
|
sub CreateStatisticsMainMenu { |
######################################################## |
my ($status, $reports)=@_; |
######################################################## |
|
|
my $Str = ''; |
=pod |
|
|
|
=item &Title() |
|
|
$Str .= '<table border="0"><tbody><tr>'."\n"; |
Inputs: $pageName a string containing the name of the page to be sent |
$Str .= '<td></td><td></td>'."\n"; |
to &Apache::loncommon::bodytag. |
$Str .= '<td align="center"><b>Analysis Reports:</b></td>'."\n"; |
|
$Str .= '<td align="center"><b>Student Status:</b></td></tr>'."\n"; |
|
$Str .= '<tr>'."\n"; |
|
$Str .= '<td align="center"><input type="submit" name="Refresh" '; |
|
$Str .= 'value="Refresh" /></td>'."\n"; |
|
$Str .= '<td align="center"><input type="submit" name="DownloadAll" '; |
|
$Str .= 'value="Update All Student Data" /></td>'."\n"; |
|
$Str .= '<td align="center">'; |
|
$Str .= '<select name="reportSelected" onchange="document.'; |
|
$Str .= 'Statistics.submit()">'."\n"; |
|
|
|
foreach (sort(keys(%$reports))) { |
|
next if($_ eq 'reportSelected'); |
|
$Str .= '<option name="'.$_.'"'; |
|
if($reports->{'reportSelected'} eq $reports->{$_}) { |
|
$Str .= ' selected=""'; |
|
} |
|
$Str .= '>'.$reports->{$_}.'</option>'."\n"; |
|
} |
|
$Str .= '</select></td>'."\n"; |
|
|
|
$Str .= '<td align="center">'; |
|
$Str .= &StatusOptions($status, 'Statistics'); |
|
$Str .= '</td>'."\n"; |
|
|
|
$Str .= '</tr></tbody></table>'."\n"; |
Returns: string containing being <html> and complete <head> and <title> |
$Str .= '<hr>'."\n"; |
as well as a <script> to focus the current window and change its width |
|
and height to 500. Why? I do not know. If you find out, please update |
|
this documentation. |
|
|
|
=cut |
|
|
|
######################################################## |
|
######################################################## |
|
sub Title { |
|
my ($pageName)=@_; |
|
|
|
my $Str = ''; |
|
|
|
$Str .= '<html><head><title>'.$pageName.'</title></head>'."\n"; |
|
$Str .= &Apache::loncommon::bodytag($pageName)."\n"; |
|
$Str .= '<script>window.focus(); window.width=500;window.height=500;'; |
|
$Str .= '</script>'."\n"; |
|
|
return $Str; |
return $Str; |
} |
} |
|
|
|
######################################################## |
|
######################################################## |
|
|
=pod |
=pod |
|
|
=item &CreateTableHeadings() |
=item &CreateHeadings() |
|
|
This function generates the column headings for the chart. |
This function generates the column headings for the chart. |
|
|
=over 4 |
=over 4 |
|
|
Inputs: $CacheData, $studentInformation, $headings, $spacePadding |
Inputs: $CacheData, $keyID, $headings, $spacePadding |
|
|
$CacheData: pointer to a hash tied to the cached data database |
$CacheData: pointer to a hash tied to the cached data database |
|
|
$studentInformation: a pointer to an array containing the names of the data |
$keyID: a pointer to an array containing the names of the data |
held in a column and is used as part of a key into $CacheData |
held in a column and is used as part of a key into $CacheData |
|
|
$headings: The names of the headings for the student information |
$headings: The names of the headings for the student information |
Line 200 $Str: A formatted string of the table co
|
Line 490 $Str: A formatted string of the table co
|
|
|
=cut |
=cut |
|
|
sub CreateStudentInformationHeadings { |
######################################################## |
my ($data,$studentInformation,$headings,$displayString)=@_; |
######################################################## |
|
sub CreateHeadings { |
|
my ($data,$keyID,$headings,$displayString,$format)=@_; |
my $Str=''; |
my $Str=''; |
|
my $formatting = ''; |
|
|
for(my $index=0; $index<(scalar @$headings); $index++) { |
for(my $index=0; $index<(scalar @$headings); $index++) { |
# if(!&ShouldShowColumn($data, 'ChartHeading'.$index)) { |
my $currentHeading=$headings->[$index]; |
# next; |
if($format eq 'preformatted') { |
# } |
my @dataLength=split(//,$currentHeading); |
my $data=$headings->[$index]; |
my $length=scalar @dataLength; |
my $linkdata=$studentInformation->[$index]; |
$formatting = (' 'x |
|
($data->{$keyID->[$index].':columnWidth'}-$length)); |
|
} |
|
my $linkdata=$keyID->[$index]; |
|
|
my $tempString = $displayString; |
my $tempString = $displayString; |
$tempString =~ s/LINKDATA/$linkdata/; |
$tempString =~ s/LINKDATA/$linkdata/; |
$tempString =~ s/DISPLAYDATA/$data/; |
$tempString =~ s/DISPLAYDATA/$currentHeading/; |
|
$tempString =~ s/FORMATTING/$formatting/; |
|
|
$Str .= $tempString; |
$Str .= $tempString; |
} |
} |
|
|
return $Str; |
return $Str; |
} |
} |
|
|
|
######################################################## |
|
######################################################## |
|
|
=pod |
=pod |
|
|
=item &FormatStudentInformation() |
=item &FormatStudentInformation() |
|
|
This function produces a formatted string of the student's information: |
This function produces a formatted string of the student\'s information: |
username, domain, section, full name, and PID. |
username, domain, section, full name, and PID. |
|
|
=over 4 |
=over 4 |
|
|
Input: $cache, $name, $studentInformation, $spacePadding |
Input: $cache, $name, $keyID, $spacePadding |
|
|
$cache: This is a pointer to a hash that is tied to the cached data |
$cache: This is a pointer to a hash that is tied to the cached data |
|
|
$name: The name and domain of the current student in name:domain format |
$name: The name and domain of the current student in name:domain format |
|
|
$studentInformation: A pointer to an array holding the names used to |
$keyID: A pointer to an array holding the names used to |
|
|
remove data from the hash. They represent the name of the data to be removed. |
remove data from the hash. They represent the name of the data to be removed. |
|
|
Line 248 $Str: Formatted string.
|
Line 550 $Str: Formatted string.
|
|
|
=cut |
=cut |
|
|
|
######################################################## |
|
######################################################## |
sub FormatStudentInformation { |
sub FormatStudentInformation { |
my ($cache,$name,$studentInformation,$spacePadding)=@_; |
my ($data,$name,$keyID,$displayString,$format)=@_; |
my $Str=''; |
my $Str=''; |
my $data; |
my $currentColumn; |
|
|
|
for(my $index=0; $index<(scalar @$keyID); $index++) { |
|
$currentColumn=$data->{$name.':'.$keyID->[$index]}; |
|
|
|
if($format eq 'preformatted') { |
|
my @dataLength=split(//,$currentColumn); |
|
my $length=scalar @dataLength; |
|
$currentColumn.= (' 'x |
|
($data->{$keyID->[$index].':columnWidth'}-$length)); |
|
} |
|
|
|
my $tempString = $displayString; |
|
$tempString =~ s/DISPLAYDATA/$currentColumn/; |
|
|
for(my $index=0; $index<(scalar @$studentInformation); $index++) { |
$Str .= $tempString; |
if(!&ShouldShowColumn($cache, 'ChartHeading'.$index)) { |
|
next; |
|
} |
|
$data=$cache->{$name.':'.$studentInformation->[$index]}; |
|
$Str .= $data; |
|
|
|
my @dataLength=split(//,$data); |
|
my $length=scalar @dataLength; |
|
$Str .= (' 'x($cache->{$studentInformation->[$index].'Length'}- |
|
$length)); |
|
$Str .= $spacePadding; |
|
} |
} |
|
|
return $Str; |
return $Str; |
} |
} |
|
|
|
######################################################## |
|
######################################################## |
|
|
|
=pod |
|
|
|
=item Progess Window Handling Routines |
|
|
|
These routines handle the creation, update, increment, and closure of |
|
progress windows. The progress window reports to the user the number |
|
of items completed and an estimate of the time required to complete the rest. |
|
|
|
=over 4 |
|
|
|
|
|
=item &Create_PrgWin |
|
|
|
Writes javascript to the client to open a progress window and returns a |
|
data structure used for bookkeeping. |
|
|
|
Inputs |
|
|
|
=over 4 |
|
|
|
=item $r Apache request |
|
|
|
=item $title The title of the progress window |
|
|
|
=item $heading A description (usually 1 line) of the process being initiated. |
|
|
|
=item $number_to_do The total number of items being processed. |
|
|
|
=back |
|
|
|
Returns a hash containing the progress state data structure. |
|
|
|
|
|
=item &Update_PrgWin |
|
|
|
Updates the text in the progress indicator. Does not increment the count. |
|
See &Increment_PrgWin. |
|
|
|
Inputs: |
|
|
|
=over 4 |
|
|
|
=item $r Apache request |
|
|
|
=item $prog_state Pointer to the data structure returned by &Create_PrgWin |
|
|
|
=item $displaystring The string to write to the status indicator |
|
|
|
=back |
|
|
|
Returns: none |
|
|
|
|
|
=item Increment_PrgWin |
|
|
|
Increment the count of items completed for the progress window by 1. |
|
|
|
Inputs: |
|
|
|
=over 4 |
|
|
|
=item $r Apache request |
|
|
|
=item $prog_state Pointer to the data structure returned by Create_PrgWin |
|
|
|
=item $extraInfo A description of the items being iterated over. Typically |
|
'student'. |
|
|
|
=back |
|
|
|
Returns: none |
|
|
|
|
|
=item Close_PrgWin |
|
|
|
Closes the progress window. |
|
|
|
Inputs: |
|
|
|
=over 4 |
|
|
|
=item $r Apache request |
|
|
|
=item $prog_state Pointer to the data structure returned by Create_PrgWin |
|
|
|
=back |
|
|
|
Returns: none |
|
|
|
=back |
|
|
|
=cut |
|
|
|
######################################################## |
|
######################################################## |
|
|
|
# Create progress |
|
sub Create_PrgWin { |
|
my ($r, $title, $heading, $number_to_do)=@_; |
|
$r->print('<script>'. |
|
"popwin=open(\'\',\'popwin\',\'width=400,height=100\');". |
|
"popwin.document.writeln(\'<html><head><title>$title</title></head>". |
|
"<body bgcolor=\"#88DDFF\">". |
|
"<h4>$heading</h4>". |
|
"<form name=popremain>". |
|
"<input type=text size=55 name=remaining value=Starting></form>". |
|
"</body></html>\');". |
|
"popwin.document.close();". |
|
"</script>"); |
|
|
|
my %prog_state; |
|
$prog_state{'done'}=0; |
|
$prog_state{'firststart'}=&Time::HiRes::time(); |
|
$prog_state{'laststart'}=&Time::HiRes::time(); |
|
$prog_state{'max'}=$number_to_do; |
|
|
|
$r->rflush(); |
|
return %prog_state; |
|
} |
|
|
|
# update progress |
|
sub Update_PrgWin { |
|
my ($r,$prog_state,$displayString)=@_; |
|
$r->print('<script>popwin.document.popremain.remaining.value="'. |
|
$displayString.'";</script>'); |
|
$$prog_state{'laststart'}=&Time::HiRes::time(); |
|
$r->rflush(); |
|
} |
|
|
|
# increment progress state |
|
sub Increment_PrgWin { |
|
my ($r,$prog_state,$extraInfo)=@_; |
|
$$prog_state{'done'}++; |
|
my $time_est= (&Time::HiRes::time() - $$prog_state{'firststart'})/ |
|
$$prog_state{'done'} * |
|
($$prog_state{'max'}-$$prog_state{'done'}); |
|
$time_est = int($time_est); |
|
if (int ($time_est/60) > 0) { |
|
my $min = int($time_est/60); |
|
my $sec = $time_est % 60; |
|
$time_est = $min.' minutes'; |
|
if ($min < 10) { |
|
if ($sec > 1) { |
|
$time_est.= ', '.$sec.' seconds'; |
|
} elsif ($sec > 0) { |
|
$time_est.= ', '.$sec.' second'; |
|
} |
|
} |
|
} else { |
|
$time_est .= ' seconds'; |
|
} |
|
my $lasttime = &Time::HiRes::time()-$$prog_state{'laststart'}; |
|
if ($lasttime > 9) { |
|
$lasttime = int($lasttime); |
|
} elsif ($lasttime < 0.01) { |
|
$lasttime = 0; |
|
} else { |
|
$lasttime = sprintf("%3.2f",$lasttime); |
|
} |
|
if ($lasttime == 1) { |
|
$lasttime = '('.$lasttime.' second for '.$extraInfo.')'; |
|
} else { |
|
$lasttime = '('.$lasttime.' seconds for '.$extraInfo.')'; |
|
} |
|
$r->print('<script>popwin.document.popremain.remaining.value="'. |
|
$$prog_state{'done'}.'/'.$$prog_state{'max'}. |
|
': '.$time_est.' remaining '.$lasttime.'";'.'</script>'); |
|
$$prog_state{'laststart'}=&Time::HiRes::time(); |
|
$r->rflush(); |
|
} |
|
|
|
# close Progress Line |
|
sub Close_PrgWin { |
|
my ($r,$prog_state)=@_; |
|
$r->print('<script>popwin.close()</script>'."\n"); |
|
undef(%$prog_state); |
|
$r->rflush(); |
|
} |
|
|
1; |
1; |
|
|
__END__ |
__END__ |