# The LearningOnline Network # Create a course # # $Id: loncreatecourse.pm,v 1.41 2003/12/05 21:34:48 raeburn 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/ # # (My Desk # # (Internal Server Error Handler # # (Login Screen # 5/21/99,5/22,5/25,5/26,5/31,6/2,6/10,7/12,7/14, # 1/14/00,5/29,5/30,6/1,6/29,7/1,11/9 Gerd Kortemeyer) # # 3/1/1 Gerd Kortemeyer) # # 3/1 Gerd Kortemeyer) # # 2/14,2/16,2/17,7/6 Gerd Kortemeyer # package Apache::loncreatecourse; use strict; use Apache::Constants qw(:common :http); use Apache::lonnet; use Apache::loncommon; use Apache::lonratedt; use Apache::londocs; use Apache::lonlocal; use Apache::londropadd; # ================================================ Get course directory listing sub crsdirlist { my ($courseid,$which)=@_; unless ($which) { $which=''; } my %crsdata=&Apache::lonnet::coursedescription($courseid); my @listing=&Apache::lonnet::dirlist ($which,$crsdata{'domain'},$crsdata{'num'}, &Apache::loncommon::propath($crsdata{'domain'},$crsdata{'num'})); my @output=(); foreach (@listing) { unless ($_=~/^\./) { push (@output,(split(/\&/,$_))[0]); } } return @output; } # ============================================================= Read a userfile sub readfile { my ($courseid,$which)=@_; my %crsdata=&Apache::lonnet::coursedescription($courseid); return &Apache::lonnet::getfile('/uploaded/'.$crsdata{'domain'}.'/'. $crsdata{'num'}.'/'.$which); } # ============================================================ Write a userfile sub writefile { (my $courseid, my $which,$ENV{'form.output'})=@_; my %crsdata=&Apache::lonnet::coursedescription($courseid); return &Apache::lonnet::finishuserfileupload( $crsdata{'num'},$crsdata{'domain'}, $crsdata{'home'}, 'output',$which); } # ===================================================================== Rewrite sub rewritefile { my ($contents,%rewritehash)=@_; foreach (keys %rewritehash) { my $pattern=$_; $pattern=~s/(\W)/\\$1/gs; my $new=$rewritehash{$_}; $contents=~s/$pattern/$new/gs; } return $contents; } # ============================================================= Copy a userfile sub copyfile { my ($origcrsid,$newcrsid,$which)=@_; unless ($which=~/\.sequence$/) { return &writefile($newcrsid,$which, &readfile($origcrsid,$which)); } else { my %origcrsdata=&Apache::lonnet::coursedescription($origcrsid); my %newcrsdata= &Apache::lonnet::coursedescription($newcrsid); return &writefile($newcrsid,$which, &rewritefile( &readfile($origcrsid,$which), ( '/uploaded/'.$origcrsdata{'domain'}.'/'.$origcrsdata{'num'}.'/' => '/uploaded/'. $newcrsdata{'domain'}.'/'. $newcrsdata{'num'}.'/' ))); } } # =============================================================== Copy a dbfile sub copydb { my ($origcrsid,$newcrsid,$which)=@_; $which=~s/\.db$//; my %origcrsdata=&Apache::lonnet::coursedescription($origcrsid); my %newcrsdata= &Apache::lonnet::coursedescription($newcrsid); my %data=&Apache::lonnet::dump ($which,$origcrsdata{'domain'},$origcrsdata{'num'}); return &Apache::lonnet::put ($which,\%data,$newcrsdata{'domain'},$newcrsdata{'num'}); } # ========================================================== Copy resourcesdata sub copyresourcedb { my ($origcrsid,$newcrsid)=@_; my %origcrsdata=&Apache::lonnet::coursedescription($origcrsid); my %newcrsdata= &Apache::lonnet::coursedescription($newcrsid); my %data=&Apache::lonnet::dump ('resourcedata',$origcrsdata{'domain'},$origcrsdata{'num'}); $origcrsid=~s/^\///; $origcrsid=~s/\//\_/; $newcrsid=~s/^\///; $newcrsid=~s/\//\_/; my %newdata=(); undef %newdata; my $startdate=$data{$origcrsid.'.0.opendate'}; my $today=time; my $delta=0; if ($startdate) { my $oneday=60*60*24; $delta=$today-$startdate; $delta=int($delta/$oneday)*$oneday; } # ugly retro fix for broken version of types foreach (keys %data) { if ($_=~/\wtype$/) { my $newkey=$_; $newkey=~s/type$/\.type/; $data{$newkey}=$data{$_}; delete $data{$_}; } } # adjust symbs my $pattern='uploaded/'.$origcrsdata{'domain'}.'/'.$origcrsdata{'num'}.'/'; $pattern=~s/(\W)/\\$1/gs; my $new= 'uploaded/'. $newcrsdata{'domain'}.'/'. $newcrsdata{'num'}.'/'; foreach (keys %data) { if ($_=~/$pattern/) { my $newkey=$_; $newkey=~s/$pattern/$new/; $data{$newkey}=$data{$_}; delete $data{$_}; } } # adjust dates foreach (keys %data) { my $thiskey=$_; $thiskey=~s/^$origcrsid/$newcrsid/; $newdata{$thiskey}=$data{$_}; if ($data{$_.'.type'}=~/^date/) { $newdata{$thiskey}=$newdata{$thiskey}+$delta; } } return &Apache::lonnet::put ('resourcedata',\%newdata,$newcrsdata{'domain'},$newcrsdata{'num'}); } # ========================================================== Copy all userfiles sub copyuserfiles { my ($origcrsid,$newcrsid)=@_; foreach (&crsdirlist($origcrsid,'userfiles')) { ©file($origcrsid,$newcrsid,$_); } } # ========================================================== Copy all userfiles sub copydbfiles { my ($origcrsid,$newcrsid)=@_; foreach (&crsdirlist($origcrsid)) { if ($_=~/\.db$/) { unless ($_=~/^(nohist\_|discussiontimes|classlist|versionupdate|resourcedata)/) { ©db($origcrsid,$newcrsid,$_); } } } } # ======================================================= Copy all course files sub copycoursefiles { my ($origcrsid,$newcrsid)=@_; ©userfiles($origcrsid,$newcrsid); ©dbfiles($origcrsid,$newcrsid); ©resourcedb($origcrsid,$newcrsid); } # ===================================================== Phase one: fill-in form sub print_course_creation_page { my $r=shift; my $defdom=$ENV{'request.role.domain'}; my %host_servers = &Apache::loncommon::get_library_servers($defdom); my $course_home = '\n"; my $domform = &Apache::loncommon::select_dom_form($defdom,'ccdomain'); my $bodytag=&Apache::loncommon::bodytag('Create a New Course'); my $helplink=&Apache::loncommon::help_open_topic('Create_Course','Help on Creating Courses'); my $cloneform=&Apache::loncommon::select_dom_form ($ENV{'request.role.domain'},'clonedomain'). &Apache::loncommon::selectcourse_link ('ccrs','clonecourse','clonedomain'); my $coursebrowserjs=&Apache::loncommon::coursebrowser_javascript(); print STDERR "Course browser js is $coursebrowserjs\n"; my $date_table = &Apache::londropadd::date_setting_table('','','createcourse'); my ($krbdef,$krbdefdom) = &Apache::loncommon::get_kerberos_defaults($defdom); my $javascript_validations=&Apache::londropadd::javascript_validations('createcourse',$krbdefdom); my %param = ( formname => 'document.ccrs', kerb_def_dom => $krbdefdom, kerb_def_auth => $krbdef ); my $krbform = &Apache::loncommon::authform_kerberos(%param); my $intform = &Apache::loncommon::authform_internal(%param); my $locform = &Apache::loncommon::authform_local(%param); $r->print(< $coursebrowserjs The LearningOnline Network with CAPA $bodytag $helplink

