loncom/interface/lonhelper.pm - diff

Return to lonhelper.pm CVS log

Up to [LON-CAPA] / loncom / interface

Diff for /loncom/interface/lonhelper.pm between versions 1.55 and 1.161.2.1

version 1.55, 2003/10/09 15:20:15	version 1.161.2.1, 2007/10/02 00:33:02
Line 25	Line 25
#	#
# http://www.lon-capa.org/	# http://www.lon-capa.org/
#	#
# (Page Handler
#
# (.helper handler
#

=pod	=pod

Line 85 State tags are also required to have an	Line 81 State tags are also required to have an
human name of the state, and will be displayed as the header on top of	human name of the state, and will be displayed as the header on top of
the screen for the user.	the screen for the user.

	State tags may also optionally have an attribute "help" which should be
	the filename of a help file, this will add a blue ? to the title.

=head2 Example Helper Skeleton	=head2 Example Helper Skeleton

An example of the tags so far:	An example of the tags so far:

<helper title="Example Helper">	<helper title="Example Helper">
<state name="START" title="Demonstrating the Example Helper">	<state name="START" title="Demonstrating the Example Helper">
<!-- notice this is the START state the wizard requires -->	<!-- notice this is the START state the helper requires -->
</state>	</state>
<state name="GET_NAME" title="Enter Student Name">	<state name="GET_NAME" title="Enter Student Name">
</state>	</state>
</helper>	</helper>

Of course this does nothing. In order for the wizard to do something, it is	Of course this does nothing. In order for the helper to do something, it is
necessary to put actual elements into the wizard. Documentation for each	necessary to put actual elements into the helper. Documentation for each
of these elements follows.	of these elements follows.

=head1 Creating a Helper With Code, Not XML	=head1 Creating a Helper With Code, Not XML

In some situations, such as the printing wizard (see lonprintout.pm),	In some situations, such as the printing helper (see lonprintout.pm),
writing the helper in XML would be too complicated, because of scope	writing the helper in XML would be too complicated, because of scope
issues or the fact that the code actually outweighs the XML. It is	issues or the fact that the code actually outweighs the XML. It is
possible to create a helper via code, though it is a little odd.	possible to create a helper via code, though it is a little odd.
Line 186 use Apache::Constants qw(:common);	Line 185 use Apache::Constants qw(:common);
use Apache::File;	use Apache::File;
use Apache::lonxml;	use Apache::lonxml;
use Apache::lonlocal;	use Apache::lonlocal;
	use Apache::lonnet;
	use Apache::longroup;
	use Apache::lonselstudent;
	use LONCAPA;

