--- loncom/interface/lonmodifycourse.pm 2003/12/26 16:30:17 1.1
+++ loncom/interface/lonmodifycourse.pm 2009/06/09 13:26:35 1.45
@@ -1,342 +1,576 @@
+# The LearningOnline Network with CAPA
+# handler for DC-only modifiable course settings
+#
+# $Id: lonmodifycourse.pm,v 1.45 2009/06/09 13:26:35 bisitz Exp $
+#
+# Copyright Michigan State University Board of Trustees
+#
+# This file is part of the LearningOnline Network with CAPA (LON-CAPA).
+#
+# LON-CAPA is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# LON-CAPA is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with LON-CAPA; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+#
+# /home/httpd/html/adm/gpl.txt
+#
+# http://www.lon-capa.org/
+#
package Apache::lonmodifycourse;
use strict;
use Apache::Constants qw(:common :http);
use Apache::lonnet;
use Apache::loncommon;
+use Apache::lonhtmlcommon;
use Apache::lonlocal;
-use Apache::londropadd;
+use Apache::lonuserutils;
+use Apache::lonpickcourse;
use LONCAPA::Enrollment;
use lib '/home/httpd/lib/perl';
-use localenroll;
+use LONCAPA;
-sub print_course_selection_page {
- my ($r,$tasklongref) = @_;
- my $dom = $ENV{'user.domain'};
+sub get_dc_settable {
+ return ('courseowner','coursecode','authtype','autharg');
+}
+
+sub catalog_settable {
+ my ($confhash) = @_;
+ my @settable;
+ if (ref($confhash) eq 'HASH') {
+ if ($confhash->{'togglecats'} ne 'crs') {
+ push(@settable,'togglecats');
+ }
+ if ($confhash->{'categorize'} ne 'crs') {
+ push(@settable,'categorize');
+ }
+ } else {
+ push(@settable,('togglecats','categorize'));
+ }
+ return @settable;
+}
+
+sub get_enrollment_settings {
+ my ($cdom,$cnum) = @_;
+ my %settings = &Apache::lonnet::dump('environment',$cdom,$cnum);
+ my %enrollvar;
+ $enrollvar{'autharg'} = '';
+ $enrollvar{'authtype'} = '';
my %lt=&Apache::lonlocal::texthash(
- 'incs' => "Internal course settings",
- 'stat' => "Although the majority of course settings for LON-CAPA courses may be modified by a Course Coordinator, there are a small number of settings which may only be modified by a Domain Coordinator. These particular course parameters control automated student enrollment in LON-CAPA courses based on classlist data available from your institution's student information system.",
- 'chcs' => "Once you have chosen the course for which you wish to view/modify internal settings, click 'Go' to proceed",
- 'ccrs' => "Choose a course",
- 'gobt' => "Go"
+ 'noen' => "No end date",
);
-
-# Determine the courses
- my %courseIDs = &Apache::lonnet::courseiddump($dom,'.',1);
- &print_header($r,$tasklongref);
- $r->print(< $lt{'stat'}
- $lt{'chcs'}
- ';
+ $menu_html.='';
+ $menu_html.=
+ qq||;
+ $menu_html.= &mt($menu_item->{'text'}).'';
+ $menu_html.='$lt{'incs'}
-'.&mt('Search for a course in the [_1] domain',$domdesc).'
'.
+ &mt('Actions available after searching for a course:').''.
+ '
');
+ $r->print(&Apache::lonpickcourse::build_filters($filterlist,$type,
+ undef,undef,$filter,$action,\$numtitles,'modifycourse'));
+}
+
+sub print_course_selection_page {
+ my ($r,$dom,$domdesc) = @_;
+ &print_header($r);
+
+# Criteria for course search
+ my $filterlist = ['descriptfilter',
+ 'instcodefilter','ownerfilter',
+ 'ownerdomfilter','coursefilter'];
+ my %filter;
+ my $type = $env{'form.type'};
+ if ($type eq '') {
+ $type = 'Course';
+ }
+ my $action = '/adm/modifycourse';
+ my $dctitle = &Apache::lonnet::plaintext('dc');
+ $r->print(&mt('Revise your search criteria for this domain').' ('.$domdesc.').
');
+ $r->print(&Apache::lonpickcourse::build_filters($filterlist,$type,
+ undef,undef,\%filter,$action));
+ $filter{'domainfilter'} = $dom;
+ my %courses = &Apache::lonpickcourse::search_courses($r,$type,0,
+ \%filter);
+ &Apache::lonpickcourse::display_matched_courses($r,$type,0,$action,undef,
+ %courses);
+ return;
+}
+
+sub print_modification_menu {
+ my ($r,$cdesc,$domdesc,$dom) = @_;
+ &print_header($r,$cdesc);
+ my $type = 'Course';
+ my $action = '/adm/modifycourse';
+ my $cctitle = &Apache::lonnet::plaintext('cc',$type);
+ my $dctitle = &Apache::lonnet::plaintext('dc');
+ my %lt=&Apache::lonlocal::texthash(
+ 'some' => "Certain settings which control auto-enrollment of students from your institution's student information system.",
+ 'crqo' => 'The total disk space allocated for storage of portfolio files in all groups in a course.',
+ );
+ my @menu =
+ (
+ { text => 'Modify quota for group portfolio',
+ phase => 'setquota',
+ },
+ { text => 'Display current settings for automated enrollment',
+ phase => 'viewparms',
+ },
+ { text => 'Modify institutional code, course owner and/or default authentication',
+ phase => 'setparms',
+ },
+ );
+ my %domconf = &Apache::lonnet::get_dom('configuration',['coursecategories'],$dom);
+ my @additional_params = &catalog_settable($domconf{'coursecategories'});
+ if (@additional_params > 0) {
+ push (@menu, { text => 'Modify course catalog settings for course',
+ phase => 'catsettings',
+ });
+ }
+ my $menu_html = ''.&mt('View/Modify settings for: ').$cdesc.'
'."\n".
+ &mt('Although almost all course settings can be modified by a [_1], a number of settings exist which only a [_2] may change:',$cctitle,$dctitle).'
+
+
+'."\n".
+ &hidden_form_elements();
+
+ foreach my $menu_item (@menu) {
+ $menu_html.='$lt{'cset'} \n".
+ "$lt{'valu'} \n".
+ "$lt{'dcon'} \n".
+ &Apache::loncommon::end_data_table_header_row()."\n";
+ foreach my $key (sort(keys(%enrollvar))) {
+ $disp_table .= &Apache::loncommon::start_data_table_row()."\n".
+ "$longtype{$key} \n".
+ "$enrollvar{$key} \n";
+ if (grep(/^\Q$key\E$/,@modifiable_params)) {
+ $disp_table .= ''.&mt('Yes').' '."\n";
+ } else {
+ $disp_table .= ''.&mt('No').' '."\n";
+ }
+ $disp_table .= &Apache::loncommon::end_data_table_row()."\n";
+ }
+ $disp_table .= &Apache::loncommon::end_data_table()."\n";
+ &print_header($r,$cdesc);
+ $r->print('
+'.$lt{'caes'}.$cdesc.'
+
+'.$lt{'cour'}.' +
+'.$disp_table.' +
+'.$lt{'back'}.' +'.&mt('Modify [_1]-only settings',$dctitle).''."\n". +&hidden_form_elements(). +'
'); +} + +sub print_setquota { + my ($r,$cdom,$cnum,$cdesc,$type) = @_; + my $dctitle = &Apache::lonnet::plaintext('dc'); + my $cctitle = &Apache::lonnet::plaintext('cc',$type); + my $subdiv = &mt('Although a [_1] will assign the disk quota for each individual group, the size of the quota is constrained by the total disk space allocated by the [_2] for portfolio files in a course.',$cctitle,$dctitle); + my %lt = &Apache::lonlocal::texthash( + 'cquo' => 'Disk space for storage of group portfolio', + 'gpqu' => 'Course portfolio files disk space', + 'each' => 'Each course group can be assigned a quota for portfolio files uploaded to the group.', + 'modi' => 'Save', + 'back' => "Back to options page", + ); + my %settings = &Apache::lonnet::get('environment',['internal.coursequota'],$cdom,$cnum); + my $coursequota = $settings{'internal.coursequota'}; + if ($coursequota eq '') { + $coursequota = 20; + } + &print_header($r,$cdesc); + my $hidden_elements = &hidden_form_elements(); + $r->print(<
+$lt{'each'}
+$subdiv
+
+$lt{'gpqu'}: Mb +
-"); - &print_footer($r); +$hidden_elements +$lt{'back'} + +ENDDOCUMENT return; } -sub print_course_modification_page { - my ($r,$tasklongref,$typeref) = @_; - my %enrollvar = (); - my @bgcolors=("#eeeeee","#cccccc"); - my $course = $ENV{'form.course'}; - my $dom = $ENV{'user.domain'}; - my $ownertable; - my %settings = &Apache::lonnet::dump('environment',$dom,$course); - foreach my $item (keys %settings) { - if ($item =~ m/^internal\.(.+)$/) { - if ( ($1 eq "autoadds") || ($1 eq "autodrops") ) { - if ($settings{$item} == 1) { - $enrollvar{$1} = "ON"; - } else { - $enrollvar{$1} = "OFF"; - } - } elsif ( ($1 eq "autostart") || ($1 eq "autoend") ) { - if ( ($1 eq "autoend") && ($settings{$item} == 0) ) { - $enrollvar{$1} = "No end date"; - } else { - $enrollvar{$1} = localtime($settings{$item}); - } +sub print_catsettings { + my ($r,$cdom,$cnum,$cdesc) = @_; + &print_header($r,$cdesc); + my %lt = &Apache::lonlocal::texthash( + 'back' => 'Back to options page', + ); + $r->print(''."\n"); + return; +} + +sub print_course_modification_page { + my ($r,$cdom,$cnum,$cdesc,$domdesc) = @_; + my %longtype = &course_settings_descrip(); + my %enrollvar = &get_enrollment_settings($cdom,$cnum); + my $ownertable; + my %lt=&Apache::lonlocal::texthash( + 'actv' => "Active", + 'inac' => "Inactive", + 'ccor' => "Course Coordinator", + 'noen' => "No end date", + 'ownr' => "Owner", + 'name' => "Name", + 'unme' => "Username:Domain", + 'stus' => "Status", + 'cquo' => "Disk space for storage of group portfolio", + 'gpqu' => "Course portfolio files disk space", + 'each' => "Each course group can be assigned a quota for portfolio files uploaded to the group.", + 'cose' => "Course settings for LON-CAPA courses that control automated student enrollment based on classlist data available from your institution's student information system fall into two groups: (a) settings that can be modified by a Course Coordinator using the ", + 'aenm' => "Automated Enrollment Manager", + 'andb' => " and (b) settings that may only be modified by a Domain Coordinator via this page.", + 'caes' => 'Current automated enrollment settings', + 'cour' => "Course settings that control automated enrollment in this LON-CAPA course +are currently:", + 'nocc' => "There is currently no course owner set for this course. In addition, no active course coordinators from this LON-CAPA domain were found, so you will not be able assign a course owner. If you wish to assign a course owner, it is recommended that you use the 'User Roles' screen to add a course coordinator with a LON-CAPA account in this domain to the course.", + 'ccus' => "A course coordinator can use the 'Automated Enrollment Manager' to change +all settings except course code, course owner, and default authentication method for students added to your course (who are also new to the LON-CAPA system at this domain).", + 'ccod' => "Course Code", + 'ccus' => "The course code is used during automated enrollment to map the internal LON-CAPA course ID for this course to the corresponding course section ID(s) used by the office responsible for providing official class lists for courses at your institution.", + 'cown' => "Course Owner", + 'cous' => "The course owner is used in the retrieval of class lists from your institution's student information system when access to class lists data incorporates validation of instructor status.", + 'tabl' => 'The table below contains a list of active course coordinators in this course, who are from this domain', + 'usrd' => 'Use the radio buttons to select a different course owner.', + 'deam' => "Default Authentication method", + 'deus' => "The default authentication method, and default authentication parameter (domain, initial password or argument) are used when automatic enrollment of students in a course requires addition of new user accounts in your domain, and the class list file contains empty entries for the <authtype> and <autharg> properties for the new student. If you choose 'internally authenticated', and leave the initial password field empty, the automated enrollment process will create a randomized password for each new student account that it adds to your LON-CAPA domain.", + 'gobt' => "Save", + ); - my @coursepersonnel = &Apache::lonnet::getkeys('nohist_userroles',$dom,$course); + my @coursepersonnel = &Apache::lonnet::getkeys('nohist_userroles',$cdom,$cnum); my @local_ccs = (); my %cc_status = (); my %pname = (); my $active_cc; - foreach (@coursepersonnel) { - my @roleinfo = split/:/,$_; - if ( ($roleinfo[0] eq 'cc') && ($roleinfo[2] eq $dom) ) { - unless (grep/^$roleinfo[1]$/,@local_ccs) { - $active_cc = &LONCAPA::Enrollment::check_user_status($roleinfo[2],$roleinfo[1],$dom,$course,'cc'); - if ($active_cc eq 'ok') { - push @local_ccs, $roleinfo[1]; - $pname{$roleinfo[1]} = &Apache::loncommon::plainname($roleinfo[1],$roleinfo[2]); - $cc_status{$roleinfo[1]} = 'Active'; + foreach my $person (@coursepersonnel) { + my ($role,$user) = split(/:/,$person,2); + $user =~ s/:$//; + if (($role eq 'cc') && ($user ne '')) { + if (!grep(/^\Q$user\E$/,@local_ccs)) { + my ($ccname,$ccdom) = split(/:/,$user); + $active_cc = + &Apache::loncommon::check_user_status($ccdom,$ccname,$cdom, + $cnum,'cc'); + if ($active_cc eq 'active') { + push(@local_ccs,$user); + $pname{$user} = &Apache::loncommon::plainname($ccname,$ccdom); + $cc_status{$user} = $lt{'actv'}; } } } } - unless ( (grep/^$enrollvar{'courseowner'}$/,@local_ccs) || ($enrollvar{'courseowner'} eq '') ) { - push @local_ccs, $enrollvar{'coursecode'}; - my ($puname,$pdom) = split/\@/,$enrollvar{'courseowner'}; - $pname{$enrollvar{'courseowner'}} = &Apache::loncommon::plainname($puname,$pdom); - $active_cc = &LONCAPA::Enrollment::check_user_status($pdom,$enrollvar{'coursecode'},$dom,$course,'cc'); - if ($active_cc eq 'ok') { - $cc_status{$enrollvar{'courseowner'}} = 'Active'; + if ( (!grep(/^$enrollvar{'courseowner'}$/,@local_ccs)) && + ($enrollvar{'courseowner'} ne '') ) { + my ($owneruname,$ownerdom) = split(/:/,$enrollvar{'courseowner'}); + push(@local_ccs,$enrollvar{'courseowner'}); + $pname{$enrollvar{'courseowner'}} = + &Apache::loncommon::plainname($owneruname,$ownerdom); + $active_cc = &Apache::loncommon::check_user_status($ownerdom,$owneruname, + $cdom,$cnum,'cc'); + if ($active_cc eq 'active') { + $cc_status{$enrollvar{'courseowner'}} = $lt{'actv'}; } else { - $cc_status{$enrollvar{'courseowner'}} = 'Inactive'; + $cc_status{$enrollvar{'courseowner'}} = $lt{'inac'}; } } my $numlocalcc = @local_ccs; - my $bodytag=&Apache::loncommon::bodytag('Modify Course Settings'); - my $helplink=&Apache::loncommon::help_open_topic('Modify_Course',&mt('Help on Modifying Courses')); - my $defdom=$ENV{'request.role.domain'}; - my ($krbdef,$krbdefdom)=&Apache::loncommon::get_kerberos_defaults($defdom); - my $javascript_validations=&Apache::londropadd::javascript_validations('createcourse',$krbdefdom); - my %param = ( formname => 'document.cmods', + + my $helplink=&Apache::loncommon::help_open_topic('Modify_Course',&mt("Help on Modifying Courses")); + my ($krbdef,$krbdefdom)=&Apache::loncommon::get_kerberos_defaults($cdom); + my $curr_authtype = ''; + my $curr_authfield = ''; + if ($enrollvar{'authtype'} =~ /^krb/) { + $curr_authtype = 'krb'; + } elsif ($enrollvar{'authtype'} eq 'internal' ) { + $curr_authtype = 'int'; + } elsif ($enrollvar{'authtype'} eq 'localauth' ) { + $curr_authtype = 'loc'; + } + unless ($curr_authtype eq '') { + $curr_authfield = $curr_authtype.'arg'; + } + my $javascript_validations=&Apache::lonuserutils::javascript_validations('modifycourse',$krbdefdom,$curr_authtype,$curr_authfield); + my %param = ( formname => 'document.'.$env{'form.phase'}, kerb_def_dom => $krbdefdom, - kerb_def_auth => $krbdef + kerb_def_auth => $krbdef, + mode => 'modifycourse', + curr_authtype => $curr_authtype, + curr_autharg => $enrollvar{'autharg'} ); - my $selscript=&Apache::loncommon::studentbrowser_javascript(); - my $sellink=&Apache::loncommon::selectstudent_link - ('cmod','crsown','ccdomain'); - my $krbform = &Apache::loncommon::authform_kerberos(%param); - my $intform = &Apache::loncommon::authform_internal(%param); - my $locform = &Apache::loncommon::authform_local(%param); - my %lt=&Apache::lonlocal::texthash( - 'aecs' => "Automated Enrollment Course Settings", - 'cose' => "Course settings for LON-CAPA courses that control automated student enrollment based on classlist data available from your institution's student information system fall into two groups: (a) settings that can be modified by a Course Coordinator using the ", - 'aenm' => "Automated Enrollment Manager", - 'andb' => " and (b) settings that may only be modified by a Domain Coordinator via this page.", - 'caes' => 'Current automated enrollment settings', - 'cour' => "Course settings that control automated enrollment in this LON-CAPA course are currently:", - 'cset' => "Course setting", - 'valu' => "Current value", - 'ccus' => "A course coordinator can use the 'Automated Enrollment Manager' to change all settings except course code, course owner, and default authentication method for students added to your course (who are also new to the LON-CAPA system at this domain).", - 'mkch' => "Make changes to course settings set by Domain Coordinator", - 'ccod' => "Course Code", - 'ccus' => "The course code is used during automated enrollment to map the internal LON-CAPA course ID for this course to the corresponding course section ID(s) used by the office responsible for providing official class lists for courses at your institution.", - 'cown' => "Course Owner", - 'cous' => "The course owner is used in the retrieval of class lists from your institution's student information system when access to class lists data incorporates validation of instructor status.", - 'tabl' => 'The table below contains a list of active course coordinators in this course, -who are from this domain', - 'usrd' => 'Use the radio buttons to select a different course owner.', - 'deam' => "Default Authentication method", - 'deus' => "The default authentication method, and default authentication parameter (domain, initial password or argument) are used when automatic enrollment of students in a course requires addition of new user accounts in your domain, and the class list file contains empty entries for the <authtype> and <autharg> properties for the new student.", - 'gobt' => "Modify settings", - ); - - my $disp_table = qq|
-
|
-
$lt{'tabl'} ($dom). $lt{'usrd'} + | $lt{'tabl'} - $cdom ($domdesc). $lt{'usrd'} | ||||||||||||||||||||
-
| ). + &Apache::loncommon::start_data_table()."\n". + &Apache::loncommon::start_data_table_header_row()."\n". + " | $lt{'ownr'} | \n". + "$lt{'name'} | \n". + "$lt{'unme'} | \n". + "$lt{'stus'} | \n". + &Apache::loncommon::end_data_table_header_row()."\n"; + foreach my $cc (@local_ccs) { + $ownertable .= &Apache::loncommon::start_data_table_row()."\n"; + if ($cc eq $enrollvar{'courseowner'}) { + $ownertable .= ''."\n"; + } else { + $ownertable .= ' | '."\n"; + } + $ownertable .= + ' | '.$pname{$cc}.' | '."\n". + ''.$cc.' | '."\n". + ''.$cc_status{$cc}.' '.$lt{'ccor'}.' | '."\n". + &Apache::loncommon::end_data_table_row()."\n"; + } + $ownertable .= &Apache::loncommon::end_data_table()."
---|
-
- | $lt{'caes'} |
-
-$lt{'cour'} -
-$disp_table
-
+