--- loncom/interface/loncreatecourse.pm 2005/11/15 20:17:00 1.84
+++ loncom/interface/loncreatecourse.pm 2020/07/20 10:37:41 1.158.2.7.2.1
@@ -1,7 +1,7 @@
# The LearningOnline Network
# Create a course
#
-# $Id: loncreatecourse.pm,v 1.84 2005/11/15 20:17:00 albertel Exp $
+# $Id: loncreatecourse.pm,v 1.158.2.7.2.1 2020/07/20 10:37:41 raeburn Exp $
#
# Copyright Michigan State University Board of Trustees
#
@@ -27,255 +27,132 @@
#
###
-package Apache::loncreatecourse;
+=head1 NAME
-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;
-use lib '/home/httpd/lib/perl';
+Apache::loncreatecourse.pm
-# ================================================ Get course directory listing
+=head1 SYNOPSIS
-my @output=();
+Allows domain coordinators to create new
+courses and assign course coordinators.
-sub crsdirlist {
- my ($courseid,$which)=@_;
- @output=();
- return &innercrsdirlist($courseid,$which);
-}
-
-sub innercrsdirlist {
- my ($courseid,$which,$path)=@_;
- my $dirptr=16384;
- unless ($which) { $which=''; } else { $which.='/'; }
- unless ($path) { $path=''; } else { $path.='/'; }
- my %crsdata=&Apache::lonnet::coursedescription($courseid);
- my @listing=&Apache::lonnet::dirlist
- ($which,$crsdata{'domain'},$crsdata{'num'},
- &Apache::loncommon::propath($crsdata{'domain'},$crsdata{'num'}));
- foreach (@listing) {
- unless ($_=~/^\./) {
- my @unpackline = split (/\&/,$_);
- if ($unpackline[3]&$dirptr) {
-# is a directory, recurse
- &innercrsdirlist($courseid,$which.$unpackline[0],
- $path.$unpackline[0]);
- } else {
-# is a file, put into output
- push (@output,$path.$unpackline[0]);
- }
- }
- }
- return @output;
-}
+This is part of the LearningOnline Network with CAPA project
+described at http://www.lon-capa.org.
-# ============================================================= Read a userfile
+=head1 SUBROUTINES
-sub readfile {
- my ($courseid,$which)=@_;
- my %crsdata=&Apache::lonnet::coursedescription($courseid);
- return &Apache::lonnet::getfile('/uploaded/'.$crsdata{'domain'}.'/'.
- $crsdata{'num'}.'/'.$which);
-}
+=over
-# ============================================================ Write a userfile
+=item handler()
-sub writefile {
- (my $courseid, my $which,$env{'form.output'})=@_;
- my %crsdata=&Apache::lonnet::coursedescription($courseid);
- return &Apache::lonnet::finishuserfileupload(
- $crsdata{'num'},$crsdata{'domain'},
- 'output',$which);
-}
+=item print_course_creation_page()
-# ===================================================================== Rewrite
+=item create_course()
-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;
-}
+=item print_intro_page()
-# ============================================================= Copy a userfile
+=item upload_batchfile()
-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'}.'/',
- '/public/'.$origcrsdata{'domain'}.'/'.$origcrsdata{'num'}.'/'
- => '/public/'. $newcrsdata{'domain'}.'/'. $newcrsdata{'num'}.'/'
- )));
- }
-}
+=item process_batchfile()
-# =============================================================== 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'});
- foreach my $key (keys(%data)) {
- if ($key=~/^internal./) { delete($data{$key}); }
- }
- 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_(start|end)$/) {
- $newdata{$thiskey}=$newdata{$thiskey}+$delta;
- }
- }
- return &Apache::lonnet::put
- ('resourcedata',\%newdata,$newcrsdata{'domain'},$newcrsdata{'num'});
-}
+=item courserequestbrowser_javascript()
-# ========================================================== Copy all userfiles
+=item print_creation_logs()
-sub copyuserfiles {
- my ($origcrsid,$newcrsid)=@_;
- foreach (&crsdirlist($origcrsid,'userfiles')) {
- if ($_ !~m|^scantron_|) {
- ©file($origcrsid,$newcrsid,$_);
- }
- }
-}
-# ========================================================== Copy all userfiles
+=item creation_display_filter()
-sub copydbfiles {
- my ($origcrsid,$newcrsid)=@_;
+=item context_names()
- my ($origcrs_discussion) = ($origcrsid=~m|^/(.*)|);
- $origcrs_discussion=~s|/|_|g;
- foreach (&crsdirlist($origcrsid)) {
- if ($_=~/\.db$/) {
- unless
- ($_=~/^(nohist\_|discussiontimes|classlist|versionupdate|resourcedata|\Q$origcrs_discussion\E|slots|slot_reservations|(grading|review)queue|CODEs)/) {
- ©db($origcrsid,$newcrsid,$_);
- my $histfile=$_;
- $histfile=~s/\.db$/\.hist/;
- ©file($origcrsid,$newcrsid,$histfile);
- }
- }
- }
-}
+=item instcode_srchstr()
-# ======================================================= Copy all course files
+=item syllabuslink_javascript()
-sub copycoursefiles {
- my ($origcrsid,$newcrsid)=@_;
- ©userfiles($origcrsid,$newcrsid);
- ©dbfiles($origcrsid,$newcrsid);
- ©resourcedb($origcrsid,$newcrsid);
-}
+=back
+
+=cut
+
+package Apache::loncreatecourse;
+
+use strict;
+use Apache::Constants qw(:common :http);
+use Apache::lonnet;
+use Apache::loncommon;
+use Apache::londocs;
+use Apache::lonlocal;
+use Apache::lonuserutils;
+use LONCAPA::batchcreatecourse;
+use LONCAPA qw(:DEFAULT :match);
+
+my $registered_flush;
+my $registered_instcats;
+my $modified_dom;
# ===================================================== Phase one: fill-in form
sub print_course_creation_page {
my $r=shift;
+ my $crstype = 'Community';
+ if ($env{'form.phase'} eq 'courseone') {
+ $crstype = 'Course';
+ }
my $defdom=$env{'request.role.domain'};
- my %host_servers = &Apache::loncommon::get_library_servers($defdom);
+ my %domdefaults = &Apache::lonnet::get_domain_defaults($defdom);
+ my %host_servers = &Apache::lonnet::get_servers($defdom,'library');
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',&mt('Help on Creating Courses'));
my $cloneform=&Apache::loncommon::select_dom_form
($env{'request.role.domain'},'clonedomain').
&Apache::loncommon::selectcourse_link
- ('ccrs','clonecourse','clonedomain');
+ ('ccrs','clonecourse','clonedomain',undef,undef,undef,$crstype);
my $coursebrowserjs=&Apache::loncommon::coursebrowser_javascript($env{'request.role.domain'});
+ my ($enroll_table,$krbdef,$krbdefdom,$krbform,$intform,$locform,
+ $javascript_validations);
my $starttime = time;
my $endtime = time+(6*30*24*60*60); # 6 months from now, approx
- my $enroll_table = &Apache::londropadd::date_setting_table($starttime,$endtime,'create_enrolldates');
- my $access_table = &Apache::londropadd::date_setting_table($starttime,$endtime,'create_defaultdates');
- 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);
+ my $access_table = &Apache::lonuserutils::date_setting_table($starttime,
+ $endtime,'create_defaultdates');
+ my $openallfrom =
+ &Apache::lonhtmlcommon::date_setter('ccrs','openallfrom',$starttime);
+ if ($crstype eq 'Course') {
+ $enroll_table = &Apache::lonuserutils::date_setting_table($starttime,
+ $endtime,'create_enrolldates');
+ ($krbdef,$krbdefdom) =
+ &Apache::loncommon::get_kerberos_defaults($defdom);
+ $javascript_validations=&Apache::lonuserutils::javascript_validations(
+ 'createcourse',$krbdefdom);
+ my %param = ( formname => 'document.ccrs',
+ kerb_def_dom => $krbdefdom,
+ kerb_def_auth => $krbdef
+ );
+ $krbform = &Apache::loncommon::authform_kerberos(%param);
+ $intform = &Apache::loncommon::authform_internal(%param);
+ $locform = &Apache::loncommon::authform_local(%param);
+ } else {
+ my $title_alert = &mt('A Community title is required');
+ my $coord_alert = &mt('The username of the Coordinator is required');
+ &js_escape(\$title_alert);
+ &js_escape(\$coord_alert);
+ $javascript_validations = qq|
+function validate(formname) {
+ if (formname.title == '') {
+ alert("$title_alert");
+ return;
+ }
+ if (formname.ccuname == '') {
+ alert("$coord_alert");
+ }
+ formname.submit();
+}
+ |;
+ }
my %lt=&Apache::lonlocal::texthash(
'cinf' => "Course Information",
'ctit' => "Course Title",
@@ -285,11 +162,13 @@ sub print_course_creation_page {
'iinf' => "Institutional Information",
'stat' => "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.",
'ccod' => "Course Code",
- 'toin' => "to interface with institutional data, e.g., fs03glg231 for Fall 2003 Geology 231",
- 'snid' => "Section Numbers and corresponding LON-CAPA section/group IDs",
- 'csli' => "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",
+ 'snid' => "Section Numbers and corresponding LON-CAPA section IDs",
+ 'csli' => "a comma separated list of institutional section numbers, each separated by a colon from the (optional) corresponding section ID to be used in LON-CAPA e.g., 001:1,002:2",
'crcs' => "Crosslisted courses",
- 'cscs' => "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:zol2",
+ 'cscs' => "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) section ID to be used in LON-CAPA, e.g., fs03ent231001:ent1,fs03bot231001:bot1,fs03zol231002:zol2",
+ 'ccre' => "Course credits",
+ 'crcd' => "Create six character course identifier to share with students",
+ 'cred' => "the number of institutional credits students will earn by completing this course",
'crco' => "Course Content",
'cncr' => "Completely new course",
'cecr' => "Clone an existing course",
@@ -301,25 +180,33 @@ sub print_course_creation_page {
'stco' => "standard courses only",
'blnk' => "Blank",
'sllb' => "Syllabus",
- 'navi' => "Navigate",
+ 'navi' => "Course Contents",
'cid' => "Course ID",
'dmn' => "Domain",
+ 'dsh' => "Date Shift",
'asov' => "Additional settings, if specified below, will override cloned settings",
+ 'ncd' => "Do not clone date parameters",
+ 'prd' => 'Clone date parameters as-is',
+ 'shd' => 'Shift date parameters by number of days',
+ 'dpl' => 'URL shortcuts (for deep linking)',
+ 'nsl' => 'Do not clone URL shortcuts',
+ 'tsl' => 'Transfer URL shortcuts from existing course to new course',
+ 'csl' => 'Create new URL shortcuts in new course',
'assp' => "Assessment Parameters",
'oaas' => "Open all assessments",
+ 'sta' => "starting from:",
'mssg' => "Messaging",
'scpf' => "Set course policy feedback to Course Coordinator",
- 'scfc' => "Set content feedback to Course Coordinator",
+ 'scfc' => "Set resource content feedback to Course Coordinator",
+ 'scof' => "Set course content feedback to Course Coordinator",
'cmmn' => "Communication",
'dsrd' => "Disable student resource discussion",
- 'dsuc' => "Disable student use of chatrooms",
+ 'dsuc' => "Disable student use of chat rooms",
'acco' => "Access Control",
'snak' => "Students need access key to enter course",
- 'kaut' =>
- 'Key authority (id@domain) if other than course',
- 'cc' => "Course Coordinator",
+ 'ow' => "Course Owner",
+ 'cc' => "(will be assigned Course Coordinator role)",
'user' => "Username",
- 'ierc' => "Immediately expire own role as Course Coordinator",
'aens' => "Automated enrollment settings",
'aesc' => "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.",
'aadd' => "Automated adds",
@@ -327,21 +214,55 @@ sub print_course_creation_page {
'no' => "No",
'audr' => "Automated drops",
'dacu' => "Duration of automated classlist updates",
+ 'dads' => 'Default Access Dates for Students',
'dacc' => "Default start and end dates for student access",
- 'psam' => "Please select the authentication mechanism",
- 'pcda' => "Please choose the default authentication method to be used by new users added to this LON-CAPA domain by the automated enrollment process",
+ 'psam' => "Authentication mechanism",
+ 'pcda' => "Default authentication method for new users added to this domain by the automated enrollment process",
'nech' => "Notification of enrollment changes",
- 'nccl' => "Notification to course coordinator via LON-CAPA message when enrollment changes occur during the automated update?",
- 'ndcl' => "Notification to domain coordinator via LON-CAPA message when enrollment changes occur during the automated update?",
'irsp' => "Include retrieval of student photographs?",
'rshm' => 'Resource Space Home',
- 'opco' => "Open Course"
- );
- my $html=&Apache::lonxml::xmlbegin();
- $r->print(<
-$lt{'aadd'} - - -
-$lt{'audr'} - - -
-$lt{'dacu'} -$enroll_table -
-$lt{'dacc'} -$access_table -
-$lt{'psam'}.
-$krbform
-
-$intform
-
-$locform
-
-$lt{'nech'}
-$lt{'nccl'}
-
-
-
-$lt{'ndcl'}
-
-
-
-$lt{'irsp'} - - -
-