Annotation of loncom/homework/radiobuttonresponse.pm, revision 1.146

1.22      albertel    1: # The LearningOnline Network with CAPA
                      2: # mutliple choice style responses
1.31      albertel    3: #
1.146   ! raeburn     4: # $Id: radiobuttonresponse.pm,v 1.145 2010/05/03 14:43:50 onken Exp $
1.31      albertel    5: #
                      6: # Copyright Michigan State University Board of Trustees
                      7: #
                      8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      9: #
                     10: # LON-CAPA is free software; you can redistribute it and/or modify
                     11: # it under the terms of the GNU General Public License as published by
                     12: # the Free Software Foundation; either version 2 of the License, or
                     13: # (at your option) any later version.
                     14: #
                     15: # LON-CAPA is distributed in the hope that it will be useful,
                     16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     18: # GNU General Public License for more details.
                     19: #
                     20: # You should have received a copy of the GNU General Public License
1.130     foxr       21: # along with LON-CAPA; if not, write to the Free Software# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
1.31      albertel   22: #
                     23: # /home/httpd/html/adm/gpl.txt
                     24: #
                     25: # http://www.lon-capa.org/
                     26: #
1.1       albertel   27: 
1.137     jms        28: 
                     29: 
1.1       albertel   30: package Apache::radiobuttonresponse;
                     31: use strict;
1.42      albertel   32: use HTML::Entities();
1.85      albertel   33: use Apache::lonlocal;
1.100     albertel   34: use Apache::lonnet;
1.115     foxr       35: use Apache::response;
1.1       albertel   36: 
1.120     foxr       37: my $default_bubbles_per_line = 10;
1.121     foxr       38: 
1.116     foxr       39: 
1.36      harris41   40: BEGIN {
1.83      albertel   41:     &Apache::lonxml::register('Apache::radiobuttonresponse',('radiobuttonresponse'));
1.1       albertel   42: }
                     43: 
1.121     foxr       44: sub bubble_line_count {
                     45:     my ($numfoils, $bubbles_per_line) = @_;
                     46:     my $bubble_lines;
                     47:     $bubble_lines = int($numfoils / $bubbles_per_line);
                     48:     if (($numfoils % $bubbles_per_line) != 0) {
                     49: 	$bubble_lines++;
                     50:     }
                     51:     return $bubble_lines;
                     52:     
                     53: }
                     54: 
                     55: 
1.1       albertel   56: sub start_radiobuttonresponse {
1.83      albertel   57:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
                     58:     my $result;
1.115     foxr       59: 
1.83      albertel   60:     #when in a radiobutton response use these
                     61:     &Apache::lonxml::register('Apache::radiobuttonresponse',('foilgroup','foil','conceptgroup'));
                     62:     push (@Apache::lonxml::namespace,'radiobuttonresponse');
                     63:     my $id = &Apache::response::start_response($parstack,$safeeval);
1.120     foxr       64: 
1.83      albertel   65:     %Apache::hint::radiobutton=();
1.85      albertel   66:     undef(%Apache::response::foilnames);
1.83      albertel   67:     if ($target eq 'meta') {
                     68: 	$result=&Apache::response::meta_package_write('radiobuttonresponse');
                     69:     } elsif ($target eq 'edit' ) {
1.136     bisitz     70: 	$result.=&Apache::edit::start_table($token)
                     71:            .'<tr><td>'.&Apache::lonxml::description($token)
                     72:            .&Apache::loncommon::help_open_topic('Radio_Response_Problems')
                     73:            .'</td>'
                     74:            .'<td><span class="LC_nobreak">'.&mt('Delete?').' '
                     75:            .&Apache::edit::deletelist($target,$token)
                     76:            .'</span></td>'
1.140     raeburn    77:            .'<td>&nbsp;'.&Apache::edit::end_row()
1.136     bisitz     78:            .&Apache::edit::start_spanning_row();
1.83      albertel   79: 	$result.=
                     80: 	    &Apache::edit::text_arg('Max Number Of Shown Foils:','max',
1.141     raeburn    81: 				    $token,'4').'&nbsp;'x 3 .
1.136     bisitz     82: 	    &Apache::edit::select_arg('Randomize Foil Order:','randomize',
1.141     raeburn    83: 				      ['yes','no'],$token).'&nbsp;'x 3 .
                     84: 	    &Apache::edit::select_arg('Display Direction:','direction',
1.103     albertel   85: 				      ['vertical','horizontal'],$token).
1.83      albertel   86: 				      &Apache::edit::end_row().
                     87: 				      &Apache::edit::start_spanning_row()."\n";
                     88:     } elsif ($target eq 'modified') {
                     89: 	my $constructtag=&Apache::edit::get_new_args($token,$parstack,
                     90: 						     $safeeval,'max',
1.103     albertel   91: 						     'randomize','direction');
1.83      albertel   92: 	if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); }
                     93:     } elsif ($target eq 'tex') {
                     94: 	my $type=&Apache::lonxml::get_param('TeXtype',$parstack,$safeeval,
                     95: 					    undef,0);
                     96: 	if ($type eq '1') {
                     97: 	    $result .= ' \renewcommand{\labelenumi}{\arabic{enumi}.}';
                     98: 	} elsif ($type eq 'A') {
                     99: 	    $result .= ' \renewcommand{\labelenumi}{\Alph{enumi}.}';
                    100: 	} elsif ($type eq 'a') {
                    101: 	    $result .= ' \renewcommand{\labelenumi}{\alph{enumi}.}';
                    102: 	} elsif ($type eq 'i') {
                    103: 	    $result .= ' \renewcommand{\labelenumi}{\roman{enumi}.}';
1.88      albertel  104: 	} else {
                    105: 	    $result .= ' \renewcommand{\labelenumi}{\Alph{enumi}.}';
1.83      albertel  106: 	}
1.143     onken     107:         if($env{'form.pdfFormFields'} eq 'yes' && $Apache::inputtags::status[-1] eq 'CAN_ANSWER') {
1.145     onken     108:             $result .= '\begin{itemize}';
1.135     onken     109:         } else {
                    110:             $result .= '\begin{enumerate}';
                    111:         }
1.83      albertel  112:     } elsif ($target eq 'analyze') {
                    113: 	my $part_id="$Apache::inputtags::part.$id";
1.131     raeburn   114:         $Apache::lonhomework::analyze{"$part_id.type"} = 'radiobuttonresponse';
1.83      albertel  115: 	push (@{ $Apache::lonhomework::analyze{"parts"} },$part_id);
                    116:     }
                    117:     return $result;
