--- loncom/interface/lonblockingmenu.pm 2011/12/28 22:09:44 1.2
+++ loncom/interface/lonblockingmenu.pm 2021/01/02 21:07:36 1.29
@@ -1,8 +1,8 @@
# The LearningOnline Network with CAPA
-# Routines for configuring blocking to collaborative functions, and specific
-# resources during an exam
+# Routines for configuring blocking of access to collaborative functions,
+# and specific resources during an exam
#
-# $Id: lonblockingmenu.pm,v 1.2 2011/12/28 22:09:44 raeburn Exp $
+# $Id: lonblockingmenu.pm,v 1.29 2021/01/02 21:07:36 raeburn Exp $
#
# Copyright Michigan State University Board of Trustees
#
@@ -26,7 +26,7 @@
#
# http://www.lon-capa.org/
#
-###############################################################
+##############################################################
##############################################################
=pod
@@ -44,25 +44,401 @@ lonblockingmenu provides an interface fo
This module is used to configure blocking of access to collaborative tools
and/or resources during an exam.
+=head1 OVERVIEW
+
+To support high-stakes testing, LON-CAPA provides Coordinators with the
+ability to disable communication and collaborative features within the
+system for the duration of an exam.
+
+Features which can be disabled include:
+(a) those which a student could use to communicate with another student.
+Messaging, discussion, chat, blogs, and some functionality in groups fall
+into this category.
+(b) those which a student could use to access materials prepared by the
+student in advance of an exam, (e.g., for use during an online exam, to
+gain an unfair advantage). Blogs and portfolio fall into this category.
+(c) those which a student could use to display or save content within
+the course itself (outside the exam folder). Printouts and resources
+fall into this category.
+
+For communication blocking to be truly effective in preventing unwanted
+communication, or access to online materials, online testing needs to
+take place in a lab setting where use of tools outside LON-CAPA, and use
+of web sites beyond LON-CAPA are unavailable.
+
+Access to specified folder(s) and/or resources in the course contents
+can be restricted for the duration of an exam.
+
+Exam blocks are of two types:
+(a) Blocks with a defined start and end date.
+(b) Blocks associated with a timed interval set for a specific folder,
+or resource.
+
+When a student attempts to use a collaboration or communication feature
+which is currently blocked, information will be available about the
+duration of the block, and the identity of the Course Coordinator who
+set the block.
+
+Although LON-CAPA communication can be blocked during an exam, course
+personnel with the 'evb' (evade blocking) privilege will continue to
+receive LON-CAPA messages sent from students in a course with an active
+block on messaging. Students will not be able to view messages sent by
+other students in the same course for the duration of the blocking event.
+
+Because students may be enrolled in more than one LON-CAPA course at a time
+it is important to use reasonable time windows for blocking events, or, in
+the case of blocks triggered by clicking a button to start a timed quiz,
+quiz durations that are of limited duration. This is especially important
+when blocking prtfolio access, as other courses may require students to use
+the portfolio as a mechanism for submitting assignments.
+
+Information about blocks in a course will be cached for 10 minutes, so,
+as with parameters set for resources, it can take up to 10 minutes for
+new blocks, or changes to existing blocks, to propagate to other servers.
+
+Changes to existing blocks on the server hosting your current session
+are available immediately, as cached data on blocks is devalidated
+automatically on the current server whenever a change is made to a
+block (including deletion), or when a new block is added.
+
=head1 INTERNAL SUBROUTINES
=over
+=item &get_permission()
+
+Returns information about permission user has to set/modify exam
+blocking events.
+
+Inputs: None
+
+Outputs: 2
+ $readonly - true if modification of blocking events is prohibited.
+
+ $allowed - true if blocking events information can be shown.
+
+
+=item &get_timed_items()
+
+Provides perl data structure with information about timed interval
+parameters set in a course.
+
+Inputs: 2 (optional)
+ $cdom - course's domain
+
+ $cnum - course's ID
+
+Output: 1 Hash
+ nested hashes containing information about timed interval
+ parameters in course). Top level keys are type: course,
+ map, resource. Next inner keys are map or symb. Next
+ inner keys are scope (all, section, group, users).
+ Values are interval (in seconds).
+
=item &blockstore()
+Stores changes to exam blocks in comm_block.db file for course.
+Processes deletions, modifications and additions.
+
+Inputs: 4
+ $r = request object
+
+ $crstype - Container type: Course or Community.
+
+ $blockcount - Total number of blocking events in course.
+
+ $currblockrecs - Ref to hash of current blocks in course.
+
+Outputs: 2
+ $changestotal - Total number of changes made.
+
+ $output - Information about changes made.
+
+
=item &get_dates_from_form()
+Extract start and end dates from web form input for blocks with
+defined start/end time.
+
+Inputs: 1 - $item - numeric ID of current block.
+
+Outputs: 2 - $startdate, $enddate (UNIX times for start and end times
+ for blocks with defined start/end
+
+
=item &get_blockdates()
+Retrieves contents of comm_block.db file for a course.
+
+Inputs: 1 - $records - reference to hash to contain blocks
+
+Outputs: 1 - $blockcount - number of blocks
+
+Side Effects: populates records hashref.
+
+
=item &get_block_choices()
+Extract information from web form about which communication/
+collaboration features are to be blocked, for a particular event,
+and also which content areas will have access blocked for the
+duration of the block.
+
+Inputs: 3
+ - $item - numeric ID of current block
+
+ - $map_ref - reference to hash mapping numeric IDs to map urls
+
+ - $symb_ref - reference to hash mapping numeric IDs to symbs
+
+Outputs: 2
+ - $blocktypes - reference to hash of features to be blocked
+
+ - $blockdocs - boolean - 0 if no blocking of content, 1 if blocking
+ of content access
+
+
+=item &check_release_required()
+
+Update LON-CAPA version requirements for course if blocked items
+(content) or blocking type (triggered by student starting timer)
+require specific LON-CAPA version (i.e., 2.11).
+
+Inputs: 3 - $value - type of constraint (currently: 'docs', 'printout' or 'timer'),
+ $chomemajor - course's home server LON-CAPA major version number.
+ $chomeminor - course's home server LON-CAPA minor version number.
+
+Outputs: 2 - status ('ok' or 'fail') and LON-CAPA version needed.
+
+=over
+
+ A status of 'fail' will be returned if the
+ LON-CAPA version installed on the course's
+ home server is older than the version
+ requirement for the blocking type.
+ For a trigger type event, the requested
+ blocking event will not be added if
+ the course's home server version is old to
+ support that type of block.
+
+=back
+
+Side Effects: &update_released_required() called in lonnet, if
+ course's home server version is requied version or
+ newer; will update version requirements for course to
+ a more recent version requirement than currently in
+ effect.
+
+
=item &display_blocker_status()
+Generates web form elements used to display, cancel, or modify
+existing blocking events.
+
+Inputs: 8
+ - $r - Apache request object
+
+ - $records - Reference to hash of current blocks
+
+ - $ltext - Reference to hash of phrases (localized)
+
+ - $intervals - Reference to hash of parameters for timed intervals
+
+ - $navmap - navmaps object.
+
+ - $errormsg - error message for display, if navmaps object
+ could not be instantiated
+
+ - $blockcount - number of existing blocking events in course
+
+ - $readonly - if true, modification not allowed.
+
+
+Output: None
+
+Side Effects: prints web form elements (in a table) for current blocks.
+
+=item &convlim()
+
+Convert a time interval used for a timed quiz (in seconds) to
+days, hours. minutes and seconds.
+
+Inputs: 1 - $timelimit - time interval in seconds
+
+Outputs: 1 - $output - time in format: DD days, HH hours, MM minutes, SS seconds
+
+
=item &display_addblocker_table()
+Generate web form elements used to define a new blocking event.
+
+Inputs: 6
+ - $r - Apache resource object
+
+ - $parmcount - current ID for block (same as number of current blocks,
+ block IDs in web form have zero-based index)
+
+ - $ltext - reference to hash of phrases (localized)
+
+ - $intervals - Reference to hash of parameters for timed intervals
+
+ - $navmap - navmaps object
+
+ - $errormsg - error message for display, if navmaps object
+ could not be instantiated
+
+Outputs: None
+
+Side Effects: prints web form elements (in a table) for adding a new block.
+
+
+=item &blocker_checkboxes()
+
+Generates web form elements in a table for checkboxes used to indicate
+which types of communication/collaboration and/or content should be blocked.
+
+Inputs: 4
+ - $parmcount - numeric ID of current block
+
+ - $blocks - reference to hash of functionalities to block
+
+ - $jschg - text of javascript call to execute when checkbox clicked
+ use within a box via 'onclick="$jchg"'
+
+ - $lookups - reference to hash to map urls or symbs to numeric IDs
+ used to populate hodden form elements containing list
+ of resources and folders with access blocking currently set.
+
+Output: 1 - HTML for table of checkboxes for current block
+
+
+=item &create_interval_form()
+
+Creates web form elements used to select one of the defined timed interval
+items in the course for use in an exam block of type: "Triggered by
+Activating Timer".
+
+Inputs: 8 (four required, last four optional)
+ - $intervals - Reference to hash of parameters for timed intervals
+
+ - $parmcount - numeric ID of current block
+
+ - $navmap - navmaps object
+
+ - $context - this will be "accesstimes" if called by lonaccesstimes.pm,
+ or "blocking" if called internally by lonblockingmenu.pm
+
+ - $currkey - current interval (where this is a block already using
+ an interval-based trigger).
+
+ - $jschg - text of javascript call to execute when radiobutton clicked
+ use within a box via 'onclick="$jchg"'
+
+ - $itemname - name/scope of current interval used for this block
+
+ - $iteminfo - Expandable/collapsible block showing which users are
+ able to activate the timer using the current trigger item.
+
+Outputs: 1 - $intervalform - web form elements used to select a time interval
+
+
+=item &interval_details()
+
+Creates name/scope of current interval and expandable/collapsible
+showing which interval parameters apply to the current folder/resource
+
+Inputs: 6
+
+ - $item - course, map url, or resource symb
+
+ - $type - course, map, or resource
+
+ - $url - url of item (null if item is course).
+
+ - $navmap - navmaps object
+
+ - $intervals - Reference to hash of parameters for timed intervals
+
+ - $parmcount - unique ID for current element.
+
+
+Outputs: 2
+
+ - $itemname - name/scope of interval (timer) parameter
+
+ - $iteminfo - Expandable/collapsible block showing which interval
+ (timer) parameters affect the current folder or resource.
+
+
+=item &trigger_details_toggle()
+
+Creates link used to expand item showing information about timer for current
+trigger for exam block.
+
+Inputs: 1 - $parmcount - numericID of exam block in web form.
+
+Outputs: 1 - returns HTML for link to display contents of information item
+
+
+=item &show_timer_path()
+
+Display hierarchy of names of folders/sub-folders containing the current
+item identified as an item with an interval timer set.
+
+Inputs: 3
+ - $type - map or resource
+
+ - $item - map URL or resource symb
+
+ - $navmap - navmaps object
+
+Outputs: 1 - HTML containing hierarchy of folders/subfolders (raquo entity separated).
+
+
=item &blocktype_text()
-=back
+Inputs: None
+
+Output: 2
+ - $typeorder - reference to array of blockable communication/collaboration/content
+
+ - $types -reference to hash of descriptions (localized) of blockable types.
+
+
+=item &blockingmenu_javascript()
+
+Create Javascript used to launch pop-up used for content selection, and to
+toggle visibility of a number of expandable/collapsible divs.
+
+Inputs: 1 - $blockcount - Total number of blocks in course's comm_block.db
+ database file.
+
+Output: 1 - Javascript (with tags) for functions used to:
+ (a) launch pop-up window for selection of course content to which
+ access could be blocked.
+ (b) toggle visibility of a number of divs:
+
+=over
+
+=item * for block type - defined dates or timer activated
+
+=item * for action to take -- add or modify block
+
+=back
+
+
+=item &details_javascript()
+
+Create Javascript to toggle visibility of unordered list item
+containing details about item with timed interval parameter.
+
+Inputs: none
+
+Output: 1 Javascript (with tags) for functions used to:
+ toggle visibility of unordered list for display of detailed
+ information about intervals.
+
+=back
=cut
@@ -73,11 +449,16 @@ use Apache::lonnet;
use Apache::Constants qw(:common :http);
use Apache::loncommon();
use Apache::lonhtmlcommon();
+use Apache::lonparmset();
+use Apache::loncourserespicker();
use HTML::Entities();
use Apache::lonlocal;
use lib '/home/httpd/lib/perl/';
use LONCAPA qw(:DEFAULT :match);
+my $registered_cleanup;
+my $modified_courses;
+
sub handler {
my $r=shift;
@@ -98,18 +479,73 @@ sub handler {
# ----------------------------------------------------------- Permissions check
- unless ((!&Apache::lonnet::allowed('dcm',$env{'request.course.id'})) ||
- (!&Apache::lonnet::allowed('dcm',$env{'request.course.id'}.
- '/'.$env{'request.course.sec'}))) {
+ my ($readonly,$allowed) = &get_permission();
+ unless ($allowed) {
+ $env{'user.error.msg'}=
+ "/adm/setblock:dcm:0:0:Cannot view/set blocking of communications in a course";
return HTTP_NOT_ACCEPTABLE;
}
# -----------------------------Get action and calling context from query string
- &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},['action','caller']);
+ $registered_cleanup=0;
+ @{$modified_courses}=();
+
+ &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
+ ['action','caller','block']);
+
+ my $crstype = &Apache::loncommon::course_type();
+ my $action = $env{'form.action'};
+ my %records = ();
+ my $blockcount = 0;
+
+# ------------------------------------------------------ Retrieve current blocks
+ $blockcount = &get_blockdates(\%records);
+
+# -------------------- Generate display for pop-up of Maps and Resources blocked
+ if ($action eq 'showdocs') {
+ my ($navmap,$errormsg) =
+ &Apache::loncourserespicker::get_navmap_object($crstype,'examblock');
+ if (ref($navmap)) {
+ my (%blockedmaps,%blockedresources);
+ if ($env{'form.block'} =~ /^\d+$/) {
+ my @currblocks = sort(keys(%records));
+ my $block = $currblocks[$env{'form.block'}];
+ if (($block ne '') && (ref($records{$block}) eq 'HASH')) {
+ if (ref($records{$block}{'blocks'}) eq 'HASH') {
+ if (ref($records{$block}{'blocks'}{'docs'}) eq 'HASH') {
+ if (ref($records{$block}{'blocks'}{'docs'}{'maps'}) eq 'HASH') {
+ %blockedmaps = %{$records{$block}{'blocks'}{'docs'}{'maps'}};
+ }
+ if (ref($records{$block}{'blocks'}{'docs'}{'resources'}) eq 'HASH') {
+ %blockedresources = %{$records{$block}{'blocks'}{'docs'}{'resources'}};
+ }
+ }
+ }
+ }
+ }
+ $r->print(&Apache::loncourserespicker::create_picker($navmap,
+ 'examblock','resourceblocks',$crstype,
+ \%blockedmaps,\%blockedresources,
+ $env{'form.block'},'','',undef,undef,$readonly));
+ } else {
+ $r->print($errormsg);
+ }
+ return OK;
+ }
-# ----------------------------------------------------------------- Breadcrumbs
+# -------------------------- Store changes and retrieve latest block information
+ my $storeresult;
+ unless ($readonly) {
+ if ($env{'form.action'} eq 'store') {
+ (my $numchanges,$storeresult) = &blockstore($r,$crstype,$blockcount,\%records);
+ if ($numchanges > 0) {
+ $blockcount = &get_blockdates(\%records);
+ }
+ }
+ }
+# ------------------------------------------------------------------ Breadcrumbs
&Apache::lonhtmlcommon::clear_breadcrumbs();
if ($env{'form.caller'} eq 'email') {
&Apache::lonhtmlcommon::add_breadcrumb
@@ -123,78 +559,211 @@ sub handler {
}
&Apache::lonhtmlcommon::add_breadcrumb
({href=>'/adm/setblock',
- text=>'Blocking communication/resource access'});
+ text=>'Blocking communication/content access'});
- $r->print(&Apache::loncommon::start_page('Blocking communication/resource access').
- &Apache::lonhtmlcommon::breadcrumbs('Blocking communication/resource access'));
+ my $js = &blockingmenu_javascript($blockcount).
+ &details_javascript();
-# ----------------------------------------------------------- Permissions check
+ $r->print(
+ &Apache::loncommon::start_page('Blocking communication/content access',$js).
+ &Apache::lonhtmlcommon::breadcrumbs('Blocking communication/content access'));
my $usertype;
- my $crstype = &Apache::loncommon::course_type();
if ($crstype eq 'Community') {
$usertype = 'members';
} else {
$usertype = 'students';
}
my $lctype = lc($crstype);
- my %lt=&Apache::lonlocal::texthash(
- 'cbds' => 'Communication blocking during scheduled exams',
- 'desc' => "You can use communication blocking to prevent $usertype enrolled in this $lctype from displaying LON-CAPA messages sent by other $usertype during an online exam. As blocking of communication could potentially interrupt legitimate communication between $usertype who are also both enrolled in a different LON-CAPA course or community, please be careful that you select the correct start and end times for your scheduled exam when setting or modifying these parameters.",
- 'mecb' => 'Modify existing communication blocking periods',
- 'ncbc' => 'No communication blocks currently saved',
- 'stor' => 'Save',
+ my %lt=&Apache::lonlocal::texthash (
+ 'cbds' => 'Blocking communication and/or content access during exams',
+ 'prev' => "For the duration of an exam, or a timed quiz, students in this course can be prevented from:",
+ 'flow' => "For the duration of an exam, or a timed quiz, event-driven interruptions to a student's workflow can be suppressed:",
+ 'blca' => "Blocks can potentially interrupt legitimate communication between $usertype who are also both enrolled in a different LON-CAPA $lctype.",
+ 'pobl' => "Portfolio blocking can impact a student's ability to complete assignments in courses besides your own. Please use this feature wisely.",
+ 'actt' => "Action to take:",
+ 'addn' => 'Add new blocking event',
+ 'mexb' => 'Modify existing blocking event(s)',
+ 'ncbc' => 'There are no blocking events currently saved.',
+ 'stor' => 'Save',
);
my %ltext = &Apache::lonlocal::texthash(
- 'dura' => 'Duration',
+ 'type' => 'Type',
+ 'defs' => 'Defined Start/End',
+ 'trig' => 'Triggered by Activating Timer',
'setb' => 'Set by',
'even' => 'Event',
'blck' => 'Blocked?',
- 'actn' => 'Action',
'star' => 'Start',
- 'endd' => 'End'
+ 'endd' => 'End',
+ 'chda' => 'Choose dates',
+ 'chtr' => 'Choose trigger',
+ 'when' => 'When using defined start/end times for an event, please set dates carefully.',
+ 'yes' => 'Yes',
+ 'no' => 'No',
);
$r->print('
'.$lt{'cbds'}.'
');
+# ---------------------------------------------------- Get Time Limit parameters
+ my %intervals = &get_timed_items();
+
+# -------------------------------------------- Display information about changes
if ($env{'form.action'} eq 'store') {
- &blockstore($r);
+ $r->print($storeresult);
+ } else {
+ $r->print(
+ $lt{'prev'}.
+ '
'."\n".
+ '
'.&mt("displaying LON-CAPA messages sent by other $usertype in the $lctype").'
'."\n".
+ '
'.&mt("displaying or posting to LON-CAPA discussion boards or live chat in the $lctype").'
'."\n".
+ '
'.&mt('accessing content in LON-CAPA portfolios, blogs, or user information pages').'
'."\n".
+ '
'.&mt("generating printouts of $lctype content").'
'.
+ '
'.&mt("displaying the LON-CAPA gradebook in the $lctype").'
'.
+ '
'.&mt("searching $lctype content by keyword").'
'.
+ '
'.&mt("accessing $lctype content in specified folders or resources").'
'.
+ '
'.&mt("changing user's own password").'
'.
+ '
'.
+ $lt{'flow'}.
+ '
'."\n".
+ '
'.&mt("re-initialization of cached course structure, when a change has been made to $lctype content by a Coordinator").'
'.
+ '
'.&mt('display of Critical Messages when navigation arrows used to move to the adjacent resource').'
'.
+ '
'.
+ '
'.$lt{'blca'}.' '.$lt{'pobl'}.'
'
+ );
}
- $r->print($lt{'desc'}.'
-
-$end_page
END
-
- $r->print(&Apache::loncommon::end_page());
+ }
+ $r->print(''.
+ &Apache::loncommon::end_page());
return OK;
}
+sub get_permission {
+ my %permission;
+ my $allowed = 0;
+ my $readonly = 0;
+ return ($readonly,$allowed) unless ($env{'request.course.id'});
+ if ((&Apache::lonnet::allowed('dcm',$env{'request.course.id'})) ||
+ (&Apache::lonnet::allowed('dcm',$env{'request.course.id'}.'/'.
+ $env{'request.course.sec'}))) {
+ $allowed = 1;
+ } elsif ((&Apache::lonnet::allowed('vcb',$env{'request.course.id'})) ||
+ (&Apache::lonnet::allowed('vcb',$env{'request.course.id'}.'/'.
+ $env{'request.course.sec'}))) {
+ $readonly = 1;
+ $allowed = 1;
+ }
+ return ($readonly,$allowed);
+}
+
+sub get_timed_items {
+ my ($cdom,$cnum) = @_;
+ my ($cid,%intervals);
+ if ($cdom eq '' || $cnum eq '') {
+ $cid = $env{'request.course.id'};
+ $cdom = $env{'course.'.$cid.'.domain'};
+ $cnum = $env{'course.'.$cid.'.num'};
+ } else {
+ $cid = $cdom.'_'.$cnum;
+ }
+ if ($cid eq '') {
+ return %intervals;
+ }
+ my $resourcedata=&Apache::lonparmset::readdata($cnum,$cdom);
+ if (ref($resourcedata) eq 'HASH') {
+ foreach my $key (keys(%{$resourcedata})) {
+ if ($key =~ /^\Q$cid\E(.*)\.0\.interval$/) {
+ my $middle = $1;
+ if ($middle eq '') {
+ $intervals{'course'}{'all'} = $resourcedata->{$key};
+ } elsif ($middle =~ /^\.\[(\w+)\]$/) {
+ $intervals{'course'}{'secgrp'}{$1} = $resourcedata->{$key};
+ } elsif ($middle =~ /^\.\[useropt\:($match_username\:$match_domain)\]$/) {
+ $intervals{'course'}{'users'}{$1} = $resourcedata->{$key};
+ } elsif ($middle =~ /^\.(.+)\Q___(all)\E$/) {
+ my $inner = $1;
+ if ($inner =~ /^\[(\w+)\]\.([^\]]+)$/) {
+ $intervals{'map'}{$2}{'secgrp'}{$1} = $resourcedata->{$key};
+ } elsif ($inner =~ /^\[useropt\:($match_username\:$match_domain)\]\.([^\]]+)$/) {
+ $intervals{'map'}{$2}{'users'}{$1} = $resourcedata->{$key};
+ } else {
+ $intervals{'map'}{$inner}{'all'} = $resourcedata->{$key};
+ }
+ } elsif ($middle =~ /^\.\[(\w+)\]\.([^\]]+)$/) {
+ $intervals{'resource'}{$2}{'secgrp'}{$1} = $resourcedata->{$key};
+ } elsif ($middle =~ /^\.\[useropt\:($match_username\:$match_domain)\]\.([^\]]+)$/) {
+ $intervals{'resource'}{$2}{'users'}{$1} = $resourcedata->{$key};
+ } else {
+ my ($symb) = ($middle =~ /^\.(.+)$/);
+ $intervals{'resource'}{$symb}{'all'} = $resourcedata->{$key};
+ }
+ }
+ }
+ }
+ return %intervals;
+}
+
sub blockstore {
- my $r = shift;
+ my ($r,$crstype,$blockcount,$currblockrecs) = @_;
my %lt=&Apache::lonlocal::texthash(
'tfcm' => 'The following changes were made',
- 'ncwm' => 'No changes were made.'
+ 'ncwm' => 'No changes were made.',
+ 'unna' => 'Unable to retrieve contents of course.',
);
my %adds = ();
my %removals = ();
@@ -202,42 +771,171 @@ sub blockstore {
my $modtotal = 0;
my $canceltotal = 0;
my $addtotal = 0;
+ my $changestotal = 0;
+ my $addtimer = 0;
my %blocking = ();
- $r->print('
';
+ if ($env{'form.blockaction'} eq 'modify') {
+ foreach my $envkey (keys(%env)) {
+ if ($envkey =~ m/^form\.action_(\d+)$/) {
+ if ($env{$envkey} eq 'modify') {
+ $adds{$1} = 1;
+ $removals{$1} = 1;
+ } elsif ($env{$envkey} eq 'cancel') {
+ $cancels{$1} = $1;
+ unless ( defined($removals{$1}) ) {
+ $removals{$1} = 1;
+ $canceltotal ++;
+ }
+ }
+ }
}
+ } elsif ($env{'form.blockaction'} eq 'add') {
+ $adds{$blockcount} = 1;
}
+ my ($navmap,$errormsg) =
+ &Apache::loncourserespicker::get_navmap_object($crstype,'examblock');
+ unless (ref($navmap)) {
+ $output = $lt{'unna'}.' '.$lt{'ncwm'}.'';
+ return ($changestotal,$output);
+ }
+ &Apache::loncourserespicker::enumerate_course_contents($navmap,\%map_url,\%resource_symb,\%titles,'examblock');
+ my $do_releasereq_update;
+ my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
+ my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
+ my $chome = $env{'course.'.$env{'request.course.id'}.'.home'};
+ my $chostname = &Apache::lonnet::hostname($chome);
+ my ($chomemajor,$chomeminor) =
+ split(/\./,&Apache::lonnet::get_server_loncaparev($cdom,$chome));
+
foreach my $key (keys(%removals)) {
my $hashkey = $env{'form.key_'.$key};
- &Apache::lonnet::del('comm_block',["$hashkey"],
- $env{'course.'.$env{'request.course.id'}.'.domain'},
- $env{'course.'.$env{'request.course.id'}.'.num'}
- );
+ if ($hashkey =~ /firstaccess____/) {
+ $do_releasereq_update = 1;
+ }
+ if (ref($currblockrecs->{$hashkey}) eq 'HASH') {
+ if (ref($currblockrecs->{$hashkey}->{'blocks'}) eq 'HASH') {
+ foreach my $type ('docs','printout') {
+ if (exists($currblockrecs->{$hashkey}->{'blocks'}->{$type})) {
+ $do_releasereq_update = 1;
+ }
+ }
+ }
+ }
+ &Apache::lonnet::del('comm_block',["$hashkey"],$cdom,$cnum);
+ }
+ if ($do_releasereq_update) {
+ push(@{$modified_courses},[$cdom,$cnum,$chome,$crstype]);
+ unless ($registered_cleanup) {
+ my $handlers = $r->get_handlers('PerlCleanupHandler');
+ $r->set_handlers('PerlCleanupHandler' => [\&update_releasereq,@{$handlers}]);
+ $registered_cleanup=1;
+ }
}
foreach my $key (keys(%adds)) {
unless ( defined($cancels{$key}) ) {
- my ($newstart,$newend) = &get_dates_from_form($key);
- my $newkey = $newstart.'____'.$newend;
- my $blocktypes = &get_block_choices($key);
- $blocking{$newkey} = {
+ my ($newkey,$status,$needsrelease);;
+ if ($env{'form.firstaccess_'.$key}) {
+ my $interval =
+ &HTML::Entities::decode($env{'form.firstaccess_'.$key});
+ if ($interval ne '') {
+ if ($interval eq 'course') {
+ $newkey = 'firstaccess____'.$interval;
+ } elsif ($interval =~ /___\d+___/) {
+ my ($map,$resid,$url) =
+ &Apache::lonnet::decode_symb($interval);
+ if (&Apache::lonnet::is_on_map($url)) {
+ $newkey = 'firstaccess____'.$interval;
+ }
+ } elsif (&Apache::lonnet::is_on_map($interval)) {
+ $newkey = 'firstaccess____'.$interval;
+ }
+ if ($newkey ne '') {
+ unless (defined($removals{$key})) {
+ ($status,$needsrelease) = &check_release_required('timer',$chomemajor,$chomeminor);
+ if ($status eq 'fail') {
+ $newkey = '';
+ $output .= '
'.
+ &mt('Triggering of blocking events not allowed for [_1]',
+ &escape($env{'form.title_'.$key})).' ';
+ }
+ }
+ }
+ }
+ } else {
+ my ($newstart,$newend) = &get_dates_from_form($key);
+ $newkey = $newstart.'____'.$newend;
+ }
+ if ($status eq 'fail') {
+ $output .= &mt('LON-CAPA version ([_1]) installed on home server ([_2]) does not meet version requirements ([_3] or newer).',
+ $chomemajor.'.'.$chomeminor,$chostname,$needsrelease).'
';
+ }
+ if ($newkey ne '') {
+ my ($blocktypes,$blockdocs) =
+ &get_block_choices($key,\%map_url,\%resource_symb);
+ if (ref($blocktypes) eq 'HASH') {
+ if ($blocktypes->{'printout'} eq 'on') {
+ ($status,$needsrelease) = &check_release_required('printout',$chomemajor,$chomeminor);
+ if ($status eq 'fail') {
+ $blocktypes->{'printout'} = 'off';
+ $output .= '
'.
+ &mt('Printout blocking not allowed for [_1]',
+ &escape($env{'form.title_'.$key})).' ';
+ }
+ }
+ if ($blocktypes->{'alert'} eq 'on') {
+ ($status,$needsrelease) = &check_release_required('alert',$chomemajor,$chomeminor);
+ if ($status eq 'fail') {
+ $blocktypes->{'alert'} = 'off';
+ $output .= '
'.
+ &mt('Message Alert blocking not allowed for [_1]',
+ &escape($env{'form.title_'.$key})).' ';
+ }
+ }
+ if ($blocktypes->{'reinit'} eq 'on') {
+ ($status,$needsrelease) = &check_release_required('reinit',$chomemajor,$chomeminor);
+ if ($status eq 'fail') {
+ $blocktypes->{'reinit'} = 'off';
+ $output .= '
'.
+ &mt('Course Re-initialization blocking not allowed for [_1]',
+ &escape($env{'form.title_'.$key})).' ';
+ }
+ }
+ }
+ if ($blockdocs) {
+ ($status,$needsrelease) = &check_release_required('docs',$chomemajor,$chomeminor);
+ if ($status eq 'fail') {
+ delete($blocktypes->{'docs'});
+ $output .= '