Course Information

Course Title:

Course Home Server:$course_home

Course ID/Number (optional)

Institutional Information

The following entries will be used to identify the course according to the naming scheme adopted by your institution. Your choices will be used to map an internal LON-CAPA course ID to the corresponding course section ID(s) used by the office responsible for providing official class lists for courses at your institution. This mapping is required if you choose to employ automatic population of class lists.

Course Code
(to interface with institutional data, e.g., fs03glg231 for Fall 2003 Geology 231)

Section Numbers and corresponding LON-CAPA section/group IDs
(a comma separated list of institutional section numbers, each separated by a colon from the (optional) corresponding section/group ID to be used in LON-CAPA e.g., 001:1,002:2)

Crosslisted courses
(a comma separated list of course sections crosslisted with the current course, with each entry including the institutional course section name followed by a colon and then the (optional) groupID to be used in LON-CAPA, e.g., fs03ent231001:ent1,fs03bot231001:bot1,fs03zol231002:bot2)

Course Content

Completely new courseClone an existing course

Map: Select Map

Do NOT generate as standard course
(only check if you know what you are doing):

First Resource
(standard courses only): Blank   Syllabus   Navigate

Course ID:
Domain: $cloneform
 
Additional settings, if specified below, will override cloned settings.

Assessment Parameters

