version 1.6, 2002/08/01 20:49:06
|
version 1.36, 2003/12/29 19:01:27
|
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 Apache::lonlocal; |
use strict; |
use strict; |
|
|
sub AscendOrderOptions { |
|
my ($order, $page, $formName)=@_; |
|
|
|
my $OpSel1 = ''; |
############################################## |
my $OpSel2 = ''; |
############################################## |
|
|
if($order eq 'Ascending') { |
=pod |
$OpSel1 = ' selected'; |
|
} else { |
|
$OpSel2 = ' selected'; |
|
} |
|
|
|
my $Str = ''; |
=item textbox |
$Str .= '<select name="'.(($page)?$page:'').'Ascend"'; |
|
if($formName) { |
|
$Str .= ' onchange="document.'.$formName.'.submit()"'; |
|
} |
|
$Str .= '>'."\n"; |
|
$Str .= '<option'.$OpSel1.'>Ascending</option>'."\n". |
|
'<option'.$OpSel2.'>Descending</option>'."\n"; |
|
$Str .= '</select>'."\n"; |
|
|
|
|
=cut |
|
|
|
############################################## |
|
############################################## |
|
sub textbox { |
|
my ($name,$value,$size,$special) = @_; |
|
$size = 40 if (! defined($size)); |
|
my $Str = '<input type="text" name="'.$name.'" size="'.$size.'" '. |
|
'value="'.$value.'" '.$special.' />'; |
return $Str; |
return $Str; |
} |
} |
|
|
sub MapOptions { |
############################################## |
my ($data, $page, $formName)=@_; |
############################################## |
my $Str = ''; |
|
$Str .= '<select name="'; |
|
$Str .= (($page)?$page:'').'Maps"'; |
|
if($formName) { |
|
$Str .= ' onchange="document.'.$formName.'.submit()"'; |
|
} |
|
$Str .= '>'."\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 checkbox |
|
|
|
=cut |
|
|
|
############################################## |
|
############################################## |
|
sub checkbox { |
|
my ($name) = @_; |
|
my $Str = '<input type="checkbox" name="'.$name.'" />'; |
return $Str; |
return $Str; |
} |
} |
|
|
sub StudentOptions { |
|
my ($cache, $students, $selectedName, $page, $formName)=@_; |
|
|
|
my $Str = ''; |
|
$Str .= '<select name="'.(($page)?$page:'').'Student"'; |
|
if($formName) { |
|
$Str .= ' onchange="document.'.$formName.'.submit()"'; |
|
} |
|
$Str .= '>'."\n"; |
|
|
|
my $selected=0; |
############################################## |
|
############################################## |
|
|
|
=pod |
|
|
|
=item &date_setter |
|
|
|
&date_setter returns html and javascript for a compact date-setting form. |
|
To retrieve values from it, use &get_date_from_form(). |
|
|
|
Inputs |
|
|
|
=over 4 |
|
|
|
=item $dname |
|
|
|
The name to prepend to the form elements. |
|
The form elements defined will be dname_year, dname_month, dname_day, |
|
dname_hour, dname_min, and dname_sec. |
|
|
|
=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. |
|
|
|
=item $special |
|
|
|
Additional html/javascript to be associated with each element in |
|
the date_setter. See lonparmset for example usage. |
|
|
|
=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,$special) = @_; |
|
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; |
|
} |
|
if ((month == 1) || (month == 3) || (month == 5) || |
|
(month == 7) || (month == 8) || (month == 10) || |
|
(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; |
} |
} |
$Str .= '>'; |
|
$Str .= $cache->{$_.':fullname'}; |
|
$Str .= '</option>'."\n"; |
|
} |
} |
|
|
$Str .= '<option'; |
function $dname\_opencalendar() { |
if($selectedName eq 'No Student Selected') { |
var calwin=window.open( |
$Str .= ' selected'; |
"/adm/announcements?pickdate=yes&formname=$formname&element=$dname&month="+ |
$selected = 1; |
document.$formname.$dname\_month.value+"&year="+ |
} |
document.$formname.$dname\_year.value, |
$Str .= '>No Student Selected</option>'."\n"; |
"LONCAPAcal", |
|
"height=350,width=350,scrollbars=yes,resizable=yes,menubar=no"); |
|
|
|
} |
|
</script> |
|
ENDJS |
|
$result .= " <nobr><select name=\"$dname\_month\" ".$special.' '. |
|
"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 .= "> ".&mt($Months[$m])." </option>\n"; |
|
} |
|
$result .= " </select>\n"; |
|
$result .= " <input type=\"text\" name=\"$dname\_day\" ". |
|
"value=\"$mday\" size=\"3\" ".$special.' '. |
|
"onChange=\"javascript:$dname\_checkday()\" />\n"; |
|
$result .= " <input type=\"year\" name=\"$dname\_year\" ". |
|
"value=\"$year\" size=\"5\" ".$special.' '. |
|
"onChange=\"javascript:$dname\_checkday()\" />\n"; |
|
$result .= " "; |
|
$result .= " <select name=\"$dname\_hour\" ".$special." >\n"; |
|
for (my $h = 0;$h<24;$h++) { |
|
$result .= " <option value=\"$h\" "; |
|
$result .= "selected " if ($hour == $h); |
|
$result .= "> "; |
|
my $timest=''; |
|
if ($h == 0) { |
|
$timest .= "12 am"; |
|
} elsif($h == 12) { |
|
$timest .= "12 noon"; |
|
} elsif($h < 12) { |
|
$timest .= "$h am"; |
|
} else { |
|
$timest .= $h-12 ." pm"; |
|
} |
|
$timest=&mt($timest); |
|
$result .= $timest." </option>\n"; |
|
} |
|
$result .= " </select>\n"; |
|
$result .= " <input type=\"text\" name=\"$dname\_minute\" ".$special.' '. |
|
"value=\"$min\" size=\"3\" /> m\n"; |
|
$result .= " <input type=\"text\" name=\"$dname\_second\" ".$special.' '. |
|
"value=\"$sec\" size=\"3\" /> s\n"; |
|
$result .= "<a href=\"javascript:$dname\_opencalendar()\">". |
|
&mt('Select Date')."</a></nobr>\n<!-- 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 |
|
|
|
=item $dname |
|
|
|
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. |
|
|
$Str .= '<option'; |
=back |
if(!$selected) { |
|
$Str .= ' selected'; |
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 < 24)) { |
|
$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; |
|
} |
|
} |
|
if (($year<70) || ($year>137)) { return undef; } |
|
if (defined($sec) && defined($min) && defined($hour) && |
|
defined($day) && defined($month) && defined($year) && |
|
eval(&timelocal($sec,$min,$hour,$day,$month,$year))) { |
|
return &timelocal($sec,$min,$hour,$day,$month,$year); |
|
} else { |
|
return undef; |
} |
} |
$Str .= '>All Students</option>'."\n"; |
} |
|
|
$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. |
|
|
|
$onchange: javascript to use when the value is changed. Enclosed in |
|
double quotes, ""s, not single quotes. |
|
|
|
Returns: a perl string as described. |
|
|
|
=cut |
|
|
|
############################################## |
|
############################################## |
sub StatusOptions { |
sub StatusOptions { |
my ($status, $formName)=@_; |
my ($status, $formName,$size,$onchange)=@_; |
|
$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 139 sub StatusOptions {
|
Line 428 sub StatusOptions {
|
|
|
my $Str = ''; |
my $Str = ''; |
$Str .= '<select name="Status"'; |
$Str .= '<select name="Status"'; |
if(defined($formName) && $formName ne '') { |
if(defined($formName) && $formName ne '' && ! defined($onchange)) { |
$Str .= ' onchange="document.'.$formName.'.submit()"'; |
$Str .= ' onchange="document.'.$formName.'.submit()"'; |
} |
} |
|
if (defined($onchange)) { |
|
$Str .= ' onchange="'.$onchange.'"'; |
|
} |
|
$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"; |
} |
} |
|
|
|
|
|
######################################################## |
|
######################################################## |
|
|
|
=pod |
|
|
|
=item &MultipleSectionSelect() |
|
|
|
Inputs: |
|
|
|
=over 4 |
|
|
|
=item $sections A references to an array containing the names of all the |
|
sections used in a class. |
|
|
|
=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 { |
sub MultipleSectionSelect { |
my ($sections,$selectedSections)=@_; |
my ($sections,$selectedSections)=@_; |
|
|
my $Str = ''; |
my $Str = ''; |
$Str .= '<select name="Section" multiple="" size="4">'."\n"; |
$Str .= '<select name="Section" multiple="true" size="4">'."\n"; |
|
|
foreach (@$sections) { |
foreach (sort @$sections) { |
$Str .= '<option'; |
$Str .= '<option'; |
foreach my $selected (@$selectedSections) { |
foreach my $selected (@$selectedSections) { |
if($_ eq $selected) { |
if($_ eq $selected) { |
Line 165 sub MultipleSectionSelect {
|
Line 490 sub MultipleSectionSelect {
|
$Str .= '>'.$_.'</option>'."\n"; |
$Str .= '>'.$_.'</option>'."\n"; |
} |
} |
$Str .= '</select>'."\n"; |
$Str .= '</select>'."\n"; |
|
|
return $Str; |
return $Str; |
} |
} |
|
|
|
######################################################## |
|
######################################################## |
|
|
|
=pod |
|
|
|
=item &Title() |
|
|
|
Inputs: $pageName a string containing the name of the page to be sent |
|
to &Apache::loncommon::bodytag. |
|
|
|
Returns: string containing being <html> and complete <head> and <title> |
|
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 { |
sub Title { |
my ($pageName)=@_; |
my ($pageName)=@_; |
|
|
my $Str = ''; |
my $Str = ''; |
|
|
$Str .= '<html><head><title>'.$pageName.'</title></head>'."\n"; |
$Str .= '<html><head><title>'.$pageName.'</title></head>'."\n"; |
$Str .= '<body bgcolor="#FFFFFF">'."\n"; |
$Str .= &Apache::loncommon::bodytag($pageName)."\n"; |
$Str .= '<script>window.focus(); window.width=500;window.height=500;'; |
$Str .= '<script>window.focus(); window.width=500;window.height=500;'; |
$Str .= '</script>'."\n"; |
$Str .= '</script>'."\n"; |
$Str .= '<table width="100%"><tr><td valign="top">'; |
|
$Str .= '<h1> Course: '; |
|
$Str .= $ENV{'course.'.$ENV{'request.course.id'}.'.description'}; |
|
$Str .= '</h1></td><td align="right">'."\n"; |
|
$Str .= '<img align="right" src=/adm/lonIcons/lonlogos.gif>'; |
|
$Str .= '</td></tr></table>'."\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. |
|
|
Line 215 $Str: A formatted string of the table co
|
Line 556 $Str: A formatted string of the table co
|
|
|
=cut |
=cut |
|
|
|
######################################################## |
|
######################################################## |
sub CreateHeadings { |
sub CreateHeadings { |
my ($data,$keyID,$headings,$displayString,$format)=@_; |
my ($data,$keyID,$headings,$displayString,$format)=@_; |
my $Str=''; |
my $Str=''; |
Line 241 sub CreateHeadings {
|
Line 584 sub CreateHeadings {
|
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 |
Line 270 $Str: Formatted string.
|
Line 616 $Str: Formatted string.
|
|
|
=cut |
=cut |
|
|
|
######################################################## |
|
######################################################## |
sub FormatStudentInformation { |
sub FormatStudentInformation { |
my ($data,$name,$keyID,$displayString,$format)=@_; |
my ($data,$name,$keyID,$displayString,$format)=@_; |
my $Str=''; |
my $Str=''; |
Line 294 sub FormatStudentInformation {
|
Line 642 sub FormatStudentInformation {
|
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="'. |
|
&mt('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.' '.&mt('minutes'); |
|
if ($min < 10) { |
|
if ($sec > 1) { |
|
$time_est.= ', '.$sec.' '.&mt('seconds'); |
|
} elsif ($sec > 0) { |
|
$time_est.= ', '.$sec.' '.&mt('second'); |
|
} |
|
} |
|
} else { |
|
$time_est .= ' '.&mt('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.' '.&mt('second for').' '.$extraInfo.')'; |
|
} else { |
|
$lasttime = '('.$lasttime.' '.&mt('seconds for').' '.$extraInfo.')'; |
|
} |
|
# |
|
my $user_browser = $ENV{'browser.type'} if (exists($ENV{'browser.type'})); |
|
my $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') { |
|
$lasttime = ''; |
|
} |
|
$r->print('<script>popwin.document.popremain.remaining.value="'. |
|
$$prog_state{'done'}.'/'.$$prog_state{'max'}. |
|
': '.$time_est.' '.&mt('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(); |
|
} |
|
|
|
|
|
# ------------------------------------------------------- Puts directory header |
|
|
|
sub crumbs { |
|
my ($uri,$target,$prefix)=@_; |
|
my $output='<br /><tt><b><font size="+2">'.$prefix.'/'; |
|
if ($ENV{'user.adv'}) { |
|
my $path=$prefix; |
|
foreach (split('/',$uri)) { |
|
unless ($_) { next; } |
|
$path.='/'.$_; |
|
$output.='<a href="'.$path.'"'.($target?' target="'.$target.'"':'').'>'.$_.'</a>/'; |
|
} |
|
} else { |
|
$output.=$uri; |
|
} |
|
unless ($uri=~/\/$/) { $output=~s/\/$//; } |
|
return $output.'</font></b></tt><br />'; |
|
} |
|
|
|
|
1; |
1; |
|
|
__END__ |
__END__ |