1.1       albertel  118: }
                    119: 
                    120: sub end_radiobuttonresponse {
1.83      albertel  121:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
                    122:     my $result;
                    123:     if ($target eq 'edit') { $result=&Apache::edit::end_table(); }
1.145     onken     124:     if ($target eq 'tex' ) {
                    125:         if($env{'form.pdfFormFields'} eq 'yes' and $Apache::inputtags::status[-1] eq 'CAN_ANSWER') {
                    126:             $result .= '\end{itemize}';
                    127:         } else {
                    128:             $result .= '\end{enumerate}';
                    129:         }
1.135     onken     130:     }
1.83      albertel  131:     &Apache::response::end_response;
                    132:     pop @Apache::lonxml::namespace;
                    133:     &Apache::lonxml::deregister('Apache::radiobuttonresponse',('foilgroup','foil','conceptgroup'));
1.85      albertel  134:     undef(%Apache::response::foilnames);
1.83      albertel  135:     return $result;
1.1       albertel  136: }
                    137: 
1.43      albertel  138: %Apache::response::foilgroup=();
1.1       albertel  139: sub start_foilgroup {
1.83      albertel  140:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
                    141:     my $result;
                    142:     %Apache::response::foilgroup=();
                    143:     $Apache::radiobuttonresponse::conceptgroup=0;
1.89      albertel  144:     &Apache::response::pushrandomnumber();
1.83      albertel  145:     if ($target eq 'tex' && $Apache::lonhomework::type eq 'exam') {
                    146: 	$result.='\item[\textbf{'.$Apache::lonxml::counter.'}.]';
                    147:     }
                    148:     return $result;
1.5       albertel  149: }
                    150: 
1.15      albertel  151: sub storesurvey {
1.144     raeburn   152:     my ($style) = @_;
1.99      albertel  153:     if ( !&Apache::response::submitted() ) { return ''; }
1.100     albertel  154:     my $response = $env{'form.HWVAL_'.$Apache::inputtags::response['-1']};
1.83      albertel  155:     &Apache::lonxml::debug("Here I am!:$response:");
                    156:     if ( $response !~ /[0-9]+/) { return ''; }
1.96      albertel  157:     my $part = $Apache::inputtags::part;
1.83      albertel  158:     my $id = $Apache::inputtags::response['-1'];
                    159:     my @whichfoils=@{ $Apache::response::foilgroup{'names'} };
                    160:     my %responsehash;
                    161:     $responsehash{$whichfoils[$response]}=$response;
1.96      albertel  162:     my $responsestr=&Apache::lonnet::hash2str(%responsehash);
                    163:     $Apache::lonhomework::results{"resource.$part.$id.submission"}=
                    164: 	$responsestr;
                    165:     my %previous=&Apache::response::check_for_previous($responsestr,$part,$id);
1.144     raeburn   166:     my $ad;
                    167:     if ($style eq 'anonsurvey') {
                    168:         $ad=$Apache::lonhomework::results{"resource.$part.$id.awarddetail"}='ANONYMOUS';
                    169:     } elsif ($style eq 'anonsurveycred') {
1.146   ! raeburn   170:         $ad=$Apache::lonhomework::results{"resource.$part.$id.awarddetail"}='ANONYMOUS_CREDIT';
1.144     raeburn   171:     } elsif ($style eq 'surveycred') {
                    172:         $ad=$Apache::lonhomework::results{"resource.$part.$id.awarddetail"}='SUBMITTED_CREDIT';
                    173:     } else {
                    174:         $ad=$Apache::lonhomework::results{"resource.$part.$id.awarddetail"}='SUBMITTED';
                    175:     }
1.96      albertel  176:     &Apache::response::handle_previous(\%previous,$ad);
1.83      albertel  177:     &Apache::lonxml::debug("submitted a $response<br />\n");
                    178:     return '';
1.15      albertel  179: }
                    180: 
1.120     foxr      181: 
1.32      albertel  182: sub grade_response {
1.123     albertel  183:     my ($answer, $whichfoils, $bubbles_per_line)=@_;
                    184: 
1.99      albertel  185:     if ( !&Apache::response::submitted() ) { return; }
1.83      albertel  186:     my $response;
1.118     foxr      187:     
1.100     albertel  188:     if ($env{'form.submitted'} eq 'scantron') {
1.121     foxr      189: 	$response = &Apache::response::getresponse(1,undef,
1.123     albertel  190: 						   &bubble_line_count(scalar(@{ $whichfoils}),
1.121     foxr      191: 								      $bubbles_per_line),
                    192: 						   $bubbles_per_line);
1.116     foxr      193: 
1.83      albertel  194:     } else {
1.100     albertel  195: 	$response = $env{'form.HWVAL_'.$Apache::inputtags::response['-1']};
1.83      albertel  196:     }
1.120     foxr      197: 
1.118     foxr      198: 
1.83      albertel  199:     if ( $response !~ /[0-9]+/) { return; }
                    200:     my $part=$Apache::inputtags::part;
                    201:     my $id = $Apache::inputtags::response['-1'];
                    202:     my %responsehash;
1.123     albertel  203:     $responsehash{$whichfoils->[$response]}=$response;
1.83      albertel  204:     my $responsestr=&Apache::lonnet::hash2str(%responsehash);
                    205:     my %previous=&Apache::response::check_for_previous($responsestr,
                    206: 						       $part,$id);
                    207:     $Apache::lonhomework::results{"resource.$part.$id.submission"}=
                    208: 	$responsestr;
                    209:     &Apache::lonxml::debug("submitted a $response<br />\n");
                    210:     my $ad;
                    211:     if ($response == $answer) {
                    212: 	$ad='EXACT_ANS';
                    213:     } else {
                    214: 	$ad='INCORRECT';
                    215:     }
                    216:     $Apache::lonhomework::results{"resource.$part.$id.awarddetail"}=$ad;
                    217:     &Apache::response::handle_previous(\%previous,$ad);
1.32      albertel  218: }
                    219: 
