version 1.49, 2002/09/13 15:33:39
|
version 1.51, 2002/09/18 14:17:47
|
Line 31
|
Line 31
|
# |
# |
# (TeX Content Handler |
# (TeX Content Handler |
# |
# |
# YEAR=2000 |
############################################################### |
# 05/29/00,05/30,10/11 Gerd Kortemeyer) |
############################################################### |
# |
|
# 10/11,10/12,10/16 Gerd Kortemeyer) |
|
# |
|
# 11/20,11/21,11/22,11/23,11/24,11/25,11/27,11/28, |
|
# 12/08,12/12 Gerd Kortemeyer) |
|
# |
|
# 12/26,12/27,12/28, |
|
# YEAR=2001 |
|
# 01/01/01,01/15,02/10,02/13,02/14,02/22 Gerd Kortemeyer |
|
# 8/6 Scott Harrison |
|
# Guy Albertelli |
|
# 9/25 Gerd Kortemeyer |
|
# 12/19 Guy Albertelli |
|
# YEAR=2002 |
|
# 1/4 Gerd Kortemeyer |
|
|
|
package Apache::londropadd; |
package Apache::londropadd; |
|
|
use strict; |
use strict; |
use Apache::lonnet(); |
use Apache::lonnet(); |
use Apache::loncommon(); |
use Apache::loncommon(); |
|
use Apache::lonhtmlcommon(); |
use Apache::Constants qw(:common :http REDIRECT); |
use Apache::Constants qw(:common :http REDIRECT); |
|
|
# ================================================================ Print header |
############################################################### |
|
############################################################### |
sub header { |
sub header { |
my $bodytag=&Apache::loncommon::bodytag('Enrollment Manager'); |
my $bodytag=&Apache::loncommon::bodytag('Enrollment Manager'); |
return(<<ENDHEAD); |
return(<<ENDHEAD); |
Line 71 $bodytag
|
Line 57 $bodytag
|
ENDHEAD |
ENDHEAD |
} |
} |
|
|
# =========== Drop student from all sections of a course, except optional $csec |
############################################################### |
|
############################################################### |
|
# Drop student from all sections of a course, except optional $csec |
sub modifystudent { |
sub modifystudent { |
my ($udom,$unam,$courseid,$csec,$desiredhost)=@_; |
my ($udom,$unam,$courseid,$csec,$desiredhost)=@_; |
# if $csec is undefined, drop the student from all the courses matching |
# if $csec is undefined, drop the student from all the courses matching |
Line 93 sub modifystudent {
|
Line 81 sub modifystudent {
|
if ( ((!$section) && (!$csec)) || ($section ne $csec) ) { |
if ( ((!$section) && (!$csec)) || ($section ne $csec) ) { |
my (undef,$end,$start)=split(/\_/,$roles{$course}); |
my (undef,$end,$start)=split(/\_/,$roles{$course}); |
my $now=time; |
my $now=time; |
|
# if this is an active role |
if (!($start && ($now<$start)) || !($end && ($now>$end))) { |
if (!($start && ($now<$start)) || !($end && ($now>$end))) { |
my $reply=&Apache::lonnet::modifystudent |
my $reply=&Apache::lonnet::modifystudent |
($udom,$unam,'','','','','','','', |
($udom,$unam,'','','','','','','', |
Line 110 sub modifystudent {
|
Line 99 sub modifystudent {
|
return $result; |
return $result; |
} |
} |
|
|
# ============ build a domain and server selection form |
############################################################### |
|
############################################################### |
|
# build a domain and server selection form |
sub domain_form { |
sub domain_form { |
my ($defdom) = @_; |
my ($defdom) = @_; |
# Set up domain and server selection forms |
# Set up domain and server selection forms |
Line 139 sub domain_form {
|
Line 130 sub domain_form {
|
return $result; |
return $result; |
} |
} |
|
|
# ============================================================== Menu Phase One |
############################################################### |
sub menu_phase_one { |
############################################################### |
|
# Menu Phase One |
|
sub print_main_menu { |
my $r=shift; |
my $r=shift; |
$r->print(<<END); |
$r->print(<<END); |
<p> |
<p> |
<font size="+1"><a href="/adm/dropadd?phase=two&uplist=yes">Upload a course list</a></font> |
<font size="+1"> |
|
<a href="/adm/dropadd?action=upload">Upload a course list</a> |
|
</font> |
|
</p><p> |
|
<font size="+1"> |
|
<a href="/adm/dropadd?action=enrollstudent">Enroll a single student</a> |
|
</font> |
</p><p> |
</p><p> |
<font size="+1"><a href="/adm/dropadd?phase=two&enroll=yes">Enroll a single student</a></font> |
<font size="+1"> |
|
<a href="/adm/dropadd?action=modifystudent">Modify student data</a> |
|
</font> |
</p><p> |
</p><p> |
<font size="+1"><a href="/adm/dropadd?phase=two&view=yes">View Classlist</a></font> |
<font size="+1"> |
|
<a href="/adm/dropadd?action=classlist">View Classlist</a> |
|
</font> |
</p><p> |
</p><p> |
<font size="+1"><a href="/adm/dropadd?phase=two&drop=yes">Drop Students</a></font> |
<font size="+1"> |
|
<a href="/adm/dropadd?action=drop">Drop Students</a> |
|
</font> |
</p> |
</p> |
END |
END |
} |
} |
|
|
sub phase_two_header { |
############################################################### |
|
############################################################### |
|
sub print_upload_manager_header { |
my ($r,$datatoken,$distotal,$krbdefdom)=@_; |
my ($r,$datatoken,$distotal,$krbdefdom)=@_; |
my $javascript; |
my $javascript; |
|
if (! exists($ENV{'form.upfile_associate'})) { |
|
$ENV{'form.upfile_associate'} = 'forward'; |
|
} |
|
if ($ENV{'form.associate'} eq 'Reverse Association') { |
|
if ( $ENV{'form.upfile_associate'} ne 'reverse' ) { |
|
$ENV{'form.upfile_associate'} = 'reverse'; |
|
} else { |
|
$ENV{'form.upfile_associate'} = 'forward'; |
|
} |
|
} |
if ($ENV{'form.upfile_associate'} eq 'reverse') { |
if ($ENV{'form.upfile_associate'} eq 'reverse') { |
$javascript=&phase_two_javascript_reverse_associate(); |
$javascript=&upload_manager_javascript_reverse_associate(); |
} else { |
} else { |
$javascript=&phase_two_javascript_forward_associate(); |
$javascript=&upload_manager_javascript_forward_associate(); |
} |
} |
my $javascript_validations=&javascript_validations($krbdefdom); |
my $javascript_validations=&javascript_validations($krbdefdom); |
$r->print(<<ENDPICK); |
$r->print(<<ENDPICK); |
Line 172 Total number of records found in file: $
|
Line 189 Total number of records found in file: $
|
Enter as many fields as you can. The system will inform you and bring you back |
Enter as many fields as you can. The system will inform you and bring you back |
to this page if the data selected is insufficient to run your class.<hr /> |
to this page if the data selected is insufficient to run your class.<hr /> |
<input type="button" value="Reverse Association" onClick="javascript:this.form.associate.value='Reverse Association';submit(this.form);" /> |
<input type="button" value="Reverse Association" onClick="javascript:this.form.associate.value='Reverse Association';submit(this.form);" /> |
|
<input type="hidden" name="action" value="upload" /> |
|
<input type="hidden" name="state" value="got_file" /> |
<input type="hidden" name="associate" value="" /> |
<input type="hidden" name="associate" value="" /> |
<input type="hidden" name="phase" value="three" /> |
|
<input type="hidden" name="datatoken" value="$datatoken" /> |
<input type="hidden" name="datatoken" value="$datatoken" /> |
<input type="hidden" name="fileupload" value="$ENV{'form.fileupload'}" /> |
<input type="hidden" name="fileupload" value="$ENV{'form.fileupload'}" /> |
<input type="hidden" name="upfiletype" value="$ENV{'form.upfiletype'}" /> |
<input type="hidden" name="upfiletype" value="$ENV{'form.upfiletype'}" /> |
Line 187 $javascript_validations
|
Line 205 $javascript_validations
|
ENDPICK |
ENDPICK |
} |
} |
|
|
|
############################################################### |
|
############################################################### |
sub javascript_validations { |
sub javascript_validations { |
my ($krbdefdom)=@_; |
my ($krbdefdom)=@_; |
my %param = ( formname => 'studentform', |
my %param = ( formname => 'studentform', |
Line 247 function verify_message (vf,founduname,f
|
Line 267 function verify_message (vf,founduname,f
|
message+='Continue enrollment?'; |
message+='Continue enrollment?'; |
if (confirm(message)) { |
if (confirm(message)) { |
pclose(); |
pclose(); |
|
vf.state.value='enrolling'; |
vf.submit(); |
vf.submit(); |
} |
} |
} else { |
} else { |
pclose(); |
pclose(); |
|
vf.state.value='enrolling'; |
vf.submit(); |
vf.submit(); |
} |
} |
} |
} |
Line 288 ENDPICK
|
Line 310 ENDPICK
|
|
|
} |
} |
|
|
sub phase_two_javascript_forward_associate { |
############################################################### |
|
############################################################### |
|
sub upload_manager_javascript_forward_associate { |
return(<<ENDPICK); |
return(<<ENDPICK); |
function verify(vf) { |
function verify(vf) { |
var founduname=0; |
var founduname=0; |
Line 376 function clearpwd(vf) {
|
Line 400 function clearpwd(vf) {
|
ENDPICK |
ENDPICK |
} |
} |
|
|
sub phase_two_javascript_reverse_associate { |
############################################################### |
|
############################################################### |
|
sub upload_manager_javascript_reverse_associate { |
return(<<ENDPICK); |
return(<<ENDPICK); |
function verify(vf) { |
function verify(vf) { |
var founduname=0; |
var founduname=0; |
Line 429 function clearpwd(vf) {
|
Line 455 function clearpwd(vf) {
|
ENDPICK |
ENDPICK |
} |
} |
|
|
sub phase_two_end { |
############################################################### |
|
############################################################### |
|
sub print_upload_manager_footer { |
my ($r,$i,$keyfields,$defdom,$today,$halfyear)=@_; |
my ($r,$i,$keyfields,$defdom,$today,$halfyear)=@_; |
my %param = ( formname => 'document.studentform'); |
my %param = ( formname => 'document.studentform'); |
my $krbform = &Apache::loncommon::authform_kerberos(%param); |
my $krbform = &Apache::loncommon::authform_kerberos(%param); |
Line 474 LON-CAPA domain: $domform <p>
|
Line 502 LON-CAPA domain: $domform <p>
|
Disable ID/Student Number Safeguard and Force Change of Conflicting IDs |
Disable ID/Student Number Safeguard and Force Change of Conflicting IDs |
(only do if you know what you are doing)<p> |
(only do if you know what you are doing)<p> |
<input type="button" onClick="javascript:verify(this.form)" value="Update Courselist" /><br /> |
<input type="button" onClick="javascript:verify(this.form)" value="Update Courselist" /><br /> |
Note: for large courses, this operation might be time consuming. |
Note: for large courses, this operation may be time consuming. |
ENDPICK |
ENDPICK |
} |
} |
|
|
# ======================================================= Menu Phase Two Upload |
# ======================================================= Menu Phase Two Upload |
sub menu_phase_two_upload { |
sub print_upload_manager_form { |
my $r=shift; |
my $r=shift; |
|
|
my $datatoken; |
my $datatoken; |
Line 498 sub menu_phase_two_upload {
|
Line 526 sub menu_phase_two_upload {
|
my $today=time; |
my $today=time; |
my $halfyear=$today+15552000; |
my $halfyear=$today+15552000; |
my $defdom=$r->dir_config('lonDefDomain'); |
my $defdom=$r->dir_config('lonDefDomain'); |
&phase_two_header($r,$datatoken,$distotal,$krbdefdom); |
&print_upload_manager_header($r,$datatoken,$distotal,$krbdefdom); |
my $i; |
my $i; |
my $keyfields; |
my $keyfields; |
if ($total>=0) { |
if ($total>=0) { |
my @d=(['username','Username'],['names','Last Name, First Names'], |
my @d=(['username','Username'], |
['fname','First Name'],['mname','Middle Names/Initials'], |
['names','Last Name, First Names'], |
['lname','Last Name'],['gen','Generation'], |
['fname','First Name'], |
['id','ID/Student Number'],['sec','Group/Section'], |
['mname','Middle Names/Initials'], |
|
['lname','Last Name'], |
|
['gen','Generation'], |
|
['id','ID/Student Number'], |
|
['sec','Group/Section'], |
['ipwd','Initial Password']); |
['ipwd','Initial Password']); |
if ($ENV{'form.upfile_associate'} eq 'reverse') { |
if ($ENV{'form.upfile_associate'} eq 'reverse') { |
&Apache::loncommon::csv_print_samples($r,\@records); |
&Apache::loncommon::csv_print_samples($r,\@records); |
Line 519 sub menu_phase_two_upload {
|
Line 551 sub menu_phase_two_upload {
|
$keyfields=join(',',sort(keys(%sone))); |
$keyfields=join(',',sort(keys(%sone))); |
} |
} |
} |
} |
&phase_two_end($r,$i,$keyfields,$defdom,$today,$halfyear); |
&print_upload_manager_footer($r,$i,$keyfields,$defdom,$today,$halfyear); |
} |
} |
|
|
# ======================================================= Enroll single student |
# ======================================================= Enroll single student |
Line 584 sub enroll_single_student {
|
Line 616 sub enroll_single_student {
|
} |
} |
|
|
# ======================================================= Menu Phase Two Enroll |
# ======================================================= Menu Phase Two Enroll |
sub menu_phase_two_enroll { |
sub print_enroll_single_student_form { |
my $r=shift; |
my $r=shift; |
$r->print("<h3>Enroll One Student</h3>"); |
$r->print("<h3>Enroll One Student</h3>"); |
my ($krbdefdom) = $ENV{'SERVER_NAME'}=~/(\w+\.\w+)$/; |
my ($krbdefdom) = $ENV{'SERVER_NAME'}=~/(\w+\.\w+)$/; |
Line 601 sub menu_phase_two_enroll {
|
Line 633 sub menu_phase_two_enroll {
|
# Set up domain selection form |
# Set up domain selection form |
my $domform = &domain_form($defdom); |
my $domform = &domain_form($defdom); |
# Print it all out |
# Print it all out |
$r->print(<<ENDSENROLL); |
$r->print(<<END); |
|
<input type="hidden" name="action" value="enrollstudent"> |
|
<input type="hidden" name="state" value="done"> |
|
|
<script type="text/javascript" language="Javascript"> |
<script type="text/javascript" language="Javascript"> |
function verify(vf) { |
function verify(vf) { |
var founduname=0; |
var founduname=0; |
Line 639 function clearpwd(vf) {
|
Line 674 function clearpwd(vf) {
|
|
|
</script> |
</script> |
<h3>Personal Data</h3> |
<h3>Personal Data</h3> |
First Name: <input type="text" name="cfirst" size="15"><br> |
<table> |
Middle Name: <input type="text" name="cmiddle" size="15"><br> |
<tr><td>First Name:</td><td> <input type="text" name="cfirst" size="15"></td></tr> |
Last Name: <input type="text" name="clast" size="15"><br> |
<tr><td>Middle Name:</td><td> <input type="text" name="cmiddle" size="15"></td></tr> |
Generation: <input type="text" name="cgen" size="5"> |
<tr><td>Last Name: </td><td><input type="text" name="clast" size="15"></td></tr> |
|
<tr><td>Generation: </td><td><input type="text" name="cgen" size="5"> </td></tr> |
<p>ID/Student Number: <input type="text" name="cstid" size="10"></p> |
</table> |
|
|
<p>Group/Section: <input type=text name=csec size=5></p> |
|
|
|
<h3>Login Data</h3> |
<h3>Login Data</h3> |
<p>Username: <input type="text" name="cuname" size="15"></p> |
<p>Username: <input type="text" name="cuname" size="15"></p> |
Line 659 $intform
|
Line 692 $intform
|
</p><p> |
</p><p> |
$locform |
$locform |
</p><p> |
</p><p> |
<h3>Starting and Ending Dates</h3> |
|
<input type="hidden" value='' name="pres_value"> |
<h3>Course Data</h3> |
<input type="hidden" value='' name="pres_type"> |
|
<input type="hidden" value='' name="pres_marker"> |
<p>Group/Section: <input type="text" name="csec" size="5" /> |
<input type="hidden" value='$today' name=startdate> |
<p> |
<input type="hidden" value='$halfyear' name=enddate> |
<!-- Date setting form elements --> |
|
<input type="hidden" name="pres_value" value='' /> |
|
<input type="hidden" name="pres_type" value='' /> |
|
<input type="hidden" name="pres_marker" value='' /> |
|
<input type="hidden" name="startdate" value='$today' /> |
|
<input type="hidden" name="enddate" value='$halfyear' /> |
</p><p> |
</p><p> |
<a |
<a |
href="javascript:pjump('date_start','Enrollment Starting Date',document.studentform.startdate.value,'start','studentform.pres','dateset');" |
href="javascript:pjump('date_start','Enrollment Starting Date',document.studentform.startdate.value,'start','studentform.pres','dateset');" |
Line 673 $locform
|
Line 711 $locform
|
<a |
<a |
href="javascript:pjump('date_end','Enrollment Ending Date',document.studentform.enddate.value,'end','studentform.pres','dateset');" |
href="javascript:pjump('date_end','Enrollment Ending Date',document.studentform.enddate.value,'end','studentform.pres','dateset');" |
>Set Ending Date</a> |
>Set Ending Date</a> |
</p><p> |
</p> |
<h3>ID/Student Number</h3> |
<h3>ID/Student Number</h3> |
|
<p> |
|
ID/Student Number: <input type="text" name="cstid" size="10"> |
|
</p><p> |
<input type="checkbox" name="forceid" value="yes"> |
<input type="checkbox" name="forceid" value="yes"> |
Disable ID/Student Number Safeguard and Force Change of Conflicting IDs |
Disable ID/Student Number Safeguard and Force Change of Conflicting IDs |
(only do if you know what you are doing)<p> |
(only do if you know what you are doing) |
<input type="button" onClick="verify(this.form)" value="Enroll as student"><br> |
</p><p> |
<input type="hidden" name="phase" value="five"> |
<input type="button" onClick="verify(this.form)" value="Enroll as student"> |
</p> |
</p> |
ENDSENROLL |
END |
|
return; |
} |
} |
|
|
# =================================================== get the current classlist |
# =================================================== get the current classlist |
sub get_current_classlist { |
sub get_current_classlist { |
my ($domain,$identifier) = @_; |
my $r = shift; |
# domain is the domain the class is being run in |
# Call DownloadClasslist |
# identifier is the internal, unique identifier for the class. |
my $cid = $ENV{'request.course.id'}; |
my %currentlist=(); |
my $c = $r->connection; |
my $now=time; |
my $classlisthash = &Apache::loncoursedata::DownloadClasslist |
my %results=&Apache::lonnet::dump('classlist',$domain,$identifier); |
($cid,'Not downloaded',$c); |
my ($tmp) = keys(%results); |
# Call ProcessClasslist |
if ($tmp !~ /^(con_lost|error|no_such_host)/i) { |
my %cache; |
foreach my $student (keys(%results)) { |
my @students = &Apache::loncoursedata::ProcessClasslist(\%cache, |
# Extract the start and end dates |
$classlisthash, |
my ($end,$start)=split(/\:/,$results{$student}); |
$cid,$c); |
# If the class isn't over, put it in the list |
return (\@students,\%cache); |
unless (($end) && ($now>$end)) { |
|
$currentlist{$student}=1; |
|
} |
|
} |
|
return (undef,%currentlist); |
|
} else { |
|
$tmp =~ s/^error://; |
|
return ($tmp,undef); |
|
} |
|
} |
} |
|
|
# ========================================================= Menu Phase Two Drop |
# ========================================================= Menu Phase Two Drop |
sub menu_phase_two_drop { |
sub print_drop_menu { |
my $r=shift; |
my $r=shift; |
$r->print("<h3>Drop Students</h3>"); |
$r->print("<h3>Drop Students</h3>"); |
my $cid=$ENV{'request.course.id'}; |
my $cid=$ENV{'request.course.id'}; |
my ($error,%currentlist)=&get_current_classlist |
my ($student_array,$student_data)=&get_current_classlist($r); |
($ENV{'course.'.$cid.'.domain'},$ENV{'course.'.$cid.'.num'}); |
if (! scalar(@$student_array)) { |
if (defined($error)) { |
|
if ($error =~ /^No such file or directory/) { |
|
$r->print("There are no students currently enrolled.\n"); |
|
} else { |
|
$r->print("<pre>ERROR:$error</pre>"); |
|
} |
|
} elsif (!defined(%currentlist)) { |
|
$r->print("There are no students currently enrolled.\n"); |
$r->print("There are no students currently enrolled.\n"); |
} else { |
return; |
# Print out the available choices |
|
&show_drop_list($r,%currentlist); |
|
} |
} |
|
# Print out the available choices |
|
&show_drop_list($student_array,$student_data,$r); |
|
return; |
} |
} |
|
|
# ============================================== view classlist |
# ============================================== view classlist |
sub menu_phase_two_view { |
sub print_html_classlist { |
my $r=shift; |
my $r=shift; |
$r->print(<<END); |
$r->print(<<END); |
|
<p> |
<font size="+1">Current Classlist</font> |
<font size="+1">Current Classlist</font> |
<font size="+1"><a href="/adm/dropadd?phase=two&viewcsv=yes">CSV format</a></font><br /> |
<font size="+1"><a href="/adm/dropadd?action=classlist&state=csv">CSV format</a></font> |
|
</p> |
END |
END |
my $cid=$ENV{'request.course.id'}; |
my $cid=$ENV{'request.course.id'}; |
my ($error,%currentlist)=&get_current_classlist |
my ($student_array,$student_data)=&get_current_classlist($r); |
($ENV{'course.'.$cid.'.domain'},$ENV{'course.'.$cid.'.num'}); |
if (! scalar(@$student_array)) { |
if (defined($error)) { |
|
if ($error =~ /^No such file or directory/) { |
|
$r->print("There are no students currently enrolled.\n"); |
|
} else { |
|
$r->print("<pre>ERROR:$error</pre>"); |
|
} |
|
} elsif (!defined(%currentlist)) { |
|
$r->print("There are no students currently enrolled.\n"); |
$r->print("There are no students currently enrolled.\n"); |
} else { |
} else { |
# Print out the available choices |
# Print out the available choices |
&show_class_list($r,'view',%currentlist); |
if ($ENV{'form.action'} eq 'modifystudent') { |
|
&show_class_list($r,'view','modify',$student_array,$student_data); |
|
} else { |
|
&show_class_list($r,'view','aboutme',$student_array,$student_data); |
|
} |
} |
} |
} |
} |
|
|
# ============================================== view classlist |
# ============================================== view classlist |
sub menu_phase_two_viewcsv { |
sub print_csv_classlist { |
my $r=shift; |
my $r=shift; |
my $cid=$ENV{'request.course.id'}; |
my $cid=$ENV{'request.course.id'}; |
my ($error,%currentlist)=&get_current_classlist |
my ($student_array,$student_data)=&get_current_classlist($r); |
($ENV{'course.'.$cid.'.domain'},$ENV{'course.'.$cid.'.num'}); |
if (! scalar(@$student_array)) { |
if (defined($error)) { |
|
if ($error =~ /^No such file or directory/) { |
|
$r->print("There are no students currently enrolled.\n"); |
|
} else { |
|
$r->print("<pre>ERROR:$error</pre>"); |
|
} |
|
} elsif (!defined(%currentlist)) { |
|
$r->print("There are no students currently enrolled.\n"); |
$r->print("There are no students currently enrolled.\n"); |
} else { |
} else { |
&show_class_list($r,'csv',%currentlist); |
&show_class_list($r,'csv','nolink',$student_array,$student_data); |
} |
} |
} |
} |
|
|
# =================================================== Show student list to drop |
# =================================================== Show student list to drop |
sub show_class_list { |
sub show_class_list { |
my ($r,$mode,%currentlist)=@_; |
my ($r,$mode,$linkto,$students,$student_data)=@_; |
my $cid=$ENV{'request.course.id'}; |
my $cid=$ENV{'request.course.id'}; |
# Print out header |
# Print out header |
if ($mode eq 'view') { |
if ($mode eq 'view') { |
|
if ($linkto eq 'aboutme') { |
|
$r->print('Select a user name to view the users page.'); |
|
} elsif ($linkto eq 'modify') { |
|
$r->print('Select a user name to modify the students information'); |
|
} |
$r->print(<<END); |
$r->print(<<END); |
<p> |
<p> |
<table border=2> |
<table border=2> |
<tr><th>username</th><th>domain</th><th>ID</th> |
<tr><th>username</th><th>domain</th><th>ID</th> |
<th>student name</th><th>generation</th><th>section</th></tr> |
<th>student name</th><th>section</th></tr> |
END |
END |
} elsif ($mode eq 'csv') { |
} elsif ($mode eq 'csv') { |
$r->print(<<END); |
$r->print('"'.join('","',("username","domain","ID","student name", |
username,domain,ID,last name,first name,middle name,generation,section |
"section")).'"'."\n"); |
END |
|
} |
} |
foreach (sort keys %currentlist) { |
foreach my $student (@$students) { |
my ($sname,$sdom)=split(/\:/,$_); |
my $username = $student_data->{$student.':username'}; |
my %reply=&Apache::lonnet::idrget($sdom,$sname); |
my $domain = $student_data->{$student.':domain'}; |
my $ssec=&Apache::lonnet::usection($sdom,$sname,$cid); |
my $section = $student_data->{$student.':section'}; |
my %info=&Apache::lonnet::get('environment', |
my $name = $student_data->{$student.':fullname'}; |
['firstname','middlename', |
my $status = $student_data->{$student.':Status'}; |
'lastname','generation'], |
my $id = $student_data->{$student.':id'}; |
$sdom, $sname); |
next if ($status ne 'Active'); |
my ($tmp) = keys(%info); |
if ($mode eq 'view') { |
if ($tmp =~ /^(con_lost|error|no_such_host)/i) { |
$r->print("<tr>\n <td>\n "); |
$r->print( ($mode eq 'view' ? |
if ($linkto eq 'nothing') { |
'<tr><td colspan="6"><font color="red">' :''). |
$r->print($username); |
'Internal error: unable to get environment '. |
} elsif ($linkto eq 'aboutme') { |
'for '.$sname.' in domain '.$sdom. |
$r->print(&Apache::loncommon::aboutmewrapper($username, |
( $mode eq 'view' ?'</font></td></tr>' :'')); |
$username, |
} else { |
$domain)); |
if ($mode eq 'view') { |
} elsif ($linkto eq 'modify') { |
$r->print(<<"END"); |
$r->print('<a href="/adm/dropadd?action=modifystudent'. |
<tr> |
'&state=selected'.'&sname='.$username. |
<td>$sname</td> |
'&sdom='.$domain.'">'.$username."</a>\n"); |
<td>$sdom</td> |
} |
<td>$reply{$sname}</td> |
$r->print(<<"END"); |
<td>$info{'lastname'}, $info{'firstname'} $info{'middlename'}</td> |
</td> |
<td>$info{'generation'}</td> |
<td>$domain</td> |
<td>$ssec</td> |
<td>$id</td> |
|
<td>$name</td> |
|
<td>$section</td> |
</tr> |
</tr> |
END |
END |
} elsif ($mode eq 'csv') { |
} elsif ($mode eq 'csv') { |
my @line = (); |
# no need to bother with $linkto |
foreach ($sname,$sdom,$reply{$sname}, |
my @line = (); |
$info{'lastname'},$info{'firstname'}, |
foreach ($username,$domain,$id,$name,$section) { |
$info{'middlename'},$info{'generation'},$ssec) { |
push @line,&Apache::loncommon::csv_translate($_); |
push @line,&Apache::loncommon::csv_translate($_); |
|
} |
|
my $tmp = $"; |
|
$" = '","'; |
|
$r->print("\"@line\"\n"); |
|
$" = $tmp; |
|
} |
} |
|
my $tmp = $"; |
|
$" = '","'; |
|
$r->print("\"@line\"\n"); |
|
$" = $tmp; |
} |
} |
} |
} |
$r->print('</table><br>') if ($mode eq 'view'); |
$r->print('</table><br>') if ($mode eq 'view'); |
} |
} |
|
|
|
|
|
# |
|
# print out form for modification of a single students data |
|
# |
|
sub print_modify_student_form { |
|
my $r = shift(); |
|
&Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'}, |
|
['sdom','sname']); |
|
|
|
my $sname = $ENV{'form.sname'}; |
|
my $sdom = $ENV{'form.sdom'}; |
|
# determine the students name information |
|
my %info=&Apache::lonnet::get('environment', |
|
['firstname','middlename', |
|
'lastname','generation'], |
|
$sdom, $sname); |
|
my ($tmp) = keys(%info); |
|
if ($tmp =~ /^(con_lost|error|no_such_host)/i) { |
|
$r->print('<font color="#ff0000" size="+2">Error</font>'. |
|
'<p>'. |
|
'Unable to retrieve environment data for '.$sname. |
|
'in domain '.$sdom.'</p><p>'. |
|
'Please contact your LON-CAPA administrator '. |
|
'regarding this situation.</p></body></html>'); |
|
return; |
|
} |
|
# determine the students starting and ending times and section |
|
my ($starttime,$endtime,$section) = &get_enrollment_data($sname,$sdom); |
|
# Deal with date forms |
|
my $startdateform = &Apache::lonhtmlcommon::date_setter('studentform', |
|
'startdate', |
|
$starttime); |
|
my $enddateform = &Apache::lonhtmlcommon::date_setter('studentform', |
|
'enddate', |
|
$endtime); |
|
# Make sure student is enrolled in course |
|
$r->print(<<END); |
|
<input type="hidden" name="slogin" value="$sname" /> |
|
<input type="hidden" name="sdomain" value="$sdom" /> |
|
<input type="hidden" name="action" value="modifystudent" /> |
|
<input type="hidden" name="state" value="done" /> |
|
<h2>Modify Enrollment for $info{'firstname'} $info{'middlename'} |
|
$info{'lastname'} $info{'generation'}, $sname\@$sdom</h2> |
|
<p> |
|
<b>Student Name</b> |
|
<table> |
|
<tr><th>First</th><th>Middle</th><th>Last</th><th>Generation</th></tr> |
|
<tr><td> |
|
<input type="text" name="firstname" value="$info{'firstname'}" /></td><td> |
|
<input type="text" name="middlename" value="$info{'middlename'}" /></td><td> |
|
<input type="text" name="lastname" value="$info{'lastname'}" /></td><td> |
|
<input type="text" name="generation" value="$info{'generation'}" /></td></tr> |
|
</table> |
|
</p><p> |
|
<b>Section</b>: <input type="text" name="section" value="$section" size="4"/> |
|
</p><p> |
|
<table> |
|
<tr><td align="right"><b>Starting Date:</b></td><td>$startdateform</td></tr> |
|
<tr><td align="right"><b>Ending Date:</b></td><td>$enddateform</td></tr> |
|
</table> |
|
</p> |
|
<input type="submit" value="Submit Modifications" /> |
|
</body></html> |
|
END |
|
return; |
|
} |
|
|
|
# |
|
# modify a single students section |
|
# |
|
sub modify_single_student { |
|
my $r = shift; |
|
# make sure user can modify student data? |
|
my $firstname = $ENV{'form.firstname'}; |
|
my $middlename = $ENV{'form.middlename'}; |
|
my $lastname = $ENV{'form.lastname'}; |
|
my $generation = $ENV{'form.generation'}; |
|
my $section = $ENV{'form.section'}; |
|
my $courseid = $ENV{'request.course.id'}; |
|
my $sname = $ENV{'form.slogin'}; |
|
my $sdom = $ENV{'form.sdomain'}; |
|
my $starttime = &Apache::lonhtmlcommon::get_date_from_form('startdate', |
|
time); |
|
my $endtime = &Apache::lonhtmlcommon::get_date_from_form('enddate', |
|
time); |
|
my $displayable_starttime = localtime($starttime); |
|
my $displayable_endtime = localtime($endtime); |
|
# talk to the user about what we are going to do |
|
$r->print(<<END); |
|
Modifying data for user: $sname \@ $sdom <br /> |
|
<h3>Student Information</h3> |
|
<table> |
|
<tr><td>First name </td><td> $firstname </td></tr> |
|
<tr><td>Middle name </td><td> $middlename </td></tr> |
|
<tr><td>Last name </td><td> $lastname </td></tr> |
|
<tr><td>Generation </td><td> $generation </td></tr> |
|
</table> |
|
<h3>Role Information</h3> |
|
<table> |
|
<tr><td>Section </td><td> $section </td></tr> |
|
<tr><td>Start Time </td><td> $displayable_starttime </td></tr> |
|
<tr><td>End Time </td><td> $displayable_endtime </td></tr> |
|
</table> |
|
END |
|
# send request(s) to modify data |
|
my $roleresults = 'refused'; |
|
#my $roleresults = &Apache::lonnet::assignrole($sdom,$sname, |
|
# $courseid.'/'.$section, |
|
# 'st', |
|
# $endtime,$starttime); |
|
if ($roleresults =~/refused/) { |
|
$r->print("Your request to change the role information for this ". |
|
"student was refused."); |
|
} elsif ($roleresults !~ /ok/) { |
|
$r->print("An error occurred during the attempt to change the role". |
|
" information for this student. The error reported was ". |
|
$roleresults); |
|
} else { # everything is okay! |
|
$r->print("Student role updated successfully."); |
|
} |
|
# |
|
$r->print(<<END); |
|
</body></html> |
|
END |
|
return; |
|
} |
|
|
|
sub get_enrollment_data { |
|
my ($sname,$sdomain) = @_; |
|
my $courseid = $ENV{'request.course.id'}; |
|
$courseid =~ s:_:/:g; |
|
my %roles = &Apache::lonnet::dump('roles',$sdomain,$sname); |
|
my ($tmp) = keys(%roles); |
|
# Bail out if we were unable to get the students roles |
|
return "666" if ($tmp =~ /^(con_lost|error|no_such_host)/i); |
|
# Go through the roles looking for enrollment in this course |
|
my ($end,$start) = (undef,undef); |
|
my $section = ''; |
|
my $count = scalar(keys(%roles)); |
|
while (my ($course,$role) = each(%roles)) { |
|
&Apache::lonnet::logthis('course = '.$course.' role = '.$role); |
|
if ($course=~ /^\/$courseid\/*\s*(\w+)*_st$/ ) { |
|
# |
|
# Get active role |
|
$section=$1; |
|
(undef,$end,$start)=split(/\_/,$role); |
|
my $now=time; |
|
my $notactive=0; |
|
if ($start) { |
|
if ($now<$start) { $notactive=1; } |
|
} |
|
if ($end) { |
|
if ($now>$end) { $notactive=1; } |
|
} |
|
unless ($notactive) { return ($start,$end,$section); } |
|
} |
|
} |
|
return ($start,$end,$section); |
|
} |
|
|
# =================================================== Show student list to drop |
# =================================================== Show student list to drop |
sub show_drop_list { |
sub show_drop_list { |
my ($r,%currentlist)=@_; |
my ($students,$student_data,$r)=@_; |
my $cid=$ENV{'request.course.id'}; |
my $cid=$ENV{'request.course.id'}; |
$r->print(<<'END'); |
$r->print(<<'END'); |
|
<input type="hidden" name="action" value="drop" /> |
|
<input type="hidden" name="state" value="done" /> |
<script> |
<script> |
function checkAll(field) |
function checkAll(field) { |
{ |
|
for (i = 0; i < field.length; i++) |
for (i = 0; i < field.length; i++) |
field[i].checked = true ; |
field[i].checked = true ; |
} |
} |
|
|
function uncheckAll(field) |
function uncheckAll(field) { |
{ |
|
for (i = 0; i < field.length; i++) |
for (i = 0; i < field.length; i++) |
field[i].checked = false ; |
field[i].checked = false ; |
} |
} |
Line 856 function uncheckAll(field)
|
Line 1039 function uncheckAll(field)
|
<input type="hidden" name="phase" value="four"> |
<input type="hidden" name="phase" value="four"> |
<table border=2> |
<table border=2> |
<tr><th> </th><th>username</th><th>domain</th> |
<tr><th> </th><th>username</th><th>domain</th> |
<th>ID</th><th>student name</th><th>generation</th> |
<th>ID</th><th>student name</th><th>section</th></tr> |
<th>section</th></tr> |
|
END |
END |
foreach (sort keys %currentlist) { |
foreach my $student (@$students) { |
my ($sname,$sdom)=split(/\:/,$_); |
my $username = $student_data->{$student.':username'}; |
my %reply=&Apache::lonnet::idrget($sdom,$sname); |
my $domain = $student_data->{$student.':domain'}; |
my $ssec=&Apache::lonnet::usection($sdom,$sname,$cid); |
my $section = $student_data->{$student.':section'}; |
my %info=&Apache::lonnet::get('environment', |
my $name = $student_data->{$student.':fullname'}; |
['firstname','middlename', |
my $status = $student_data->{$student.':Status'}; |
'lastname','generation'], |
my $id = $student_data->{$student.':id'}; |
$sdom, $sname); |
next if ($status ne 'Active'); |
my ($tmp) = keys(%info); |
# |
if ($tmp =~ /^(con_lost|error|no_such_host)/i) { |
$r->print(<<"END"); |
$r->print('<tr><td colspan="7"><font color="red">'. |
|
'Internal error: unable to get environment '. |
|
'for '.$sname.' in domain '.$sdom.'</font></td></tr>'); |
|
} else { |
|
$r->print(<<"END"); |
|
<tr> |
<tr> |
<td><input type="checkbox" name="droplist" value="$_"></td> |
<td><input type="checkbox" name="droplist" value="$student"></td> |
<td>$sname</td> |
<td>$username</td> |
<td>$sdom</td> |
<td>$domain</td> |
<td>$reply{$sname}</td> |
<td>$id</td> |
<td>$info{'lastname'}, $info{'firstname'} $info{'middlename'}</td> |
<td>$name</td> |
<td>$info{'generation'}</td> |
<td>$section</td> |
<td>$ssec</td> |
|
</tr> |
</tr> |
END |
END |
} |
|
} |
} |
$r->print('</table><br>'); |
$r->print('</table><br>'); |
$r->print(<<"END"); |
$r->print(<<"END"); |
Line 893 END
|
Line 1068 END
|
<input type="button" value="uncheck all" onclick="javascript:uncheckAll(document.studentform.droplist)"> |
<input type="button" value="uncheck all" onclick="javascript:uncheckAll(document.studentform.droplist)"> |
<p><input type=submit value="Drop Students"></p> |
<p><input type=submit value="Drop Students"></p> |
END |
END |
|
return; |
} |
} |
|
|
# |
# |
Line 909 sub print_first_courselist_upload_form {
|
Line 1085 sub print_first_courselist_upload_form {
|
"How do I create a CSV file from a spreadsheet"); |
"How do I create a CSV file from a spreadsheet"); |
$r->print(<<ENDUPFORM); |
$r->print(<<ENDUPFORM); |
<input type=hidden name=phase value=two> |
<input type=hidden name=phase value=two> |
<hr> |
|
<h3>Upload a courselist</h3> |
<h3>Upload a courselist</h3> |
$upfile_select |
$upfile_select |
<p><input type=submit name="fileupload" value="Upload Courselist"> |
<p> |
<br /> |
<input type=submit name="fileupload" value="Upload Courselist"> |
|
<input type="hidden" name="action" value="upload" /> |
|
<input type="hidden" name="state" value="got_file" /> |
|
</p> |
$create_classlist_help <br /> |
$create_classlist_help <br /> |
$create_csv_help |
$create_csv_help |
</body></html> |
</body></html> |
Line 1071 sub upfile_drop_add {
|
Line 1249 sub upfile_drop_add {
|
if ($ENV{'form.fullup'} eq 'yes') { |
if ($ENV{'form.fullup'} eq 'yes') { |
$r->print('<h3>Dropping Students</h3>'); |
$r->print('<h3>Dropping Students</h3>'); |
# Get current classlist |
# Get current classlist |
my ($error,%currentlist)=&get_current_classlist |
my ($error,%currentlist)=&get_current_classlist($r); |
($ENV{'course.'.$cid.'.domain'}, |
|
$ENV{'course.'.$cid.'.num'}); |
|
if (defined($error)) { |
if (defined($error)) { |
$r->print('<pre>ERROR:$error</pre>'); |
$r->print('<pre>ERROR:$error</pre>'); |
} |
} |
Line 1096 sub upfile_drop_add {
|
Line 1272 sub upfile_drop_add {
|
} # end of unless |
} # end of unless |
} |
} |
|
|
|
################################################################### |
|
################################################################### |
|
|
|
=pod |
|
|
|
=item &drop_students |
|
|
|
Inputs: \@droplist, a pointer to an array of students to drop. |
|
Students should be in format of studentname:studentdomain |
|
|
|
Returns: $errors, a string describing any errors encountered. |
|
$successes, a string describing the successful dropping of students. |
|
|
|
=cut |
|
|
|
################################################################### |
|
################################################################### |
|
sub drop_students { |
|
my @droplist = @{shift()}; |
|
my $courseid = $ENV{'request.course.id'}; |
|
my $successes = ''; |
|
my $errors = ''; |
|
foreach (@droplist) { |
|
my ($sname,$sdom)=split(/:/,$_); |
|
my $result = &drop_student($sname,$sdom,$courseid); |
|
if ($result !~ /ok/) { |
|
$errors .= "Error dropping $sname\@$sdom: $result\n"; |
|
} else { |
|
$successes .= "Dropped $sname\@$sdom\n"; |
|
} |
|
} |
|
return ($errors,$successes); |
|
} |
|
################################################################### |
|
################################################################### |
|
|
|
|
# ================================================================== Phase four |
# ================================================================== Phase four |
sub drop_student_list { |
sub drop_student_list { |
my $r=shift; |
my $r=shift; |
Line 1121 sub drop_student_list {
|
Line 1334 sub drop_student_list {
|
$r->print('<p>Re-enrollment will re-activate data.'); |
$r->print('<p>Re-enrollment will re-activate data.'); |
} |
} |
|
|
# ================================================================ Main Handler |
################################################################### |
|
################################################################### |
|
|
|
=pod |
|
|
|
=item &handler |
|
|
|
The typical handler you see in all these modules. Takes $r, the |
|
http request, as an argument. |
|
|
|
The response to the request is governed by two form variables |
|
|
|
form.action form.state response |
|
--------------------------------------------------- |
|
undefined undefined print main menu |
|
upload undefined print courselist upload menu |
|
upload got_file deal with uploaded file, |
|
print the upload managing menu |
|
upload enrolling enroll students based on upload |
|
drop undefined print the classlist ready to drop |
|
drop done drop the selected students |
|
enrollstudent undefined print single student enroll menu |
|
enrollstudent enrolling enroll student |
|
classlist undefined print html classlist |
|
classlist csv print csv classlist |
|
modifystudent undefined print classlist to select student to modify |
|
modifystudent selected print modify student menu |
|
modifystudent done make modifications to student record |
|
|
|
=cut |
|
|
|
################################################################### |
|
################################################################### |
sub handler { |
sub handler { |
my $r=shift; |
my $r=shift; |
if ($r->header_only) { |
if ($r->header_only) { |
Line 1130 sub handler {
|
Line 1375 sub handler {
|
return OK; |
return OK; |
} |
} |
&Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'}, |
&Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'}, |
['enroll','drop','view','phase', |
['action','state']); |
'viewcsv','uplist']); |
|
# Needs to be in a course |
# Needs to be in a course |
if (($ENV{'request.course.fn'}) && |
if (! (($ENV{'request.course.fn'}) && |
(&Apache::lonnet::allowed('cst',$ENV{'request.course.id'}))) { |
(&Apache::lonnet::allowed('cst',$ENV{'request.course.id'})))) { |
|
# Not in a course, or not allowed to modify parms |
|
$ENV{'user.error.msg'}= |
|
"/adm/dropadd:cst:0:0:Cannot drop or add students"; |
|
return HTTP_NOT_ACCEPTABLE; |
|
} |
|
# |
|
# Only output the header information if they did not request csv format |
|
# |
|
if (exists($ENV{'form.state'}) && ($ENV{'form.state'} eq 'csv')) { |
|
$r->content_type('text/csv'); |
|
} else { |
# Start page |
# Start page |
$r->content_type('text/html') if (! exists($ENV{'form.viewcsv'})); |
$r->content_type('text/html'); |
$r->send_http_header; |
$r->send_http_header; |
$r->print(&header()) if (! exists($ENV{'form.viewcsv'})); |
$r->print(&header()); |
# Phase one, initial screen |
} |
unless ($ENV{'form.phase'}) { |
# |
&menu_phase_one($r); |
# Main switch on form.action and form.state, as appropriate |
} |
if (! exists($ENV{'form.action'})) { |
# Phase two |
&print_main_menu($r); |
if ($ENV{'form.associate'} eq 'Reverse Association') { |
} elsif ($ENV{'form.action'} eq 'upload') { |
$ENV{'form.phase'} = 'two'; |
if (! exists($ENV{'form.state'})) { |
if ( $ENV{'form.upfile_associate'} ne 'reverse' ) { |
&print_first_courselist_upload_form($r); |
$ENV{'form.upfile_associate'} = 'reverse'; |
} elsif ($ENV{'form.state'} eq 'got_file') { |
} else { |
&print_upload_manager_form($r); |
$ENV{'form.upfile_associate'} = 'forward'; |
} elsif ($ENV{'form.state'} eq 'enrolling') { |
} |
|
} |
|
if ($ENV{'form.phase'} eq 'two') { |
|
if ($ENV{'form.uplist'}) { |
|
&print_first_courselist_upload_form($r); |
|
} elsif ($ENV{'form.fileupload'}) { |
|
&menu_phase_two_upload($r); |
|
} elsif ($ENV{'form.enroll'}) { |
|
&menu_phase_two_enroll($r); |
|
} elsif ($ENV{'form.drop'}) { |
|
&menu_phase_two_drop($r); |
|
} elsif ($ENV{'form.view'}) { |
|
&menu_phase_two_view($r); |
|
} elsif ($ENV{'form.viewcsv'}) { |
|
&menu_phase_two_viewcsv($r); |
|
} |
|
} |
|
# Phase three |
|
if ($ENV{'form.phase'} eq 'three') { |
|
if ($ENV{'form.datatoken'}) { |
if ($ENV{'form.datatoken'}) { |
&upfile_drop_add($r); |
&upfile_drop_add($r); |
|
} else { |
|
# Hmmm, this is an error |
} |
} |
|
} else { |
|
&print_first_courselist_upload_form($r); |
} |
} |
# Phase four |
} elsif ($ENV{'form.action'} eq 'drop') { |
if ($ENV{'form.phase'} eq 'four') { |
if (! exists($ENV{'form.state'})) { |
|
&print_drop_menu($r); |
|
} elsif ($ENV{'form.state'} eq 'done') { |
&drop_student_list($r); |
&drop_student_list($r); |
|
} else { |
|
&menu_phase_two_drop($r); |
} |
} |
# Phase five |
} elsif ($ENV{'form.action'} eq 'enrollstudent') { |
if ($ENV{'form.phase'} eq 'five') { |
if (! exists($ENV{'form.state'})) { |
|
&print_enroll_single_student_form($r); |
|
} elsif ($ENV{'form.state'} eq 'enrolling') { |
&enroll_single_student($r); |
&enroll_single_student($r); |
|
} else { |
|
&print_enroll_single_student_form($r); |
|
} |
|
} elsif ($ENV{'form.action'} eq 'classlist') { |
|
if (! exists($ENV{'form.state'})) { |
|
&print_html_classlist($r); |
|
} elsif ($ENV{'form.state'} eq 'csv') { |
|
&print_csv_classlist($r); |
|
} else { |
|
&print_html_classlist($r); |
} |
} |
# End |
} elsif ($ENV{'form.action'} eq 'modifystudent') { |
$r->print('</form></body></html>') if (! exists($ENV{'form.viewcsv'})); |
if (! exists($ENV{'form.state'})) { |
|
&print_html_classlist($r); |
|
} elsif ($ENV{'form.state'} eq 'selected') { |
|
&print_modify_student_form($r); |
|
} elsif ($ENV{'form.state'} eq 'done') { |
|
&modify_single_student($r); |
|
} else { |
|
&print_html_classlist($r); |
|
} |
} else { |
} else { |
# Not in a course, or not allowed to modify parms |
# We should not end up here, but I guess it is possible |
$ENV{'user.error.msg'}= |
&Apache::lonnet::logthis("Undetermined state in londropadd.pm. ". |
"/adm/dropadd:cst:0:0:Cannot drop or add students"; |
"form.action = ".$ENV{'form.action'}. |
return HTTP_NOT_ACCEPTABLE; |
"Someone should fix this."); |
|
&print_main_menu($r); |
|
} |
|
# |
|
# Finish up |
|
if (exists($ENV{'form.state'}) && ($ENV{'form.state'} eq 'csv')) { |
|
$r->print("\n"); |
|
} else { |
|
$r->print('</form></body></html>'); |
} |
} |
return OK; |
return OK; |
} |
} |
|
|
|
################################################################### |
|
################################################################### |
|
|
1; |
1; |
__END__ |
__END__ |
|
|
|
|