[LON-CAPA-cvs] cvs: modules /raeburn loncreatecourse.pm

raeburn lon-capa-cvs@mail.lon-capa.org
Thu, 13 Nov 2003 16:11:10 -0000


This is a MIME encoded message

--raeburn1068739870
Content-Type: text/plain

raeburn		Thu Nov 13 11:11:10 2003 EDT

  Added files:                 
    /modules/raeburn	loncreatecourse.pm 
  Log:
  Stuart's modified version of loncreatecourse to allow DCs to set up auto-enrollment parameters
  
  
--raeburn1068739870
Content-Type: text/plain
Content-Disposition: attachment; filename="raeburn-20031113111110.txt"


Index: modules/raeburn/loncreatecourse.pm
+++ modules/raeburn/loncreatecourse.pm
# The LearningOnline Network
# Create a course
#
# $Id: loncreatecourse.pm,v 1.1 2003/11/13 16:11:10 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::lonhtmlcommon;
use Apache::lonratedt;
use Apache::londocs;

# ===================================================== 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 = '<select name="course_home" size="1">'."\n";
    foreach my $server (sort(keys(%host_servers))) {
        $course_home .= qq{<option value="$server"};
        if ($server eq $Apache::lonnet::perlvar{'lonHostID'}) {
            $course_home .= " selected ";
        }
        $course_home .= qq{>$server $host_servers{$server}</option>};
    }
    $course_home .= "\n</select>\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 $date_table = &date_setting_table();
    $r->print(<<ENDDOCUMENT);
<html>
<script language="JavaScript" type="text/javascript">
var editbrowser = null;
function openbrowser(formname,elementname) {
    var url = '/res/?';
    if (editbrowser == null) {
        url += 'launch=1&';
    }
    url += 'catalogmode=interactive&';
    url += 'mode=edit&';
    url += 'form=' + formname + '&';
    url += 'element=' + elementname + '&';
    url += 'only=sequence' + '';
    var title = 'Browser';
    var options = 'scrollbars=1,resizable=1,menubar=0';
    options += ',width=700,height=600';
    editbrowser = open(url,title,options,'1');
    editbrowser.focus();
}
</script>
<head>
<title>The LearningOnline Network with CAPA</title>
</head>
$bodytag
$helplink
<form action="/adm/createcourse" method="post" name="ccrs">
<h2>Course Information</h2>
<p>
<b>Course Title:</b>
<input type="text" size="50" name="title">
</p><p>
<b>Course Home Server:</b>$course_home
</p><p>
<b>Course ID/Number (optional)</b>
<input type="text" size="30" name="crsid">
</p><p>
<h2>Institutional Information</h2>
<p>
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.  
</p><p>          
<b>Course Code</b> 
<input type="text" size="30" name="crscode"><br>
(to interface with institutional data, e.g., fs03glg231 for Fall 2003 Geology 231)
</p><p>
<b>Section Numbers</b>
 <input type="text" size="30" name="crssections"><br>
(a comma separated list of section numbers, e.g., 001,002)
</p><p>
<b>Crosslisted courses</b>
 <input type="text" size="30" name="crsxlists"><br>
(a comma separated list of course sections crosslisted with the current course, e.g., fs03ent231001, fs03bot231001, fs03zol231002)
</p><p>  
<h2>Course Content</h2>
<p>
<b>Map:</b>
<input type="text" size="50" name="topmap">
<a href="javascript:openbrowser('ccrs','topmap')">Select Map</a>
</p><p>
<b>Do NOT generate as standard course</b> 
(only check if you know what you are doing):
<input type="checkbox" name="nonstandard">
</p>
<p>
<b>First Resource</b> (standard courses only):
<input type="radio" name="firstres" value="blank">Blank
&nbsp;
<input type="radio" name="firstres" value="syl" checked>Syllabus
&nbsp;
<input type="radio" name="firstres" value="nav">Navigate
</p>

<h2>Assessment Parameters</h2>
<p>
<b>Open all assessments: </b>
<input type="checkbox" name="openall" checked>
</p>
<h2>Messaging</h2>
<p>
<b>Set course policy feedback to Course Coordinator: </b>
<input type="checkbox" name="setpolicy" checked>
</p><p>
<b>Set content feedback to Course Coordinator: </b>
<input type="checkbox" name="setcontent" checked>
</p>
<h2>Communication</h2>
<p>
<b>Disable student resource discussion: </b>
<input type="checkbox" name="disresdis" /> <br />
<b>Disable student use of chatrooms: </b>
<input type="checkbox" name="disablechat" />
</p>
<h2>Access Control</h2>
<p>
<b>Students need access key to enter course: </b>
<input type="checkbox" name="setkeys" />
</p>
<h2>Course Coordinator</h2>
<p>
<b>Username:</b> <input type="text" size="15" name="ccuname" />
</p><p>
<b>Domain:</b> $domform
</p><p>
<b>Immediately expire own role as Course Coordinator:</b>
<input type="checkbox" name="expireown" checked>
</p><p>
<h2>Automated enrollment settings</h2>
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.
</p>
<p>
<b>Automated adds</b>
<input type="radio" name="autoadds" value="1">Yes <input type="radio" name="autoadds" value="0" >No
</p><p>
<b>Automated drops</b>
<input type="radio" name="autodrops" value="1">Yes <input type="radio" name="autodrops" value="0" >No
</p><p>
<b>Duration of automated classlist updates</b>
$date_table
</p><p>
<input type="hidden" name="phase" value="two" />
<input type="submit" value="Open Course">
</p><p>
<b>Email notification of enrollment changes</b>
Email notification to course coordinator when enrollment changes occur during the automated update? 
<input type="checkbox" name="notifyemail">   
</form>
</body>
</html>
ENDDOCUMENT
}