1.1       albertel  220: sub end_foilgroup {
1.83      albertel  221:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
1.29      albertel  222: 
1.83      albertel  223:     my $result;
1.121     foxr      224:     my $bubble_lines;
                    225:     my $bubbles_per_line;
                    226:     my $answer_count;
1.129     foxr      227:     my $id   = $Apache::inputtags::response['-1'];
                    228:     my $part = $Apache::inputtags::part;
1.121     foxr      229:     $bubbles_per_line = 
                    230: 	&Apache::response::get_response_param($Apache::inputtags::part."_$id",
                    231: 					      'numbubbles',
                    232: 					      $default_bubbles_per_line);
                    233: 
                    234: 
1.83      albertel  235:     if ($target eq 'grade' || $target eq 'web' || $target eq 'answer' ||
                    236: 	$target eq 'tex' || $target eq 'analyze') {
                    237: 	my $style = $Apache::lonhomework::type;
1.93      albertel  238: 	my $direction = &Apache::lonxml::get_param('direction',$parstack,
                    239: 						   $safeeval,'-2');
1.144     raeburn   240: 	if ( (($style eq 'survey') || ($style eq 'surveycred') || 
                    241:               ($style eq 'anonsurvey') || ($style eq 'anonsurveycred')) 
                    242:              && ($target ne 'analyze')) {
1.83      albertel  243: 	    if ($target eq 'web' || $target eq 'tex') {
1.110     foxr      244: 		$result=&displayallfoils($direction, $target);
1.83      albertel  245: 	    } elsif ( $target eq 'answer' ) {
                    246: 		$result=&displayallanswers();
                    247: 	    } elsif ( $target eq 'grade' ) {
1.144     raeburn   248: 		$result=&storesurvey($style);
1.83      albertel  249: 	    }
1.121     foxr      250: 	    $answer_count = scalar(@{$Apache::response::foilgroup{'names'}});
                    251: 
1.83      albertel  252: 	} else {
1.121     foxr      253: 
1.83      albertel  254: 	    my $name;
                    255: 	    my $max = &Apache::lonxml::get_param('max',$parstack,$safeeval,
                    256: 						 '-2');
                    257: 	    my $randomize = &Apache::lonxml::get_param('randomize',$parstack,
                    258: 						       $safeeval,'-2');
1.123     albertel  259: 	    my ($answer, @shown) = &whichfoils($max, $randomize);
1.121     foxr      260: 	    $answer_count = scalar(@shown);
                    261: 
1.83      albertel  262: 	    if ($target eq 'web' || $target eq 'tex') {
1.121     foxr      263: 		$result=&displayfoils($target,
1.123     albertel  264: 				      $answer, \@shown,
1.121     foxr      265: 				      $direction,
                    266: 				      $bubbles_per_line);
1.83      albertel  267: 	    } elsif ($target eq 'answer' ) {
1.124     albertel  268: 		$result=&displayanswers($answer, \@shown, $bubbles_per_line);
1.83      albertel  269: 	    } elsif ( $target eq 'grade') {
1.123     albertel  270: 		&grade_response($answer, \@shown, $bubbles_per_line);
1.83      albertel  271: 	    }  elsif ( $target eq 'analyze') {
1.126     foxr      272: 		my $bubble_lines = &bubble_line_count($answer_count, 
                    273: 						      $bubbles_per_line);
1.83      albertel  274: 		&Apache::response::analyze_store_foilgroup(\@shown,
                    275: 							   ['text','value','location']);
1.129     foxr      276: 		my $part_id="$part.$id";
1.83      albertel  277: 		push (@{ $Apache::lonhomework::analyze{"$part_id.options"} },
                    278: 		      ('true','false'));
1.130     foxr      279: 
1.83      albertel  280: 	    }
1.81      albertel  281: 	}
1.111     albertel  282: 	$Apache::lonxml::post_evaluate=0;
1.83      albertel  283:     }
1.114     albertel  284:     if ($target eq 'web') {
                    285: 	&Apache::response::setup_prior_tries_hash(\&format_prior_answer,
                    286: 						  [\%Apache::response::foilgroup]);
                    287:     }
1.128     foxr      288:     &Apache::response::poprandomnumber();
1.121     foxr      289:     $bubble_lines = &bubble_line_count($answer_count, $bubbles_per_line);
1.128     foxr      290:     &Apache::lonxml::increment_counter($bubble_lines,
1.129     foxr      291: 				       "$part.$id");
1.128     foxr      292:     if ($target eq 'analyze') {
                    293: 	&Apache::lonhomework::set_bubble_lines();
                    294:     }
1.83      albertel  295:     return $result;
1.6       albertel  296: }
                    297: 
                    298: sub getfoilcounts {
1.83      albertel  299:     my @names;
                    300:     my $truecnt=0;
                    301:     my $falsecnt=0;
                    302:     my $name;
                    303:     if ( $Apache::response::foilgroup{'names'} ) {
                    304: 	@names= @{ $Apache::response::foilgroup{'names'} };
1.6       albertel  305:     }
1.83      albertel  306:     foreach $name (@names) {
                    307: 	if ($Apache::response::foilgroup{$name.'.value'} eq 'true') {
                    308: 	    $truecnt++;
                    309: 	} elsif ($Apache::response::foilgroup{$name.'.value'} eq 'false') {
                    310: 	    $falsecnt++;
                    311: 	}
                    312:     }
                    313:     return ($truecnt,$falsecnt);
1.5       albertel  314: }
                    315: 
1.114     albertel  316: sub format_prior_answer {
                    317:     my ($mode,$answer,$other_data) = @_;
                    318:     my $foil_data = $other_data->[0];
                    319:     my %response = &Apache::lonnet::str2hash($answer);
                    320:     my ($name)   = keys(%response);
                    321:     return '<span class="LC_prior_radiobutton">'.
                    322: 	$foil_data->{$name.'.text'}.'</span>';
                    323: 
1.112     albertel  324: }
                    325: 
