--- loncom/homework/radiobuttonresponse.pm 2007/06/26 10:42:09 1.120
+++ loncom/homework/radiobuttonresponse.pm 2008/11/14 21:27:17 1.137
@@ -1,7 +1,7 @@
# The LearningOnline Network with CAPA
# mutliple choice style responses
#
-# $Id: radiobuttonresponse.pm,v 1.120 2007/06/26 10:42:09 foxr Exp $
+# $Id: radiobuttonresponse.pm,v 1.137 2008/11/14 21:27:17 jms Exp $
#
# Copyright Michigan State University Board of Trustees
#
@@ -18,14 +18,135 @@
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
-# along with LON-CAPA; if not, write to the Free Software
-# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+# along with LON-CAPA; if not, write to the Free Software# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
#
# /home/httpd/html/adm/gpl.txt
#
# http://www.lon-capa.org/
#
+
+=head1 NAME
+
+Apache::radiobuttonresponse
+
+=head1 SYNOPSIS
+
+Handles multiple-choice style responses.
+
+This is part of the LearningOnline Network with CAPA project
+described at http://www.lon-capa.org.
+
+=head1 HANDLER SUBROUTINE
+
+start_radiobuttonresponse()
+
+=head1 OTHER SUBROUTINES
+
+=over
+
+=item *
+
+bubble_line_count()
+
+=item *
+
+end_radiobuttonresponse()
+
+=item *
+
+start_foilgroup()
+
+=item *
+
+storesurvey()
+
+=item *
+
+grade_response()
+
+=item *
+
+end_foilgroup()
+
+=item *
+
+getfoilcounts()
+
+=item *
+
+format_prior_answer()
+
+=item *
+
+displayallfoils()
+
+=item *
+
+&whichfoils($max,$randomize)
+
+Randomizes the list of foils.
+Respects
+ - each foils desire to be randomized
+ - the existance of Concept groups of foils (select 1 foil from each)
+ - and selects a single correct statement from all possilble true statments
+ - and limits it to a toal of $max foils
+
+WARNING: this routine uses the random number generator, it should only
+be called once per target, otherwise it can cause randomness changes in
+homework problems.
+
+Arguments
+ $max - maximum number of foils to select (including the true one)
+ (so a max of 5 is: 1 true, 4 false)
+
+ $randomize - whether to randomize the listing of foils, by default
+ will randomize, only if randomize is 'no' will it not
+
+Returns
+ $answer - location in the array of the correct answer
+ @foils - array of foil names in to display order
+
+=item *
+
+displayfoils()
+
+=item *
+
+displayallanswers()
+
+=item *
+
+displayanswers()
+
+=item *
+
+start_conceptgroup()
+
+=item *
+
+end_conceptgroup()
+
+=item *
+
+insert_conceptgroup()
+
+=item *
+
+start_foil()
+
+=item *
+
+end_foil()
+
+=item *
+
+insert_foil()
+
+=back
+
+=cut
+
package Apache::radiobuttonresponse;
use strict;
use HTML::Entities();
@@ -34,44 +155,51 @@ use Apache::lonnet;
use Apache::response;
my $default_bubbles_per_line = 10;
-my $bubbles_per_line;
-my $bubble_lines = 1;
+
BEGIN {
&Apache::lonxml::register('Apache::radiobuttonresponse',('radiobuttonresponse'));
}
+sub bubble_line_count {
+ my ($numfoils, $bubbles_per_line) = @_;
+ my $bubble_lines;
+ $bubble_lines = int($numfoils / $bubbles_per_line);
+ if (($numfoils % $bubbles_per_line) != 0) {
+ $bubble_lines++;
+ }
+ return $bubble_lines;
+
+}
+
+
sub start_radiobuttonresponse {
my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
my $result;
-
-
#when in a radiobutton response use these
&Apache::lonxml::register('Apache::radiobuttonresponse',('foilgroup','foil','conceptgroup'));
push (@Apache::lonxml::namespace,'radiobuttonresponse');
my $id = &Apache::response::start_response($parstack,$safeeval);
- $bubbles_per_line =
- &Apache::response::get_response_param($Apache::inputtags::part."_$id",
- 'numbubbles',
- $default_bubbles_per_line);
%Apache::hint::radiobutton=();
undef(%Apache::response::foilnames);
if ($target eq 'meta') {
$result=&Apache::response::meta_package_write('radiobuttonresponse');
} elsif ($target eq 'edit' ) {
- $result.=&Apache::edit::start_table($token).
- '