--- loncom/html/adm/helper/newslot.helper 2005/10/11 20:47:02 1.1
+++ loncom/html/adm/helper/newslot.helper 2006/05/16 21:03:42 1.19
@@ -1,99 +1,377 @@
-
-
- Name:
-
+
+ OPTIONAL
+
+
+ if (!exists($helper->{'VARS'}{'name'}) ||
+ $helper->{'VARS'}{'name'} !~ /\S/) {
+ &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'});
+ if (exists($env{'form.name'}) ||
+ $env{'form.name'} =~ /\S/) {
+ $helper->{'VARS'}{'name'}=$env{'form.name'};
+ $helper->{VARS}{'origname'}=$env{'form.name'};
+ $helper->{DATA}{copy} = 1;
+ }
+ }
+ $helper->{DATA}{origslot} = sub {
+ my ($which,$default)=@_;
+ if (!exists($helper->{'VARS'}{'name'}) ||
+ $helper->{'VARS'}{'name'} !~ /\S/) {
+ return $default;
+ }
+ my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
+ my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
+ my $name=$helper->{VARS}{'origname'};
+ my %slot=&Apache::lonnet::get('slots', [$name], $cdom, $cnum);
+ if (!ref($slot{$name})) { return $default; }
+ if (!exists($slot{$name}{$which})) { return $default; }
+ return $slot{$name}{$which};
+ }
+
+
+ Name:
-
+
if ($val=~/^\s*$/) { return 'Must specify a name'; }
- if ($val=~/\s$/) { return 'Must not contain spaces'; }
+ if ($val=~/\s/) { return 'Must not contain spaces'; }
+ if ($val=~/\W/) { return 'Must contain only letters, numbers and _'; }
return undef;
+
+ return $helper->{'VARS'}{'name'};
+
+
+ $helper->{DATA}{copy}
+
+ Changing the Name will create a new slot with the new name, and not rename the existing slot.
+
+
-
Start time:
+
Start time:
-
+
+
+ return &{$helper->{DATA}{origslot}}('starttime');
+
+
-
End time:
+
End time:
-
+
+
+ return &{$helper->{DATA}{origslot}}('endtime');
+
+
+ if ($val < $helper->{'VARS'}{'starttime'}) {
+ return 'End time must be later than the start time.';
+ }
+ return undef;
+
+
-
Type:
+
Type:
Instructor asssignable.
- Student selectable.
+ Student selectable.
- return 'preassigned';
+ return &{$helper->{DATA}{origslot}}('type','preassigned');
+
-
- Time students can start reserving:
-
-
-
-
-
-
IP restrictions:
-
+
Description:
-
-
- return undef;
-
+
+
+ return &{$helper->{DATA}{origslot}}('description');
+
+
+ $helper->{'VARS'}{'type'} eq 'schedulable_student'
+
+
Time students can start reserving:
+
+
+
+ return &{$helper->{DATA}{origslot}}('startreserve','anytime');
+
+
+ if (defined($val) && $val > $helper->{'VARS'}{'starttime'}) {
+ return 'Reservation time must come before the slot has started.';
+ }
+ return undef;
+
+
+
+
Maxium number of students allowed in this slot:
+
+
+
+ if ($val ne '' && $val=~/\D/) { return 'Must be numeric.'; }
+ return undef;
+
+
+ return &{$helper->{DATA}{origslot}}('maxspace');
+
+
+
+
Period of time in which this slot is can only be uniquely chosen:
Start:
+
+
+
+ my $default=&{$helper->{DATA}{origslot}}('uniqueperiod','anytime');
+ if ($default eq 'anytime') { return 'anytime' };
+ if (ref($default)) { return $default->[0]; }
+ return 'anytime';
+
+
+
End:
+
+
+ my $default=&{$helper->{DATA}{origslot}}('uniqueperiod','anytime');
+ if ($default eq 'anytime') { return 'anytime' };
+ if (ref($default)) { return $default->[1]; }
+ return 'anytime';
+
+
+ if (defined($val) && $val < $helper->{'VARS'}{'startunique'}) {
+ return 'End time must be later than the start time.';
+ }
+ return undef;
+
+
+
+
+ $helper->{'VARS'}{'type'} eq 'preassigned'
+
+ delete($helper->{'VARS'}{'startreserve'});
+ delete($helper->{'VARS'}{'maxspace'});
+ delete($helper->{'VARS'}{'startunique'});
+ delete($helper->{'VARS'}{'endunique'});
+
+
-
-
Description:
-
-
-
-
-
-
Maxium number of students allowed in this slot:
-
+
Secret word proctors use to checkin users:
-
+
- if ($val ne '' && $val=~/\D/) { return 'Must be numeric.'; }
return undef;
+
+ return &{$helper->{DATA}{origslot}}('secret');
+
-
-
Period of time in which this slot is can only be uniquely chosen:
Start:
-
-
-
-
End:
-
-
-
-
Slot is:
-
+
Slot is:
- usable for any resource.
+ usable for any resource.
restricted to a specific resource.
- 'any'
+
+ my $default=&{$helper->{DATA}{origslot}}('symb');
+ if ($default) { return 'resource'; }
+ return 'any';
+
-
+
+ IP restrictions:
+
+
+
+ return undef;
+
+
+ return &{$helper->{DATA}{origslot}}('ip');
+
+
+
+
+
+
+ PROCTOR
+
return $res->is_problem()
return $res->symb()
- FINISH
+
+ return &{$helper->{DATA}{origslot}}('symb');
+
-
- fin
+
+
+
+
+ FINISH
+
+
+ $helper->{'VARS'}{'type'} eq 'schedulable_student'
+ RESTRICTUSER
+
+
+
+ No proctor checkin required for access.
+ Require proctored access.
+
+ my $default=&{$helper->{DATA}{origslot}}('proctor');
+ if ($default) { return 'yes'; }
+ return 'no';
+
+
+
+
+
+ my @defaults;
+ my $default=&{$helper->{DATA}{origslot}}('proctor');
+ if ($default) {
+ @defaults=(split(',',$default));
+ }
+ return @defaults;
+
+
+
+
+
+
+ FINISH
+
+ Slots are by default available to all users in a course, if you would like this slot to be restricted to a subset of users you can specify restrictions.
+
+
+
+ Select sections to limit slot availability to:
+
+
+
+ return join('|||',
+ split(',',&{$helper->{DATA}{origslot}}('allowedsections')));
+
+
+
+ Select users to limit slot availability to:
+
+
+
+ return split(',',&{$helper->{DATA}{origslot}}('allowedusers'));
+
+
+
+
+
+
+ Created Slot
+
+
+ my $result;
+ if ($helper->{'STATE'} ne 'FINISH') { return; }
+ my %slot;
+
+ foreach my $which ('type','starttime','endtime') {
+ $slot{$which} = $helper->{'VARS'}{$which};
+ }
+
+ foreach my $which ('ip','description','maxspace','secret','symb') {
+ if ( $helper->{'VARS'}{$which} =~/\S/ ) {
+ $slot{$which} = $helper->{'VARS'}{$which};
+ }
+ }
+
+ if ( $helper->{'VARS'}{'startreserve'} > 0) {
+ $slot{'startreserve'} = $helper->{'VARS'}{'startreserve'};
+ }
+
+ if ( $helper->{'VARS'}{'startunique'} > 0 &&
+ $helper->{'VARS'}{'endunique'} > 0 ) {
+ $slot{'uniqueperiod'} = [$helper->{'VARS'}{'startunique'},
+ $helper->{'VARS'}{'endunique'}];
+ }
+
+ if ( $helper->{'VARS'}{'useproctor'} eq 'yes'
+ && $helper->{'VARS'}{'proctor'} =~/\S/ ) {
+ my @names;
+ # just need the username/domain throw away the other data
+ # that returns
+ foreach my $user (split(/\|\|\|/, $helper->{'VARS'}{'proctor'})) {
+ my ($uname,$udomain)=split(/:/,$user);
+ push(@names,"$uname:$udomain");
+ }
+ # make sure the usernmaes are unique
+ my %proctors = map { ($_,1) } @names;
+ $slot{'proctor'}=join(',',sort(keys(%proctors)));
+ }
+
+ if ( $helper->{'VARS'}{'allowedsections'} =~/\S/ ) {
+ $slot{'allowedsections'}=
+ join(',',sort(split(/\|\|\|/,
+ $helper->{'VARS'}{'allowedsections'})));
+ }
+
+ if ( $helper->{'VARS'}{'allowedusers'} =~/\S/ ) {
+ my @names;
+ # just need the username/domain throw away the other data
+ # that returns
+ foreach my $item (split(/\|\|\|/,
+ $helper->{'VARS'}{'allowedusers'})) {
+ my ($uname,$udomain)=split(/:/,$item);
+ push(@names,"$uname:$udomain");
+ }
+
+ # make sure the choices are unique
+ my %users = map { ($_,1) } @names;
+ $slot{'allowedusers'}=join(',',sort(keys(%users)));
+ }
+
+ my $cname = $env{'course.'.$env{'request.course.id'}.'.num'};
+ my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
+
+ my $ret = &Apache::lonnet::cput('slots',
+ {$helper->{'VARS'}{'name'} => \%slot},
+ $cdom,$cname);
+ $result.="\n ".'Name: '.&HTML::Entities::encode($helper->{'VARS'}{'name'}).''.
+ "\n".' Starts: '.&Apache::lonlocal::locallocaltime($slot{'starttime'}).''.
+ "\n".' Ends: '.&Apache::lonlocal::locallocaltime($slot{'endtime'}).''.
+ "\n".' Type: '.$slot{'type'}.'';
+ my %labels =
+ map {($_->[0],$_->[1])} &Apache::slotrequest::csvupload_fields();
+ foreach my $which ('ip','description','maxspace','secret','symb',
+ 'allowedsections','allowedusers') {
+ if (exists($slot{$which})) {
+ $result.="\n".' '.$labels{$which}.': '.
+ &HTML::Entities::encode($slot{$which}).'';
+ }
+ }
+ if (exists($slot{'startreserve'})) {
+ $result.="\n".' '.$labels{'startreserve'}.': '.
+ &Apache::lonlocal::locallocaltime($slot{'startreserve'}).'';
+ }
+ if (exists($slot{'proctor'})) {
+ my $proctors = $slot{'proctor'};
+ $proctors =~ s/,/, /g;
+ $result.="\n".' '.$labels{'proctor'}.': '.
+ &HTML::Entities::encode($proctors).'';
+ }
+ if (exists($slot{'uniqueperiod'})) {
+ $result.=
+ "\n".' '.$labels{'uniqueperiod'}.': '.
+ &Apache::lonlocal::locallocaltime($slot{'uniqueperiod'}[0]).
+ ', '.
+ &Apache::lonlocal::locallocaltime($slot{'uniqueperiod'}[1]).
+ '';
+ }
+ return $result;
+
+ /adm/slotrequest?command=showslots
+