[LON-CAPA-cvs] cvs: doc /loncapafiles loncapafiles.lpml loncom/html/adm/help/tex Course_Request_Access_End.tex Course_Request_Access_Start.tex Course_Request_Autoadd.tex Course_Request_Autodrop.tex Course_Request_Category.tex Course_Request_Clone.tex Course_Request_Crosslist.tex Course_Request_Description.tex Course_Request_Enroll_End.tex Course_Request_Enroll_Start.tex Course_Request_LCSection.tex Course_Request_Personnel.tex Course_Request_RegAccess_End.tex Course_Request_RegAccess_Start.tex Course_Request_Rolesection.tex Course_Request_Sections.tex loncom/interface lonrequestcourse.pm
raeburn
raeburn@source.lon-capa.org
Thu, 10 Sep 2009 03:00:37 -0000
This is a MIME encoded message
--raeburn1252551637
Content-Type: text/plain
raeburn Thu Sep 10 03:00:37 2009 EDT
Added files:
/loncom/html/adm/help/tex Course_Request_Access_End.tex
Course_Request_Access_Start.tex
Course_Request_Autoadd.tex
Course_Request_Autodrop.tex
Course_Request_Category.tex
Course_Request_Clone.tex
Course_Request_Crosslist.tex
Course_Request_Description.tex
Course_Request_Enroll_End.tex
Course_Request_Enroll_Start.tex
Course_Request_LCSection.tex
Course_Request_Personnel.tex
Course_Request_Rolesection.tex
Course_Request_Sections.tex
Course_Request_RegAccess_Start.tex
Course_Request_RegAccess_End.tex
Modified files:
/loncom/interface lonrequestcourse.pm
/doc/loncapafiles loncapafiles.lpml
Log:
- Contextual help for Course Requests.
--raeburn1252551637
Content-Type: text/plain
Content-Disposition: attachment; filename="raeburn-20090910030037.txt"
Index: loncom/interface/lonrequestcourse.pm
diff -u loncom/interface/lonrequestcourse.pm:1.33 loncom/interface/lonrequestcourse.pm:1.34
--- loncom/interface/lonrequestcourse.pm:1.33 Wed Sep 9 15:49:26 2009
+++ loncom/interface/lonrequestcourse.pm Thu Sep 10 03:00:31 2009
@@ -1,7 +1,7 @@
# The LearningOnline Network
# Request a course
#
-# $Id: lonrequestcourse.pm,v 1.33 2009/09/09 15:49:26 raeburn Exp $
+# $Id: lonrequestcourse.pm,v 1.34 2009/09/10 03:00:31 raeburn Exp $
#
# Copyright Michigan State University Board of Trustees
#
@@ -724,7 +724,9 @@
END
- $r->print(&header('Course Requests',$js.$jscript,$loaditems).$crumb.'<div>'.
+ $r->print(&header('Course Requests',$js.$jscript,$loaditems).$crumb.
+ '<p>'.&mt('Request creation of a new course, or manage pending course requests.').'</p>'.
+ '<div>'.
&Apache::lonhtmlcommon::start_pick_box().
&Apache::lonhtmlcommon::row_title(&mt('Course Domain')).
'<form name="domforcourse" method="post" action="/adm/requestcourse">'.
@@ -1134,7 +1136,7 @@
next => 'Next',
);
$crstype = $env{'form.crstype'};
- $r->print('<form name="'.$formname.'" method="post" action="/adm/requestcourse">');
+ $r->print('<br /><form name="'.$formname.'" method="post" action="/adm/requestcourse">');
my (@codetitles,%cat_titles,%cat_order,@code_order,$instcode,$code_chk,
@disallowed);
if ($crstype eq 'official') {
@@ -1171,7 +1173,9 @@
$codepicker = &coursecode_form($dom,'instcode',\@codetitles,
\%cat_titles,\%cat_order);
if ($codepicker) {
- $r->print('<div>'.&Apache::lonhtmlcommon::start_pick_box().$codepicker.
+ $r->print(&mt('Specify the course to be created.').
+ '<div>'.&Apache::lonhtmlcommon::start_pick_box().
+ $codepicker.
&Apache::lonhtmlcommon::end_pick_box().'</div>');
} else {
$next = $states->{$action}[$page+2];
@@ -1411,7 +1415,7 @@
sub print_enrollment_menu {
my ($formname,$instcode,$dom,$codetitles,$cat_titles,$cat_order,$code_order,
$invalidcrosslist) =@_;
- my ($sections,$autoenroll,$access_dates,$output);
+ my ($sections,$autoenroll,$access_dates,$output,$hasauto);
my $starttime = time;
my $endtime = time+(6*30*24*60*60); # 6 months from now, approx
@@ -1430,7 +1434,8 @@
$section_form = &inst_section_selector($dom,$instcode);
if ($section_form) {
$sections = &Apache::lonhtmlcommon::row_headline().
- '<h3>'.&mt('Sections for auto-enrollment').'</h3>'.
+ '<h3>'.&Apache::loncommon::help_open_topic('Course_Request_Sections').
+ ' '.&mt('Sections for auto-enrollment').'</h3>'.
&Apache::lonhtmlcommon::row_closure(1).
$section_form;
}
@@ -1457,26 +1462,29 @@
&Apache::lonhtmlcommon::row_closure(1).
$crosslist_form;
}
+ $hasauto = 1;
$autoenroll =
- &Apache::lonhtmlcommon::row_title(&mt('Add registered students automatically')).
+ &Apache::lonhtmlcommon::row_title(&Apache::loncommon::help_open_topic('Course_Request_Autoadd').' '.&mt('Add registered students automatically')).
'<span class="LC_nobreak"><label>'.
'<input type="radio" name="autoadds" value="1">'.
&mt('Yes').'</label>'.(' 'x3).'<label>'.
'<input type="radio" name="autoadds" value="0" checked="checked">'.
&mt('No').'</label></span>'.
&Apache::lonhtmlcommon::row_closure(1).
- &Apache::lonhtmlcommon::row_title(&mt('Drop unregistered students automatically')).
+ &Apache::lonhtmlcommon::row_title(&Apache::loncommon::help_open_topic('Course_Request_Autodrop').' '.&mt('Drop unregistered students automatically')).
'<span class="LC_nobreak"><label>'.
'<input type="radio" name="autodrops" value="1">'.
&mt('Yes').'</label>'.(' 'x3).'<label>'.
'<input type="radio" name="autodrops" value="0" checked="checked">'.
&mt('No').'</label></span>'.
&Apache::lonhtmlcommon::row_closure(1).
- &date_setting_table($starttime,$endtime,$formname,'enroll',%enrolltitles);
+ &date_setting_table($starttime,$endtime,$formname,'enroll',
+ $hasauto,%enrolltitles);
}
}
my $access_dates =
- &date_setting_table($starttime,$endtime,$formname,'access',%accesstitles);
+ &date_setting_table($starttime,$endtime,$formname,'access',$hasauto,
+ %accesstitles);
$output .= &Apache::lonhtmlcommon::start_pick_box();
if ($sections) {
$output .= $sections;
@@ -1530,7 +1538,8 @@
'<th>'.&mt('Include?').'<input type="hidden" name="sectotal" '.
'value="'.$sectotal.'" /></th>'.
'<th>'.&mt('Institutional Section').'</th>'.
- '<th>'.&mt('LON-CAPA section').'</th>'.
+ '<th>'.&Apache::loncommon::help_open_topic('Course_Request_LCSection').
+ ' '.&mt('LON-CAPA section').'</th>'.
&Apache::loncommon::end_data_table_row();
for (my $i=0; $i<@sections; $i++) {
my $colflag = $i%2;
@@ -1559,7 +1568,7 @@
}
sub date_setting_table {
- my ($starttime,$endtime,$formname,$prefix,%datetitles) = @_;
+ my ($starttime,$endtime,$formname,$prefix,$hasauto,%datetitles) = @_;
my ($perpetual,$table);
my $startform = &Apache::lonhtmlcommon::date_setter($formname,$prefix.'start',
$starttime,'','','',1,'','','',1);
@@ -1572,11 +1581,27 @@
&mt('No end date').'</label></span>';
$closure = '1';
}
- $table = &Apache::lonhtmlcommon::row_title($datetitles{'start'}).
- $startform.
+
+ my %help_item = (
+ access => {
+ start => 'Course_Request_Access_Start',
+ end => 'Course_Request_Access_End',
+ },
+ enroll => {
+ start => 'Course_Request_Enroll_Start',
+ end => 'Course_Request_Enroll_End',
+ },
+ );
+ if ($hasauto) {
+ $help_item{'access'}{'start'} = 'Course_Request_RegAccess_Start';
+ $help_item{'access'}{'end'} = 'Course_Request_RegAccess_End';
+ }
+
+ $table = &Apache::lonhtmlcommon::row_title(&Apache::loncommon::help_open_topic($help_item{$prefix}{'start'}).
+ ' '.$datetitles{'start'}).$startform.
&Apache::lonhtmlcommon::row_closure(1).
- &Apache::lonhtmlcommon::row_title($datetitles{'end'}).
- $endform.$perpetual.
+ &Apache::lonhtmlcommon::row_title(&Apache::loncommon::help_open_topic($help_item{$prefix}{'end'}).
+ ' '.$datetitles{'end'}).$endform.$perpetual.
&Apache::lonhtmlcommon::row_closure($closure);
return $table;
}
@@ -1645,7 +1670,7 @@
);
$lt{'unofficial'} = $lt{'official'};
$output .= &Apache::lonhtmlcommon::row_headline().
- '<h3>'.$lt{$crstype}.' '.&mt('Include other personnel?').'</h3>';
+ '<h3>'.&Apache::loncommon::help_open_topic('Course_Request_Personnel').' '.$lt{$crstype}.' '.&mt('Include other personnel?').'</h3>';
}
for (my $i=0; $i<$persontotal; $i++) {
my @linkargs = map { 'person_'.$i.'_'.$_ } (@items);
@@ -1687,8 +1712,9 @@
'<td align="center" valign="top">'.&mt('First Name').'<br />'.$form_elems{'firstname'}.'</td>'."\n".
'<td align="center" valign="top">'.&mt('Last Name').'<br />'.$form_elems{'lastname'}.'</td>'."\n".
'<td align="center" valign="top">'.&mt('E-mail').'<br />'.$form_elems{'emailaddr'}.'</td></tr>'."\n".
- '<tr><td align="center" valign="top">'.&mt('Role').&Apache::loncommon::help_open_topic('Course_Roles').'<br />'.$roleselector.'</td>'."\n".
- '<td'.$seccolspan.' align="center" valign="top">'.&mt('LON-CAPA Section(s)').'<br />'.$sectionselector.'</td>'."\n".
+ '<tr><td align="center" valign="top">'.&Apache::loncommon::help_open_topic('Course_Roles').' '.&mt('Role').'<br />'.$roleselector.'</td>'."\n".
+ '<td'.$seccolspan.' align="center" valign="top">'.
+ &Apache::loncommon::help_open_topic('Course_Request_Rolesection').' '.&mt('LON-CAPA Section(s)').'<br />'.$sectionselector.'</td>'."\n".
'</tr></table>'.&Apache::lonhtmlcommon::row_closure();
}
$output .= &Apache::lonhtmlcommon::row_title(&mt('Add another?')).
@@ -1696,7 +1722,8 @@
'<input name="addperson" type="checkbox" value="'.$persontotal.'"'.
' onclick="javascript:nextPage(document.'.$formname.",'".$env{'form.state'}.
"'".');" />'.&mt('Add?').&Apache::lonhtmlcommon::row_closure(1).
- &Apache::lonhtmlcommon::end_pick_box().'</div>';
+ &Apache::lonhtmlcommon::end_pick_box().'</div>'.
+ '<p>'.&mt('You may also add users later, once the course has been created, by using the "Manage course users" link, accessible from the "Main Menu".').'</p>';
return $output;
}
@@ -2241,7 +2268,7 @@
}
my $output .= $js_validate."\n".'<div>'.&Apache::lonhtmlcommon::start_pick_box().
&Apache::lonhtmlcommon::row_headline().
- '<h3>'.$title.'</h3>'.
+ '<h3>'.&Apache::loncommon::help_open_topic('Course_Request_Description').' '.$title.'</h3>'.
&Apache::lonhtmlcommon::row_closure(1).
&Apache::lonhtmlcommon::row_title(&mt('Description')).
'<input type="text" size="40" name="cdescr" />';
@@ -2255,7 +2282,7 @@
$output .= $home_server_pick.
&Apache::lonhtmlcommon::row_closure().
&Apache::lonhtmlcommon::row_headline().
- '<h3>'.&mt('Clone content and settings from an existing course?').'</h3>'.
+ '<h3>'.&Apache::loncommon::help_open_topic('Course_Request_Clone').' '.&mt('Clone content and settings from an existing course?').'</h3>'.
&Apache::lonhtmlcommon::row_closure(1).
&clone_form($dom,$formname,$crstype).
&Apache::lonhtmlcommon::end_pick_box().'</div>'."\n";
@@ -2307,6 +2334,10 @@
instcode => 'Course Category',
crosslist => 'Cross Listed Course',
);
+ my %helpitem = (
+ instcode => 'Course_Request_Category',
+ crosslist => 'Course_Request_Crosslist',
+ );
if ((ref($codetitles) eq 'ARRAY') && (ref($cat_titles) eq 'HASH') &&
(ref($cat_order))) {
my ($sel,$instsec,$lcsec);
@@ -2322,7 +2353,7 @@
my $lastitem = pop(@{$codetitles});
my $lastinput = '<input type="text" size="5" name="'.$sel.'_'. $lastitem.'" />';
if (@{$codetitles} > 0) {
- $output = &Apache::lonhtmlcommon::row_title($rowtitle{$context}).
+ $output = &Apache::lonhtmlcommon::row_title(&Apache::loncommon::help_open_topic($helpitem{$context}).' '.$rowtitle{$context}).
'<table><tr>';
if ($context eq 'crosslist') {
$output .= '<td>'.&mt('Include?').'<br />'.
Index: doc/loncapafiles/loncapafiles.lpml
diff -u doc/loncapafiles/loncapafiles.lpml:1.658 doc/loncapafiles/loncapafiles.lpml:1.659
--- doc/loncapafiles/loncapafiles.lpml:1.658 Wed Sep 9 15:49:04 2009
+++ doc/loncapafiles/loncapafiles.lpml Thu Sep 10 03:00:37 2009
@@ -2,7 +2,7 @@
"http://lpml.sourceforge.net/DTD/lpml.dtd">
<!-- loncapafiles.lpml -->
-<!-- $Id: loncapafiles.lpml,v 1.658 2009/09/09 15:49:04 raeburn Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.659 2009/09/10 03:00:37 raeburn Exp $ -->
<!--
@@ -2687,6 +2687,20 @@
Course_Parameter_Levels.tex;
Course_Parameter_Table_Mode.tex;
Course_Problem_Weight.tex;
+Course_Request_Access_End.tex;
+Course_Request_Access_Start.tex;
+Course_Request_Autoadd.tex;
+Course_Request_Autodrop.tex;
+Course_Request_Category.tex;
+Course_Request_Clone.tex;
+Course_Request_Crosslist.tex;
+Course_Request_Description.tex;
+Course_Request_Enroll_End.tex;
+Course_Request_Enroll_Start.tex;
+Course_Request_LCSection.tex;
+Course_Request_Personnel.tex;
+Course_Request_Rolesection.tex
+Course_Request_Sections.tex;
Course_Roles.tex;
Course_Self_Enrollment.tex;
Course_Set_Start_End_Date.tex;
Index: loncom/html/adm/help/tex/Course_Request_Access_End.tex
+++ loncom/html/adm/help/tex/Course_Request_Access_End.tex
\label{Course_Request_Access_End}
Choose the default date when course access should end for students added to the course. This date will apply to any student roles added as part of this course request, and also to any student roles added subsequently, once the course has been created (unless it is changed or overridden).
Index: loncom/html/adm/help/tex/Course_Request_Access_Start.tex
+++ loncom/html/adm/help/tex/Course_Request_Access_Start.tex
\label{Course_Request_Access_Start}
Choose the default date when course access should begin for students added to the course. This date will apply to any student roles added as part of this course request, and also to any student roles added subsequently, once the course has been created (unless it is changed or overridden).
Index: loncom/html/adm/help/tex/Course_Request_Autoadd.tex
+++ loncom/html/adm/help/tex/Course_Request_Autoadd.tex
\label{Course_Request_Autoadd}
Choose whether you would like registered students to be enrolled automatically in your course.
Index: loncom/html/adm/help/tex/Course_Request_Autodrop.tex
+++ loncom/html/adm/help/tex/Course_Request_Autodrop.tex
\label{Course_Request_Autodrop}
Choose whether you would like course access terminated for previously registered students who cease to be registered. All data for a dropped student continue to be accessible to Course Coordinators, and will be reinstated if the student is re-enrolled.
Index: loncom/html/adm/help/tex/Course_Request_Category.tex
+++ loncom/html/adm/help/tex/Course_Request_Category.tex
\label{Course_Request_Category}
Official courses may have been categorized by your institution for example by Year, Semeter, and Department. If so, select options for these categories which correspond to the course for which you will be using LON-CAPA.
Index: loncom/html/adm/help/tex/Course_Request_Clone.tex
+++ loncom/html/adm/help/tex/Course_Request_Clone.tex
\label{Course_Request_Clone}
You may choose to build your new course by cloning an existing course. If you have Course Coordinator access or have been assigned "cloner" rights in an existing course currently in the LON-CAPA system you can search for the course and select it in a pop-up window, launched by the 'Select Course' link.
Cloning a course will copy all course content, and most course settings. Student enrollment, peformance data and discussion postings will not be copied. Settings which involve dates (e.g., open dates, due dates, and close dates for availability of course content and online homework problems) will be preserved, shifted by a number of days, or omitted from the copy process, based on your choice for the 'Date Shift'.
Index: loncom/html/adm/help/tex/Course_Request_Crosslist.tex
+++ loncom/html/adm/help/tex/Course_Request_Crosslist.tex
\label{Course_Request_Crosslist}
An 'official' course may be cross-listed in your institution's schedule of courses under a different number, or a different department. If this is the case for your course, and you would like students who are enrolled in the cross-listed courses to be enrolled automatically in your LON-CAPA course, select the appropriate options from your institution's course categorization.
The 'LON-CAPA section' is the section within your LON-CAPA course with which students enrolled in the cross-listed course will be affiliated. You can leave this box empty if you do not wish to differentiate students based on method of enrollment. In that case students will receive a 'section-less' role in your LON-CAPA course. Otherwise, not that LON-CAPA section names may only contain letters and numbers.
Index: loncom/html/adm/help/tex/Course_Request_Description.tex
+++ loncom/html/adm/help/tex/Course_Request_Description.tex
\label{Course_Request_Description}
This is the title of the course (e.g., PHY231, Fall 2009 Physics for Scientists and Engineers I).
Index: loncom/html/adm/help/tex/Course_Request_Enroll_End.tex
+++ loncom/html/adm/help/tex/Course_Request_Enroll_End.tex
\label{Course_Request_Enroll_End}
Choose when automatic enrollment of registered students should end. Newly registered students will cease to be enrolled automatically in your course after this date.
Index: loncom/html/adm/help/tex/Course_Request_Enroll_Start.tex
+++ loncom/html/adm/help/tex/Course_Request_Enroll_Start.tex
\label{Course_Request_Enroll_Start}
Choose a date when you would like registered students to begin being enrolled automatically. Prior to this date no registered students will be enrolled.
Index: loncom/html/adm/help/tex/Course_Request_LCSection.tex
+++ loncom/html/adm/help/tex/Course_Request_LCSection.tex
\label{Course_Request_LCSection}
The 'LON-CAPA section' is the section in your LON-CAPA course with which students automatically enrolled from a particular institutional section will be affiliated. You can leave this box empty if you do not wish to differentiate students based on institutional section. In that case, students will receive a 'section-less' role in your LON-CAPA course.
LON-CAPA section names may only contain letters and numbers.
Index: loncom/html/adm/help/tex/Course_Request_Personnel.tex
+++ loncom/html/adm/help/tex/Course_Request_Personnel.tex
\label{Course_Request_Personnel}
You can identify course personnel and assign course roles to them when requesting your course.
An individual user can be assigned multiple roles in a LON-CAPA course. A user assigned more than one role will select which aprticular course role he/she wishes to adopt at any time by making a selection on the roles screen, or from a role-switcher select box displayed at the top of most course pages.
The Course Coordinator role (which is the most powerful role in a course) can assign roles to other users once a course is set-up, and can also assume any role in the course, on an ad hoc basis.
Currently, additional course coordinators must be added to a course by the domain coordinator (usually someone from the unit responsible for providing LON-CAPA service at your institution), unless included in your course request.
You will probably not want to add students to your course from the 'additional personnel' page included in the course request form, as there are more efficient ways to do this once the course has been created. If your institution has enabled automatic enrollment in official courses, then that would be the simplest way to add students to an 'official' course. You can also upload a file containing usernames of students - and (optionally) other information - once the course has been created.
Index: loncom/html/adm/help/tex/Course_Request_Rolesection.tex
+++ loncom/html/adm/help/tex/Course_Request_Rolesection.tex
\label{Course_Request_Rolesection}
Specify the sections to which you would like each individual role to have access.
LON-CAPA section names may only contain letters and numbers.
The Course Coordinator role is 'section-less' and will have access to all sections in a course with multiple sections. For other roles, you can assign access to specific sections. To assign a 'section-less' role with access to all sections choose "None" if there are 'Official' sections, or else leave the LON-CAPA Sections box empty.
If there are 'Official' sections, you can select multiple sections by using the following keyboard and mouse combinations in the 'official' sections drop-down box.
\begin{longtable}{|ll|}
\hline
\textbf{Action} & \textbf{OS}\\
Apple-click & Mac\\
Ctrl-click & Windows\\
Ctrl-click & Linux\\
\hline
\end{longtable}
Use a comma to separate section names when specifying multiple sections in the 'LON-CAPA sections' box.
Index: loncom/html/adm/help/tex/Course_Request_Sections.tex
+++ loncom/html/adm/help/tex/Course_Request_Sections.tex
\label{Course_Request_Sections}
Multiple sections can be managed in a single LON-CAPA course.
You can assign users to different sections, and can set open and close dates for content pages, discussions, and assessments, on a section-by-section basis.
Typically, a single LON-CAPA course is sufficient when teaching a course with more than one section. However, you can also create different courses for different sections (or sets of sections) taught by different faculty.
If you want to assign content editing rights to specific instructors for different sections or combinations of sections then you should request creation of more than one LON-CAPA course for your class.
To request multiple LON-CAPA courses for a single class, you will need to complete the course request form for each course (specifying different institutional section(s) for the different courses).
Index: loncom/html/adm/help/tex/Course_Request_RegAccess_Start.tex
+++ loncom/html/adm/help/tex/Course_Request_RegAccess_Start.tex
\label{Course_Request_RegAccess_Start}
Choose when course access should begin for registered students added by the auto-enrollment process. Prior to this date student roles for registered students will be inactive.
Index: loncom/html/adm/help/tex/Course_Request_RegAccess_End.tex
+++ loncom/html/adm/help/tex/Course_Request_RegAccess_End.tex
\label{Course_Request_RegAccess_End}
Choose when course access should end for students added by the auto-enrollment process. After this date student roles for registered students will become inactive.
--raeburn1252551637--