sub date_setting_table {
    my $starttime = time;
    my $endtime = time+(6*30*24*60*60); # 6 months from now, approx 
    my $startform = &Apache::lonhtmlcommon::date_setter('ccrs','startdate',$starttime);
    my $endform =  &Apache::lonhtmlcommon::date_setter('ccrs','enddate',$endtime);
    my $perpetual = '<nobr><input type="checkbox" name="no_end_date"/> no ending date</nobr>';
    my $result = '';
    $result .= "<table>\n";
    $result .= '<tr><td align="right">Starting Date</td>'.
        '<td>'.$startform.'</td>'.
        '<td></td>'."</tr>\n";
    $result .= '<tr><td align="right">Ending Date</td>'.
        '<td>'.$endform.'</td>'.
        '<td>'.$perpetual.'</td>'."</tr>\n";
    $result .= "</table>\n";
    return $result;
}

# ====================================================== 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(<<ENDENHEAD);
<html>
<head>
<title>The LearningOnline Network with CAPA</title>
</head>
$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.'</body></html>');
	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'}.'</body></html>');
        return;
    }
#
# Open course
#
    my $courseid=&Apache::lonnet::createcourse($ENV{'request.role.domain'},
                                               $cdescr,$curl,
                                               $ENV{'form.course_home'},
                                               $ENV{'form.nonstandard'});

    $r->print('New LON-CAPA Course ID: '.$courseid.'<br>');
#
# Check if created correctly
#
    my ($crsudom,$crsunum)=($courseid=~/^\/(\w+)\/(\w+)$/);
    my $crsuhome=&Apache::lonnet::homeserver($crsunum,$crsudom);
    $r->print('Created on: '.$crsuhome.'<br>');
#
# Set environment
#
    my %cenv=();
    my $envflag=0;
    if ($ENV{'form.crsid'}) {
	$envflag=1;
        $cenv{'courseid'}=$ENV{'form.crsid'};
    }
    if ($ENV{'form.crscode'}) {
        $envflag=1;
        $cenv{'coursecode'}=$ENV{'form.crscode'};
    }
    if ($ENV{'form.crssections'}) {
        $envflag=1;
        $cenv{'sectionnums'}=$ENV{'form.crssections'};
    }
    if ($ENV{'form.crsxlist'}) {
        $envflag=1;
        $cenv{'crosslistings'}=$ENV{'form.crsxlist'};
    }
    if ($ENV{'form.autoadds'}) {
        $envflag=1;
        $cenv{'autoadds'}=$ENV{'form.autoadds'};
    }
    if ($ENV{'form.autodrops'}) {
        $envflag=1;
        $cenv{'autodrops'}=$ENV{'form.autodrops'};
    }
    if ($ENV{'form.notifyemail'}) {
        $envflag=1;
        $cenv{'notification'}=$ENV{'form.notifyemail'};
        if ($ccuname)
        {
# get e-mail address of ccuname.
          $cenv{'notifylist'}= $ENV{'$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{'autostart'}=$startdate;
    $cenv{'autoend'}=$enddate;

    if (($ccdomain) && ($ccuname)) {
       if ($ENV{'form.setpolicy'}) {
	   $envflag=1;
           $cenv{'policy.email'}=$ccuname.':'.$ccdomain;
       }
       if ($ENV{'form.setcontent'}) {
           $envflag=1;
           $cenv{'question.email'}=$ccuname.':'.$ccdomain;
       }
    }
    if ($ENV{'form.setkeys'}) {
       $envflag=1;
       $cenv{'keyaccess'}='yes';
    }
    if ($ENV{'form.disresdis'}) {
	$envflag=1;
        $cenv{'pch.roles.denied'}='st';
    }
    if ($ENV{'form.disablechat'}) {
	$envflag=1;
        $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
    #
    $envflag=1;
    $cenv{'rndseed'}=&Apache::lonnet::latest_rnd_algorithm_id();;
    #
    # By default, use standard grading
    $cenv{'grading'} = 'standard';

    if ($envflag) {
       $r->print('Setting environment: '.                 
          &Apache::lonnet::put('environment',\%cenv,$crsudom,$crsunum).'<br>');
   }
#
# 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).'<br>');
   }
#
# 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').'<br>');
  }
#
# 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).'<br>');
#
# 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').'<p>');
   }
    if ($ENV{'form.setkeys'}) {
	$r->print(
 '<p><a href="/adm/managekeys?cid='.$crsudom.'_'.$crsunum.'">Manage Access Keys</a></p>');
    }
    $r->print('<p>Roles will be active at next login.</p></body></html>');
}

# ===================================================================== Handler
sub handler {
    my $r = shift;

    if ($r->header_only) {
       $r->content_type('text/html');
       $r->send_http_header;
       return OK;
    }

    if (&Apache::lonnet::allowed('ccc',$ENV{'request.role.domain'})) {
       $r->content_type('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__

--raeburn1068739870--