Open all assessments:

Messaging

Set course policy feedback to Course Coordinator:

Set content feedback to Course Coordinator:

Communication

Disable student resource discussion:
Disable student use of chatrooms:

Access Control

Students need access key to enter course:

Course Coordinator

Username:

Domain: $domform

Immediately expire own role as Course Coordinator:

Automated enrollment settings

The following settings control automatic enrollment of students in this class based on information available for this specific course from your institution's official classlists.

Automated adds Yes No

Automated drops Yes No

Duration of automated classlist updates $date_table

Please select the authentication mechanism.
Please choose the default authentication method to be used by new users added to this LON-CAPA domain by the automated enrollment process.

$krbform
$intform
$locform

Notification of enrollment changes
Notification to course coordinator via LON-CAPA message when enrollment changes occur during the automated update?
Yes No

Include retrieval of student photographs? Yes No

ENDDOCUMENT } # ====================================================== Phase two: make course sub create_course { my $r=shift; my $topurl='/res/'.&Apache::lonnet::declutter($ENV{'form.topmap'}); my $ccuname=$ENV{'form.ccuname'}; my $ccdomain=$ENV{'form.ccdomain'}; $ccuname=~s/\W//g; $ccdomain=~s/\W//g; my $cdescr=$ENV{'form.title'}; my $curl=$ENV{'form.topmap'}; my $bodytag=&Apache::loncommon::bodytag('Create a New Course'); $r->print(< The LearningOnline Network with CAPA $bodytag ENDENHEAD # # Verify data # # Check the veracity of the course coordinator if (&Apache::lonnet::homeserver($ccuname,$ccdomain) eq 'no_host') { $r->print('No such user '.$ccuname.' at '.$ccdomain.''); return; } # Check the proposed home server for the course my %host_servers = &Apache::loncommon::get_library_servers ($ENV{'request.role.domain'}); if (! exists($host_servers{$ENV{'form.course_home'}})) { $r->print('Invalid home server for course: '. $ENV{'form.course_home'}.''); return; } # # Open course # my %cenv=(); my $courseid=&Apache::lonnet::createcourse($ENV{'request.role.domain'}, $cdescr,$curl, $ENV{'form.course_home'}, $ENV{'form.nonstandard'}); # Note: The testing routines depend on this being output; see # Utils::Course. This needs to at least be output as a comment # if anyone ever decides to not show this, and Utils::Course::new # will need to be suitably modified. $r->print('New LON-CAPA Course ID: '.$courseid.'
'); # # Check if created correctly # my ($crsudom,$crsunum)=($courseid=~/^\/(\w+)\/(\w+)$/); my $crsuhome=&Apache::lonnet::homeserver($crsunum,$crsudom); $r->print('Created on: '.$crsuhome.'
'); # # Are we cloning? # my $cloneid=''; if (($ENV{'form.clonecourse'}) && ($ENV{'form.clonedomain'})) { $cloneid='/'.$ENV{'form.clonedomain'}.'/'.$ENV{'form.clonecourse'}; my ($clonecrsudom,$clonecrsunum)=($cloneid=~/^\/(\w+)\/(\w+)$/); my $clonehome=&Apache::lonnet::homeserver($clonecrsunum,$clonecrsudom); if ($clonehome eq 'no_host') { $r->print( '
Attempting to clone non-existing course '.$cloneid.''); } else { $r->print( '
Cloning course from '.$clonehome.''); my %oldcenv=&Apache::lonnet::dump('environment',$crsudom,$crsunum); # Copy all files ©coursefiles($cloneid,$courseid); # Restore URL $cenv{'url'}=$oldcenv{'url'}; # Restore title $cenv{'description'}=$oldcenv{'description'}; # Mark as cloned $cenv{'clonedfrom'}=$cloneid; } } # # Set environment (will override cloned, if existing) # if ($ENV{'form.crsid'}) { $cenv{'courseid'}=$ENV{'form.crsid'}; } if ($ENV{'form.crscode'}) { $cenv{'internal.coursecode'}=$ENV{'form.crscode'}; } if ($ENV{'form.crssections'}) { $cenv{'internal.sectionnums'}=$ENV{'form.crssections'}; } if ($ENV{'form.crsxlist'}) { $cenv{'internal.crosslistings'}=$ENV{'form.crsxlist'}; } if ($ENV{'form.autoadds'}) { $cenv{'internal.autoadds'}=$ENV{'form.autoadds'}; } if ($ENV{'form.autodrops'}) { $cenv{'internal.autodrops'}=$ENV{'form.autodrops'}; } if ($ENV{'form.notify'}) { if ($ccuname) { $cenv{'internal.notifylist'} = $ccuname; } } if ($ccuname) { $cenv{'internal.courseowner'} = $ccuname; } my $startdate = &Apache::lonhtmlcommon::get_date_from_form('startdate'); my $enddate = &Apache::lonhtmlcommon::get_date_from_form('enddate'); if ($ENV{'form.no_end_date'}) { $enddate = 0; } $cenv{'internal.autostart'}=$startdate; $cenv{'internal.autoend'}=$enddate; if ($ENV{'form.showphotos'}) { $cenv{'internal.showphotos'}=$ENV{'form.showphotos'}; } if ($ENV{'form.login'} eq 'krb') { $cenv{'internal.authtype'} = 'krb'; $cenv{'internal.authtype'} .=$ENV{'form.krbver'}; $cenv{'internal.autharg'} = $ENV{'form.krbarg'}; } elsif ($ENV{'form.login'} eq 'int') { $cenv{'internal.authtype'} ='internal'; if ((defined($ENV{'form.intarg'})) && ($ENV{'form.intarg'})) { $cenv{'internal.autharg'} = $ENV{'form.intarg'}; } } elsif ($ENV{'form.login'} eq 'loc') { $cenv{'internal.authtype'} = 'localauth'; if ((defined($ENV{'form.locarg'})) && ($ENV{'form.locarg'})) { $cenv{'internal.autharg'} = $ENV{'form.locarg'}; } } if ( ($cenv{'internal.authtype'} =~ /^krb/) && ($cenv{'internal.autoadds'} == 1)) { if (! defined($cenv{'internal.autharg'}) || $cenv{'internal.autharg'} eq '') { $r->print(''. 'As you did not include the default Kerberos domain to be used for authentication in this class, the institutional data used by the automated enrollment process must include the Kerberos domain for each new student'.'