1.15      albertel  326: sub displayallfoils {
1.110     foxr      327:     my ($direction, $target)=@_;
1.83      albertel  328:     my $result;
                    329:     &Apache::lonxml::debug("survey style display");
1.106     albertel  330:     my @names;
                    331:     if ( $Apache::response::foilgroup{'names'} ) {
                    332: 	@names= @{ $Apache::response::foilgroup{'names'} };
                    333:     }
1.120     foxr      334: 
1.83      albertel  335:     my $temp=0;
1.110     foxr      336:     my $i   =0;
1.83      albertel  337:     my $id=$Apache::inputtags::response['-1'];
                    338:     my $part=$Apache::inputtags::part;
1.144     raeburn   339:     my $lastresponse;
                    340:     unless ((($Apache::lonhomework::history{"resource.$part.type"} eq 'anonsurvey') || ($Apache::lonhomework::history{"resource.$part.type"} eq 'anonsurveycred')) && (defined($env{'form.grade_symb'}))) {
                    341:         $lastresponse = 
                    342: 	    $Apache::lonhomework::history{"resource.$part.$id.submission"};
                    343:     }
1.93      albertel  344:     if ($direction eq 'horizontal') { $result.='<table><tr>'; }
1.83      albertel  345:     my %lastresponse=&Apache::lonnet::str2hash($lastresponse);
                    346:     if (&Apache::response::show_answer() ) {
                    347: 	foreach my $name (@names) {
                    348: 	    if ($Apache::response::foilgroup{$name.'.value'} ne 'unused') {
1.110     foxr      349: 		if (($direction eq 'horizontal') && ($target ne 'tex')) {
1.93      albertel  350: 		    $result.="<td>";
                    351: 		} else {
1.110     foxr      352: 		    if ($target eq 'tex') {
                    353: 			$result .= '\item \vskip -2mm ';
                    354: 		    } else {
                    355: 			$result.="<br />";
                    356: 		    }
1.93      albertel  357: 		}
1.84      albertel  358: 		if (defined($lastresponse{$name})) {
1.110     foxr      359: 		    if ($target eq 'tex') {
                    360: 			$result .= '}';
                    361: 		    } else {
                    362: 			$result.='<b>';
                    363: 		    }
1.83      albertel  364: 		}
                    365: 		$result .= $Apache::response::foilgroup{$name.'.text'};
1.110     foxr      366: 		if (defined($lastresponse{$name}) && ($target ne 'tex')) {
1.83      albertel  367: 		    $result.='</b>';
                    368: 		}
1.110     foxr      369: 		if (($direction eq 'horizontal') && ($target ne 'tex')) { $result.="</td>"; }
1.83      albertel  370: 	    }
1.45      albertel  371: 	}
1.83      albertel  372:     } else {
                    373: 	foreach my $name (@names) {
                    374: 	    if ($Apache::response::foilgroup{$name.'.value'} ne 'unused') {
1.93      albertel  375: 		if ($direction eq 'horizontal') {
                    376: 		    $result.="<td>";
                    377: 		} else {
1.110     foxr      378: 		    if ($target eq 'tex') {
1.143     onken     379: 		        if($env{'form.pdfFormFields'} eq 'yes' && $Apache::inputtags::status[-1] eq 'CAN_ANSWER') {
1.145     onken     380:                             my $fieldname = $env{'request.symb'}.'&part_'. $Apache::inputtags::part
                    381:                                             .'&radiobuttonresponse'.'&HWVAL_'.$Apache::inputtags::response['-1'];
                    382:                             $result .= '\item[{'.&Apache::lonxml::print_pdf_radiobutton($fieldname,$temp).'}]'
                    383:                                        .$Apache::response::foilgroup{$name.'.text'}."\n";
1.135     onken     384:                         } else {
                    385:                             $result .= '\item \vskip -2mm ';
                    386:                         }
                    387:                     } else {
1.110     foxr      388: 			$result.="<br />";
                    389: 		    }
                    390: 		}
                    391: 		if ($target eq 'tex') {
1.143     onken     392: 		    if($env{'form.pdfFormFields'} ne 'yes' or $Apache::inputtags::status[-1] ne 'CAN_ANSWER') {
1.135     onken     393:                         $result .= '$\bigcirc$'.$Apache::response::foilgroup{$name.'.text'}.'\\\\';  #' stupid emacs
                    394:                     }
1.110     foxr      395: 		    $i++;
                    396: 		} else {
                    397: 		    $result .= '<label>';
1.113     albertel  398: 		    $result.="<input
                    399:                        onchange=\"javascript:setSubmittedPart('$part');\"
                    400:                        type=\"radio\"
                    401:                        name=\"HWVAL_$Apache::inputtags::response['-1']\"
1.142     bisitz    402:                        value=\"$temp\"";
                    403: 		    if (defined($lastresponse{$name})) { $result .= ' checked="checked"'; }
1.110     foxr      404: 		    $result .= ' />'.$Apache::response::foilgroup{$name.'.text'}.
                    405: 			'</label>';
1.93      albertel  406: 		}
1.83      albertel  407: 		$temp++;
1.110     foxr      408: 		if ($target ne 'tex') {
                    409: 		    if (($direction eq 'horizontal') && ($target ne 'tex')) { $result.="</td>"; }
                    410: 		} else {
                    411: 		    $result.='\vskip 0 mm ';
                    412: 		}
1.83      albertel  413: 	    }
1.45      albertel  414: 	}
                    415:     }
1.120     foxr      416:     
1.110     foxr      417:     if (($direction eq 'horizontal') && ($target ne 'tex')) { $result.='</tr></table>'; }
1.83      albertel  418:     return $result;
1.15      albertel  419: }
                    420: 
