--- loncom/interface/lonblockingmenu.pm 2016/10/16 21:49:51 1.19 +++ loncom/interface/lonblockingmenu.pm 2024/12/31 19:28:29 1.32 @@ -2,7 +2,7 @@ # Routines for configuring blocking of access to collaborative functions, # and specific resources during an exam # -# $Id: lonblockingmenu.pm,v 1.19 2016/10/16 21:49:51 raeburn Exp $ +# $Id: lonblockingmenu.pm,v 1.32 2024/12/31 19:28:29 raeburn Exp $ # # Copyright Michigan State University Board of Trustees # @@ -116,7 +116,7 @@ Outputs: 2 $readonly - true if modification of blocking events is prohibited. $allowed - true if blocking events information can be shown. - + =item &get_timed_items() @@ -252,7 +252,7 @@ Inputs: 8 - $blockcount - number of existing blocking events in course - $readonly - if true, modification not allowed. - + Output: None @@ -318,13 +318,16 @@ Creates web form elements used to select items in the course for use in an exam block of type: "Triggered by Activating Timer". -Inputs: 7 (three required, last four optional) +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). @@ -339,6 +342,34 @@ Inputs: 7 (three required, last four opt 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 @@ -348,6 +379,7 @@ Inputs: 1 - $parmcount - numericID of ex 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 @@ -392,12 +424,21 @@ Output: 1 - Javascript (with tags) for functions used to: + toggle visibility of unordered list for display of detailed + information about intervals. + +=back =cut @@ -486,7 +527,8 @@ sub handler { $r->print(&Apache::loncourserespicker::create_picker($navmap, 'examblock','resourceblocks',$crstype, \%blockedmaps,\%blockedresources, - $env{'form.block'},'','',undef,$readonly)); + $env{'form.block'},'','',undef,undef,undef, + $readonly)); } else { $r->print($errormsg); } @@ -520,7 +562,8 @@ sub handler { ({href=>'/adm/setblock', text=>'Blocking communication/content access'}); - my $js = &blockingmenu_javascript($blockcount); + my $js = &blockingmenu_javascript($blockcount). + &details_javascript(); $r->print( &Apache::loncommon::start_page('Blocking communication/content access',$js). @@ -536,6 +579,7 @@ sub handler { 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:", @@ -575,19 +619,27 @@ sub handler { '
'.$lt{'blca'}.'
'.$lt{'pobl'}.'