'); } } if (($ccdomain) && ($ccuname)) { if ($ENV{'form.setpolicy'}) { $cenv{'policy.email'}=$ccuname.':'.$ccdomain; } if ($ENV{'form.setcontent'}) { $cenv{'question.email'}=$ccuname.':'.$ccdomain; } } if ($ENV{'form.setkeys'}) { $cenv{'keyaccess'}='yes'; } if ($ENV{'form.disresdis'}) { $cenv{'pch.roles.denied'}='st'; } if ($ENV{'form.disablechat'}) { $cenv{'plc.roles.denied'}='st'; } # Record we've not yet viewed the Course Initialization Helper for this # course $cenv{'course.helper.not.run'} = 1; # # Use new Randomseed # $cenv{'rndseed'}=&Apache::lonnet::latest_rnd_algorithm_id();; # # By default, use standard grading $cenv{'grading'} = 'standard'; $r->print('
Setting environment: '. &Apache::lonnet::put('environment',\%cenv,$crsudom,$crsunum).'
'); # # Open all assignments # if ($ENV{'form.openall'}) { my $storeunder=$crsudom.'_'.$crsunum.'.0.opendate'; my %storecontent = ($storeunder => time, $storeunder.'.type' => 'date_start'); $r->print('Opening all assignments: '.&Apache::lonnet::cput ('resourcedata',\%storecontent,$crsudom,$crsunum).'
'); } # # Set first page # unless (($ENV{'form.nonstandard'}) || ($ENV{'form.firstres'} eq 'blank')) { $r->print('Setting first resource: '); my ($errtext,$fatal)= &Apache::londocs::mapread($crsunum,$crsudom,'default.sequence'); $r->print(($fatal?$errtext:'read ok').' - '); my $title; my $url; if ($ENV{'form.firstres'} eq 'syl') { $title='Syllabus'; $url='/public/'.$crsudom.'/'.$crsunum.'/syllabus'; } else { $title='Navigate Contents'; $url='/adm/navmaps'; } $Apache::lonratedt::resources[1]=$title.':'.$url.':false:start:res'; ($errtext,$fatal)= &Apache::londocs::storemap($crsunum,$crsudom,'default.sequence'); $r->print(($fatal?$errtext:'write ok').'
'); } # # Make current user course adminstrator # my $end=undef; my $addition=''; if ($ENV{'form.expireown'}) { $end=time+5; $addition='expired'; } $r->print('Assigning '.$addition.' role of course coordinator to self: '. &Apache::lonnet::assignrole( $ENV{'user.domain'},$ENV{'user.name'},$courseid,'cc',$end).'
'); # # Make additional user course administrator # if (($ccdomain) && ($ccuname)) { $r->print('Assigning role of course coordinator to '. $ccuname.' at '.$ccdomain.': '. &Apache::lonnet::assignrole($ccdomain,$ccuname,$courseid,'cc').'

'); } if ($ENV{'form.setkeys'}) { $r->print( '

Manage Access Keys

'); } $r->print('

Roles will be active at next login.

'); } # ===================================================================== Handler sub handler { my $r = shift; if ($r->header_only) { &Apache::loncommon::content_type($r,'text/html'); $r->send_http_header; return OK; } if (&Apache::lonnet::allowed('ccc',$ENV{'request.role.domain'})) { &Apache::loncommon::content_type($r,'text/html'); $r->send_http_header; if ($ENV{'form.phase'} eq 'two') { &create_course($r); } else { &print_course_creation_page($r); } } else { $ENV{'user.error.msg'}= "/adm/createcourse:ccc:0:0:Cannot create courses"; return HTTP_NOT_ACCEPTABLE; } return OK; } 1; __END__