1.122     albertel  421: 
1.28      albertel  422: sub whichfoils {
1.83      albertel  423:     my ($max,$randomize)=@_;
1.28      albertel  424: 
1.83      albertel  425:     my @truelist;
                    426:     my @falselist;
                    427:     my @whichfalse =();
                    428:     my ($truecnt,$falsecnt) = &getfoilcounts();
                    429:     my $count=0;
                    430:     # we will add in 1 of the true statements
1.104     albertel  431:     if ( $max>0 && ($falsecnt+1)>$max) { $count=$max } else { $count=$falsecnt+1; $max=$count; }
1.83      albertel  432:     my $answer=int(&Math::Random::random_uniform() * ($count));
                    433:     &Apache::lonxml::debug("Count is $count, $answer is $answer");
                    434:     my @names;
                    435:     if ( $Apache::response::foilgroup{'names'} ) {
                    436: 	@names= @{ $Apache::response::foilgroup{'names'} };
                    437:     }
                    438:     if (&Apache::response::showallfoils()) {
                    439: 	@whichfalse=@names;
                    440:     } elsif ($randomize eq 'no') {
                    441: 	&Apache::lonxml::debug("No randomization");
                    442: 	my $havetrue=0;
                    443: 	foreach my $name (@names) {
                    444: 	    if ($Apache::response::foilgroup{$name.'.value'} eq 'true') {
                    445: 		if (!$havetrue ) {
                    446: 		    push(@whichfalse,$name); $havetrue++; $answer=$#whichfalse;
                    447: 		}
                    448: 	    } elsif ($Apache::response::foilgroup{$name.'.value'} eq 'false') {
                    449: 		push (@whichfalse,$name);
                    450: 	    } elsif ($Apache::response::foilgroup{$name.'.value'} eq 'unused') {
                    451: 	    } else {
1.87      albertel  452: 		&Apache::lonxml::error(&HTML::Entities::encode("No valid value assigned ($Apache::response::foilgroup{$name.'.value'}) for foil $name in <foilgroup>",'<>&"'));
1.83      albertel  453: 	    }
                    454: 	}
1.144     raeburn   455: 	if ((!$havetrue) && 
                    456:             ($Apache::lonhomework::type ne 'survey') && 
                    457:             ($Apache::lonhomework::type ne 'surveycred') &&
                    458:             ($Apache::lonhomework::type ne 'anonsurvey') &&
                    459:             ($Apache::lonhomework::type ne 'anonsurveycred')) {
1.134     bisitz    460: 	    &Apache::lonxml::error(&mt('There are no true statements available.').'<br />');
1.97      albertel  461: 	}
1.83      albertel  462:     } else {
                    463: 	my $current=0;
                    464: 	&Apache::lonhomework::showhash(%Apache::response::foilgroup);
                    465: 	my (%top,%bottom);
                    466: 	#first find out where everyone wants to be
                    467: 	foreach my $name (@names) {
                    468: 	    $current++;
                    469: 	    if ($Apache::response::foilgroup{$name.'.value'} eq 'true') {
                    470: 		push (@truelist,$name);
                    471: 		if ($Apache::response::foilgroup{$name.'.location'} eq 'top') {
                    472: 		    $top{$name}=$current;
                    473: 		} elsif ($Apache::response::foilgroup{$name.'.location'} eq 'bottom') {
                    474: 		    $bottom{$name}=$current;
                    475: 		}
                    476: 	    } elsif ($Apache::response::foilgroup{$name.'.value'} eq 'false') {
                    477: 		push (@falselist,$name);
                    478: 		if ($Apache::response::foilgroup{$name.'.location'} eq 'top') {
                    479: 		    $top{$name}=$current;
                    480: 		} elsif ($Apache::response::foilgroup{$name.'.location'} eq 'bottom') {
                    481: 		    $bottom{$name}=$current;
                    482: 		}
                    483: 	    } elsif ($Apache::response::foilgroup{$name.'.value'} eq 'unused') {
                    484: 	    } else {
1.87      albertel  485: 		&Apache::lonxml::error(&HTML::Entities::encode("No valid value assigned ($Apache::response::foilgroup{$name.'.value'}) for foil $name in <foilgroup>",'<>&"'));
1.83      albertel  486: 	    }
                    487: 	}
                    488: 	#pick a true statement
                    489: 	my $notrue=0;
                    490: 	if (scalar(@truelist) == 0) { $notrue=1; }
                    491: 	my $whichtrue = int(&Math::Random::random_uniform() * ($#truelist+1));
                    492: 	&Apache::lonxml::debug("Max is $max, From $#truelist elms, picking $whichtrue");
                    493: 	my (@toplist, @bottomlist);
                    494: 	my $topcount=0;
                    495: 	my $bottomcount=0;
                    496: 	# assign everyone to either toplist/bottomlist or whichfalse
                    497: 	# which false is randomized, toplist bottomlist are in order
                    498: 	while ((($#whichfalse+$topcount+$bottomcount) < $max-2) && ($#falselist > -1)) {
                    499: 	    &Apache::lonxml::debug("Have $#whichfalse max is $max");
                    500: 	    my $afalse=int(&Math::Random::random_uniform() * ($#falselist+1));
                    501: 	    &Apache::lonxml::debug("From $#falselist elms, picking $afalse");
                    502: 	    $afalse=splice(@falselist,$afalse,1);
                    503: 	    &Apache::lonxml::debug("Picked $afalse");
                    504: 	    &Apache::lonhomework::showhash(('names'=>\@names));
                    505: 	    &Apache::lonhomework::showhash(%top);
                    506: 	    if ($top{$afalse}) {
                    507: 		$toplist[$top{$afalse}]=$afalse;
                    508: 		$topcount++;
                    509: 	    } elsif ($bottom{$afalse}) {
                    510: 		$bottomlist[$bottom{$afalse}]=$afalse;
                    511: 		$bottomcount++;
                    512: 	    } else {
                    513: 		push (@whichfalse,$afalse);
                    514: 	    }
                    515: 	}
                    516: 	&Apache::lonxml::debug("Answer wants $answer");
                    517: 	my $truename=$truelist[$whichtrue];
                    518: 	my $dosplice=1;
1.144     raeburn   519: 	if (($notrue) && 
                    520:             ($Apache::lonhomework::type ne 'survey') &&
                    521:             ($Apache::lonhomework::type ne 'surveycred') &&
                    522:             ($Apache::lonhomework::type ne 'anonsurvey') &&
                    523:             ($Apache::lonhomework::type ne 'anonsurveycred')) {
1.83      albertel  524: 	    $dosplice=0;
1.134     bisitz    525: 	    &Apache::lonxml::error(&mt('There are no true statements available.').'<br />');
1.83      albertel  526: 	}
                    527: 	#insert the true statement, keeping track of where it wants to be
                    528: 	if ($Apache::response::foilgroup{$truename.'.location'} eq 'top' && $dosplice) {
                    529: 	    $toplist[$top{$truename}]=$truename;
                    530: 	    $answer=-1;
                    531: 	    foreach my $top (reverse(@toplist)) {
                    532: 		if ($top) { $answer++;}
                    533: 		if ($top eq $truename) { last; }
1.49      albertel  534: 	    }
1.83      albertel  535: 	    $dosplice=0;
                    536: 	} elsif ($Apache::response::foilgroup{$truename.'.location'} eq 'bottom' && $dosplice) {
                    537: 	    $bottomlist[$bottom{$truename}]=$truename;
                    538: 	    $answer=-1;
                    539: 	    foreach my $bot (@bottomlist) {
                    540: 		if ($bot) { $answer++;}
                    541: 		if ($bot eq $truename) { last; }
1.49      albertel  542: 	    }
1.83      albertel  543: 	    $answer+=$topcount+$#whichfalse+1;
                    544: 	    $dosplice=0;
1.49      albertel  545: 	} else {
1.83      albertel  546: 	    if ($topcount>0 || $bottomcount>0) {
                    547: 		$answer = int(&Math::Random::random_uniform() * ($#whichfalse+1))
                    548: 		    + $topcount;
                    549: 	    }
                    550: 	}
                    551: 	&Apache::lonxml::debug("Answer now wants $answer");
                    552: 	#add the top items to the top, bottom items to the bottom
                    553: 	for (my $i=0;$i<=$#toplist;$i++) {
                    554: 	    if ($toplist[$i]) { unshift(@whichfalse,$toplist[$i]) }
1.49      albertel  555: 	}
1.83      albertel  556: 	for (my $i=0;$i<=$#bottomlist;$i++) {
                    557: 	    if ($bottomlist[$i]) { push(@whichfalse,$bottomlist[$i]) }
1.49      albertel  558: 	}
1.83      albertel  559: 	#if the true statement is randomized insert it into the list
                    560: 	if ($dosplice) { splice(@whichfalse,$answer,0,$truelist[$whichtrue]); }
1.49      albertel  561:     }
1.83      albertel  562:     &Apache::lonxml::debug("Answer is $answer");
                    563:     return ($answer,@whichfalse);
1.28      albertel  564: }
                    565: 
                    566: sub displayfoils {
1.123     albertel  567:     my ($target,$answer,$whichfoils,$direction, $bubbles_per_line)=@_;
1.83      albertel  568:     my $result;
1.28      albertel  569: 
1.22      albertel  570:     my $part=$Apache::inputtags::part;
1.83      albertel  571:     my $solved=$Apache::lonhomework::history{"resource.$part.solved"};
                    572:     if ( ($target ne 'tex') &&
                    573: 	 &Apache::response::show_answer() ) {
1.90      albertel  574: 	if ($direction eq 'horizontal') {
                    575: 	    if ($target ne 'tex') {
                    576: 		$result.='<table><tr>';
                    577: 	    }
                    578: 	}
1.123     albertel  579: 	foreach my $name (@{ $whichfoils }) {
1.90      albertel  580: 	    if ($direction eq 'horizontal') {
                    581: 		if ($target ne 'tex') { $result.='<td>'; }
                    582: 	    }
1.83      albertel  583: 	    if ($target ne 'tex') {
                    584: 		$result.="<br />";
                    585: 	    } else {
                    586: 		$result.='\item \vskip -2 mm  ';
                    587: 	    }
                    588: 	    if ($Apache::response::foilgroup{$name.'.value'} eq 'true') { 
1.132     bisitz    589: 		if ($target ne 'tex') {
                    590:                     $result.=&mt('Correct:').'<b>';
                    591:                 } else {
                    592:                     $result.=&mt('Correct:').' \textbf{';
                    593:                 }
1.83      albertel  594: 	    } else {
1.132     bisitz    595: 		$result.=&mt('Incorrect:');
1.83      albertel  596: 	    }
1.94      matthew   597: 	    if ($target eq 'web') { $result.="<label>"; }
1.90      albertel  598: 	    $result.=$Apache::response::foilgroup{$name.'.text'};
1.94      matthew   599: 	    if ($target eq 'web') { $result.="</label>"; }
1.83      albertel  600: 	    if ($Apache::response::foilgroup{$name.'.value'} eq 'true') {
                    601: 		if ($target ne 'tex') { $result.='</b>';} else {$result.='}';}
                    602: 	    }
1.90      albertel  603: 	    if ($direction eq 'horizontal') {
                    604: 		if ($target ne 'tex') { $result.='</td>'; }
                    605: 	    }
                    606: 	}
                    607: 	if ($direction eq 'horizontal') {
                    608: 	    if ($target ne 'tex') {
                    609: 		$result.='</tr></table>';
                    610: 	    }
1.83      albertel  611: 	}
                    612:     } else {
                    613: 	my @alphabet = ('A'..'Z');
                    614: 	my $i = 0;
1.116     foxr      615: 	my $bubble_number = 0;
1.124     albertel  616: 	my $line = 0;
1.83      albertel  617: 	my $temp=0;  
                    618: 	my $id=$Apache::inputtags::response['-1'];
                    619: 	my $part=$Apache::inputtags::part;
                    620: 	my $lastresponse=$Apache::lonhomework::history{"resource.$part.$id.submission"};
                    621: 	my %lastresponse=&Apache::lonnet::str2hash($lastresponse);
1.90      albertel  622: 	if ($target ne 'tex' && $direction eq 'horizontal') {
                    623: 	    $result.="<table><tr>";
                    624: 	}
1.123     albertel  625: 	foreach my $name (@{ $whichfoils }) {
1.83      albertel  626: 	    if ($target ne 'tex') {
1.90      albertel  627: 		if ($direction eq 'horizontal') {
                    628: 		    $result.="<td>"; 
                    629: 		} else { 
                    630: 		    $result.="<br />";
                    631: 		} 
                    632: 	    }
                    633: 	    if ($target ne 'tex') { 
1.94      matthew   634:                 $result.= '<label>';
1.113     albertel  635: 		$result.=
                    636: 		    "<input type=\"radio\"
                    637:                             onchange=\"javascript:setSubmittedPart('$part');\"
                    638:                             name=\"HWVAL_$Apache::inputtags::response['-1']\"
1.142     bisitz    639:                             value=\"$temp\"";
                    640: 		if (defined($lastresponse{$name})) { $result .= ' checked="checked"'; }
1.108     albertel  641: 		$result .= ' />'.$Apache::response::foilgroup{$name.'.text'}."</label>";
1.83      albertel  642: 	    } else {
                    643: 		if ($Apache::lonhomework::type eq 'exam') {
1.116     foxr      644: 		    if($bubble_number >= $bubbles_per_line) {
1.124     albertel  645: 			$line++;
1.116     foxr      646: 			$i = 0;
                    647: 			$bubble_number = 0;
1.124     albertel  648: 			$result.='\item[\textbf{'.($Apache::lonxml::counter+$line).'}.]';
1.116     foxr      649: 		    }
1.124     albertel  650: 		    $result .= '{\small \textbf{'.$alphabet[$i].'}}$\bigcirc$'.$Apache::response::foilgroup{$name.'.text'}.'\\\\';  #' stupid emacs
                    651: 		    $i++;
                    652: 		    $bubble_number++;
1.83      albertel  653: 		} else {
1.145     onken     654:                     if($env{'form.pdfFormFields'} eq 'yes' && $Apache::inputtags::status[-1] eq 'CAN_ANSWER') {
                    655:                         my $fieldname = $env{'request.symb'}.'&part_'. $Apache::inputtags::part
                    656:                                         .'&radiobuttonresponse'.'&HWVAL_'.$Apache::inputtags::response['-1'];
                    657:                         $result .= '\item[{'.&Apache::lonxml::print_pdf_radiobutton($fieldname,$temp).'}]'
                    658:                                    .$Apache::response::foilgroup{$name.'.text'}."\n";
                    659:                     } else { 
                    660:                         $result .= '\vspace*{-2 mm}\item '.$Apache::response::foilgroup{$name.'.text'};
                    661:                     }
1.135     onken     662:                 }
1.83      albertel  663: 	    }
1.90      albertel  664: 	    if ($target ne 'tex' && $direction eq 'horizontal') {
                    665: 		$result.="</td>"; 
                    666: 	    }
1.83      albertel  667: 	    $temp++;
                    668: 	}
1.90      albertel  669: 	if ($target ne 'tex' && $direction eq 'horizontal') {
                    670: 	    $result.="</tr></table>";
                    671: 	}
1.83      albertel  672:     }
1.92      albertel  673:     if ($target ne 'tex') { if ($direction ne 'horizontal') { $result.="<br />";} } else { $result.='\vskip 0 mm '; }
1.83      albertel  674:     return $result;
1.81      albertel  675: }
                    676: 
                    677: sub displayallanswers {
1.106     albertel  678:     my @names;
                    679:     if ( $Apache::response::foilgroup{'names'} ) {
                    680: 	@names= @{ $Apache::response::foilgroup{'names'} };
                    681:     }
1.81      albertel  682:     my $result=&Apache::response::answer_header('radiobuttonresponse');
                    683:     foreach my $name (@names) {
                    684: 	$result.=&Apache::response::answer_part('radiobuttonresponse',
                    685: 				$Apache::response::foilgroup{$name.'.value'});
                    686:     }
                    687:     $result.=&Apache::response::answer_footer('radiobuttonresponse');
                    688:     return $result;
1.14      albertel  689: }
                    690: 
1.28      albertel  691: sub displayanswers {
1.124     albertel  692:     my ($answer, $whichopt, $bubbles_per_line)=@_;
                    693:     my $result;
                    694: 
1.105     albertel  695:     if ($Apache::lonhomework::type eq 'exam') {
1.124     albertel  696: 	my $line = int($answer/$bubbles_per_line);
                    697: 	my $correct = ('A'..'Z')[$answer%$bubbles_per_line];
                    698: 	$result .= &Apache::response::answer_header('radiobuttonresponse',
                    699: 						    $line);
                    700: 	$result .= &Apache::response::answer_part('radiobuttonresponse',
                    701: 						  $correct);
                    702:     } else {
                    703: 	$result .= &Apache::response::answer_header('radiobuttonresponse');
1.105     albertel  704:     }
1.123     albertel  705:     foreach my $name (@{ $whichopt }) {
1.83      albertel  706: 	$result.=&Apache::response::answer_part('radiobuttonresponse',
1.105     albertel  707: 						$Apache::response::foilgroup{$name.'.value'});
                    708:     }
1.83      albertel  709:     $result.=&Apache::response::answer_footer('radiobuttonresponse');
                    710:     return $result;
1.28      albertel  711: }
                    712: 
1.14      albertel  713: sub start_conceptgroup {
1.83      albertel  714:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
                    715:     $Apache::radiobuttonresponse::conceptgroup=1;
                    716:     %Apache::response::conceptgroup=();
                    717:     my $result;
                    718:     if ($target eq 'edit') {
                    719: 	$result.=&Apache::edit::tag_start($target,$token);
                    720: 	$result.=&Apache::edit::text_arg('Concept:','concept',$token,'50').
                    721: 	    &Apache::edit::end_row().&Apache::edit::start_spanning_row();
                    722:     } elsif ($target eq 'modified') {
                    723: 	my $constructtag=&Apache::edit::get_new_args($token,$parstack,
                    724: 						     $safeeval,'concept');
                    725: 	if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); }
                    726:     }
                    727:     return $result;
1.14      albertel  728: }
                    729: 
                    730: sub end_conceptgroup {
1.83      albertel  731:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
                    732:     $Apache::radiobuttonresponse::conceptgroup=0;
                    733:     my $result;
                    734:     if ($target eq 'web' || $target eq 'grade' || $target eq 'answer'  ||
                    735: 	$target eq 'tex' || $target eq 'analyze') {
                    736: 	&Apache::response::pick_foil_for_concept($target,
                    737: 						 ['value','text','location'],
                    738: 						 \%Apache::hint::radiobutton,
                    739: 						 $parstack,$safeeval);
                    740:     } elsif ($target eq 'edit') {
                    741: 	$result=&Apache::edit::end_table();
                    742:     }
                    743:     return $result;
1.26      albertel  744: }
                    745: 
                    746: sub insert_conceptgroup {
1.83      albertel  747:     my $result="\n\t\t<conceptgroup concept=\"\">".&insert_foil()."\n\t\t</conceptgroup>\n";
                    748:     return $result;
1.1       albertel  749: }
                    750: 
                    751: sub start_foil {
1.83      albertel  752:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
                    753:     my $result='';
                    754:     if ($target eq 'web' || $target eq 'tex' || $target eq 'analyze') {
                    755: 	&Apache::lonxml::startredirection;
1.95      albertel  756: 	if ($target eq 'analyze') {
                    757: 	    &Apache::response::check_if_computed($token,$parstack,$safeeval,'value');
                    758: 	}
1.83      albertel  759:     } elsif ($target eq 'edit') {
                    760: 	$result=&Apache::edit::tag_start($target,$token);
                    761: 	$result.=&Apache::edit::text_arg('Name:','name',$token);
                    762: 	$result.=&Apache::edit::select_or_text_arg('Correct Option:','value',
                    763: 						   ['unused','true','false'],
                    764: 						   $token);
                    765: 	my $randomize=&Apache::lonxml::get_param('randomize',$parstack,
                    766: 						 $safeeval,'-3');
                    767: 	if ($randomize ne 'no') {
                    768: 	    $result.=&Apache::edit::select_arg('Location:','location',
                    769: 					       ['random','top','bottom'],$token);
                    770: 	}
                    771: 	$result.=&Apache::edit::end_row().&Apache::edit::start_spanning_row();
                    772:     } elsif ($target eq 'modified') {
                    773: 	my $constructtag=&Apache::edit::get_new_args($token,$parstack,
                    774: 						     $safeeval,'value','name',
                    775: 						     'location');
                    776: 	if ($constructtag) { $result = &Apache::edit::rebuild_tag($token); }
                    777:     } 
                    778:     return $result;
1.1       albertel  779: }
                    780: 
                    781: sub end_foil {
1.83      albertel  782:     my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
                    783:     my $text='';
                    784:     if ($target eq 'web' || $target eq 'tex' || $target eq 'analyze') {
                    785: 	$text=&Apache::lonxml::endredirection;
                    786:     }
1.85      albertel  787:     if ($target eq 'web' || $target eq 'grade' || $target eq 'answer'
                    788: 	|| $target eq 'tex' || $target eq 'analyze') {
1.83      albertel  789: 	my $value = &Apache::lonxml::get_param('value',$parstack,$safeeval);
                    790: 	if ($value ne 'unused') {
                    791: 	    my $name = &Apache::lonxml::get_param('name',$parstack,$safeeval);
1.102     albertel  792: 	    if ($name eq "") {
1.134     bisitz    793: 		&Apache::lonxml::warning(&mt('Foils without names exist. This can cause problems to malfunction.'));
1.98      albertel  794: 		$name=$Apache::lonxml::curdepth;
                    795: 	    }
1.85      albertel  796: 	    if (defined($Apache::response::foilnames{$name})) {
1.134     bisitz    797: 		&Apache::lonxml::error(&mt('Foil name [_1] appears more than once. Foil names need to be unique.','<b><tt>'.$name.'</tt></b>'));
1.85      albertel  798: 	    }
1.86      albertel  799: 	    $Apache::response::foilnames{$name}++;
1.85      albertel  800: 	    my $location =&Apache::lonxml::get_param('location',$parstack,
                    801: 						     $safeeval);
1.83      albertel  802: 	    if ( $Apache::radiobuttonresponse::conceptgroup
                    803: 		 && !&Apache::response::showallfoils() ) {
                    804: 		push @{ $Apache::response::conceptgroup{'names'} }, $name;
                    805: 		$Apache::response::conceptgroup{"$name.value"} = $value;
                    806: 		$Apache::response::conceptgroup{"$name.text"} = $text;	
                    807: 		$Apache::response::conceptgroup{"$name.location"} = $location;
                    808: 	    } else {
                    809: 		push @{ $Apache::response::foilgroup{'names'} }, $name;
                    810: 		$Apache::response::foilgroup{"$name.value"} = $value;
                    811: 		$Apache::response::foilgroup{"$name.text"} = $text;
                    812: 		$Apache::response::foilgroup{"$name.location"} = $location;
                    813: 	    }
                    814: 	}
1.18      albertel  815:     }
1.83      albertel  816:     return '';
1.1       albertel  817: }
                    818: 
1.27      albertel  819: sub insert_foil {
1.83      albertel  820:     return '
1.27      albertel  821: <foil name="" value="unused">
                    822: <startouttext />
                    823: <endouttext />
                    824: </foil>';
                    825: }
1.1       albertel  826: 1;
                    827: __END__
1.139     jms       828: 
                    829: 
                    830: 
                    831: =head1 NAME
                    832: 
                    833: Apache::radiobuttonresponse
                    834: 
                    835: =head1 SYNOPSIS
                    836: 
                    837: Handles multiple-choice style responses.
                    838: 
                    839: This is part of the LearningOnline Network with CAPA project
                    840: described at http://www.lon-capa.org.
                    841: 
                    842: =head1 SUBROUTINES
                    843: 
                    844: =over
                    845: 
                    846: =item start_radiobuttonresponse()
                    847: 
                    848: =item bubble_line_count()
                    849: 
                    850: =item end_radiobuttonresponse()
                    851: 
                    852: =item start_foilgroup()
                    853: 
                    854: =item storesurvey()
                    855: 
                    856: =item grade_response()
                    857: 
                    858: =item end_foilgroup()
                    859: 
                    860: =item getfoilcounts()
                    861: 
                    862: =item format_prior_answer()
                    863: 
                    864: =item displayallfoils()
                    865: 
                    866: =item &whichfoils($max,$randomize)
                    867: 
                    868: Randomizes the list of foils.
                    869: Respects
                    870:   - each foils desire to be randomized
                    871:   - the existance of Concept groups of foils (select 1 foil from each)
                    872:   - and selects a single correct statement from all possilble true statments
                    873:   - and limits it to a toal of $max foils
                    874: 
                    875: WARNING: this routine uses the random number generator, it should only
                    876: be called once per target, otherwise it can cause randomness changes in
                    877: homework problems.
                    878: 
                    879: Arguments
                    880:   $max - maximum number of foils to select (including the true one)
                    881:          (so a max of 5 is: 1 true, 4 false)
                    882: 
                    883:   $randomize - whether to randomize the listing of foils, by default
                    884:                will randomize, only if randomize is 'no' will it not
                    885: 
                    886: Returns
                    887:   $answer - location in the array of the correct answer
                    888:   @foils  - array of foil names in to display order
                    889: 
                    890: =item displayfoils()
                    891: 
                    892: =item displayallanswers()
                    893: 
                    894: =item displayanswers()
                    895: 
                    896: =item start_conceptgroup()
                    897: 
                    898: =item end_conceptgroup()
                    899: 
                    900: =item insert_conceptgroup()
                    901: 
                    902: =item start_foil()
                    903: 
                    904: =item end_foil()
                    905: 
                    906: =item insert_foil()
                    907: 
                    908: =back
                    909: 
                    910: =cut
1.1       albertel  911:  

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>