# Register all the tags with the helper, so the helper can	# Register all the tags with the helper, so the helper can
# push and pop them	# push and pop them
Line 230 my $paramHash;	Line 233 my $paramHash;
# In the debugger, this means that breakpoints are ignored until you step into	# In the debugger, this means that breakpoints are ignored until you step into
# a function and get out of what must be a "faked up scope" in the Apache->	# a function and get out of what must be a "faked up scope" in the Apache->
# mod_perl connection. In this code, it was manifesting itself in the existence	# mod_perl connection. In this code, it was manifesting itself in the existence
# of two seperate file-scoped $helper variables, one set to the value of the	# of two separate file-scoped $helper variables, one set to the value of the
# helper in the helper constructor, and one referenced by the handler on the	# helper in the helper constructor, and one referenced by the handler on the
# "$helper->process()" line. Using the debugger, one could actually	# "$helper->process()" line. Using the debugger, one could actually
# see the two different $helper variables, as hashes at completely	# see the two different $helper variables, as hashes at completely
Line 255 sub real_handler {	Line 258 sub real_handler {
my $r = shift;	my $r = shift;
my $uri = shift;	my $uri = shift;
if (!defined($uri)) { $uri = $r->uri(); }	if (!defined($uri)) { $uri = $r->uri(); }
$ENV{'request.uri'} = $uri;	$env{'request.uri'} = $uri;
my $filename = '/home/httpd/html' . $uri;	my $filename = '/home/httpd/html' . $uri;
my $fh = Apache::File->new($filename);	my $fh = Apache::File->new($filename);
my $file;	my $file;
Line 263 sub real_handler {	Line 266 sub real_handler {


# Send header, don't cache this page	# Send header, don't cache this page
if ($r->header_only) {	if ($env{'browser.mathml'}) {
if ($ENV{'browser.mathml'}) {	&Apache::loncommon::content_type($r,'text/xml');
$r->content_type('text/xml; charset=UTF-8');
} else {
$r->content_type('text/html; charset=UTF-8');
}
$r->send_http_header;
return OK;
}
if ($ENV{'browser.mathml'}) {
$r->content_type('text/xml');
} else {	} else {
$r->content_type('text/html');	&Apache::loncommon::content_type($r,'text/html');
}	}
$r->send_http_header;	$r->send_http_header;
	return OK if $r->header_only;
$r->rflush();	$r->rflush();

# Discard result, we just want the objects that get created by the	# Discard result, we just want the objects that get created by the
Line 286 sub real_handler {	Line 281 sub real_handler {

my $allowed = $helper->allowedCheck();	my $allowed = $helper->allowedCheck();
if (!$allowed) {	if (!$allowed) {
$ENV{'user.error.msg'} = $ENV{'request.uri'}.':'.$helper->{REQUIRED_PRIV}.	$env{'user.error.msg'} = $env{'request.uri'}.':'.$helper->{REQUIRED_PRIV}.
":0:0:Permission denied to access this helper.";	":0:0:Permission denied to access this helper.";
return HTTP_NOT_ACCEPTABLE;	return HTTP_NOT_ACCEPTABLE;
}	}
Line 342 sub start_state {	Line 337 sub start_state {
}	}

Apache::lonhelper::state->new($token->[2]{'name'},	Apache::lonhelper::state->new($token->[2]{'name'},
$token->[2]{'title'});	$token->[2]{'title'},
	$token->[2]{'help'});
return '';	return '';
}	}

Line 371 use HTML::Entities();	Line 367 use HTML::Entities();
use Apache::loncommon;	use Apache::loncommon;
use Apache::File;	use Apache::File;
use Apache::lonlocal;	use Apache::lonlocal;
	use Apache::lonnet;
	use LONCAPA;

sub new {	sub new {
my $proto = shift;	my $proto = shift;
Line 382 sub new {	Line 380 sub new {

# If there is a state from the previous form, use that. If there is no	# If there is a state from the previous form, use that. If there is no
# state, use the start state parameter.	# state, use the start state parameter.
if (defined $ENV{"form.CURRENT_STATE"})	if (defined $env{"form.CURRENT_STATE"})
{	{
$self->{STATE} = $ENV{"form.CURRENT_STATE"};	$self->{STATE} = $env{"form.CURRENT_STATE"};
}	}
else	else
{	{
$self->{STATE} = "START";	$self->{STATE} = "START";
}	}

$self->{TOKEN} = $ENV{'form.TOKEN'};	$self->{TOKEN} = $env{'form.TOKEN'};
# If a token was passed, we load that in. Otherwise, we need to create a	# If a token was passed, we load that in. Otherwise, we need to create a
# new storage file	# new storage file
# Tried to use standard Tie'd hashes, but you can't seem to take a	# Tried to use standard Tie'd hashes, but you can't seem to take a
Line 424 sub new {	Line 422 sub new {
return undef;	return undef;
}	}
# Must create the storage	# Must create the storage
$self->{TOKEN} = md5_hex($ENV{'user.name'} . $ENV{'user.domain'} .	$self->{TOKEN} = md5_hex($env{'user.name'} . $env{'user.domain'} .
time() . rand());	time() . rand());
$self->{FILENAME} = $Apache::lonnet::tmpdir . md5_hex($self->{TOKEN});	$self->{FILENAME} = $Apache::lonnet::tmpdir . md5_hex($self->{TOKEN});
}	}

# OK, we now have our persistent storage.	# OK, we now have our persistent storage.

if (defined $ENV{"form.RETURN_PAGE"})	if (defined $env{"form.RETURN_PAGE"})
{	{
$self->{RETURN_PAGE} = $ENV{"form.RETURN_PAGE"};	$self->{RETURN_PAGE} = $env{"form.RETURN_PAGE"};
}	}
else	else
{	{
Line 462 sub _saveVars {	Line 460 sub _saveVars {
my $self = shift;	my $self = shift;
my $result = "";	my $result = "";
$result .= '<input type="hidden" name="CURRENT_STATE" value="' .	$result .= '<input type="hidden" name="CURRENT_STATE" value="' .
HTML::Entities::encode($self->{STATE}) . "\" />\n";	HTML::Entities::encode($self->{STATE},'<>&"') . "\" />\n";
$result .= '<input type="hidden" name="TOKEN" value="' .	$result .= '<input type="hidden" name="TOKEN" value="' .
$self->{TOKEN} . "\" />\n";	$self->{TOKEN} . "\" />\n";
$result .= '<input type="hidden" name="RETURN_PAGE" value="' .	$result .= '<input type="hidden" name="RETURN_PAGE" value="' .
HTML::Entities::encode($self->{RETURN_PAGE}) . "\" />\n";	HTML::Entities::encode($self->{RETURN_PAGE},'<>&"') . "\" />\n";

return $result;	return $result;
}	}
Line 476 sub _saveVars {	Line 474 sub _saveVars {
sub _varsInFile {	sub _varsInFile {
my $self = shift;	my $self = shift;
my @vars = ();	my @vars = ();
for my $key (keys %{$self->{VARS}}) {	for my $key (keys(%{$self->{VARS}})) {
push @vars, &Apache::lonnet::escape($key) . '=' .	push(@vars, &escape($key) . '=' . &escape($self->{VARS}->{$key}));
&Apache::lonnet::escape($self->{VARS}->{$key});
}	}
return join ('&', @vars);	return join ('&', @vars);
}	}
Line 493 sub declareVar {	Line 490 sub declareVar {
$self->{VARS}->{$var} = '';	$self->{VARS}->{$var} = '';
}	}

my $envname = 'form.' . $var . '.forminput';	my $envname = 'form.' . $var . '_forminput';
if (defined($ENV{$envname})) {	if (defined($env{$envname})) {
if (ref($ENV{$envname})) {	if (ref($env{$envname})) {
$self->{VARS}->{$var} = join('\|\|\|', @{$ENV{$envname}});	$self->{VARS}->{$var} = join('\|\|\|', @{$env{$envname}});
} else {	} else {
$self->{VARS}->{$var} = $ENV{$envname};	$self->{VARS}->{$var} = $env{$envname};
}	}
}	}
}	}
Line 510 sub allowedCheck {	Line 507 sub allowedCheck {
return 1;	return 1;
}	}

return Apache::lonnet::allowed($self->{REQUIRED_PRIV}, $ENV{'request.course.id'});	return Apache::lonnet::allowed($self->{REQUIRED_PRIV}, $env{'request.course.id'});
}	}

sub changeState {	sub changeState {
Line 532 sub process {	Line 529 sub process {
# Phase 1: Post processing for state of previous screen (which is actually	# Phase 1: Post processing for state of previous screen (which is actually
# the "current state" in terms of the helper variables), if it wasn't the	# the "current state" in terms of the helper variables), if it wasn't the
# beginning state.	# beginning state.
if ($self->{STATE} ne "START" \|\| $ENV{"form.SUBMIT"} eq &mt("Next ->")) {	if ($self->{STATE} ne "START" \|\| $env{"form.SUBMIT"} eq &mt("Next ->")) {
my $prevState = $self->{STATES}{$self->{STATE}};	my $prevState = $self->{STATES}{$self->{STATE}};
$prevState->postprocess();	$prevState->postprocess();
}	}
Line 583 sub display {	Line 580 sub display {
}	}

# Phase 4: Display.	# Phase 4: Display.
my $stateTitle = &mt($state->title());	my $stateTitle=&mt($state->title());
my $helperTitle = &mt($self->{TITLE});	my $stateHelp= $state->help();
my $bodytag = &Apache::loncommon::bodytag($helperTitle,'','');	my $browser_searcher_js =
	'<script type="text/javascript">'."\n".
	&Apache::loncommon::browser_and_searcher_javascript().
	"\n".'</script>';

	$result .= &Apache::loncommon::start_page($self->{TITLE},
	$browser_searcher_js);

my $previous = HTML::Entities::encode(&mt("<- Previous"), '<>&"');	my $previous = HTML::Entities::encode(&mt("<- Previous"), '<>&"');
my $next = HTML::Entities::encode(&mt("Next ->"), '<>&"');	my $next = HTML::Entities::encode(&mt("Next ->"), '<>&"');
# FIXME: This should be parameterized, not concatenated - Jeremy	# FIXME: This should be parameterized, not concatenated - Jeremy
my $loncapaHelper = &mt("LON-CAPA Helper:");

$result .= <<HEADER;
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>$loncapaHelper: $helperTitle</title>
</head>
$bodytag
HEADER
if (!$state->overrideForm()) { $result.="<form name='helpform' method='POST'>"; }	if (!$state->overrideForm()) { $result.="<form name='helpform' method='POST'>"; }
	if ($stateHelp) {
	$stateHelp = &Apache::loncommon::help_open_topic($stateHelp);
	}
$result .= <<HEADER;	$result .= <<HEADER;
<table border="0" width='100%'><tr><td>	<table border="0" width='100%'><tr><td>
<h2><i>$stateTitle</i></h2>	<h2><i>$stateTitle</i>$stateHelp</h2>
HEADER	HEADER

$result .= "<table cellpadding='10' width='100%'><tr><td rowspan='2' valign='top'>";	$result .= "<table cellpadding='10' width='100%'><tr><td rowspan='2' valign='top'>";
Line 661 HEADER	Line 660 HEADER
</tr>	</tr>
</table>	</table>
</form>	</form>
</body>
</html>
FOOTER	FOOTER

	$result .= &Apache::loncommon::end_page();
# Handle writing out the vars to the file	# Handle writing out the vars to the file
my $file = Apache::File->new('>'.$self->{FILENAME});	my $file = Apache::File->new('>'.$self->{FILENAME});
print $file $self->_varsInFile();	print $file $self->_varsInFile();
Line 690 sub new {	Line 688 sub new {

$self->{NAME} = shift;	$self->{NAME} = shift;
$self->{TITLE} = shift;	$self->{TITLE} = shift;
	$self->{HELP} = shift;
$self->{ELEMENTS} = [];	$self->{ELEMENTS} = [];

bless($self, $class);	bless($self, $class);
Line 711 sub title {	Line 710 sub title {
return $self->{TITLE};	return $self->{TITLE};
}	}

	sub help {
	my $self = shift;
	return $self->{HELP};
	}

sub preprocess {	sub preprocess {
my $self = shift;	my $self = shift;
for my $element (@{$self->{ELEMENTS}}) {	for my $element (@{$self->{ELEMENTS}}) {
Line 802 the element. How this value is interpret	Line 806 the element. How this value is interpret
the element itself, and possibly the settings the element has (such as	the element itself, and possibly the settings the element has (such as
multichoice vs. single choice for <choices> tags).	multichoice vs. single choice for <choices> tags).

This is also intended for things like the course initialization wizard, where the	This is also intended for things like the course initialization helper, where the
user is setting various parameters. By correctly grabbing current settings	user is setting various parameters. By correctly grabbing current settings
and including them into the helper, it allows the user to come back to the	and including them into the helper, it allows the user to come back to the
helper later and re-execute it, without needing to worry about overwriting	helper later and re-execute it, without needing to worry about overwriting
Line 998 sub start_message {	Line 1002 sub start_message {
return '';	return '';
}	}

$paramHash->{MESSAGE_TEXT} = &Apache::lonxml::get_all_text('/message',	$paramHash->{MESSAGE_TEXT} = &mtn(&Apache::lonxml::get_all_text('/message',
$parser);	$parser));

if (defined($token->[2]{'nextstate'})) {	if (defined($token->[2]{'nextstate'})) {
$paramHash->{NEXTSTATE} = $token->[2]{'nextstate'};	$paramHash->{NEXTSTATE} = $token->[2]{'nextstate'};
Line 1020 sub end_message {	Line 1024 sub end_message {
sub render {	sub render {
my $self = shift;	my $self = shift;

return &mtn($self->{MESSAGE_TEXT});	return $self->{MESSAGE_TEXT};
}	}
# If a NEXTSTATE was given, switch to it	# If a NEXTSTATE was given, switch to it
sub postprocess {	sub postprocess {
Line 1033 sub postprocess {	Line 1037 sub postprocess {
}	}
1;	1;

	package Apache::lonhelper::helpicon;

	=pod

	=head1 Elements

	=head2 Element: helpiconX<helpicon, helper element>

	Helpicon elements add a help icon at the current location.
	Example:

	<helpicon file="Help">
	General Help
	</helpicon>

	In this example will generate a help icon to the Help.hlp url with a
	description of 'General Help'. The description is not required and if
	left out (Example: <helpicon file="Help" /> only the icon will be
	added.)

	=head3 Localization

	The description text will be run through the normalize_string function
	and that will be used as a call to &mt.

	=cut

	no strict;
	@ISA = ("Apache::lonhelper::element");
	use strict;
	use Apache::lonlocal;

	BEGIN {
	&Apache::lonhelper::register('Apache::lonhelper::helpicon',
	('helpicon'));
	}

	sub new {
	my $ref = Apache::lonhelper::element->new();
	bless($ref);
	}

	# CONSTRUCTION: Construct the message element from the XML
	sub start_helpicon {
	my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;

	if ($target ne 'helper') {
	return '';
	}

	$paramHash->{HELP_TEXT} = &mtn(&Apache::lonxml::get_all_text('/helpicon',
	$parser));

	$paramHash->{HELP_TEXT} =~s/^\s+//;
	$paramHash->{HELP_TEXT} =~s/\s+$//;

	if (defined($token->[2]{'file'})) {
	$paramHash->{HELP_FILE} = $token->[2]{'file'};
	}
	return '';
	}

	sub end_helpicon {
	my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;

	if ($target ne 'helper') {
	return '';
	}
	Apache::lonhelper::helpicon->new();
	return '';
	}

	sub render {
	my $self = shift;

	my $text;
	if ( $self->{HELP_TEXT} ne '') {
	$text=&mtn($self->{HELP_TEXT});
	}

	return &Apache::loncommon::help_open_topic($self->{HELP_FILE},
	$text);
	}
	sub postprocess {
	my $self = shift;
	if (defined($self->{NEXTSTATE})) {
	$helper->changeState($self->{NEXTSTATE});
	}

	return 1;
	}

	1;

	package Apache::lonhelper::skip;

	=pod

	=head1 Elements

	=head2 Element: skipX<skip>

	The <skip> tag allows you define conditions under which the current state
	should be skipped over and define what state to skip to.

	<state name="SKIP">
	<skip>
	<clause>
	#some code that decides whether to skip the state or not
	</clause>
	<nextstate>FINISH</nextstate>
	</skip>
	<message nextstate="FINISH">A possibly skipped state</message>
	</state>

	=cut

	no strict;
	@ISA = ("Apache::lonhelper::element");
	use strict;

	BEGIN {
	&Apache::lonhelper::register('Apache::lonhelper::skip',
	('skip'));
	}

	sub new {
	my $ref = Apache::lonhelper::element->new();
	bless($ref);
	}

	sub start_skip {
	my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;

	if ($target ne 'helper') {
	return '';
	}
	# let <cluase> know what text to skip to
	$paramHash->{SKIPTAG}='/skip';
	return '';
	}

	sub end_skip {
	my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;

	if ($target ne 'helper') {
	return '';
	}
	Apache::lonhelper::skip->new();
	return '';
	}

	sub render {
	my $self = shift;
	return '';
	}
	# If a NEXTSTATE is set, switch to it
	sub preprocess {
	my ($self) = @_;

	if (defined($self->{NEXTSTATE})) {
	$helper->changeState($self->{NEXTSTATE});
	}

	return 1;
	}

	1;

package Apache::lonhelper::choices;	package Apache::lonhelper::choices;

=pod	=pod
Line 1082 will be the state transistioned to if th	Line 1255 will be the state transistioned to if th
the choice is not multichoice. This will override the nextstate	the choice is not multichoice. This will override the nextstate
passed to the parent C<choices> tag.	passed to the parent C<choices> tag.

	<choice> may optionally contain a 'relatedvalue' attribute, which
	if present will cause a text entry to appear to the right of the
	selection. The value of the relatedvalue attribute is a variable
	into which the text entry will be stored e.g.:
	<choice computer='numberprovided" relatedvalue="num">Type the number in:</choice>

	<choice> may contain a relatededefault atribute which, if the
	relatedvalue attribute is present will be the initial value of the input
	box.

=back	=back

To create the choices programmatically, either wrap the choices in	To create the choices programmatically, either wrap the choices in
Line 1123 no strict;	Line 1306 no strict;
@ISA = ("Apache::lonhelper::element");	@ISA = ("Apache::lonhelper::element");
use strict;	use strict;
use Apache::lonlocal;	use Apache::lonlocal;
	use Apache::lonnet;

BEGIN {	BEGIN {
&Apache::lonhelper::register('Apache::lonhelper::choices',	&Apache::lonhelper::register('Apache::lonhelper::choices',
Line 1169 sub start_choice {	Line 1353 sub start_choice {
}	}

my $computer = $token->[2]{'computer'};	my $computer = $token->[2]{'computer'};
my $human = &Apache::lonxml::get_all_text('/choice',	my $human = &mt(&Apache::lonxml::get_all_text('/choice',
$parser);	$parser));
my $nextstate = $token->[2]{'nextstate'};	my $nextstate = $token->[2]{'nextstate'};
my $evalFlag = $token->[2]{'eval'};	my $evalFlag = $token->[2]{'eval'};
push @{$paramHash->{CHOICES}}, [$human, $computer, $nextstate,	my $relatedVar = $token->[2]{'relatedvalue'};
$evalFlag];	my $relatedDefault = $token->[2]{'relateddefault'};
	push @{$paramHash->{CHOICES}}, [&mtn($human), $computer, $nextstate,
	$evalFlag, $relatedVar, $relatedDefault];
return '';	return '';
}	}

Line 1182 sub end_choice {	Line 1368 sub end_choice {
return '';	return '';
}	}

	{
	# used to generate unique id attributes for <input> tags.
	# internal use only.
	my $id = 0;
	sub new_id { return $id++; }
	}

sub render {	sub render {
my $self = shift;	my $self = shift;
my $var = $self->{'variable'};	my $var = $self->{'variable'};
Line 1190 sub render {	Line 1383 sub render {

if ($self->{'multichoice'}) {	if ($self->{'multichoice'}) {
$result .= <<SCRIPT;	$result .= <<SCRIPT;
<script>	<script type="text/javascript">
	// <!--
function checkall(value, checkName) {	function checkall(value, checkName) {
for (i=0; i<document.forms.helpform.elements.length; i++) {	for (i=0; i<document.forms.helpform.elements.length; i++) {
ele = document.forms.helpform.elements[i];	ele = document.forms.helpform.elements[i];
if (ele.name == checkName + '.forminput') {	if (ele.name == checkName + '_forminput') {
document.forms.helpform.elements[i].checked=value;	document.forms.helpform.elements[i].checked=value;
}	}
}	}
}	}
	// -->
</script>	</script>
SCRIPT	SCRIPT
}	}
Line 1206 SCRIPT	Line 1401 SCRIPT
# Only print "select all" and "unselect all" if there are five or	# Only print "select all" and "unselect all" if there are five or
# more choices; fewer then that and it looks silly.	# more choices; fewer then that and it looks silly.
if ($self->{'multichoice'} && scalar(@{$self->{CHOICES}}) > 4) {	if ($self->{'multichoice'} && scalar(@{$self->{CHOICES}}) > 4) {
	my %lt=&Apache::lonlocal::texthash(
	'sa' => "Select All",
	'ua' => "Unselect All");
$buttons = <<BUTTONS;	$buttons = <<BUTTONS;
<br />	<br />
<input type="button" onclick="checkall(true, '$var')" value="Select All" />	<input type="button" onclick="checkall(true, '$var')" value="$lt{'sa'}" />
<input type="button" onclick="checkall(false, '$var')" value="Unselect All" />	<input type="button" onclick="checkall(false, '$var')" value="$lt{'ua'}" />
<br />	<br />
BUTTONS	BUTTONS
}	}
Line 1261 BUTTONS	Line 1459 BUTTONS
my $type = "radio";	my $type = "radio";
if ($self->{'multichoice'}) { $type = 'checkbox'; }	if ($self->{'multichoice'}) { $type = 'checkbox'; }
foreach my $choice (@{$self->{CHOICES}}) {	foreach my $choice (@{$self->{CHOICES}}) {
	my $id = &new_id();
$result .= "<tr>\n<td width='20'> </td>\n";	$result .= "<tr>\n<td width='20'> </td>\n";
$result .= "<td valign='top'><input type='$type' name='$var.forminput'"	$result .= "<td valign='top'><input type='$type' name='${var}_forminput'"
. "' value='" .	. " value='" .
HTML::Entities::encode($choice->[1])	HTML::Entities::encode($choice->[1],"<>&\"'")
. "'";	. "'";
if ($checkedChoices{$choice->[1]}) {	if ($checkedChoices{$choice->[1]}) {
$result .= " checked ";	$result .= " checked='checked' ";
}	}
	$result .= qq{id="id$id"};
my $choiceLabel = $choice->[0];	my $choiceLabel = $choice->[0];
if ($choice->[4]) { # if we need to evaluate this choice	if ($choice->[3]) { # if we need to evaluate this choice
$choiceLabel = "sub { my $helper = shift; my $state = shift;" .	$choiceLabel = "sub { my $helper = shift; my $state = shift;" .
$choiceLabel . "}";	$choiceLabel . "}";
$choiceLabel = eval($choiceLabel);	$choiceLabel = eval($choiceLabel);
$choiceLabel = &$choiceLabel($helper, $self);	$choiceLabel = &$choiceLabel($helper, $self);
}	}
$result .= "/></td><td> " . &mtn($choiceLabel) . "</td></tr>\n";	$result .= "/></td><td> ".qq{<label for="id$id">}.
	$choiceLabel. "</label></td>";
	if ($choice->[4]) {
	$result .='<td><input type="text" size="5" name="'
	.$choice->[4].'_forminput" value="'
	.$choice->[5].'" /></td>';
	}
	$result .= "</tr>\n";
}	}
$result .= "</table>\n\n\n";	$result .= "</table>\n\n\n";
$result .= $buttons;	$result .= $buttons;
Line 1288 BUTTONS	Line 1495 BUTTONS
# given, switch to it	# given, switch to it
sub postprocess {	sub postprocess {
my $self = shift;	my $self = shift;
my $chosenValue = $ENV{'form.' . $self->{'variable'} . '.forminput'};	my $chosenValue = $env{'form.' . $self->{'variable'} . '_forminput'};

if (!defined($chosenValue) && !$self->{'allowempty'}) {	if (!defined($chosenValue) && !$self->{'allowempty'}) {
$self->{ERROR_MSG} = "You must choose one or more choices to" .	$self->{ERROR_MSG} =
" continue.";	&mt("You must choose one or more choices to continue.");
return 0;	return 0;
}	}

Line 1310 sub postprocess {	Line 1517 sub postprocess {
$helper->changeState($choice->[2]);	$helper->changeState($choice->[2]);
}	}
}	}
	if ($choice->[4]) {
	my $varname = $choice->[4];
	$helper->{'VARS'}->{$varname} = $env{'form.'."${varname}_forminput"};
	}
}	}
return 1;	return 1;
}	}
Line 1342 no strict;	Line 1553 no strict;
@ISA = ("Apache::lonhelper::element");	@ISA = ("Apache::lonhelper::element");
use strict;	use strict;
use Apache::lonlocal;	use Apache::lonlocal;
	use Apache::lonnet;

BEGIN {	BEGIN {
&Apache::lonhelper::register('Apache::lonhelper::dropdown',	&Apache::lonhelper::register('Apache::lonhelper::dropdown',
Line 1416 sub render {	Line 1628 sub render {
$checkedChoices{$self->{CHOICES}->[0]->[1]} = 1;	$checkedChoices{$self->{CHOICES}->[0]->[1]} = 1;
}	}

$result .= "<select name='${var}.forminput'>\n";	$result .= "<select name='${var}_forminput'>\n";
foreach my $choice (@{$self->{CHOICES}}) {	foreach my $choice (@{$self->{CHOICES}}) {
$result .= "<option value='" .	$result .= "<option value='" .
HTML::Entities::encode($choice->[1])	HTML::Entities::encode($choice->[1],"<>&\"'")
. "'";	. "'";
if ($checkedChoices{$choice->[1]}) {	if ($checkedChoices{$choice->[1]}) {
$result .= " selected";	$result .= " selected='selected' ";
}	}
my $choiceLabel = $choice->[0];	my $choiceLabel = $choice->[0];
if ($choice->[4]) { # if we need to evaluate this choice	if ($choice->[4]) { # if we need to evaluate this choice
Line 1431 sub render {	Line 1643 sub render {
$choiceLabel = eval($choiceLabel);	$choiceLabel = eval($choiceLabel);
$choiceLabel = &$choiceLabel($helper, $self);	$choiceLabel = &$choiceLabel($helper, $self);
}	}
$result .= ">" . &mtn($choiceLabel) . "\n";	$result .= ">" . &mtn($choiceLabel) . "</option>\n";
}	}
$result .= "</select>\n";	$result .= "</select>\n";

Line 1442 sub render {	Line 1654 sub render {
# given, switch to it	# given, switch to it
sub postprocess {	sub postprocess {
my $self = shift;	my $self = shift;
my $chosenValue = $ENV{'form.' . $self->{'variable'} . '.forminput'};	my $chosenValue = $env{'form.' . $self->{'variable'} . '_forminput'};

if (!defined($chosenValue) && !$self->{'allowempty'}) {	if (!defined($chosenValue) && !$self->{'allowempty'}) {
$self->{ERROR_MSG} = "You must choose one or more choices to" .	$self->{ERROR_MSG} = "You must choose one or more choices to" .
Line 1501 no strict;	Line 1713 no strict;
@ISA = ("Apache::lonhelper::element");	@ISA = ("Apache::lonhelper::element");
use strict;	use strict;
use Apache::lonlocal; # A localization nightmare	use Apache::lonlocal; # A localization nightmare
	use Apache::lonnet;
use Time::localtime;	use Time::localtime;

BEGIN {	BEGIN {
Line 1529 sub start_date {	Line 1741 sub start_date {
$paramHash->{'variable'} = $token->[2]{'variable'};	$paramHash->{'variable'} = $token->[2]{'variable'};
$helper->declareVar($paramHash->{'variable'});	$helper->declareVar($paramHash->{'variable'});
$paramHash->{'hoursminutes'} = $token->[2]{'hoursminutes'};	$paramHash->{'hoursminutes'} = $token->[2]{'hoursminutes'};
	$paramHash->{'anytime'} = $token->[2]{'anytime'};
}	}

sub end_date {	sub end_date {
Line 1547 sub render {	Line 1760 sub render {
my $var = $self->{'variable'};	my $var = $self->{'variable'};

my $date;	my $date;

	my $time=time;
	my ($anytime,$onclick);


	# first check VARS for a valid new value from the user
	# then check DEFAULT_VALUE for a valid default time value
	# otherwise pick now as reasonably good time

	if (defined($helper->{VARS}{$var})
	&& $helper->{VARS}{$var} > 0) {
	$date = localtime($helper->{VARS}{$var});
	} elsif (defined($self->{DEFAULT_VALUE})) {
	my $valueFunc = eval($self->{DEFAULT_VALUE});
	die('Error in default value code for variable ' .
	$self->{'variable'} . ', Perl said: ' . $@) if $@;
	$time = &$valueFunc($helper, $self);
	if (lc($time) eq 'anytime') {
	$anytime=1;
	$date = localtime(time);
	$date->min(0);
	} elsif (defined($time) && $time ne 0) {
	$date = localtime($time);
	} else {
	# leave date undefined so it'll default to now
	}
	}

	if (!defined($date)) {
	$date = localtime(time);
	$date->min(0);
	}

	if ($anytime) {
	$onclick = "onclick=\"javascript:updateCheck(this.form,'${var}anytime',false)\"";
	}
# Default date: The current hour.	# Default date: The current hour.
$date = localtime();
$date->min(0);

if (defined $self->{ERROR_MSG}) {	if (defined $self->{ERROR_MSG}) {
$result .= '<font color="#FF0000">' . $self->{ERROR_MSG} . '</font><br /><br />';	$result .= '<font color="#FF0000">' . $self->{ERROR_MSG} . '</font><br /><br />';
Line 1558 sub render {	Line 1804 sub render {

# Month	# Month
my $i;	my $i;
$result .= "<select name='${var}month'>\n";	$result .= "<select $onclick name='${var}month'>\n";
for ($i = 0; $i < 12; $i++) {	for ($i = 0; $i < 12; $i++) {
if ($i == $date->mon) {	if ($i == $date->mon) {
$result .= "<option value='$i' selected>";	$result .= "<option value='$i' selected='selected'>";
} else {	} else {
$result .= "<option value='$i'>";	$result .= "<option value='$i'>";
}	}
Line 1570 sub render {	Line 1816 sub render {
$result .= "</select>\n";	$result .= "</select>\n";

# Day	# Day
$result .= "<select name='${var}day'>\n";	$result .= "<select $onclick name='${var}day'>\n";
for ($i = 1; $i < 32; $i++) {	for ($i = 1; $i < 32; $i++) {
if ($i == $date->mday) {	if ($i == $date->mday) {
$result .= '<option selected>';	$result .= '<option selected="selected">';
} else {	} else {
$result .= '<option>';	$result .= '<option>';
}	}
Line 1582 sub render {	Line 1828 sub render {
$result .= "</select>,\n";	$result .= "</select>,\n";

# Year	# Year
$result .= "<select name='${var}year'>\n";	$result .= "<select $onclick name='${var}year'>\n";
for ($i = 2000; $i < 2030; $i++) { # update this after 64-bit dates	for ($i = 2000; $i < 2030; $i++) { # update this after 64-bit dates
if ($date->year + 1900 == $i) {	if ($date->year + 1900 == $i) {
$result .= "<option selected>";	$result .= "<option selected='selected'>";
} else {	} else {
$result .= "<option>";	$result .= "<option>";
}	}
Line 1595 sub render {	Line 1841 sub render {

# Display Hours and Minutes if they are called for	# Display Hours and Minutes if they are called for
if ($self->{'hoursminutes'}) {	if ($self->{'hoursminutes'}) {
	# This needs parameterization for times.
	my $am = &mt('a.m.');
	my $pm = &mt('p.m.');
# Build hour	# Build hour
$result .= "<select name='${var}hour'>\n";	$result .= "<select $onclick name='${var}hour'>\n";
$result .= "<option " . ($date->hour == 0 ? 'selected ':'') .	$result .= "<option " . ($date->hour == 0 ? 'selected="selected" ':'') .
" value='0'>midnight</option>\n";	" value='0'>" . &mt('midnight') . "</option>\n";
for ($i = 1; $i < 12; $i++) {	for ($i = 1; $i < 12; $i++) {
if ($date->hour == $i) {	if ($date->hour == $i) {
$result .= "<option selected value='$i'>$i a.m.</option>\n";	$result .= "<option selected='selected' value='$i'>$i $am</option>\n";
} else {	} else {
$result .= "<option value='$i'>$i a.m</option>\n";	$result .= "<option value='$i'>$i $am</option>\n";
}	}
}	}
$result .= "<option " . ($date->hour == 12 ? 'selected ':'') .	$result .= "<option " . ($date->hour == 12 ? 'selected="selected" ':'') .
" value='12'>noon</option>\n";	" value='12'>" . &mt('noon') . "</option>\n";
for ($i = 13; $i < 24; $i++) {	for ($i = 13; $i < 24; $i++) {
my $printedHour = $i - 12;	my $printedHour = $i - 12;
if ($date->hour == $i) {	if ($date->hour == $i) {
$result .= "<option selected value='$i'>$printedHour p.m.</option>\n";	$result .= "<option selected='selected' value='$i'>$printedHour $pm</option>\n";
} else {	} else {
$result .= "<option value='$i'>$printedHour p.m.</option>\n";	$result .= "<option value='$i'>$printedHour $pm</option>\n";
}	}
}	}

$result .= "</select> :\n";	$result .= "</select> :\n";

$result .= "<select name='${var}minute'>\n";	$result .= "<select $onclick name='${var}minute'>\n";
for ($i = 0; $i < 60; $i++) {	my $selected=0;
	for my $i ((0,15,30,45,59,undef,0..59)) {
my $printedMinute = $i;	my $printedMinute = $i;
if ($i < 10) {	if (defined($i) && $i < 10) {
$printedMinute = "0" . $printedMinute;	$printedMinute = "0" . $printedMinute;
}	}
if ($date->min == $i) {	if (!$selected && $date->min == $i) {
$result .= "<option selected>";	$result .= "<option selected='selected'>";
	$selected=1;
} else {	} else {
$result .= "<option>";	$result .= "<option>";
}	}
Line 1634 sub render {	Line 1885 sub render {
}	}
$result .= "</select>\n";	$result .= "</select>\n";
}	}
	if ($self->{'anytime'}) {
	$result.=(<<CHECK);
	<script type="text/javascript">
	// <!--
	function updateCheck(form,name,value) {
	var checkbox=form[name];
	checkbox.checked = value;
	}
	// -->
	</script>
	CHECK
	$result.=" or <label><input type='checkbox' ";
	if ($anytime) {
	$result.=' checked="checked" '
	}
	$result.="name='${var}anytime'/>".&mt('Any time').'</label>'
	}
return $result;	return $result;

}	}
Line 1642 sub render {	Line 1909 sub render {
sub postprocess {	sub postprocess {
my $self = shift;	my $self = shift;
my $var = $self->{'variable'};	my $var = $self->{'variable'};
my $month = $ENV{'form.' . $var . 'month'};	if ($env{'form.' . $var . 'anytime'}) {
my $day = $ENV{'form.' . $var . 'day'};	$helper->{VARS}->{$var} = undef;
my $year = $ENV{'form.' . $var . 'year'};	} else {
my $min = 0;	my $month = $env{'form.' . $var . 'month'};
my $hour = 0;	my $day = $env{'form.' . $var . 'day'};
if ($self->{'hoursminutes'}) {	my $year = $env{'form.' . $var . 'year'};
$min = $ENV{'form.' . $var . 'minute'};	my $min = 0;
$hour = $ENV{'form.' . $var . 'hour'};	my $hour = 0;
}	if ($self->{'hoursminutes'}) {
	$min = $env{'form.' . $var . 'minute'};
	$hour = $env{'form.' . $var . 'hour'};
	}

	my $chosenDate;
	eval {$chosenDate = Time::Local::timelocal(0, $min, $hour, $day, $month, $year);};
	my $error = $@;

	# Check to make sure that the date was not automatically co-erced into a
	# valid date, as we want to flag that as an error
	# This happens for "Feb. 31", for instance, which is coerced to March 2 or
	# 3, depending on if it's a leap year
	my $checkDate = localtime($chosenDate);

	if ($error \|\| $checkDate->mon != $month \|\| $checkDate->mday != $day \|\|
	$checkDate->year + 1900 != $year) {
	unless (Apache::lonlocal::current_language()== ~/^en/) {
	$self->{ERROR_MSG} = &mt("Invalid date entry");
	return 0;
	}
	# LOCALIZATION FIXME: Needs to be parameterized
	$self->{ERROR_MSG} = "Can't use " . $months[$month] . " $day, $year as a "
	. "date because it doesn't exist. Please enter a valid date.";

my $chosenDate;
eval {$chosenDate = Time::Local::timelocal(0, $min, $hour, $day, $month, $year);};
my $error = $@;

# Check to make sure that the date was not automatically co-erced into a
# valid date, as we want to flag that as an error
# This happens for "Feb. 31", for instance, which is coerced to March 2 or
# 3, depending on if it's a leap year
my $checkDate = localtime($chosenDate);

if ($error \|\| $checkDate->mon != $month \|\| $checkDate->mday != $day \|\|
$checkDate->year + 1900 != $year) {
unless (Apache::lonlocal::current_language()== ~/^en/) {
$self->{ERROR_MSG} = &mt("Invalid date entry");
return 0;	return 0;
}	}
# LOCALIZATION FIXME: Needs to be parameterized	$helper->{VARS}->{$var} = $chosenDate;
$self->{ERROR_MSG} = "Can't use " . $months[$month] . " $day, $year as a "
. "date because it doesn't exist. Please enter a valid date.";

return 0;
}	}

$helper->{VARS}->{$var} = $chosenDate;	if (defined($self->{VALIDATOR})) {
	my $validator = eval($self->{VALIDATOR});
	die 'Died during evaluation of validator code; Perl said: ' . $@ if $@;
	my $invalid = &$validator($helper, $state, $self, $self->getValue());
	if ($invalid) {
	$self->{ERROR_MSG} = $invalid;
	return 0;
	}
	}

if (defined($self->{NEXTSTATE})) {	if (defined($self->{NEXTSTATE})) {
$helper->changeState($self->{NEXTSTATE});	$helper->changeState($self->{NEXTSTATE});
Line 1707 to false. The "suppressEmptySequences" a	Line 1987 to false. The "suppressEmptySequences" a
suppressEmptySequences argument to the render routine, which will cause	suppressEmptySequences argument to the render routine, which will cause
folders that have all of their contained resources filtered out to also	folders that have all of their contained resources filtered out to also
be filtered out. The 'addstatus' attribute, if true, will add the icon	be filtered out. The 'addstatus' attribute, if true, will add the icon
and long status display columns to the display.	and long status display columns to the display. The 'addparts'
	attribute will add in a part selector beside problems that have more
	than 1 part.

=head3 SUB-TAGS	=head3 SUB-TAGS

Line 1747 and long status display columns to the d	Line 2029 and long status display columns to the d
no strict;	no strict;
@ISA = ("Apache::lonhelper::element");	@ISA = ("Apache::lonhelper::element");
use strict;	use strict;
	use Apache::lonnet;

BEGIN {	BEGIN {
&Apache::lonhelper::register('Apache::lonhelper::resource',	&Apache::lonhelper::register('Apache::lonhelper::resource',
('resource', 'filterfunc',	('resource', 'filterfunc',
'choicefunc', 'valuefunc',	'choicefunc', 'valuefunc',
'mapurl'));	'mapurl','option'));
}	}

sub new {	sub new {
Line 1774 sub start_resource {	Line 2057 sub start_resource {
$paramHash->{'suppressEmptySequences'} = $token->[2]{'suppressEmptySequences'};	$paramHash->{'suppressEmptySequences'} = $token->[2]{'suppressEmptySequences'};
$paramHash->{'toponly'} = $token->[2]{'toponly'};	$paramHash->{'toponly'} = $token->[2]{'toponly'};
$paramHash->{'addstatus'} = $token->[2]{'addstatus'};	$paramHash->{'addstatus'} = $token->[2]{'addstatus'};
	$paramHash->{'addparts'} = $token->[2]{'addparts'};
	if ($paramHash->{'addparts'}) {
	$helper->declareVar($paramHash->{'variable'}.'_part');
	}
	$paramHash->{'closeallpages'} = $token->[2]{'closeallpages'};
return '';	return '';
}	}

Line 1856 sub start_mapurl {	Line 2144 sub start_mapurl {

sub end_mapurl { return ''; }	sub end_mapurl { return ''; }


	sub start_option {
	my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
	if (!defined($paramHash->{OPTION_TEXTS})) {
	$paramHash->{OPTION_TEXTS} = [ ];
	$paramHash->{OPTION_VARS} = [ ];

	}
	# OPTION_TEXTS is a list of the text attribute
	# values used to create column headings.
	# OPTION_VARS is a list of the variable names, used to create the checkbox
	# inputs.
	# We're ok with empty elements. as place holders
	# Although the 'variable' element should really exist.
	#

	my $option_texts = $paramHash->{OPTION_TEXTS};
	my $option_vars = $paramHash->{OPTION_VARS};
	push(@$option_texts, $token->[2]{'text'});
	push(@$option_vars, $token->[2]{'variable'});

	# Need to create and declare the option variables as well to make them
	# persistent.
	#
	my $varname = $token->[2]{'variable'};
	$helper->declareVar($varname);


	return '';
	}

	sub end_option {
	my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;
	return '';
	}

# A note, in case I don't get to this before I leave.	# A note, in case I don't get to this before I leave.
# If someone complains about the "Back" button returning them	# If someone complains about the "Back" button returning them
# to the previous folder state, instead of returning them to	# to the previous folder state, instead of returning them to
Line 1878 sub render {	Line 2202 sub render {

if ($self->{'multichoice'}) {	if ($self->{'multichoice'}) {
$result = <<SCRIPT;	$result = <<SCRIPT;
<script>	<script type="text/javascript">
	// <!--
function checkall(value, checkName) {	function checkall(value, checkName) {
for (i=0; i<document.forms.helpform.elements.length; i++) {	for (i=0; i<document.forms.helpform.elements.length; i++) {
ele = document.forms.helpform.elements[i];	ele = document.forms.helpform.elements[i];
if (ele.name == checkName + '.forminput') {	if (ele.name == checkName + '_forminput') {
document.forms.helpform.elements[i].checked=value;	document.forms.helpform.elements[i].checked=value;
}	}
}	}
}	}
	// -->
</script>	</script>
SCRIPT	SCRIPT
	my %lt=&Apache::lonlocal::texthash(
	'sar' => "Select All Resources",
	'uar' => "Unselect All Resources");

$buttons = <<BUTTONS;	$buttons = <<BUTTONS;
<br />	<br />
<input type="button" onclick="checkall(true, '$var')" value="Select All Resources" />	<input type="button" onclick="checkall(true, '$var')" value="$lt{'sar'}" />
<input type="button" onclick="checkall(false, '$var')" value="Unselect All Resources" />	<input type="button" onclick="checkall(false, '$var')" value="$lt{'uar'}" />
<br />	<br />
BUTTONS	BUTTONS
}	}
Line 1903 BUTTONS	Line 2233 BUTTONS

$result .= $buttons;	$result .= $buttons;

my $filterFunc = $self->{FILTER_FUNC};	my $filterFunc = $self->{FILTER_FUNC};
my $choiceFunc = $self->{CHOICE_FUNC};	my $choiceFunc = $self->{CHOICE_FUNC};
my $valueFunc = $self->{VALUE_FUNC};	my $valueFunc = $self->{VALUE_FUNC};
my $multichoice = $self->{'multichoice'};	my $multichoice = $self->{'multichoice'};
	my $option_vars = $self->{OPTION_VARS};
	my $option_texts = $self->{OPTION_TEXTS};
	my $addparts = $self->{'addparts'};
	my $headings_done = 0;

# Evaluate the map url as needed	# Evaluate the map url as needed
my $mapUrl;	my $mapUrl;
Line 1918 BUTTONS	Line 2252 BUTTONS
$mapUrl = $self->{MAP_URL};	$mapUrl = $self->{MAP_URL};
}	}

	my %defaultSymbs;
	if (defined($self->{DEFAULT_VALUE})) {
	my $valueFunc = eval($self->{DEFAULT_VALUE});
	die 'Error in default value code for variable ' .
	$self->{'variable'} . ', Perl said: ' . $@ if $@;
	my @defaultSymbs = &$valueFunc($helper, $self);
	if (!$multichoice && @defaultSymbs) { # only allowed 1
	@defaultSymbs = ($defaultSymbs[0]);
	}
	%defaultSymbs = map { if ($_) {($_,1) } } @defaultSymbs;
	delete($defaultSymbs{''});
	}

# Create the composite function that renders the column on the nav map	# Create the composite function that renders the column on the nav map
# have to admit any language that lets me do this can't be all bad	# have to admit any language that lets me do this can't be all bad
# - Jeremy (Pythonista) ;-)	# - Jeremy (Pythonista) ;-)
my $checked = 0;	my $checked = 0;
my $renderColFunc = sub {	my $renderColFunc = sub {
my ($resource, $part, $params) = @_;	my ($resource, $part, $params) = @_;
	my $result = "";

	if(!$headings_done) {
	if ($option_texts) {
	foreach my $text (@$option_texts) {
	$result .= "<th>$text</th>";
	}
	}
	$result .= "<th>Select</th>";
	$result .= "</tr><tr>"; # Close off the extra row and start a new one.
	$headings_done = 1;
	}

my $inputType;	my $inputType;
if ($multichoice) { $inputType = 'checkbox'; }	if ($multichoice) { $inputType = 'checkbox'; }
else {$inputType = 'radio'; }	else {$inputType = 'radio'; }

if (!&$choiceFunc($resource)) {	if (!&$choiceFunc($resource)) {
return '<td> </td>';	$result .= '<td> </td>';
	return $result;
} else {	} else {
my $col = "<td><input type='$inputType' name='${var}.forminput' ";	my $col = "";
if (!$checked && !$multichoice) {	my $raw_name = &$valueFunc($resource);
$col .= "checked ";	my $resource_name =
$checked = 1;	HTML::Entities::encode($raw_name,"<>&\"'");
}	if($option_vars) {
if ($multichoice) { # all resources start checked; see bug 1174	foreach my $option_var (@$option_vars) {
$col .= "checked ";	my $var_value = "\\|\\|\\|" . $helper->{VARS}->{$option_var} .
$checked = 1;	"\\|\\|\\|";
	my $checked ="";
	if($var_value =~ /\Q\|\|\|$raw_name\|\|\|\E/) {
	$checked = "checked='checked'";
	}
	$col .=
	"<td align='center'><input type='checkbox' name ='$option_var".
	"_forminput' value='".
	$resource_name . "' $checked /> </td>";
	}
}	}
$col .= "value='" .
HTML::Entities::encode(&$valueFunc($resource))	$col .= "<td align='center'><input type='$inputType' name='${var}_forminput' ";
. "' /></td>";	if (%defaultSymbs) {
return $col;	my $symb=$resource->symb();
	if (exists($defaultSymbs{$symb})) {
	$col .= "checked='checked' ";
	$checked = 1;
	}
	} else {
	if (!$checked && !$multichoice) {
	$col .= "checked='checked' ";
	$checked = 1;
	}
	if ($multichoice) { # all resources start checked; see bug 1174
	$col .= "checked='checked' ";
	$checked = 1;
	}
	}
	$col .= "value='" . $resource_name . "' /></td>";

	return $result.$col;
}	}
};	};
	my $renderPartsFunc = sub {
	my ($resource, $part, $params) = @_;
	my $col= "<td>";
	my $id=$resource->{ID};
	my $resource_name =
	&HTML::Entities::encode(&$valueFunc($resource),"<>&\"'");
	if ($addparts && (scalar(@{$resource->parts}) > 1)) {
	$col .= "<select onclick=\"javascript:updateRadio(this.form,'${var}_forminput','$resource_name');updateHidden(this.form,'$id','${var}');\" name='part_${id}_forminput'>\n";
	$col .= "<option value=\"$part\">All Parts</option>\n";
	foreach my $part (@{$resource->parts}) {
	$col .= "<option value=\"$part\">Part: $part</option>\n";
	}
	$col .= "</select>";
	}
	$col .= "</td>";
	};
	$result.=(<<RADIO);
	<script type="text/javascript">
	// <!--
	function updateRadio(form,name,value) {
	var radiobutton=form[name];
	for (var i=0; i<radiobutton.length; i++) {
	if (radiobutton[i].value == value) {
	radiobutton[i].checked = true;
	break;
	}
	}
	}
	function updateHidden(form,id,name) {
	var select=form['part_'+id+'_forminput'];
	var hidden=form[name+'_part_forminput'];
	var which=select.selectedIndex;
	hidden.value=select.options[which].value;
	}
	// -->
	</script>
	<input type="hidden" name="${var}_part_forminput" />

$ENV{'form.condition'} = !$self->{'toponly'};	RADIO
my $cols = [$renderColFunc, Apache::lonnavmaps::resource()];	$env{'form.condition'} = !$self->{'toponly'};
	my $cols = [$renderColFunc];
	if ($self->{'addparts'}) { push(@$cols, $renderPartsFunc); }
	push(@$cols, Apache::lonnavmaps::resource());
if ($self->{'addstatus'}) {	if ($self->{'addstatus'}) {
push @$cols, (Apache::lonnavmaps::part_status_summary());	push @$cols, (Apache::lonnavmaps::part_status_summary());

Line 1959 BUTTONS	Line 2385 BUTTONS
'showParts' => 0,	'showParts' => 0,
'filterFunc' => $filterFunc,	'filterFunc' => $filterFunc,
'resource_no_folder_link' => 1,	'resource_no_folder_link' => 1,
	'closeAllPages' => $self->{'closeallpages'},
'suppressEmptySequences' => $self->{'suppressEmptySequences'},	'suppressEmptySequences' => $self->{'suppressEmptySequences'},
'iterator_map' => $mapUrl }	'iterator_map' => $mapUrl }
);	);
Line 2017 selection. Defaults to false.	Line 2444 selection. Defaults to false.
If true, only active students and course personnel will be	If true, only active students and course personnel will be
shown. Defaults to false.	shown. Defaults to false.

	=item * B<emptyallowed>:

	If true, the selection of no users is allowed. Defaults to false.

=back	=back

=cut	=cut
Line 2024 shown. Defaults to false.	Line 2455 shown. Defaults to false.
no strict;	no strict;
@ISA = ("Apache::lonhelper::element");	@ISA = ("Apache::lonhelper::element");
use strict;	use strict;
	use Apache::lonlocal;
	use Apache::lonnet;

BEGIN {	BEGIN {
&Apache::lonhelper::register('Apache::lonhelper::student',	&Apache::lonhelper::register('Apache::lonhelper::student',
Line 2048 sub start_student {	Line 2479 sub start_student {
$helper->declareVar($paramHash->{'variable'});	$helper->declareVar($paramHash->{'variable'});
$paramHash->{'multichoice'} = $token->[2]{'multichoice'};	$paramHash->{'multichoice'} = $token->[2]{'multichoice'};
$paramHash->{'coursepersonnel'} = $token->[2]{'coursepersonnel'};	$paramHash->{'coursepersonnel'} = $token->[2]{'coursepersonnel'};
$paramHash->{'sctiveonly'} = $token->[2]{'activeonly'};	$paramHash->{'activeonly'} = $token->[2]{'activeonly'};
if (defined($token->[2]{'nextstate'})) {	if (defined($token->[2]{'nextstate'})) {
$paramHash->{NEXTSTATE} = $token->[2]{'nextstate'};	$paramHash->{NEXTSTATE} = $token->[2]{'nextstate'};
}	}
	$paramHash->{'emptyallowed'} = $token->[2]{'emptyallowed'};

}	}

Line 2070 sub render {	Line 2502 sub render {
my $buttons = '';	my $buttons = '';
my $var = $self->{'variable'};	my $var = $self->{'variable'};

if ($self->{'multichoice'}) {
$result = <<SCRIPT;
<script>
function checkall(value, checkName) {
for (i=0; i<document.forms.helpform.elements.length; i++) {
ele = document.forms.helpform.elements[i];
if (ele.name == checkName + '.forminput') {
document.forms.helpform.elements[i].checked=value;
}
}
}
function checksec() {
for (i=0; i<document.forms.helpform.elements.length; i++) {
comp = document.forms.helpform.elements.chksec.value;
if (document.forms.helpform.elements[i].value.indexOf(':'+comp+':') != -1) {
document.forms.helpform.elements[i].checked=true;
}
}
}
function checkactive() {
for (i=0; i<document.forms.helpform.elements.length; i++) {
if (document.forms.helpform.elements[i].value.indexOf(':Active') != -1) {
document.forms.helpform.elements[i].checked=true;
}
}
}
</script>
SCRIPT
$buttons = <<BUTTONS;
<br />
<input type="button" onclick="checkactive()" value="Select Only Current Students" />
<input type="button" onclick="checkall(true, '$var')" value="Select All Students" />
<input type="button" onclick="checkall(false, '$var')" value="Unselect All Students" />
<input type="button" onclick="checksec()" value="Check for Section/Group">
<input type="text" size="5" name="chksec">
<br />
BUTTONS
}

if (defined $self->{ERROR_MSG}) {	if (defined $self->{ERROR_MSG}) {
$result .= '<font color="#FF0000">' . $self->{ERROR_MSG} . '</font><br /><br />';	$result .= '<font color="#FF0000">' . $self->{ERROR_MSG} . '</font><br /><br />';
}	}

my $choices = [];	my %defaultUsers;
	if (defined($self->{DEFAULT_VALUE})) {
	my $valueFunc = eval($self->{DEFAULT_VALUE});
	die 'Error in default value code for variable ' .
	$self->{'variable'} . ', Perl said: ' . $@ if $@;
	my @defaultUsers = &$valueFunc($helper, $self);
	if (!$self->{'multichoice'} && @defaultUsers) { # only allowed 1
	@defaultUsers = ($defaultUsers[0]);
	}
	%defaultUsers = map { if ($_) {($_,1) } } @defaultUsers;
	delete($defaultUsers{''});
	}


	my ($course_personnel,
	$current_members,
	$expired_members,
	$future_members) =
	&Apache::lonselstudent::get_people_in_class($env{'request.course.sec'});



# Load up the non-students, if necessary	# Load up the non-students, if necessary

if ($self->{'coursepersonnel'}) {	if ($self->{'coursepersonnel'}) {
my %coursepersonnel = Apache::lonnet::get_course_adv_roles();	unshift @$current_members, (@$course_personnel);
for (sort keys %coursepersonnel) {
for my $role (split /,/, $coursepersonnel{$_}) {
# extract the names so we can sort them
my @people;

for (split /,/, $role) {
push @people, [split /:/, $role];
}

@people = sort { $a->[0] cmp $b->[0] } @people;

for my $person (@people) {
push @$choices, [join(':', @$person), $person->[0], '', $_];
}
}
}
}	}

# Constants
my $section = Apache::loncoursedata::CL_SECTION();
my $fullname = Apache::loncoursedata::CL_FULLNAME();
my $status = Apache::loncoursedata::CL_STATUS();

# Load up the students	# Current personel
my $classlist = &Apache::loncoursedata::get_classlist();
my @keys = keys %{$classlist};	$result .= '<h4>'.&mt('Select Currently Enrolled Students and Active Course Personnel').'</h4>';
# Sort by: Section, name	$result .= &Apache::lonselstudent::render_student_list( $current_members,
@keys = sort {	"helpform",
if ($classlist->{$a}->[$section] ne $classlist->{$b}->[$section]) {	"current",
return $classlist->{$a}->[$section] cmp $classlist->{$b}->[$section];	\%defaultUsers,
}	$self->{'multichoice'},
return $classlist->{$a}->[$fullname] cmp $classlist->{$b}->[$fullname];	$self->{'variable'},
} @keys;	1);

# username, fullname, section, type
for (@keys) {	# If activeonly is not set then we can also give the expired students:
# Filter out inactive students if we've set "activeonly"	#
if (!$self->{'activeonly'} \|\| $classlist->{$_}->[$status] eq	if (!$self->{'activeonly'} && ((scalar(@$future_members)) > 0)) {
'Active') {
push @$choices, [$_, $classlist->{$_}->[$fullname],	# And future.
$classlist->{$_}->[$section],
$classlist->{$_}->[$status], 'Student'];	$result .= '<h4>'.&mt('Select Future Enrolled Students and Future Course Personnel').'</h4>';
}
	$result .= &Apache::lonselstudent::render_student_list( $future_members,
	"helpform",
	"future",
	\%defaultUsers,
	$self->{'multichoice'},
	$self->{'variable'},
	0);
	}
	if (!$self->{'activeonly'} && ((scalar(@$expired_members)) > 0)) {
	# Past

	$result .= '<h4>'.&mt('Select Previously Enrolled Students and Inactive Course Personnel').'</h4>';
	$result .= &Apache::lonselstudent::render_student_list($expired_members,
	"helpform",
	"past",
	\%defaultUsers,
	$self->{'multichoice'},
	$self->{'variable'},
	0);
}	}

my $name = $self->{'coursepersonnel'} ? 'Name' : 'Student Name';
my $type = 'radio';
if ($self->{'multichoice'}) { $type = 'checkbox'; }
$result .= "<table cellspacing='2' cellpadding='2' border='0'>\n";
$result .= "<tr><td></td><td align='center'><b>$name</b></td>".
"<td align='center'><b>Section</b></td>" .
"<td align='center'><b>Status</b></td>" .
"<td align='center'><b>Role</b></td>" .
"<td align='center'><b>Username:Domain</b></td></tr>";

my $checked = 0;
for my $choice (@$choices) {
$result .= "<tr><td><input type='$type' name='" .
$self->{'variable'} . '.forminput' . "'";

if (!$self->{'multichoice'} && !$checked) {
$result .= " checked ";
$checked = 1;
}
$result .=
" value='" . HTML::Entities::encode($choice->[0] . ':' . $choice->[2] . ':' . $choice->[1] . ':' . $choice->[3])
. "' /></td><td>"
. HTML::Entities::encode($choice->[1])
. "</td><td align='center'>"
. HTML::Entities::encode($choice->[2])
. "</td>\n<td>"
. HTML::Entities::encode($choice->[3])
. "</td>\n<td>"
. HTML::Entities::encode($choice->[4])
. "</td>\n<td>"
. HTML::Entities::encode($choice->[0])
. "</td></tr>\n";
}

$result .= "</table>\n\n";
$result .= $buttons;

return $result;	return $result;
}	}

sub postprocess {	sub postprocess {
my $self = shift;	my $self = shift;

my $result = $ENV{'form.' . $self->{'variable'} . '.forminput'};	my $result = $env{'form.' . $self->{'variable'} . '_forminput'};
if (!$result) {	if (!$result && !$self->{'emptyallowed'}) {
$self->{ERROR_MSG} = 'You must choose at least one student '.	if ($self->{'coursepersonnel'}) {
'to continue.';	$self->{ERROR_MSG} =
	&mt('You must choose at least one user to continue.');
	} else {
	$self->{ERROR_MSG} =
	&mt('You must choose at least one student to continue.');
	}
return 0;	return 0;
}	}

Line 2275 viewing the files.	Line 2659 viewing the files.
no strict;	no strict;
@ISA = ("Apache::lonhelper::element");	@ISA = ("Apache::lonhelper::element");
use strict;	use strict;
	use Apache::lonlocal;
	use Apache::lonnet;
use Apache::lonpubdir; # for getTitleString	use Apache::lonpubdir; # for getTitleString

BEGIN {	BEGIN {
Line 2350 sub start_filefilter {	Line 2735 sub start_filefilter {

sub end_filefilter { return ''; }	sub end_filefilter { return ''; }

	{
	# used to generate unique id attributes for <input> tags.
	# internal use only.
	my $id=0;
	sub new_id { return $id++;}
	}

sub render {	sub render {
my $self = shift;	my $self = shift;
my $result = '';	my $result = '';
Line 2373 sub render {	Line 2765 sub render {

if ($self->{'multichoice'}) {	if ($self->{'multichoice'}) {
$result = <<SCRIPT;	$result = <<SCRIPT;
<script>	<script type="text/javascript">
	// <!--
function checkall(value, checkName) {	function checkall(value, checkName) {
for (i=0; i<document.forms.helpform.elements.length; i++) {	for (i=0; i<document.forms.helpform.elements.length; i++) {
ele = document.forms.helpform.elements[i];	ele = document.forms.helpform.elements[i];
if (ele.name == checkName + '.forminput') {	if (ele.name == checkName + '_forminput') {
document.forms.helpform.elements[i].checked=value;	document.forms.helpform.elements[i].checked=value;
}	}
}	}
Line 2391 sub render {	Line 2784 sub render {
}	}
}	}
}	}
	// -->
</script>	</script>
SCRIPT	SCRIPT
$buttons = <<BUTTONS;	my %lt=&Apache::lonlocal::texthash(
	'saf' => "Select All Files",
	'uaf' => "Unselect All Files");
	$buttons = <<BUTTONS;
<br />	<br />
<input type="button" onclick="checkall(true, '$var')" value="Select All Files" />	<input type="button" onclick="checkall(true, '$var')" value="$lt{'saf'}" />
<input type="button" onclick="checkall(false, '$var')" value="Unselect All Files" />	<input type="button" onclick="checkall(false, '$var')" value="$lt{'uaf'}" />
BUTTONS	BUTTONS

	%lt=&Apache::lonlocal::texthash(
	'sap' => "Select All Published",
	'uap' => "Unselect All Published");
if ($helper->{VARS}->{'construction'}) {	if ($helper->{VARS}->{'construction'}) {
$buttons .= <<BUTTONS;	$buttons .= <<BUTTONS;
<input type="button" onclick="checkallclass(true, 'Published')" value="Select All Published" />	<input type="button" onclick="checkallclass(true, 'Published')" value="$lt{'sap'}" />
<input type="button" onclick="checkallclass(false, 'Published')" value="Unselect All Published" />	<input type="button" onclick="checkallclass(false, 'Published')" value="$lt{'uap'}" />
<br />	<br />
BUTTONS	BUTTONS
}	}
Line 2414 BUTTONS	Line 2814 BUTTONS
# If the subdirectory is in local CSTR space	# If the subdirectory is in local CSTR space
my $metadir;	my $metadir;
if ($subdir =~ m\|/home/([^/]+)/public_html/(.*)\|) {	if ($subdir =~ m\|/home/([^/]+)/public_html/(.*)\|) {
my $user = $1;	my ($user,$domain)=
my $domain = $Apache::lonnet::perlvar{'lonDefDomain'};	&Apache::loncacc::constructaccess($subdir,
	$Apache::lonnet::perlvar{'lonDefDomain'});
$metadir='/res/'.$domain.'/'.$user.'/'.$2;	$metadir='/res/'.$domain.'/'.$user.'/'.$2;
@fileList = &Apache::lonnet::dirlist($subdir, $domain, $user, '');	@fileList = &Apache::lonnet::dirlist($subdir, $domain, $user, '');
} elsif ($subdir =~ m\|^~([^/]+)/(.*)$\|) {	} elsif ($subdir =~ m\|^~([^/]+)/(.*)$\|) {
$subdir='/home/'.$1.'/public_html/'.$2;	$subdir='/home/'.$1.'/public_html/'.$2;
my $user = $1;	my ($user,$domain)=
my $domain = $Apache::lonnet::perlvar{'lonDefDomain'};	&Apache::loncacc::constructaccess($subdir,
	$Apache::lonnet::perlvar{'lonDefDomain'});
$metadir='/res/'.$domain.'/'.$user.'/'.$2;	$metadir='/res/'.$domain.'/'.$user.'/'.$2;
@fileList = &Apache::lonnet::dirlist($subdir, $domain, $user, '');	@fileList = &Apache::lonnet::dirlist($subdir, $domain, $user, '');
} else {	} else {
# local library server resource space	# local library server resource space
@fileList = &Apache::lonnet::dirlist($subdir, $ENV{'user.domain'}, $ENV{'user.name'}, '');	@fileList = &Apache::lonnet::dirlist($subdir, $env{'user.domain'}, $env{'user.name'}, '');
}	}

# Sort the fileList into order	# Sort the fileList into order
@fileList = sort @fileList;	@fileList = sort {lc($a) cmp lc($b)} @fileList;

$result .= $buttons;	$result .= $buttons;

Line 2482 BUTTONS	Line 2884 BUTTONS
if ($status eq 'Published' && $helper->{VARS}->{'construction'}) {	if ($status eq 'Published' && $helper->{VARS}->{'construction'}) {
$onclick = 'onclick="a=1" ';	$onclick = 'onclick="a=1" ';
}	}
	my $id = &new_id();
$result .= '<tr><td align="right"' . " bgcolor='$color'>" .	$result .= '<tr><td align="right"' . " bgcolor='$color'>" .
"<input $onclick type='$type' name='" . $var	"<input $onclick type='$type' name='" . $var
. ".forminput' value='" . HTML::Entities::encode($fileName) .	. "_forminput' ".qq{id="$id"}." value='" . HTML::Entities::encode($fileName,"<>&\"'").
"'";	"'";
if (!$self->{'multichoice'} && $choices == 0) {	if (!$self->{'multichoice'} && $choices == 0) {
$result .= ' checked';	$result .= ' checked="checked"';
}	}
$result .= "/></td><td bgcolor='$color'>" . $file . "</td>" .	$result .= "/></td><td bgcolor='$color'>".
	qq{<label for="$id">}. $file . "</label></td>" .
"<td bgcolor='$color'>$title</td>" .	"<td bgcolor='$color'>$title</td>" .
"<td bgcolor='$color'>$status</td>" . "</tr>\n";	"<td bgcolor='$color'>$status</td>" . "</tr>\n";
$choices++;	$choices++;
Line 2517 sub fileState {	Line 2921 sub fileState {
my $constructionSpaceDir = shift;	my $constructionSpaceDir = shift;
my $file = shift;	my $file = shift;

	my ($uname,$udom)=($env{'user.name'},$env{'user.domain'});
	if ($env{'request.role'}=~/^ca\./) {
	(undef,$udom,$uname)=split(/\//,$env{'request.role'});
	}
my $docroot = $Apache::lonnet::perlvar{'lonDocRoot'};	my $docroot = $Apache::lonnet::perlvar{'lonDocRoot'};
my $subdirpart = $constructionSpaceDir;	my $subdirpart = $constructionSpaceDir;
$subdirpart =~ s/^\/home\/$ENV{'user.name'}\/public_html//;	$subdirpart =~ s/^\/home\/$uname\/public_html//;
my $resdir = $docroot . '/res/' . $ENV{'user.domain'} . '/' . $ENV{'user.name'} .	my $resdir = $docroot . '/res/' . $udom . '/' . $uname .
$subdirpart;	$subdirpart;

my @constructionSpaceFileStat = stat($constructionSpaceDir . '/' . $file);	my @constructionSpaceFileStat = stat($constructionSpaceDir . '/' . $file);
Line 2540 sub fileState {	Line 2948 sub fileState {

sub postprocess {	sub postprocess {
my $self = shift;	my $self = shift;
my $result = $ENV{'form.' . $self->{'variable'} . '.forminput'};	my $result = $env{'form.' . $self->{'variable'} . '_forminput'};
if (!$result) {	if (!$result) {
$self->{ERROR_MSG} = 'You must choose at least one file '.	$self->{ERROR_MSG} = 'You must choose at least one file '.
'to continue.';	'to continue.';
Line 2565 package Apache::lonhelper::section;	Line 2973 package Apache::lonhelper::section;
<section> allows the user to choose one or more sections from the current	<section> allows the user to choose one or more sections from the current
course.	course.

It takes the standard attributes "variable", "multichoice", and	It takes the standard attributes "variable", "multichoice",
"nextstate", meaning what they do for most other elements.	"allowempty" and "nextstate", meaning what they do for most other
	elements.

	also takes a boolean 'onlysections' whcih will restrict this to only
	have sections and not include groups

=cut	=cut

Line 2596 sub start_section {	Line 3008 sub start_section {
$paramHash->{'variable'} = $token->[2]{'variable'};	$paramHash->{'variable'} = $token->[2]{'variable'};
$helper->declareVar($paramHash->{'variable'});	$helper->declareVar($paramHash->{'variable'});
$paramHash->{'multichoice'} = $token->[2]{'multichoice'};	$paramHash->{'multichoice'} = $token->[2]{'multichoice'};
	$paramHash->{'allowempty'} = $token->[2]{'allowempty'};
if (defined($token->[2]{'nextstate'})) {	if (defined($token->[2]{'nextstate'})) {
$paramHash->{NEXTSTATE} = $token->[2]{'nextstate'};	$paramHash->{NEXTSTATE} = $token->[2]{'nextstate'};
}	}
Line 2605 sub start_section {	Line 3018 sub start_section {

my $section = Apache::loncoursedata::CL_SECTION();	my $section = Apache::loncoursedata::CL_SECTION();
my $classlist = Apache::loncoursedata::get_classlist();	my $classlist = Apache::loncoursedata::get_classlist();
foreach (keys %$classlist) {	foreach my $user (keys(%$classlist)) {
my $sectionName = $classlist->{$_}->[$section];	my $section_name = $classlist->{$user}[$section];
if (!$sectionName) {	if (!$section_name) {
$choices{"No section assigned"} = "";	$choices{"No section assigned"} = "";
} else {	} else {
$choices{$sectionName} = $sectionName;	$choices{$section_name} = $section_name;
}	}
}	}

for my $sectionName (sort(keys(%choices))) {	if (exists($choices{"No section assigned"})) {
	push(@{$paramHash->{CHOICES}},
push @{$paramHash->{CHOICES}}, [$sectionName, $sectionName];	['No section assigned','No section assigned']);
	delete($choices{"No section assigned"});
	}
	for my $section_name (sort {lc($a) cmp lc($b) } (keys(%choices))) {
	push @{$paramHash->{CHOICES}}, [$section_name, $section_name];
	}
	return if ($token->[2]{'onlysections'});

	# add in groups to the end of the list
	my %curr_groups = &Apache::longroup::coursegroups();
	foreach my $group_name (sort(keys(%curr_groups))) {
	push(@{$paramHash->{CHOICES}}, [$group_name, $group_name]);
}	}
}	}

Line 2630 sub end_section {	Line 3054 sub end_section {
}	}
1;	1;

	package Apache::lonhelper::group;

	=pod

	=head2 Element: groupX<group, helper element>

	<group> allows the user to choose one or more groups from the current course.

	It takes the standard attributes "variable", "multichoice",
	"allowempty" and "nextstate", meaning what they do for most other
	elements.

	=cut

	no strict;
	@ISA = ("Apache::lonhelper::choices");
	use strict;

	BEGIN {
	&Apache::lonhelper::register('Apache::lonhelper::group',
	('group'));
	}

	sub new {
	my $ref = Apache::lonhelper::choices->new();
	bless($ref);
	}

	sub start_group {
	my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;

	if ($target ne 'helper') {
	return '';
	}

	$paramHash->{CHOICES} = [];

	$paramHash->{'variable'} = $token->[2]{'variable'};
	$helper->declareVar($paramHash->{'variable'});
	$paramHash->{'multichoice'} = $token->[2]{'multichoice'};
	$paramHash->{'allowempty'} = $token->[2]{'allowempty'};
	if (defined($token->[2]{'nextstate'})) {
	$paramHash->{NEXTSTATE} = $token->[2]{'nextstate'};
	}

	# Populate the CHOICES element
	my %choices;

	my %curr_groups = &Apache::longroup::coursegroups();
	foreach my $group_name (sort {lc($a) cmp lc($b)} (keys(%curr_groups))) {
	push(@{$paramHash->{CHOICES}}, [$group_name, $group_name]);
	}
	}

	sub end_group {
	my ($target,$token,$tagstack,$parstack,$parser,$safeeval,$style)=@_;

	if ($target ne 'helper') {
	return '';
	}
	Apache::lonhelper::group->new();
	}
	1;

package Apache::lonhelper::string;	package Apache::lonhelper::string;

=pod	=pod
Line 2649 string honors the validation function, i	Line 3137 string honors the validation function, i
no strict;	no strict;
@ISA = ("Apache::lonhelper::element");	@ISA = ("Apache::lonhelper::element");
use strict;	use strict;
	use Apache::lonlocal;

BEGIN {	BEGIN {
&Apache::lonhelper::register('Apache::lonhelper::string',	&Apache::lonhelper::register('Apache::lonhelper::string',
Line 2692 sub render {	Line 3181 sub render {
my $result = '';	my $result = '';

if (defined $self->{ERROR_MSG}) {	if (defined $self->{ERROR_MSG}) {
$result .= '<br /><font color="#FF0000">' . $self->{ERROR_MSG} . '</font><br /><br />';	$result .= '<p><font color="#FF0000">' . $self->{ERROR_MSG} . '</font></p>';
}	}

$result .= '<input type="string" name="' . $self->{'variable'} . '.forminput"';	$result .= '<input type="string" name="' . $self->{'variable'} . '_forminput"';

if (defined($self->{'size'})) {	if (defined($self->{'size'})) {
$result .= ' size="' . $self->{'size'} . '"';	$result .= ' size="' . $self->{'size'} . '"';
Line 2722 sub postprocess {	Line 3211 sub postprocess {

if (defined($self->{VALIDATOR})) {	if (defined($self->{VALIDATOR})) {
my $validator = eval($self->{VALIDATOR});	my $validator = eval($self->{VALIDATOR});
die 'Died during evaluation of evaulation code; Perl said: ' . $@ if $@;	die 'Died during evaluation of validator code; Perl said: ' . $@ if $@;
my $invalid = &$validator($helper, $state, $self, $self->getValue());	my $invalid = &$validator($helper, $state, $self, $self->getValue());
if ($invalid) {	if ($invalid) {
$self->{ERROR_MSG} = $invalid;	$self->{ERROR_MSG} = $invalid;
Line 2746 package Apache::lonhelper::general;	Line 3235 package Apache::lonhelper::general;
=head2 General-purpose tag: <exec>X<exec, helper tag>	=head2 General-purpose tag: <exec>X<exec, helper tag>

The contents of the exec tag are executed as Perl code, B<not> inside a	The contents of the exec tag are executed as Perl code, B<not> inside a
safe space, so the full range of $ENV and such is available. The code	safe space, so the full range of $env and such is available. The code
will be executed as a subroutine wrapped with the following code:	will be executed as a subroutine wrapped with the following code:

"sub { my $helper = shift; my $state = shift;" and	"sub { my $helper = shift; my $state = shift;" and
Line 2767 be able to call methods on it.	Line 3256 be able to call methods on it.

=cut	=cut

	use Apache::lonlocal;
	use Apache::lonnet;

BEGIN {	BEGIN {
&Apache::lonhelper::register('Apache::lonhelper::general',	&Apache::lonhelper::register('Apache::lonhelper::general',
'exec', 'condition', 'clause',	'exec', 'condition', 'clause',
Line 2825 sub start_clause {	Line 3317 sub start_clause {
die 'Error in clause of condition, Perl said: ' . $@ if $@;	die 'Error in clause of condition, Perl said: ' . $@ if $@;
if (!&$clause($helper, $paramHash)) {	if (!&$clause($helper, $paramHash)) {
# Discard all text until the /condition.	# Discard all text until the /condition.
&Apache::lonxml::get_all_text('/condition', $parser);	my $end_tag = $paramHash->{SKIPTAG} \|\| '/condition';
	&Apache::lonxml::get_all_text($end_tag, $parser);
}	}
}	}

Line 2888 will make a "Finish Helper" button that	Line 3381 will make a "Finish Helper" button that
which is useful for the Course Initialization helper so the users never see	which is useful for the Course Initialization helper so the users never see
the old values taking effect.	the old values taking effect.

	If the parameter "restartCourse" is not true a 'Finish' Button will be
	presented that takes the user back to whatever was defined as <exitpage>

=cut	=cut

no strict;	no strict;
@ISA = ("Apache::lonhelper::element");	@ISA = ("Apache::lonhelper::element");
use strict;	use strict;
	use Apache::lonlocal;
	use Apache::lonnet;
BEGIN {	BEGIN {
&Apache::lonhelper::register('Apache::lonhelper::final',	&Apache::lonhelper::register('Apache::lonhelper::final',
('final', 'exitpage'));	('final', 'exitpage'));
Line 2978 sub render {	Line 3475 sub render {
}	}

if (!@results) {	if (!@results) {
$result .= ' <li>No changes were made to current settings.</li>';	$result .= ' <li>' .
	&mt('No changes were made to current settings.') . '</li>';
}	}

$result .= '</ul>';	$result .= '</ul>';
}	}

	my $actionURL = $self->{EXIT_PAGE};
	my $targetURL = '';
	my $finish=&mt('Finish');
if ($self->{'restartCourse'}) {	if ($self->{'restartCourse'}) {
my $targetURL = '/adm/menu';	$actionURL = '/adm/roles';
if ($ENV{'course.'.$ENV{'request.course.id'}.'.clonedfrom'}) {	$targetURL = '/adm/menu';
	if ($env{'course.'.$env{'request.course.id'}.'.url'}=~/^uploaded/) {
	$targetURL = '/adm/coursedocs';
	} else {
	$targetURL = '/adm/navmaps';
	}
	if ($env{'course.'.$env{'request.course.id'}.'.clonedfrom'}) {
$targetURL = '/adm/parmset?overview=1';	$targetURL = '/adm/parmset?overview=1';
}	}
$result .= "<center>\n" .	my $finish=&mt('Finish Course Initialization');
"<form action='/adm/roles' method='post' target='loncapaclient'>\n" .
"<input type='button' onclick='history.go(-1)' value='<- Previous' />" .
"<input type='hidden' name='orgurl' value='$targetURL' />" .
"<input type='hidden' name='selectrole' value='1' />\n" .
"<input type='hidden' name='" . $ENV{'request.role'} .
"' value='1' />\n<input type='submit' value='Finish Course Initialization' />\n" .
"</form></center>";
}	}
	my $previous = HTML::Entities::encode(&mt("<- Previous"), '<>&"');
	my $next = HTML::Entities::encode(&mt("Next ->"), '<>&"');
	my $target = " target='loncapaclient'";
	if (($env{'browser.interface'} eq 'textual') \|\|
	($env{'environment.remote'} eq 'off')) { $target=''; }
	$result .= "<center>\n" .
	"<form action='".$actionURL."' method='post' $target>\n" .
	"<input type='button' onclick='history.go(-1)' value='$previous' />" .
	"<input type='hidden' name='orgurl' value='$targetURL' />" .
	"<input type='hidden' name='selectrole' value='1' />\n" .
	"<input type='hidden' name='" . $env{'request.role'} .
	"' value='1' />\n<input type='submit' value='" . $finish . "' />\n" .
	"</form></center>";

return $result;	return $result;
}	}

sub overrideForm {	sub overrideForm {
my $self = shift;	return 1;
return $self->{'restartCourse'};
}	}

1;	1;

package Apache::lonhelper::parmwizfinal;	package Apache::lonhelper::parmwizfinal;

# This is the final state for the parmwizard. It is not generally useful,	# This is the final state for the parm helper. It is not generally useful,
# so it is not perldoc'ed. It does its own processing.	# so it is not perldoc'ed. It does its own processing.
# It is represented with <parmwizfinal />, and	# It is represented with <parmwizfinal />, and
# should later be moved to lonparmset.pm .	# should later be moved to lonparmset.pm .
Line 3019 package Apache::lonhelper::parmwizfinal;	Line 3531 package Apache::lonhelper::parmwizfinal;
no strict;	no strict;
@ISA = ('Apache::lonhelper::element');	@ISA = ('Apache::lonhelper::element');
use strict;	use strict;
	use Apache::lonlocal;
	use Apache::lonnet;

BEGIN {	BEGIN {
&Apache::lonhelper::register('Apache::lonhelper::parmwizfinal',	&Apache::lonhelper::register('Apache::lonhelper::parmwizfinal',
Line 3060 sub render {	Line 3574 sub render {
'answer_date' => "0_answerdate",	'answer_date' => "0_answerdate",
'tries' => '0_maxtries',	'tries' => '0_maxtries',
'weight' => '0_weight' );	'weight' => '0_weight' );
	my %realParmName = ('open_date' => "opendate",
	'due_date' => "duedate",
	'answer_date' => "answerdate",
	'tries' => 'maxtries',
	'weight' => 'weight' );

my $affectedResourceId = "";	my $affectedResourceId = "";
my $parm_name = $parmTypeHash{$vars->{ACTION_TYPE}};	my $parm_name = $parmTypeHash{$vars->{ACTION_TYPE}};
Line 3067 sub render {	Line 3586 sub render {
my $resourceString;	my $resourceString;
my $symb;	my $symb;
my $paramlevel;	my $paramlevel;

# Print the granularity, depending on the action	# Print the granularity, depending on the action
if ($vars->{GRANULARITY} eq 'whole_course') {	if ($vars->{GRANULARITY} eq 'whole_course') {
$resourceString .= '<li>for <b>all resources in the course</b></li>';	$resourceString .= '<li>'.&mt('for <b>all resources in the course</b>').'</li>';
$level = 9; # general course, see lonparmset.pm perldoc	if ($vars->{TARGETS} eq 'course') {
	$level = 14; # general course, see lonparmset.pm perldoc
	} elsif ($vars->{TARGETS} eq 'section') {
	$level = 9;
	} elsif ($vars->{TARGETS} eq 'group') {
	$level = 6;
	} else {
	$level = 3;
	}
$affectedResourceId = "0.0";	$affectedResourceId = "0.0";
$symb = 'a';	$symb = 'a';
$paramlevel = 'general';	$paramlevel = 'general';
Line 3080 sub render {	Line 3607 sub render {
my $res = $navmap->getByMapPc($vars->{RESOURCE_ID});	my $res = $navmap->getByMapPc($vars->{RESOURCE_ID});
my $title = $res->compTitle();	my $title = $res->compTitle();
$symb = $res->symb();	$symb = $res->symb();
$navmap->untieHashes();	$resourceString .= '<li>'.&mt('for the map named [_1]',"<b>$title</b>").'</li>';
$resourceString .= "<li>for the map named <b>$title</b></li>";	if ($vars->{TARGETS} eq 'course') {
$level = 8;	$level = 13; # general course, see lonparmset.pm perldoc
	} elsif ($vars->{TARGETS} eq 'section') {
	$level = 8;
	} elsif ($vars->{TARGETS} eq 'group') {
	$level = 5;
	} else {
	$level = 2;
	}
$affectedResourceId = $vars->{RESOURCE_ID};	$affectedResourceId = $vars->{RESOURCE_ID};
$paramlevel = 'map';	$paramlevel = 'map';
} else {	} else {
my $navmap = Apache::lonnavmaps::navmap->new();	my $navmap = Apache::lonnavmaps::navmap->new();
my $res = $navmap->getById($vars->{RESOURCE_ID});	my $res = $navmap->getById($vars->{RESOURCE_ID});
	my $part = $vars->{RESOURCE_ID_part};
	if ($part ne 'All Parts' && $part) { $parm_name=~s/^0/$part/; } else { $part=&mt('All Parts'); }
$symb = $res->symb();	$symb = $res->symb();
my $title = $res->compTitle();	my $title = $res->compTitle();
$navmap->untieHashes();	$resourceString .= '<li>'.&mt('for the resource named [_1] part [_2]',"<b>$title</b>","<b>$part</b>").'</li>';
$resourceString .= "<li>for the resource named <b>$title</b></li>";	if ($vars->{TARGETS} eq 'course') {
$level = 7;	$level = 10; # general course, see lonparmset.pm perldoc
	} elsif ($vars->{TARGETS} eq 'section') {
	$level = 7;
	} elsif ($vars->{TARGETS} eq 'group') {
	$level = 4;
	} else {
	$level = 1;
	}
$affectedResourceId = $vars->{RESOURCE_ID};	$affectedResourceId = $vars->{RESOURCE_ID};
$paramlevel = 'full';	$paramlevel = 'full';
}	}

my $result = "<form name='helpform' method='get' action='/adm/parmset#$affectedResourceId&$parm_name&$level'>\n";	my $result = "<form name='helpform' method='POST' action='/adm/parmset#$affectedResourceId&$parm_name&$level'>\n";
$result .= '<p>Confirm that this information is correct, then click "Finish Wizard" to complete setting the parameter.<ul>';	$result .= "<input type='hidden' name='action' value='settable' />\n";
	$result .= "<input type='hidden' name='dis' value='helper' />\n";
	$result .= "<input type='hidden' name='pscat' value='".
	$realParmName{$vars->{ACTION_TYPE}}."' />\n";
	if ($vars->{GRANULARITY} eq 'resource') {
	$result .= "<input type='hidden' name='symb' value='".
	HTML::Entities::encode($symb,"'<>&\"") . "' />\n";
	} elsif ($vars->{GRANULARITY} eq 'map') {
	$result .= "<input type='hidden' name='pschp' value='".
	$affectedResourceId."' />\n";
	}
	my $part = $vars->{RESOURCE_ID_part};
	if ($part eq 'All Parts' \|\| !$part) { $part=0; }
	$result .= "<input type='hidden' name='psprt' value='".
	HTML::Entities::encode($part,"'<>&\"") . "' />\n";

	$result .= '<p>'.&mt('Confirm that this information is correct, then click "Finish Helper" to complete setting the parameter.').'<ul>';

# Print the type of manipulation:	# Print the type of manipulation:
$result .= '<li>Setting the <b>' . $dateTypeHash{$vars->{ACTION_TYPE}} . '</b>';	my $extra;
if ($vars->{ACTION_TYPE} eq 'tries') {	if ($vars->{ACTION_TYPE} eq 'tries') {
$result .= ' to <b>' . $vars->{TRIES} . '</b>';	$extra = $vars->{TRIES};
}	}
if ($vars->{ACTION_TYPE} eq 'weight') {	if ($vars->{ACTION_TYPE} eq 'weight') {
$result .= ' to <b>' . $vars->{WEIGHT} . '</b>';	$extra = $vars->{WEIGHT};
	}
	$result .= "<li>";
	my $what = &mt($dateTypeHash{$vars->{ACTION_TYPE}});
	if ($extra) {
	$result .= &mt('Setting the [_1] to [_2]',"<b>$what</b>",$extra);
	} else {
	$result .= &mt('Setting the [_1]',"<b>$what</b>");
}	}
$result .= "</li>\n";	$result .= "</li>\n";
if ($vars->{ACTION_TYPE} eq 'due_date' \|\|	if ($vars->{ACTION_TYPE} eq 'due_date' \|\|
Line 3128 sub render {	Line 3694 sub render {
} elsif ($vars->{ACTION_TYPE} eq 'tries') {	} elsif ($vars->{ACTION_TYPE} eq 'tries') {
$result .= "<input type='hidden' name='pres_value' " .	$result .= "<input type='hidden' name='pres_value' " .
"value='" . $vars->{TRIES} . "' />\n";	"value='" . $vars->{TRIES} . "' />\n";
	$result .= "<input type='hidden' name='pres_type' " .
	"value='int_pos' />\n";
} elsif ($vars->{ACTION_TYPE} eq 'weight') {	} elsif ($vars->{ACTION_TYPE} eq 'weight') {
$result .= "<input type='hidden' name='pres_value' " .	$result .= "<input type='hidden' name='pres_value' " .
"value='" . $vars->{WEIGHT} . "' />\n";	"value='" . $vars->{WEIGHT} . "' />\n";
Line 3137 sub render {	Line 3705 sub render {

# Print targets	# Print targets
if ($vars->{TARGETS} eq 'course') {	if ($vars->{TARGETS} eq 'course') {
$result .= '<li>for <b>all students in course</b></li>';	$result .= '<li>'.&mt('for <b>all students in course</b>').'</li>';
} elsif ($vars->{TARGETS} eq 'section') {	} elsif ($vars->{TARGETS} eq 'section') {
my $section = $vars->{SECTION_NAME};	my $section = $vars->{SECTION_NAME};
$result .= "<li>for section <b>$section</b></li>";	$result .= '<li>'.&mt('for section [_1]',"<b>$section</b>").'</li>';
$level -= 3;	$result .= "<input type='hidden' name='csec' value='" .
$result .= "<input type='hidden' name='csec' value='" .	HTML::Entities::encode($section,"'<>&\"") . "' />\n";
HTML::Entities::encode($section) . "' />\n";	} elsif ($vars->{TARGETS} eq 'group') {
	my $group = $vars->{GROUP_NAME};
	$result .= '<li>'.&mt('for group [_1]',"<b>$group</b>").'</li>';
	$result .= "<input type='hidden' name='cgroup' value='" .
	HTML::Entities::encode($group,"'<>&\"") . "' />\n";
} else {	} else {
# FIXME: This is probably wasteful! Store the name!	# FIXME: This is probably wasteful! Store the name!
my $classlist = Apache::loncoursedata::get_classlist();	my $classlist = Apache::loncoursedata::get_classlist();
my $username = $vars->{USER_NAME};	my ($uname,$udom)=split(':',$vars->{USER_NAME});
# Chop off everything after the last colon (section)	my $name = $classlist->{$uname.':'.$udom}->[6];
$username = substr($username, 0, rindex($username, ':'));	$result .= '<li>'.&mt('for [_1]',"<b>$name</b>").'</li>';
my $name = $classlist->{$username}->[6];
$result .= "<li>for <b>$name</b></li>";
$level -= 6;
my ($uname, $udom) = split /:/, $vars->{USER_NAME};
$result .= "<input type='hidden' name='uname' value='".	$result .= "<input type='hidden' name='uname' value='".
HTML::Entities::encode($uname) . "' />\n";	HTML::Entities::encode($uname,"'<>&\"") . "' />\n";
$result .= "<input type='hidden' name='udom' value='".	$result .= "<input type='hidden' name='udom' value='".
HTML::Entities::encode($udom) . "' />\n";	HTML::Entities::encode($udom,"'<>&\"") . "' />\n";
}	}

# Print value	# Print value
if ($vars->{ACTION_TYPE} ne 'tries' && $vars->{ACTION_TYPE} ne 'weight') {	if ($vars->{ACTION_TYPE} ne 'tries' && $vars->{ACTION_TYPE} ne 'weight') {
$result .= "<li>to <b>" . ctime($vars->{PARM_DATE}) . "</b> (" .	$result .= '<li>'.&mt('to [_1] ([_2])',"<b>".ctime($vars->{PARM_DATE})."</b>",Apache::lonnavmaps::timeToHumanString($vars->{PARM_DATE}))."</li>\n";
Apache::lonnavmaps::timeToHumanString($vars->{PARM_DATE})
. ")</li>\n";
}	}

# print pres_marker	# print pres_marker
Line 3173 sub render {	Line 3739 sub render {

# Make the table appear	# Make the table appear
$result .= "\n<input type='hidden' value='true' name='prevvisit' />";	$result .= "\n<input type='hidden' value='true' name='prevvisit' />";
$result .= "\n<input type='hidden' value='all' name='pschp' />";
$result .= "\n<input type='hidden' value='$symb' name='pssymb' />";	$result .= "\n<input type='hidden' value='$symb' name='pssymb' />";
$result .= "\n<input type='hidden' value='$paramlevel' name='parmlev' />";	$result .= "\n<input type='hidden' value='$paramlevel' name='parmlev' />";

$result .= "<br /><br /><center><input type='submit' value='Finish Helper' /></center></form>\n";	$result .= "<br /><br /><center><input type='submit' value='".&mt('Finish Helper')."' /></center></form>\n";

return $result;	return $result;
}	}

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

Removed from v.1.55
changed lines
	Added in v.1.161.2.1